@riverbankcms/sdk 0.121.0 → 0.124.0

package/README.md

@@ -3244,7 +3244,6 @@ npx riverbankcms pull [scope] [type] [identifier]
 | `venues` | Pull all event venues or one venue by slug |
 | `event-categories` | Pull all event categories or one category by identifier |
 | `events` | Pull all event series or one event by identifier |
-| `courses` | Pull all course runs or one course by identifier |
 
 **Examples:**
 
@@ -3267,9 +3266,6 @@ npx riverbankcms pull pages home
 # Pull one canonical event
 npx riverbankcms pull events the-whole-in-your-heart
 
-# Pull one course
-npx riverbankcms pull courses beginners
-
 # Pull from remote environment
 npx riverbankcms pull --env=remote
 
@@ -3607,7 +3603,7 @@ For a fuller public-performance checklist covering broad client imports, bundle
 This single call replaces ~160 lines of typical boilerplate that handles:
 - Path resolution from URL slugs
 - Content loading (pages and entries)
-- Entry subroute routing (event occurrences at `/events/yoga-class/2025-01-15`, course runs at `/courses/yoga-101/spring-2026`, …)
+- Entry subroute routing for event occurrences such as `/events/yoga-class/2025-01-15`
 - Preview mode detection
 - Template rendering for entries
 - SEO metadata generation
@@ -3626,13 +3622,22 @@ When enabled, `loadContent()` fetches draft/unpublished content instead of publi
 
 ### Entry Subroute Routing
 
-For content types that declare `routing.subroutes` (events, courses, …), `createCatchAllPage` automatically handles "one-extra-segment" URLs under the parent entry. For example, with an event entry at `/events/yoga-class` and a course entry at `/courses/yoga-101`:
+For content types that declare `routing.subroutes`, `createCatchAllPage`
+automatically handles "one-extra-segment" URLs under the parent entry. For an
+event entry at `/events/yoga-class`:
 
 - `/events/yoga-class/2025-01-15` — date-based event occurrence (ISO date)
 - `/events/yoga-class/abc123-def4-...` — UUID-based event occurrence
-- `/courses/yoga-101/spring-2026` — slug-based course run
-
-The page detects these patterns using local route matching (no extra API calls), fetches the parent entry, and calls the public resolve endpoint to fetch the subroute payload. The result is passed to blocks via `dataContext.entrySubrouteContext`, a discriminated union of `{ kind: 'event-occurrence'; occurrence } | { kind: 'course-run'; run }`. Blocks that need it (event registration, course registration) read the variant they care about.
+The page detects event-occurrence paths using local route matching (no extra
+API calls), fetches the parent entry, and calls the public resolve endpoint to
+fetch the occurrence payload. The result is passed to event blocks via
+`dataContext.entrySubrouteContext` as
+`{ kind: 'event-occurrence'; occurrence }`.
+
+Whole-series offerings use direct content paths such as `/courses/beginners`.
+Course details and registration blocks select the canonical series from the
+page's `eventOffering` or `eventSeries` subject; nested course-run routes are
+not part of the SDK contract.
 
 Invalid subroute segments (e.g., `/events/yoga-class/invalid-date`) return a 404.
 

package/dist/{PreviewEditorSidebar-lZ600tJx.mjs → PreviewEditorSidebar-DBmAJJkQ.mjs}

@@ -1,8 +1,8 @@
 "use client";
