@riverbankcms/sdk 0.128.0 → 0.129.0

package/README.md

@@ -2627,6 +2627,38 @@ export default Page;
 export { generateMetadata };
 ```
 
+### Fully custom, override-only rendering
+
+Hosts that own all visual rendering can opt out of CMS theme admission and built-in block fallbacks explicitly. The registry only needs to cover block kinds the host's content actually uses; `satisfies BlockOverrideRegistrations` checks each registration without pretending custom block kinds form a closed exhaustive set.
+
+```tsx
+import { createCatchAllPage } from '@riverbankcms/sdk/next';
+import type {
+  BlockOverrideProps,
+  BlockOverrideRegistrations,
+} from '@riverbankcms/sdk/rendering';
+
+const blockOverrides = {
+  hero: ({ content }: BlockOverrideProps) => (
+    <Hero heading={String(content.heading ?? '')} />
+  ),
+  'custom.product-grid': ProductGrid,
+} satisfies BlockOverrideRegistrations;
+
+const { Page, generateMetadata } = createCatchAllPage({
+  getClient: getRiverbankClient,
+  config,
+  rendering: { kind: 'overrides-only' },
+  blockOverrides,
+});
+```
+
+In this mode the SDK does not resolve, parse, normalize, or build tokens from the response theme. Overrides receive the usual content, resolved data, routing, media, API/auth, IDs, and preview context, but no `theme` or `themeConfig`. A page fails with `MissingBlockOverrideError` when its content contains an unregistered kind; it never falls through to the known built-in renderer.
+
+The optional theme-independent wrapper belongs inside `rendering`: use `runtime: { kind: 'responsive-only' }` (the default) for Riverbank's generated responsive utility scope, or `runtime: { kind: 'none' }` when the host owns that too. Do not combine override-only rendering with top-level `themeRuntime`, `theme`, `themes`, or `getTheme`. If you use SDK `Layout` directly, its header and footer must both be custom or disabled. Preview receives the same rendering selection and registry.
+
+The content response still carries a compatibility theme field for now; override-only rendering deliberately ignores it. Wire-level theme nullability is tracked separately in #1290.
+
 Keep the `server-only` marker at the top of the registry so Next.js turns an accidental Client Component import into a build error. `generateMetadata()` never receives or runs host loaders—even with `customMetadata`—so a normal request does not repeat host queries for metadata and rendering.
 
 ```tsx
