@riverbankcms/sdk 0.84.0 → 0.84.1

package/dist/cli/init-docs/content/workflow-agent-safe-sync.md

@@ -0,0 +1,81 @@
+# Workflow: Agent-Safe Sync
+
+Use this workflow when an agent needs to push a narrow CMS change without overwriting unrelated dashboard edits.
+
+## Golden Rules
+
+1. Prefer the CLI `--env` flag over shell environment overrides.
+2. Dry-run the exact scope you plan to apply.
+3. Push the narrowest possible content scope.
+4. Treat stale-content warnings as evidence of unrelated remote edits.
+5. Use `push-config` for schema/config only; use `push` for pages, entries, navigation, settings, and other content files.
+
+## Environment Targeting
+
+Use the CLI environment flag:
+
+```bash
+riverbankcms pull --env=remote
+riverbankcms push pages privacy-policy --env=remote --dry-run
+riverbankcms push-config --env=remote
+```
+
+Do not rely on `RIVERBANK_ENV=remote riverbankcms ...` for CLI sync commands. Site projects often load `.env.local`, and an existing `RIVERBANK_ENV=local` value can override the shell value in config-loading paths. The CLI `--env` flag is explicit and survives project env defaults.
+
+## Narrow Page Push
+
+For a single page, push the page identifier rather than all pages:
+
+```bash
+riverbankcms push pages privacy-policy --env=remote --dry-run --force
+riverbankcms push pages privacy-policy --env=remote --yes --force
+```
+
+If you need to isolate a local file snapshot from the rest of `content/pages`, use a temporary content directory:
+
+```bash
+tmpdir=$(mktemp -d)
+mkdir -p "$tmpdir/pages"
+cp content/pages/privacy-policy.json "$tmpdir/pages/privacy-policy.json"
+
+riverbankcms push pages --content-dir "$tmpdir" --env=remote --dry-run --force
+riverbankcms push pages --content-dir "$tmpdir" --env=remote --yes --force
+
+rm -rf "$tmpdir"
+```
+
+This is useful when local content files include older or unrelated page differences that should not be pushed.
+
+## Stale Content
+
+If a push aborts because unrelated remote content is newer:
+
+- Do not blindly run a broad `push --force`.
+- Prefer pushing the exact changed page, entry, or navigation scope.
+- Use `--force` only after a dry-run confirms the planned changes are limited to the intended objects.
+- If you truly need the latest remote state, run a scoped pull first, for example `riverbankcms pull pages privacy-policy --env=remote`.
+
+## Content vs Config
+
+Use these commands for different surfaces:
+
+```bash
+# Pages, entries, navigation, settings, forms, footer content, themes
+riverbankcms push <scope> ...
+
+# Custom blocks, block extensions/options, content type schemas/templates,
+# SDK-managed settings, footer blocks/layout config
+riverbankcms push-config ...
+```
+
+`push-config` does not replace `push pages` or `push entries`; it syncs schema/config surfaces. If config validation fails, read the field errors as schema feedback before working around them in the site.
+
+## Before Applying
+
+Checklist:
+
+- [ ] I used `--env=local`, `--env=remote`, or `--env=both` explicitly.
+- [ ] I ran a dry-run for the same scope and target environment.
+- [ ] The dry-run contains only intended creates/updates/deletes.
+- [ ] I understand any stale-content warnings.
+- [ ] For remote writes, I included `--yes` only after reviewing the dry-run.

package/dist/cli/init-docs/content/workflow-create-page.md

@@ -10,6 +10,16 @@ This workflow guides you through creating a new page in the CMS.
 
 ## Steps
 
+### Before You Add Custom Blocks
+
+For simple content pages such as privacy policies, terms pages, FAQs, about copy, and editorial articles, start with built-in blocks:
+
+- `block.body-text` for long-form rich text
+- `block.hero` only when the page genuinely needs a visual/intro hero
+- `block.cta-full` or existing CTA blocks for action strips
+
+Check `block-types.md` before creating a custom block. A plain content page should usually be one `block.body-text` block with an `h1` and intro paragraph in the rich text body, not a site-specific custom block.
+
 ### 1. Create the Page
 
 ```bash
@@ -45,7 +55,7 @@ Add a body text block:
 ```bash
 riverbankcms block upsert contact intro-text \
   --kind block.body-text \