-import { $c as cn, $i as findCuratedPalette, $l as LoaderCircle, A as dismissWarnings, Ac as CollapsibleContent, Ai as curatedSiteStyles, B as previewCuratedPalette, Bc as DropdownMenuLabel, C as applyResolvedSelections, Cl as assertNever$1, D as createPalette, Dn as listEntryPageContentSlots, Ds as updateButtonStyleSelectionChoice, E as committedPaletteForSnapshot, Es as resolveButtonStyleSelection, F as openRow, Fi as getHeaderLayout, G as previewSiteStyle, Gt as useEditorUiStore, H as previewHeaderLayout, Hc as DropdownMenuTrigger, Hl as Smartphone, I as paletteMutationCapability, Ic as Surface, Ii as getHeaderStyle, J as setPaletteColors, K as reconcilePaletteLibraryActive, Kl as Plus, Kt as useEditorUiStoreInstance, L as palettePreviewProjection, Lc as DropdownMenu, M as markApplyFailed, Mi as getCuratedSiteStyle, N as markApplySaved, Nn as ThemeScope, O as createStyleConfiguratorState, Os as buttonStyleSelectionKey, P as markApplySaving, Pi as findFooterLook, Pl as X$1, Qi as curatedPalettes, Ql as Maximize2, R as prepareStalePaletteRetry, Rc as DropdownMenuContent, Sc as TabsTrigger, T as cancelPreview, Ts as findButtonStyleRecipe, U as previewHeaderStyle, Ul as SlidersHorizontal, V as previewFooterLook, Vc as DropdownMenuSeparator, W as previewSitePalette, X as syncStyleConfiguratorState, Xc as Button, Xl as Monitor, Y as styleConfiguratorHistoryEntryForPersistedSelection, Z as toggleRow, _ as planSiteChromeLookSelection, _c as PopoverTrigger, _n as createManifestValidation, at as resolvePreviewSidebarTab, b as usePreviewDesignCoordinator, bc as TabsContent, bn as createStoreBackend, c as selectionSnapshotFromApplySiteStyleSelectionResponse, cc as SelectContent, cu as ChevronLeft, d as PREVIEW_DESIGN_REFRESH_ERROR_MESSAGE, dc as SelectValue, dn as resolveContentTitle, dt as useUISelector, ea as buildPaletteLibraryReadModel, f as PREVIEW_DESIGN_SAVE_ERROR_MESSAGE, fc as Callout, g as cycleableSiteChromeOptions, gc as PopoverContent, h as cycleSiteChromeLookId, hc as Popover, hn as ManifestForm, it as createOptimisticActionRunner, j as isPreviewingChange, jc as CollapsibleTrigger, js as themeButtonClassName, k as deriveStyleConfiguratorCapabilities, kc as Collapsible, l as resolveStyleConfiguratorInitialSnapshot, lc as SelectItem, ln as deriveRouteMetadataPresentation, m as buildSiteChromeLookModels, mc as SearchInput, mt as useEntryController, n as useSiteChromeCustomizeOptional, na as paletteColorsEqual, nl as unsafeAsEditorBlockId, ot as FooterComposerPanel, p as reportPreviewDesignError, pc as CalloutDescription, q as resetTypographyToSaved, ra as paletteColorsSchema, s as buildApplySiteStyleSelectionBody, sc as Select, sn as isAdapterReferenceKind, su as ChevronRight, ta as paletteColorEntries, u as PREVIEW_DESIGN_LOAD_ERROR_MESSAGE, uc as SelectTrigger, un as resolvePageRouteSlug, ut as ContentFieldsForm, uu as Check, v as planSiteStylePreviewChange, vc as Input, vn as FormRenderer, w as applyTypographyDraftPatch, ws as buttonStyleSelectionParameterValue, xc as TabsList, yc as Tabs, z as previewButtonStyle, zc as DropdownMenuItem, zl as Tablet, zt as BlockEditor } from "./SiteChromeCustomizeContext-BkNvpzNZ.mjs";
-import { d as unwrapResponse, f as getDashboardUrl, r as usePreviewAuth } from "./previewAuthStore-31xH13Jc.mjs";
-import { S as getSiteFontsStorageUrl, _ as useBlockCustomizeControls, b as buildFontPreviewUrl, d as resolvePreviewDashboardSetupHandoff, f as resolvePreviewEditorGuidanceModel, g as usePreviewBlockCustomizeSelectionOptional, h as canInspectSiteStyle, m as canApplySiteStyle, p as resolvePreviewSidebarChromeModel, u as buildPreviewDashboardSetupUrl, v as PreviewFormProvider, x as generateFontFaceCss, y as previewWidgetOverrides } from "./SdkPreviewModeRuntime-DhPU58s7.mjs";
-import { t as Separator } from "./separator-CiffYtk3.mjs";
+import { $i as curatedPalettes, $s as SearchInput, A as deriveStyleConfiguratorCapabilities, B as previewButtonStyle, Bt as BlockEditor, Cc as DropdownMenuContent, D as committedPaletteForSnapshot, Dc as DropdownMenuTrigger, Dl as Smartphone, E as cancelPreview, Ec as DropdownMenuSeparator, F as markApplySaving, Fc as Button, Fi as findFooterLook, Fl as Monitor, G as previewSitePalette, Gi as getHeaderLayout, H as previewFooterLook, I as openRow, J as resetTypographyToSaved, Js as SelectItem, K as previewSiteStyle, Ki as getHeaderStyle, Kl as ChevronRight, Ks as Select, Kt as useEditorUiStore, L as paletteMutationCapability, Ll as Maximize2, M as isPreviewingChange, N as markApplyFailed, Ni as getCuratedSiteStyle, O as createPalette, Ol as SlidersHorizontal, On as listEntryPageContentSlots, P as markApplySaved, Pn as ThemeScope, Q as toggleRow, Qs as CalloutDescription, R as palettePreviewProjection, Rc as cn, Rl as LoaderCircle, Sc as DropdownMenu, T as applyTypographyDraftPatch, Tc as DropdownMenuLabel, U as previewHeaderLayout, V as previewCuratedPalette, Vc as unsafeAsEditorBlockId, W as previewHeaderStyle, X as styleConfiguratorHistoryEntryForPersistedSelection, Xs as SelectValue, Y as setPaletteColors, Yl as Check, Ys as SelectTrigger, Z as syncStyleConfiguratorState, Zs as Callout, _ as planSiteChromeLookSelection, ac as TabsContent, at as createOptimisticActionRunner, c as selectionSnapshotFromApplySiteStyleSelectionResponse, cl as assertNever$1, cn as isAdapterReferenceKind, d as PREVIEW_DESIGN_REFRESH_ERROR_MESSAGE, dn as resolvePageRouteSlug, ds as resolveButtonStyleSelection, dt as ContentFieldsForm, ea as findCuratedPalette, ec as Popover, f as PREVIEW_DESIGN_SAVE_ERROR_MESSAGE, fn as resolveContentTitle, fs as updateButtonStyleSelectionChoice, ft as useUISelector, g as cycleableSiteChromeOptions, gc as CollapsibleTrigger, gn as ManifestForm, gs as themeButtonClassName, h as cycleSiteChromeLookId, hc as CollapsibleContent, ht as useEntryController, ia as paletteColorsSchema, ic as Tabs, j as dismissWarnings, ji as curatedSiteStyles, jl as Plus, k as createStyleConfiguratorState, l as resolveStyleConfiguratorInitialSnapshot, ls as buttonStyleSelectionParameterValue, m as buildSiteChromeLookModels, mc as Collapsible, n as useSiteChromeCustomizeOptional, na as paletteColorEntries, nc as PopoverTrigger, oc as TabsList, ot as resolvePreviewSidebarTab, p as reportPreviewDesignError, ps as buttonStyleSelectionKey, q as reconcilePaletteLibraryActive, ql as ChevronLeft, qs as SelectContent, qt as useEditorUiStoreInstance, ra as paletteColorsEqual, rc as Input, s as buildApplySiteStyleSelectionBody, sc as TabsTrigger, st as FooterComposerPanel, ta as buildPaletteLibraryReadModel, tc as PopoverContent, u as PREVIEW_DESIGN_LOAD_ERROR_MESSAGE, un as deriveRouteMetadataPresentation, us as findButtonStyleRecipe, v as deriveSiteStylePreviewUpdate, vn as createManifestValidation, w as applyResolvedSelections, wc as DropdownMenuItem, wl as Tablet, x as usePreviewDesignCoordinator, xc as Surface, xn as createStoreBackend, y as planSiteStylePreviewChange, yl as X$1, yn as FormRenderer, z as prepareStalePaletteRetry } from "./SiteChromeCustomizeContext-2z8moxYf.mjs";
+import { d as unwrapResponse, f as getDashboardUrl, r as usePreviewAuth } from "./previewAuthStore-CJX21dGi.mjs";
+import { S as getSiteFontsStorageUrl, _ as useBlockCustomizeControls, b as buildFontPreviewUrl, d as resolvePreviewDashboardSetupHandoff, f as resolvePreviewEditorGuidanceModel, g as usePreviewBlockCustomizeSelectionOptional, h as canInspectSiteStyle, m as canApplySiteStyle, p as resolvePreviewSidebarChromeModel, u as buildPreviewDashboardSetupUrl, v as PreviewFormProvider, x as generateFontFaceCss, y as previewWidgetOverrides } from "./SdkPreviewModeRuntime-BW9Z8j8T.mjs";
+import { t as Separator } from "./separator-CPtfzHqA.mjs";
 import React, { createContext, forwardRef, useCallback, useContext, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore, useTransition } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