@@ -3772,6 +3804,7 @@ createCatchAllPage({
 | `getClient` | `() => RiverbankClient` | Yes | Factory function returning a configured client |
 | `config` | `RiverbankSiteConfig` | Yes | Site config from `defineConfig()` |
 | `blockOverrides` | `BlockOverrides` | No | Custom block component overrides |
+| `rendering` | `{ kind: 'overrides-only', runtime?: { kind: 'responsive-only' \| 'none' } }` | No | Opt into host-only rendering; requires `blockOverrides` and forbids theme options |
 | `siteUrl` | `string` | No | Override site URL for metadata (uses `config.liveUrl`/`previewUrl` as fallback) |
 | `beforeRender` | `function` | No | Intercept before rendering |
 | `customMetadata` | `function` | No | Custom metadata generation |

package/dist/{PreviewEditorSidebar-Dbvb7GIr.mjs → PreviewEditorSidebar-B43CJ0g_.mjs}

@@ -1,8 +1,8 @@
 "use client";
-import { $ as createOptimisticActionRunner, $i as Callout, A as isPreviewingChange, B as previewHeaderStyle, Br as getHeaderStyle, Ca as DropdownMenuLabel, Ci as updateButtonStyleSelectionChoice, D as createStyleConfiguratorState, Da as Button, Dr as getCuratedSiteStyle, E as cancelPreview, F as palettePreviewProjection, Ft as BlockEditor, G as syncStyleConfiguratorState, H as resetTypographyToSaved, Ht as useEditorUiStoreInstance, I as previewButtonStyle, Ji as Select, K as toggleRow, L as previewCuratedPalette, La as X$1, M as markApplySaved, Mi as paletteColorsSchema, N as markApplySaving, Na as assertNever$1, O as deriveStyleConfiguratorCapabilities, On as ThemeScope, P as openRow, Qa as LoaderCircle, Qi as SelectValue, R as previewFooterLook, Sa as DropdownMenuItem, Si as resolveButtonStyleSelection, T as applyTypographyDraftPatch, Ta as DropdownMenuTrigger, Ti as themeButtonClassName, Tr as curatedSiteStyles, U as setPaletteColors, Ua as Smartphone, V as previewSiteStyle, Va as Tablet, Vt as useEditorUiStore, W as styleConfiguratorHistoryEntryForPersistedSelection, Wa as SlidersHorizontal, Xa as Monitor, Xi as SelectItem, Yi as SelectContent, Za as Maximize2, Zi as SelectTrigger, _ as cycleableSiteChromeOptions, _a as CollapsibleContent, aa as Input, an as deriveRouteMetadataPresentation, ba as DropdownMenu, bi as buttonStyleSelectionParameterValue, c as selectionSnapshotFromApplySiteStyleSelectionResponse, ca as TabsList, d as resolveStyleConfiguratorInitialSnapshot, ea as CalloutDescription, et as resolvePreviewSidebarTab, fn as createManifestValidation, g as cycleSiteChromeLookId, ga as Collapsible, h as buildSiteChromeLookModels, hn as createStoreBackend, ia as PopoverTrigger, io as ChevronLeft, j as markApplyFailed, ja as unsafeAsEditorBlockId, ji as paletteColorEntries, k as dismissWarnings, ka as cn, kr as findFooterLook, l as deriveSiteStylePreviewUpdate, la as TabsTrigger, m as reportPreviewDesignError, n as useSiteChromeCustomizeOptional, na as Popover, oa as Tabs, on as resolvePageRouteSlug, oo as Check, ot as ContentFieldsForm, p as PREVIEW_DESIGN_SAVE_ERROR_MESSAGE, pn as FormRenderer, qr as curatedPalettes, ra as PopoverContent, rn as isAdapterReferenceKind, ro as ChevronRight, s as buildApplySiteStyleSelectionBody, sa as TabsContent, sn as resolveContentTitle, st as useUISelector, ta as SearchInput, tt as FooterComposerPanel, u as planSiteStylePreviewChange, un as ManifestForm, ut as useEntryController, v as planSiteChromeLookSelection, va as CollapsibleTrigger, w as applyResolvedSelections, wa as DropdownMenuSeparator, wi as buttonStyleSelectionKey, x as usePreviewDesignCoordinator, xa as DropdownMenuContent, xi as findButtonStyleRecipe, y as siteChromeLookUnavailableReasonLabel, ya as Surface, yn as listEntryPageContentSlots, z as previewHeaderLayout, zr as getHeaderLayout } from "./SiteChromeCustomizeContext-CvuGbHJX.mjs";
+import { $ as createOptimisticActionRunner, $i as Callout, A as isPreviewingChange, B as previewHeaderStyle, Br as getHeaderStyle, Ca as DropdownMenuLabel, Ci as updateButtonStyleSelectionChoice, D as createStyleConfiguratorState, Da as Button, Dr as getCuratedSiteStyle, E as cancelPreview, F as palettePreviewProjection, Ft as BlockEditor, G as syncStyleConfiguratorState, H as resetTypographyToSaved, Ht as useEditorUiStoreInstance, I as previewButtonStyle, Ji as Select, K as toggleRow, L as previewCuratedPalette, La as X$1, M as markApplySaved, Mi as paletteColorsSchema, N as markApplySaving, Na as assertNever$1, O as deriveStyleConfiguratorCapabilities, On as ThemeScope, P as openRow, Qa as LoaderCircle, Qi as SelectValue, R as previewFooterLook, Sa as DropdownMenuItem, Si as resolveButtonStyleSelection, T as applyTypographyDraftPatch, Ta as DropdownMenuTrigger, Ti as themeButtonClassName, Tr as curatedSiteStyles, U as setPaletteColors, Ua as Smartphone, V as previewSiteStyle, Va as Tablet, Vt as useEditorUiStore, W as styleConfiguratorHistoryEntryForPersistedSelection, Wa as SlidersHorizontal, Xa as Monitor, Xi as SelectItem, Yi as SelectContent, Za as Maximize2, Zi as SelectTrigger, _ as cycleableSiteChromeOptions, _a as CollapsibleContent, aa as Input, an as deriveRouteMetadataPresentation, ba as DropdownMenu, bi as buttonStyleSelectionParameterValue, c as selectionSnapshotFromApplySiteStyleSelectionResponse, ca as TabsList, d as resolveStyleConfiguratorInitialSnapshot, ea as CalloutDescription, et as resolvePreviewSidebarTab, fn as createManifestValidation, g as cycleSiteChromeLookId, ga as Collapsible, h as buildSiteChromeLookModels, hn as createStoreBackend, ia as PopoverTrigger, io as ChevronLeft, j as markApplyFailed, ja as unsafeAsEditorBlockId, ji as paletteColorEntries, k as dismissWarnings, ka as cn, kr as findFooterLook, l as deriveSiteStylePreviewUpdate, la as TabsTrigger, m as reportPreviewDesignError, n as useSiteChromeCustomizeOptional, na as Popover, oa as Tabs, on as resolvePageRouteSlug, oo as Check, ot as ContentFieldsForm, p as PREVIEW_DESIGN_SAVE_ERROR_MESSAGE, pn as FormRenderer, qr as curatedPalettes, ra as PopoverContent, rn as isAdapterReferenceKind, ro as ChevronRight, s as buildApplySiteStyleSelectionBody, sa as TabsContent, sn as resolveContentTitle, st as useUISelector, ta as SearchInput, tt as FooterComposerPanel, u as planSiteStylePreviewChange, un as ManifestForm, ut as useEntryController, v as planSiteChromeLookSelection, va as CollapsibleTrigger, w as applyResolvedSelections, wa as DropdownMenuSeparator, wi as buttonStyleSelectionKey, x as usePreviewDesignCoordinator, xa as DropdownMenuContent, xi as findButtonStyleRecipe, y as siteChromeLookUnavailableReasonLabel, ya as Surface, yn as listEntryPageContentSlots, z as previewHeaderLayout, zr as getHeaderLayout } from "./SiteChromeCustomizeContext-D9SlpwEj.mjs";
 import { d as unwrapResponse, f as getDashboardUrl, r as usePreviewAuth } from "./previewAuthStore-BesgU5Xu.mjs";
-import { t as Separator } from "./separator-CEoGABRc.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-BZHt6e9w.mjs";
+import { t as Separator } from "./separator-DkTe68HE.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-BJumZy1B.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";

package/dist/{PreviewEditorUI-e9O9l20X.mjs → PreviewEditorUI-DHirVkeM.mjs}

@@ -1,7 +1,7 @@
 "use client";
-import { Ba as TriangleAlert, Bt as classifyHistoryShortcut, Da as Button, Gi as Tooltip, Ha as Sparkles, Ht as useEditorUiStoreInstance, Ja as PenLine, Ka as Redo2, Ki as TooltipContent, Mt as useEditor, Oa as cva, Qa as LoaderCircle, Qt as useMultiAutosave, Sa as DropdownMenuItem, Ta as DropdownMenuTrigger, Vt as useEditorUiStore, Ya as Palette, a as previewDesignHistoryDomainForCommand, ao as ChevronDown, ba as DropdownMenu, da as DialogContent, dt as useEntryEditorController, fa as DialogDescription, ha as DialogTitle, i as usePreviewDesignHistoryOrder, ka as cn, ma as DialogHeader, n as useSiteChromeCustomizeOptional, no as EllipsisVertical, o as selectPreviewDesignHistoryDomain, qa as Pencil, qi as TooltipTrigger, to as Eye, ua as Dialog, xa as DropdownMenuContent, za as Undo2 } from "./SiteChromeCustomizeContext-CvuGbHJX.mjs";
+import { Ba as TriangleAlert, Bt as classifyHistoryShortcut, Da as Button, Gi as Tooltip, Ha as Sparkles, Ht as useEditorUiStoreInstance, Ja as PenLine, Ka as Redo2, Ki as TooltipContent, Mt as useEditor, Oa as cva, Qa as LoaderCircle, Qt as useMultiAutosave, Sa as DropdownMenuItem, Ta as DropdownMenuTrigger, Vt as useEditorUiStore, Ya as Palette, a as previewDesignHistoryDomainForCommand, ao as ChevronDown, ba as DropdownMenu, da as DialogContent, dt as useEntryEditorController, fa as DialogDescription, ha as DialogTitle, i as usePreviewDesignHistoryOrder, ka as cn, ma as DialogHeader, n as useSiteChromeCustomizeOptional, no as EllipsisVertical, o as selectPreviewDesignHistoryDomain, qa as Pencil, qi as TooltipTrigger, to as Eye, ua as Dialog, xa as DropdownMenuContent, za as Undo2 } from "./SiteChromeCustomizeContext-D9SlpwEj.mjs";
 import { d as unwrapResponse, r as usePreviewAuth } from "./previewAuthStore-BesgU5Xu.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-BZHt6e9w.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-BJumZy1B.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";