-  --data '{"content": "<p>Reach out using the form below or email us directly.</p>"}'
+  --data '{"body": {"type": "doc", "content": [{"type": "heading", "attrs": {"level": 1}, "content": [{"type": "text", "text": "Contact Us"}]}, {"type": "paragraph", "content": [{"type": "text", "text": "Reach out using the form below or email us directly."}]}]}}'
 ```
 
 Add more blocks as needed. See `block-types.md` for available block types.
@@ -159,12 +169,12 @@ riverbankcms block upsert about hero \
 # 3. Add introduction text
 riverbankcms block upsert about intro \
   --kind block.body-text \
-  --data '{"content": "<p>Founded in 2020, we have been...</p>"}'
+  --data '{"body": {"type": "doc", "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Founded in 2020, we have been..."}]}]}}'
 
 # 4. Add team section (if using a team block)
 riverbankcms block upsert about team \
   --kind block.body-text \
-  --data '{"content": "<h2>Our Team</h2><p>Meet the people behind the company.</p>"}'
+  --data '{"body": {"type": "doc", "content": [{"type": "heading", "attrs": {"level": 2}, "content": [{"type": "text", "text": "Our Team"}]}, {"type": "paragraph", "content": [{"type": "text", "text": "Meet the people behind the company."}]}]}}'
 
 # 5. Verify
 riverbankcms page get about

package/dist/cli/init-docs/content/workflow-custom-block.md

@@ -4,6 +4,15 @@ Create a site-specific block with custom fields and rendering when system blocks
 
 ## When to Use Custom Blocks
 
+Before creating a custom block, check `block-types.md` and the site `schema.md`. Many content needs are already covered by system blocks:
+
+- `block.body-text` for policy pages, terms pages, simple articles, and editorial copy
+- `block.hero` for page intros and visual mastheads
+- `block.cta-full` / CTA blocks for call-to-action sections
+- `block.image-gallery`, `block.media-text`, and similar media/content patterns
+
+Do not create a custom block just to get “a rich text area with different spacing.” Use a built-in block and add scoped site CSS or block field extensions when that is enough.
+
 **Use custom blocks when:**
 - You need a completely unique block structure
 - The functionality doesn't map to any system block

package/dist/cli/init-docs/content/workflow-templates.md

@@ -210,6 +210,19 @@ Bindings map block fields to data sources. Available binding sources:
 
 **Valid meta paths:** `title`, `slug`, `publishedAt`, `createdAt`, `updatedAt`
 
+### Binding Type Compatibility
+
+Template bindings must connect compatible source and target field types. `push-config` validates this and will reject mismatches before they reach the dashboard.
+
+Common examples:
+
+- `richText` entry field -> `richText` block field
+- `media` entry field -> `media` block field
+- `reference` entry field -> `reference` block field with the same `referenceKind`
+- `text` entry field -> `text` block field
+
+Do not bind a `reference` source into a `text` target just because the renderer eventually wants an identifier string. Make the custom block field a `reference` too, then convert/normalize the rendered value in code if needed. This keeps the block schema honest and allows dashboard validation/editor UI to work correctly.
+
 ### Step 4: Push Configuration
 
 Push the template to sync it with the CMS:
@@ -365,3 +378,4 @@ When you first push a template to a content type that has existing entries:
 - Check binding keys match block field IDs
 - Verify field paths exist in content type fields
 - Ensure block kinds are valid system or custom blocks
+- Ensure source and target field types are compatible, especially `reference` fields

package/dist/client/{accordion-ESY65T56.mjs → accordion-2UZPBMYM.mjs}

@@ -1,4 +1,4 @@
-import { defineIslandPropsDecoder } from './chunk-HXPWP5EN.mjs';
+import { defineIslandPropsDecoder } from './chunk-VGDBVNOO.mjs';
 import './chunk-ZE5G642V.mjs';
 
 // src/rendering/islands/enhancers/accordion.ts

package/dist/client/{bookingForm-JRFNZUHD.mjs → bookingForm-DYXT6YB6.mjs}

@@ -1,15 +1,15 @@
 "use client";
-import { usePolling } from './chunk-5ZEAZ33K.mjs';
+import { usePolling } from './chunk-ZKUO52W3.mjs';
 import { SpinnerNode } from './chunk-SYIJ5JO2.mjs';
 import { useDiscountCodeUi } from './chunk-ZFHRN6W2.mjs';
 import { buildRouteIslandApiConfig } from './chunk-L4J5Y62O.mjs';
-import { scrollToBlock, buildCheckoutReturnUrls, DiscountCodeDisclosure, formatPrice } from './chunk-52I7BGEK.mjs';
+import { scrollToBlock, buildCheckoutReturnUrls, DiscountCodeDisclosure, formatPrice } from './chunk-7UCLJ5SP.mjs';
 import { FieldValidationMessage, getFieldValidationControlProps } from './chunk-3DCJ45Z2.mjs';
 import './chunk-DVNUDUVT.mjs';
 import { isSpamProtectionEnabled, getChallengeUrl, AltchaWidget } from './chunk-GFSQNTRW.mjs';
 import { BlockApiProvider, useBlockApi, FeedbackMessage } from './chunk-UDNSI5PY.mjs';
 import { mountReactIsland } from './chunk-N7PBWBWQ.mjs';
-import { defineIslandPropsDecoder, resolveBookingSiteId, resolveDefaultBookingServiceId, getBookingRedirectStateFromLocation, deriveBookingFormViewState, logger, getBookingSuccessMessage, resolveAppointmentCheckoutVerificationState, themeButtonClassName, toSelectedCollectionOptionKind, assertNever11, prepareBookingSubmission, formatBookingSubmissionPreparationError, resolveBookingPaymentStep, BOOKING_FORM_DATA_RESERVED_KEYS, clearWorkflowFeedback, reportWorkflowError, reportWorkflowSuccess, okWith2, err2 } from './chunk-HXPWP5EN.mjs';
+import { defineIslandPropsDecoder, resolveBookingSiteId, resolveDefaultBookingServiceId, getBookingRedirectStateFromLocation, deriveBookingFormViewState, logger, getBookingSuccessMessage, resolveAppointmentCheckoutVerificationState, themeButtonClassName, toSelectedCollectionOptionKind, assertNever11, prepareBookingSubmission, formatBookingSubmissionPreparationError, resolveBookingPaymentStep, BOOKING_FORM_DATA_RESERVED_KEYS, clearWorkflowFeedback, reportWorkflowError, reportWorkflowSuccess, okWith2, err2 } from './chunk-VGDBVNOO.mjs';
 import { resolveBookingTimeZoneId, DEFAULT_BOOKING_TIME_ZONE, unsafeAsFormId, unsafeAsAppointmentResourceId, unsafeAsCustomerPassId, unsafeAsAppointmentServiceId, formatLocalScheduleDate, addLocalScheduleDays, parseBookingLocalDate, resolveFlexibleBalanceInitialPaymentCents, resolveFlexibleBalanceDueAt, getBookingInstalmentDepositRefundability, unsafeAsPassId, splitAmountWithRemainderInFirst, addIntervalPreservingMonthAnchor, clampConfiguredAmount, getBookingInstalmentPlanIntervalCount, omitZeroAmountFutureRows, formatBookingInstant } from './chunk-ZE5G642V.mjs';
 import React2, { useRef, useState, useMemo, useReducer, useEffect, useCallback, useLayoutEffect } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';

package/dist/client/bookings.mjs

@@ -11786,6 +11786,89 @@ var MQ_TABLET_ONLY = mqBetween(BREAKPOINT_SM, BREAKPOINT_LG_DOWN);
 var MQ_MAX_640 = mqDown(BREAKPOINT_SM);
 var MQ_MAX_768 = mqDown(BREAKPOINT_MD);
 
+// ../blocks/src/system/runtime/nodes/event-registration/registrationDerivations.ts
+function eventMatchesOccurrenceId(event, occurrenceId) {
+  return event.registrationOccurrenceId === occurrenceId || event.publicEventId === occurrenceId;
+}
+function findEventByOccurrenceId(events, occurrenceId) {
+  return events.find((event) => eventMatchesOccurrenceId(event, occurrenceId)) ?? null;
+}
+function findPreSelectedEvent(input) {
+  const occurrenceContext = input.occurrenceContext;
+  if (!occurrenceContext) {
+    return null;
+  }
+  const contextDate = getBookingLocalDateKey(toScheduledBookingDateTime({
+    startsAt: occurrenceContext.startsAt,
+    timeZone: occurrenceContext.timeZone
+  }));
+  return input.scopedEvents.find(
+    (event) => eventMatchesOccurrenceId(event, occurrenceContext.id) || getBookingLocalDateKey(toScheduledBookingDateTime({
+      startsAt: event.startsAt,
+      timeZone: event.timeZone
+    })) === contextDate
+  ) ?? null;
+}
+function resolveRegistrationTarget(input) {
+  const occurrenceId = input.occurrenceContext?.id ?? input.selectedEvent?.registrationOccurrenceId ?? null;
+  if (!occurrenceId) {
+    return null;
+  }
+  return {
+    occurrenceId,
+    selectedEventId: input.selectedEvent?.publicEventId ?? null
+  };
+}
+function resolveEventRequiresPayment(input) {
+  if (input.eligibility) {
+    return input.eligibility.requiresPayment;
+  }
+  if (input.selectedTicketType) {
+    return input.selectedTicketType.priceAmount > 0;
+  }
+  if (!input.event) {
+    return false;
+  }
+  return publicEventPricingType(resolveRuntimeEventPricing(input.event)) !== "free";
+}
+function resolveDiscountContext(input) {
+  const selection = input.paymentSelection.method ? input.paymentSelection : null;
+  if (!input.event) {
+    return null;
+  }
+  if (selection?.method === "pass_bundle" && selection.bundlePassId) {
+    return { type: "pass", passId: selection.bundlePassId };
+  }
+  if (selection?.method === "membership_bundle" && selection.bundleMembershipId) {
+    return { type: "membership", membershipId: selection.bundleMembershipId };
+  }
+  if (!input.eventRequiresPayment) {
+    return null;
+  }
+  if (selection?.method && selection.method !== "stripe") {
+    return null;
+  }
+  return {
+    type: "event",
+    eventSeriesId: input.event.seriesId,
+    eventCategoryId: input.event.eventCategory?.id ?? null,
+    ticketsCount: input.ticketsCount
+  };
+}
+
+// ../blocks/src/system/runtime/nodes/event-registration/registrationEventAdapter.ts
+function toRegistrationEvent(event) {
+  return {
+    ...event,
+    pricing: resolveRuntimeEventPricing(event),
+    publicEventId: event.id,
+    registrationOccurrenceId: event.occurrenceId
+  };
+}
+function toRegistrationEvents(events) {
+  return events.map(toRegistrationEvent);
+}
+
 // ../blocks/src/system/runtime/shared/components/FeedbackMessage.tsx
 import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 function joinClasses(...parts) {
@@ -15628,8 +15711,10 @@ function requiresPaymentStep(params) {
   return !isEntitlementSelection(params.paymentSelection);
 }
 
-// ../blocks/src/system/runtime/nodes/event-registration/event-registration.headless.state.ts
+// ../blocks/src/system/runtime/nodes/event-registration/event-registration.headless.contract.ts
 var DEFAULT_EVENT_REGISTRATION_MAX_TICKETS = 5;
+
+// ../blocks/src/system/runtime/nodes/event-registration/event-registration.headless.override.ts
 function createEventRegistrationBlockApiConfig(input) {
   return {
     baseUrl: input.apiBaseUrl,
@@ -15639,19 +15724,6 @@ function createEventRegistrationBlockApiConfig(input) {
     ...input.portalToken ? { authOverrides: { portal: { type: "bearer", token: input.portalToken } } } : {}
   };
 }
-function getRegistrableStatuses(isPreview) {
-  return isPreview ? ["active", "draft"] : ["active"];
-}
-function normalizeEventRegistrationMaxTickets(value) {
-  if (typeof value === "number" && Number.isFinite(value) && value > 0) {
-    return Math.floor(value);
-  }
-  if (typeof value === "string") {
-    const parsed = Number.parseInt(value, 10);
-    return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_EVENT_REGISTRATION_MAX_TICKETS;
-  }
-  return DEFAULT_EVENT_REGISTRATION_MAX_TICKETS;
-}
 function getEventRegistrationOverrideInput(props) {
   if (!props.siteId) {
     return {
@@ -15694,6 +15766,36 @@ function getEventRegistrationOverrideInput(props) {
     }
   };
 }
+function isRecord5(value) {
+  return typeof value === "object" && value !== null;
+}
+function isPublicEventLike(value) {
+  return isRecord5(value) && typeof value.id === "string" && typeof value.occurrenceId === "string" && typeof value.seriesId === "string" && typeof value.title === "string" && typeof value.slug === "string" && typeof value.path === "string" && typeof value.requiresRegistration === "boolean" && isDeliveryMode(value.deliveryMode) && Array.isArray(value.attendanceModes) && typeof value.startsAt === "string" && typeof value.endsAt === "string" && typeof value.timeZone === "string" && isRecord5(value.pricing) && isRecord5(value.paymentTerms) && isAccessRestriction(value.accessRestriction) && Array.isArray(value.allowedCategoryIds);
+}
+function isDeliveryMode(value) {
+  return value === "in_person" || value === "online" || value === "hybrid";
+}
+function isAccessRestriction(value) {
+  return value === "none" || value === "category";
+}
+function isEventRegistrationContentEntryLike(value) {
+  return isRecord5(value) && typeof value.id === "string" && typeof value.slug === "string" && typeof value.contentTypeSlug === "string";
+}
+
+// ../blocks/src/system/runtime/nodes/event-registration/event-registration.headless.planning.ts
+function getRegistrableStatuses(isPreview) {
+  return isPreview ? ["active", "draft"] : ["active"];
+}
+function normalizeEventRegistrationMaxTickets(value) {
+  if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+    return Math.floor(value);
+  }
+  if (typeof value === "string") {
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_EVENT_REGISTRATION_MAX_TICKETS;
+  }
+  return DEFAULT_EVENT_REGISTRATION_MAX_TICKETS;
+}
 function toHeadlessPaymentSelection(selection) {
   switch (selection.method) {
     case null:
@@ -15843,7 +15945,9 @@ function resolveHeadlessEventRegistrationView(wizard) {
     return { kind: "empty", message: "No events available for registration." };
   }
   const allowedStatuses = getRegistrableStatuses(wizard.api.config.isPreview);
-  const hasRegistrableEvents = wizard.scopedEvents.some((event) => !event.status || allowedStatuses.includes(event.status));
+  const hasRegistrableEvents = wizard.scopedEvents.some(
+    (event) => !event.status || allowedStatuses.includes(event.status)
+  );
   if (!hasRegistrableEvents && !wizard.occurrenceContext) {
     return {
       kind: "unavailable",
@@ -15869,16 +15973,6 @@ function resolveHeadlessEventRegistrationView(wizard) {
       return { kind: "form" };
   }
 }
-function withOptionalSelection(args, selection) {
-  return selection ? { ...args, selection } : args;
-}
-function missingPaymentSelection() {
-  return {
-    ok: false,
-    reason: "payment-selection-required",
-    message: "Select a payment option to continue."
-  };
-}
 function deriveEventRegistrationSteps(input) {
   const ids = [];
   if (!input.hasPreSelectedContext) ids.push("select-event");
@@ -15895,6 +15989,16 @@ function deriveEventRegistrationSteps(input) {
     canLeave: activeIndex !== index
   }));
 }
+function withOptionalSelection(args, selection) {
+  return selection ? { ...args, selection } : args;
+}
+function missingPaymentSelection() {
+  return {
+    ok: false,
+    reason: "payment-selection-required",
+    message: "Select a payment option to continue."
+  };
+}
 function getStepLabel(step) {
   switch (step) {
     case "select-event":
@@ -15907,21 +16011,6 @@ function getStepLabel(step) {
       return "Payment";
   }
 }
-function isRecord5(value) {
-  return typeof value === "object" && value !== null;
-}
-function isPublicEventLike(value) {
-  return isRecord5(value) && typeof value.id === "string" && typeof value.occurrenceId === "string" && typeof value.seriesId === "string" && typeof value.title === "string" && typeof value.slug === "string" && typeof value.path === "string" && typeof value.requiresRegistration === "boolean" && isDeliveryMode(value.deliveryMode) && Array.isArray(value.attendanceModes) && typeof value.startsAt === "string" && typeof value.endsAt === "string" && typeof value.timeZone === "string" && isRecord5(value.pricing) && isRecord5(value.paymentTerms) && isAccessRestriction(value.accessRestriction) && Array.isArray(value.allowedCategoryIds);
-}
-function isDeliveryMode(value) {
-  return value === "in_person" || value === "online" || value === "hybrid";
-}
-function isAccessRestriction(value) {
-  return value === "none" || value === "category";
-}
-function isEventRegistrationContentEntryLike(value) {
-  return isRecord5(value) && typeof value.id === "string" && typeof value.slug === "string" && typeof value.contentTypeSlug === "string";
-}
 
 // ../blocks/src/system/runtime/nodes/event-registration/utils.ts
 var DEFAULT_EVENT_CURRENCY2 = "usd";
@@ -16749,89 +16838,6 @@ function useEventRegistrationSubmit(options) {
   };
 }
 
-// ../blocks/src/system/runtime/nodes/event-registration/registrationDerivations.ts
-function eventMatchesOccurrenceId(event, occurrenceId) {
-  return event.registrationOccurrenceId === occurrenceId || event.publicEventId === occurrenceId;
-}
-function findEventByOccurrenceId(events, occurrenceId) {
-  return events.find((event) => eventMatchesOccurrenceId(event, occurrenceId)) ?? null;
-}
-function findPreSelectedEvent(input) {
-  const occurrenceContext = input.occurrenceContext;
-  if (!occurrenceContext) {
-    return null;
-  }
-  const contextDate = getBookingLocalDateKey(toScheduledBookingDateTime({
-    startsAt: occurrenceContext.startsAt,
-    timeZone: occurrenceContext.timeZone
-  }));
-  return input.scopedEvents.find(
-    (event) => eventMatchesOccurrenceId(event, occurrenceContext.id) || getBookingLocalDateKey(toScheduledBookingDateTime({
-      startsAt: event.startsAt,
-      timeZone: event.timeZone
-    })) === contextDate
-  ) ?? null;
-}
-function resolveRegistrationTarget(input) {
-  const occurrenceId = input.occurrenceContext?.id ?? input.selectedEvent?.registrationOccurrenceId ?? null;
-  if (!occurrenceId) {
-    return null;
-  }
-  return {
-    occurrenceId,
-    selectedEventId: input.selectedEvent?.publicEventId ?? null
-  };
-}
-function resolveEventRequiresPayment(input) {
-  if (input.eligibility) {
-    return input.eligibility.requiresPayment;
-  }
-  if (input.selectedTicketType) {
-    return input.selectedTicketType.priceAmount > 0;
-  }
-  if (!input.event) {
-    return false;
-  }
-  return publicEventPricingType(resolveRuntimeEventPricing(input.event)) !== "free";
-}
-function resolveDiscountContext(input) {
-  const selection = input.paymentSelection.method ? input.paymentSelection : null;
-  if (!input.event) {
-    return null;
-  }
-  if (selection?.method === "pass_bundle" && selection.bundlePassId) {
-    return { type: "pass", passId: selection.bundlePassId };
-  }
-  if (selection?.method === "membership_bundle" && selection.bundleMembershipId) {
-    return { type: "membership", membershipId: selection.bundleMembershipId };
-  }
-  if (!input.eventRequiresPayment) {
-    return null;
-  }
-  if (selection?.method && selection.method !== "stripe") {
-    return null;
-  }
-  return {
-    type: "event",
-    eventSeriesId: input.event.seriesId,
-    eventCategoryId: input.event.eventCategory?.id ?? null,
-    ticketsCount: input.ticketsCount
-  };
-}
-
-// ../blocks/src/system/runtime/nodes/event-registration/registrationEventAdapter.ts
-function toRegistrationEvent(event) {
-  return {
-    ...event,
-    pricing: resolveRuntimeEventPricing(event),
-    publicEventId: event.id,
-    registrationOccurrenceId: event.occurrenceId
-  };
-}
-function toRegistrationEvents(events) {
-  return events.map(toRegistrationEvent);
-}
-
 // ../blocks/src/system/runtime/nodes/event-registration/useEventRegistrationWizard.ts
 function useEventRegistrationWizard(options) {
   const api = useBlockApi();
@@ -17125,23 +17131,29 @@ function useEventRegistrationWizard(options) {
   );
   const handleDetailsComplete = async () => {
     if (ticketTypeSelectionRequired && !hasValidSelectedTicketType) {
-      setErrorMessage("Select a ticket type to continue.");
+      const message = "Select a ticket type to continue.";
+      setErrorMessage(message);
       setStep("error");
-      return;
+      return { ok: false, reason: "blocked", message };
     }
     if (!validateForm()) {
       setGuestSectionShake(true);
-      return;
+      return {
+        ok: false,
+        reason: "validation-failed",
+        message: "Check the highlighted fields and try again."
+      };
     }
     if (waitlistClaim.claim === null && eligibility?.isFull && !eligibility.canJoinWaitlist) {
-      setErrorMessage("This event is sold out.");
+      const message = "This event is sold out.";
+      setErrorMessage(message);
       setStep("error");
-      return;
+      return { ok: false, reason: "blocked", message };
     }
     const shouldCollectPayment = !eligibility?.canJoinWaitlist && requiresPaymentStep({ eventRequiresPayment, paymentSelection });
     if (shouldCollectPayment) {
       setStep("select-payment");
-      return;
+      return { ok: true, outcome: "payment-step" };
     }
     const submitPlan = resolveEventRegistrationSubmitPlan({
       paymentSelection,
@@ -17151,14 +17163,22 @@ function useEventRegistrationWizard(options) {
     if (!submitPlan.ok) {
       setErrorMessage(submitPlan.message);
       setStep("error");
-      return;
+      return { ok: false, reason: "blocked", message: submitPlan.message };
     }
-    await handleSubmit(
+    const submitResult = await handleSubmit(
       submitPlan.args.method,
       submitPlan.args.passId,
       submitPlan.args.membershipId,
       submitPlan.args.selection
     );
+    if (!submitResult.ok) {
+      return {
+        ok: false,
+        reason: submitResult.reason === "submission-failed" ? "submission-failed" : "blocked",
+        message: submitResult.message
+      };
+    }
+    return { ok: true, outcome: "submitted" };
   };
   const handlePaymentSelect = async () => {
     const submitPlan = resolveEventRegistrationSubmitPlan({
@@ -18146,9 +18166,10 @@ function useEventRegistrationController(options) {
         }
         wizard.setStep("enter-details");
         return { ok: true };
-      case "enter-details":
-        await wizard.handleDetailsComplete();
-        return { ok: true };
+      case "enter-details": {
+        const result = await wizard.handleDetailsComplete();
+        return result.ok ? { ok: true } : result;
+      }
       case "select-payment": {
         const result = await submit({ redirect: "manual" });
         return result.ok ? { ok: true } : {

package/dist/client/{carousel-CPR5VWIP.mjs → carousel-QH77HR6X.mjs}

@@ -1,6 +1,6 @@
-import { normalizeCarouselProps, CarouselNodeClient } from './chunk-JWEYB4V6.mjs';
+import { normalizeCarouselProps, CarouselNodeClient } from './chunk-4OXKTA3D.mjs';
 import { mountReactIsland } from './chunk-N7PBWBWQ.mjs';
-import { defineIslandPropsDecoder } from './chunk-HXPWP5EN.mjs';
+import { defineIslandPropsDecoder } from './chunk-VGDBVNOO.mjs';
 import './chunk-ZE5G642V.mjs';
 import { jsx } from 'react/jsx-runtime';
 

package/dist/client/{cart-ZUX5BA7O.mjs → cart-X4YK4FTW.mjs}

@@ -1,15 +1,15 @@
-import { mountShopBlockIsland, CartClient } from './chunk-URQCZD5W.mjs';
-import './chunk-Z5OBQ5I4.mjs';
-import './chunk-JWEYB4V6.mjs';
+import { mountShopBlockIsland, CartClient } from './chunk-52CGCQ7B.mjs';
+import './chunk-F5VRX5Y6.mjs';
+import './chunk-4OXKTA3D.mjs';
 import './chunk-I2MMZO53.mjs';
 import './chunk-ZFHRN6W2.mjs';
 import './chunk-L4J5Y62O.mjs';
-import './chunk-52I7BGEK.mjs';
+import './chunk-7UCLJ5SP.mjs';
 import './chunk-3DCJ45Z2.mjs';
 import './chunk-DVNUDUVT.mjs';
 import './chunk-UDNSI5PY.mjs';
 import './chunk-N7PBWBWQ.mjs';
-import { defineIslandPropsDecoder } from './chunk-HXPWP5EN.mjs';
+import { defineIslandPropsDecoder } from './chunk-VGDBVNOO.mjs';
 import './chunk-ZE5G642V.mjs';
 
 // src/rendering/islands/enhancers/cart.tsx

package/dist/client/{checkout-RULGBADZ.mjs → checkout-OM2BEPWD.mjs}

@@ -1,15 +1,15 @@
-import { mountShopBlockIsland, CheckoutClient } from './chunk-URQCZD5W.mjs';
-import './chunk-Z5OBQ5I4.mjs';
-import './chunk-JWEYB4V6.mjs';
+import { mountShopBlockIsland, CheckoutClient } from './chunk-52CGCQ7B.mjs';
+import './chunk-F5VRX5Y6.mjs';
+import './chunk-4OXKTA3D.mjs';
 import './chunk-I2MMZO53.mjs';
 import './chunk-ZFHRN6W2.mjs';
 import './chunk-L4J5Y62O.mjs';
-import './chunk-52I7BGEK.mjs';
+import './chunk-7UCLJ5SP.mjs';
 import './chunk-3DCJ45Z2.mjs';
 import './chunk-DVNUDUVT.mjs';
 import './chunk-UDNSI5PY.mjs';
 import './chunk-N7PBWBWQ.mjs';
-import { defineIslandPropsDecoder } from './chunk-HXPWP5EN.mjs';
+import { defineIslandPropsDecoder } from './chunk-VGDBVNOO.mjs';
 import './chunk-ZE5G642V.mjs';
 
 // src/rendering/islands/enhancers/checkout.tsx

package/dist/client/{chunk-BT6AEIKN.mjs → chunk-3DTWLTXM.mjs}

@@ -1,6 +1,6 @@
 "use client";
 import { useBlockApi, BlockApiError } from './chunk-UDNSI5PY.mjs';
-import { themeButtonClassName } from './chunk-HXPWP5EN.mjs';
+import { themeButtonClassName } from './chunk-VGDBVNOO.mjs';
 import { useState, useSyncExternalStore, useEffect } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 

package/dist/client/{chunk-JWEYB4V6.mjs → chunk-4OXKTA3D.mjs}

@@ -1,5 +1,5 @@
 "use client";
-import { ChevronLeft, ChevronRight } from './chunk-HXPWP5EN.mjs';
+import { ChevronLeft, ChevronRight } from './chunk-VGDBVNOO.mjs';
 import { clsx_default } from './chunk-ZE5G642V.mjs';
 import React, { useRef, useState, useCallback, useEffect } from 'react';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';