@riverbankcms/sdk 0.81.0 → 0.84.0

package/dist/cli/init-docs/content/getting-started.md

@@ -80,6 +80,8 @@ riverbankcms push
 
 If your SDK site uses `createCatchAllPage()`, you can render with local theme objects (and switch themes at runtime) without pushing theme changes to the CMS. See `cli-reference.md` for theme pull/push commands and the SDK README for the `createCatchAllPage({ themes, themeSwitch })` API.
 
+Event registration blocks need both the SDK base stylesheet and a runtime theme scope. Generated SDK pages that render inside `Layout` get `ThemeScope` by default. Standalone `Page` or `Block` usage should wrap registration content in `ThemeBridgeProvider` or manual `generateThemeBridgeCss` with a `data-theme-scope="sdk"` wrapper; keep visual changes in scoped CSS variables instead of forking booking logic.
+
 ## Key Documentation
 
 | Document                | Purpose                                                          |

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

@@ -40,6 +40,9 @@ export default defineConfig({
       category: 'content',
       icon: 'Workflow',
       tags: ['process', 'steps', 'flow'],
+      previewCustomize: {
+        quickFieldPriority: ['title', 'introText'],
+      },
       fields: [
         {
           id: 'title',
@@ -74,6 +77,8 @@ export default defineConfig({
 });
 ```
 
+`previewCustomize` is optional. When present, `quickFieldPriority` must list one or more unique field IDs to consider for compact Preview Customize controls; unlisted fields remain in the full panel.
+
 ### Step 2: Choose Field Types
 
 Common field types for custom blocks:

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

@@ -11,8 +11,8 @@ Define default template blocks for content types that generate pages. Templates
 
 **Templates vs manual blocks:**
 - Templates define the *default* blocks for new entries
-- Editors can still modify blocks after entry creation
-- SDK always wins on sync—templates overwrite manual changes
+- Entry slots let editors add per-entry Page Content inside a shared template
+- SDK config owns the template structure; entry slot blocks belong to each entry
 
 ## Prerequisites
 
@@ -92,6 +92,97 @@ Each template block has a scope that determines how its content is sourced:
 }
 ```
 
+### Page Content Slots
+
+Use `system.entry-slot` when every entry should keep the same outer template but needs its own editable Page Content area. The slot must be template-scoped, and it only renders blocks for entries whose current template declares that slot key.
+
+```typescript
+{
+  key: 'article',
+  name: 'Article',
+  hasPages: true,
+  routePattern: '/articles/{slug}',
+  fields: [
+    { id: 'summary', type: 'text', label: 'Summary', multiline: true },
+  ],
+  template: {
+    blocks: [
+      {
+        identifier: 'article-header',
+        kind: 'block.hero',
+        scope: 'entry',
+        bindings: {
+          headline: { source: 'meta', path: 'title' },
+          subheadline: { source: 'field', path: 'summary' },
+        },
+      },
+      {
+        identifier: 'main-content',
+        kind: 'system.entry-slot',
+        scope: 'template',
+        content: {
+          slotKey: 'main',
+          label: 'Page content',
+          allowedBlocks: ['block.body-text', 'block.rich-text', 'custom.article-callout'],
+        },
+      },
+    ],
+  },
+}
+```
+
+Event templates use the same primitive. Keep native event data in event blocks, then place editorial content in the slot:
+
+```typescript
+{
+  key: 'event',
+  name: 'Event',
+  hasPages: true,
+  routePattern: '/events/{slug}',
+  template: {
+    blocks: [
+      { identifier: 'event-hero', kind: 'block.hero', scope: 'entry' },
+      { identifier: 'event-details', kind: 'block.event-details', scope: 'template' },
+      {
+        identifier: 'event-page-content',
+        kind: 'system.entry-slot',
+        scope: 'template',
+        content: {
+          slotKey: 'main',
+          label: 'Page content',
+          allowedBlocks: ['block.body-text', 'block.image-gallery', 'block.cta-full'],
+        },
+      },
+      { identifier: 'registration', kind: 'block.event-registration', scope: 'template' },
+    ],
+  },
+}
+```
+
+For entry content files, use the `blocks` object keyed by slot:
+
+```typescript
+{
+  identifier: 'gentle-essay',
+  contentType: 'article',
+  slug: 'gentle-essay',
+  data: { summary: 'A short introduction.' },
+  blocks: {
+    main: [
+      {
+        identifier: 'intro',
+        kind: 'block.body-text',
+        content: { body: 'The editable article body starts here.' },
+      },
+    ],
+  },
+}
+```
+
+If `allowedBlocks` is omitted, the slot uses the curated Page Content palette. An empty array means the slot is locked and editors cannot add blocks. Template-only system blocks such as event registration are not allowed inside slots; keep those in the outer template.
+
+Use entry fields for structured metadata that code needs to query or validate, such as retreat level, arrival time, teacher references, or event booking settings. Entry slots are for editorial page composition; extending built-in event metadata is a separate structured-data concern.
+
 **Template-scoped blocks** have fixed content:
 ```typescript
 {

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

@@ -1,5 +1,5 @@
-import { defineIslandPropsDecoder } from './chunk-NX6X3GRF.mjs';
-import './chunk-7BXX7WXH.mjs';
+import { defineIslandPropsDecoder } from './chunk-HXPWP5EN.mjs';
+import './chunk-ZE5G642V.mjs';
 
 // src/rendering/islands/enhancers/accordion.ts
 var decode = defineIslandPropsDecoder("accordion");

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

@@ -1,15 +1,16 @@
 "use client";
-import { usePolling } from './chunk-IUEDYLFJ.mjs';
-import { SpinnerNode } from './chunk-RMWMT3ZD.mjs';
+import { usePolling } from './chunk-5ZEAZ33K.mjs';
+import { SpinnerNode } from './chunk-SYIJ5JO2.mjs';
 import { useDiscountCodeUi } from './chunk-ZFHRN6W2.mjs';
-import { scrollToBlock, buildCheckoutReturnUrls, DiscountCodeDisclosure, formatPrice } from './chunk-PA2LJH2M.mjs';
+import { buildRouteIslandApiConfig } from './chunk-L4J5Y62O.mjs';
+import { scrollToBlock, buildCheckoutReturnUrls, DiscountCodeDisclosure, formatPrice } from './chunk-52I7BGEK.mjs';
 import { FieldValidationMessage, getFieldValidationControlProps } from './chunk-3DCJ45Z2.mjs';
-import './chunk-3PEDD5KJ.mjs';
-import { isSpamProtectionEnabled, getChallengeUrl, AltchaWidget } from './chunk-YLMKMCSJ.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-NX6X3GRF.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-7BXX7WXH.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 { 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';
 
@@ -3000,12 +3001,11 @@ var enhance = (root, props) => {
   if (!apiBaseUrl) {
     throw new Error("[sdk:islands] booking-form requires apiBaseUrl");
   }
-  const apiConfig = {
-    baseUrl: apiBaseUrl,
-    auth: { type: "none" },
-    authOverrides: portalToken ? { portal: { type: "bearer", token: portalToken } } : void 0,
+  const apiConfig = buildRouteIslandApiConfig({
+    apiBaseUrl,
+    portalToken,
     siteId
-  };
+  });
   return mountReactIsland(root, ({ root: reactRoot }) => {
     reactRoot.render(
       /* @__PURE__ */ jsx(BlockApiProvider, { config: apiConfig, children: /* @__PURE__ */ jsx(BookingFormClient, { ...props }) })