@@ -464,11 +464,7 @@ function ContentSpinner({ className, size = "xl" }) {
 * consumers (notice, SEO, breadcrumbs, …).
 */
 function foldSubroute(ctx, fold) {
-	switch (ctx.kind) {
-		case "event-occurrence": return fold["event-occurrence"](ctx.occurrence);
-		case "course-run": return fold["course-run"](ctx.run);
-		default: return assertNever$1(ctx, "Unhandled subroute kind");
-	}
+	return fold["event-occurrence"](ctx.occurrence);
 }
 //#endregion
 //#region ../blocks/src/subroutes/formatDate.ts
@@ -507,24 +503,14 @@ function formatOccurrenceDate(iso) {
 * Adding a new {@link EntrySubrouteKind} requires a new entry here; the
 * `Record<EntrySubrouteKind, …>` shape will refuse to compile otherwise.
 */
-const SUBROUTE_KINDS = {
-	"event-occurrence": {
-		kind: "event-occurrence",
-		containerNoun: "event",
-		instanceNoun: "date",
-		listLabel: "events list",
-		formatInstanceName: (occurrence) => formatOccurrenceDate(occurrence.startsAt),
-		subEditorPath: (occurrence) => `bookings/events/${occurrence.seriesId}`
-	},
-	"course-run": {
-		kind: "course-run",
-		containerNoun: "course",
-		instanceNoun: "run",
-		listLabel: "courses list",
-		formatInstanceName: (run) => run.runName,
-		subEditorPath: (run) => `bookings/courses/${run.courseId}`
-	}
-};
+const SUBROUTE_KINDS = { "event-occurrence": {
+	kind: "event-occurrence",
+	containerNoun: "event",
+	instanceNoun: "date",
+	listLabel: "events list",
+	formatInstanceName: (occurrence) => formatOccurrenceDate(occurrence.startsAt),
+	subEditorPath: (occurrence) => `bookings/events/${occurrence.seriesId}`
+} };
 //#endregion
 //#region ../content-model/src/contentManifest.ts
 function assertNever(value) {
@@ -1051,10 +1037,7 @@ function buildNoticeFromMeta(meta, payload, siteId) {
 */
 function resolveSubrouteNotice(ctx, args) {
 	if (!ctx) return null;
-	return foldSubroute(ctx, {
-		"event-occurrence": (occurrence) => buildNoticeFromMeta(SUBROUTE_KINDS["event-occurrence"], occurrence, args.siteId),
-		"course-run": (run) => buildNoticeFromMeta(SUBROUTE_KINDS["course-run"], run, args.siteId)
-	});
+	return foldSubroute(ctx, { "event-occurrence": (occurrence) => buildNoticeFromMeta(SUBROUTE_KINDS["event-occurrence"], occurrence, args.siteId) });
 }
 //#endregion
 //#region ../preview-next/src/client/preview/EntrySlotBlockEditorPanel.tsx
@@ -1253,9 +1236,9 @@ function EntrySlotBlockEditorPanel({ siteId, dashboardBaseUrl, typeKey, entryId,
 			})
 		}, `${warning.kind}:${warning.slotKey}`)), slots.length > 1 ? /* @__PURE__ */ jsxs(Tabs, {
 			value: selectedSlot.slotKey,
-			onValueChange: (nextSlotKey) => {
+			onValueChange: async (nextSlotKey) => {
 				if (blockAutosaveStatus === "saving") return;
-				uiStore.getState().autosave.saveNow(["blocks"]);
+				await uiStore.getState().autosave.saveNow(["blocks"]);
 				setSlotSelection({
 					kind: "selected",
 					slotKey: nextSlotKey
@@ -3283,8 +3266,8 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 		previewTheme("style-configurator", planSiteStylePreviewChange({
 			siteStyle,
 			selection: state.previewed,
-			baseTheme: theme,
-			headerSelectionContext
+			headerSelectionContext,
+			compilation: deriveSiteStylePreviewUpdate(theme, state.base)
 		}).themeOverlay, "site-style");
 	}, [
 		state,
@@ -3319,8 +3302,8 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 			const result = planSiteStylePreviewChange({
 				siteStyle,
 				selection: next.previewed,
-				baseTheme: theme,
-				headerSelectionContext
+				headerSelectionContext,
+				compilation: deriveSiteStylePreviewUpdate(theme, next.base)
 			});
 			return applyResolvedSelections(next, {
 				resolved: {
@@ -3376,8 +3359,8 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 			return applyTypographyDraftPatch(current, planSiteStylePreviewChange({
 				siteStyle,
 				selection: current.previewed,
-				baseTheme: theme,
-				headerSelectionContext
+				headerSelectionContext,
+				compilation: deriveSiteStylePreviewUpdate(theme, current.base)
 			}).themeOverlay.typography, patch);
 		});
 	}, [headerSelectionContext, theme]);
@@ -3533,8 +3516,8 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 	const currentPreviewPlan = planSiteStylePreviewChange({
 		siteStyle: currentSiteStyle,
 		selection: state.previewed,
-		baseTheme: theme,
-		headerSelectionContext
+		headerSelectionContext,
+		compilation: deriveSiteStylePreviewUpdate(theme, state.base)
 	});
 	const currentTypography = currentPreviewPlan.themeOverlay.typography;
 	const chromeLookModels = buildSiteChromeLookModels({

package/dist/{PreviewEditorUI-CTBWzLSb.mjs → PreviewEditorUI-CfGaz9cY.mjs}

@@ -1,7 +1,7 @@
 "use client";
-import { $c as cn, $l as LoaderCircle, Cc as Dialog, Dc as DialogHeader, Gl as Redo2, Gt as useEditorUiStore, Hc as DropdownMenuTrigger, Il as Undo2, It as useEditor, Jl as PenLine, Kt as useEditorUiStoreInstance, Lc as DropdownMenu, Ll as TriangleAlert, Oc as DialogTitle, Rc as DropdownMenuContent, Tc as DialogDescription, Vl as Sparkles, Wt as classifyHistoryShortcut, Xc as Button, Yl as Palette, Zc as cva, a as previewDesignHistoryDomainForCommand, ac as TooltipContent, ht as useEntryEditorController, i as usePreviewDesignHistoryOrder, ic as Tooltip, lu as ChevronDown, n as useSiteChromeCustomizeOptional, nn as useMultiAutosave, nu as Eye, o as selectPreviewDesignHistoryDomain, oc as TooltipTrigger, ql as Pencil, ru as EllipsisVertical, wc as DialogContent, zc as DropdownMenuItem } from "./SiteChromeCustomizeContext-BkNvpzNZ.mjs";
-import { d as unwrapResponse, r as usePreviewAuth } from "./previewAuthStore-31xH13Jc.mjs";
-import { C as FixedBottomSurface, a as usePreviewPageDesignEditorState, c as applyPreviewChromeSurfaceToElement, l as resolvePreviewChromeSurface, o as PREVIEW_CHROME_PORTAL_CLASS_NAME, s as PREVIEW_CHROME_THEME_CLASS_NAME } from "./SdkPreviewModeRuntime-DhPU58s7.mjs";
+import { Al as Redo2, Cc as DropdownMenuContent, Dc as DropdownMenuTrigger, El as Sparkles, Fc as Button, Gs as TooltipTrigger, Gt as classifyHistoryShortcut, Hl as EllipsisVertical, Ic as cva, Jl as ChevronDown, Kt as useEditorUiStore, Lt as useEditor, Ml as Pencil, Nl as PenLine, Pl as Palette, Rc as cn, Rl as LoaderCircle, Sc as DropdownMenu, Sl as TriangleAlert, Us as Tooltip, Vl as Eye, Ws as TooltipContent, a as previewDesignHistoryDomainForCommand, cc as Dialog, fc as DialogHeader, gt as useEntryEditorController, i as usePreviewDesignHistoryOrder, lc as DialogContent, n as useSiteChromeCustomizeOptional, o as selectPreviewDesignHistoryDomain, pc as DialogTitle, qt as useEditorUiStoreInstance, rn as useMultiAutosave, uc as DialogDescription, wc as DropdownMenuItem, xl as Undo2 } from "./SiteChromeCustomizeContext-2z8moxYf.mjs";
+import { d as unwrapResponse, r as usePreviewAuth } from "./previewAuthStore-CJX21dGi.mjs";
+import { C as FixedBottomSurface, a as usePreviewPageDesignEditorState, c as applyPreviewChromeSurfaceToElement, l as resolvePreviewChromeSurface, o as PREVIEW_CHROME_PORTAL_CLASS_NAME, s as PREVIEW_CHROME_THEME_CLASS_NAME } from "./SdkPreviewModeRuntime-BW9Z8j8T.mjs";
 import * as React$1 from "react";
 import { useCallback, useEffect, useMemo, useState, useTransition } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";

package/dist/{PreviewQueryProvider-BHT8CJvZ.mjs → PreviewQueryProvider-BH-3-jSj.mjs}

@@ -1,5 +1,5 @@
 "use client";
-import { n as markPreviewAuthExpired, s as ApiRequestError } from "./previewAuthStore-31xH13Jc.mjs";
+import { n as markPreviewAuthExpired, s as ApiRequestError } from "./previewAuthStore-CJX21dGi.mjs";
 import { createContext, useContext, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
 import { MutationCache, QueryCache, QueryClient, QueryClientProvider } from "@tanstack/react-query";