@riverbankcms/sdk 0.136.0 → 0.137.0

package/CHANGELOG.md

@@ -7,6 +7,107 @@ and then gets the version it went out in.
 
 ## Unreleased
 
+### Theme contract changes (#1318)
+
+- **`saveSiteChromeSelection`'s header body no longer carries a `theme`.** The
+  surface used to send the whole compiled theme alongside `layoutId`, `styleId`
+  and `preferences` — the Phase 4b dual write — and the server compared the two
+  headers and logged a mismatch. The server has been the author of those bytes
+  since 4b, so the second copy was only ever a measurement: it is gone, and with
+  it the `theme:site_chrome_selection:header_compilation_mismatch` log. The
+  footer surface still sends a theme, because a footer save's change *is* a
+  theme. The save response is unchanged and still returns the persisted theme,
+  which is what a client reconciles to.
+
+- **`sdkUpsertTheme`'s update body takes a theme with no `header`.** `POST
+  /sdk/{siteId}/theme` used to accept and persist whatever `theme.header` an SDK
+  consumer sent, which was the last route through which raw header bytes reached
+  persistence. `theme` is now `SdkThemeWireWithoutHeader` (exported from
+  `@riverbankcms/api`), and the header is compiled server-side from the site's
+  stored selection and `header_preferences` against the site style the body
+  authors. A body carrying a `header` is rejected rather than silently stripped.
+  A site whose current theme row cannot be read is refused rather than
+  re-provisioned.
+
+- **`saveSiteTheme`'s body takes a theme with no `header`.** `theme` is now
+  `Omit<Theme, 'header'>` (`ThemeWithoutHeader`, exported from
+  `@riverbankcms/api`), derived at the route from `themeSchema.omit({ header:
+  true })`. The header is compiled server-side from the row's stored selection
+  and `header_preferences`; `headerSelection` still names the selection to
+  compile for. This was the last path by which hand-written header bytes could
+  reach persistence. A save against a site with no current theme selection is
+  now refused with `THEME_SELECTION_NOT_FOUND` rather than falling back to a
+  site-style default, and the header selection it stores is the one the shared
+  pipeline resolves — which applies the site style's **curated** repair, not
+  only the catalogue's. A body naming a (layout, style) pair the site style does
+  not offer now stores the repaired pair, so the persisted ids and the persisted
+  bytes always name the same selection.
+
+- **`HeaderPreferences` gains a required `brandPresentation` field**
+  (`'recommended' | 'plain'`), and `headerPreferencesSchema` requires it. It
+  says whether the header wears a brand presentation block at all. `'plain'` is
+  the state several live rows persist — no `logo` object — which the record
+  could not express before, so a recompile would have given those sites a logo
+  treatment they have never rendered. This is a **widening**: `'recommended'` is
+  the default and reproduces the previous behaviour exactly, and the header
+  parity lockfile is unchanged. Consumers that construct a `HeaderPreferences`
+  literal must add the field; consumers that only read one are unaffected.
+
+- **`readHeaderPreferences` is no longer exported.** It gained a fourth
+  argument — the two headers the brand-presentation modes compile to, because
+  the mode is derived by comparing the persisted `logo` against both — and the
+  type of that argument was never on the package surface, so the export was a
+  function no consumer could call. Deriving a record from persisted bytes goes
+  through `recompileSiteChromeHeaderFromPersistedIntent`, which builds the
+  candidates itself and has always been the supported way to do it.
+
+- **`headerPreferencesWireSchema` is exported alongside `headerPreferencesSchema`.** It is the
+  same record with `brandPresentation` defaulting to `'recommended'`, for bodies arriving from a
+  client build that predates the field. The field is not client-authored — the server reads the
+  mode off the row — so defaulting it on the wire loses nothing, and the persisted schema keeps
+  requiring it so a stored record can never be incomplete.
+
+- **`headerLogoShapeContext` is exported from
+  `@riverbankcms/theme-core/site-styles`.** It is the one definition of "the
+  site's logo as the header pipeline sees it", from an asset (or its absence)
+  and the accommodation the row persists. The dashboard's server lookup and the
+  #1318 Phase 4c migration generator both go through it.
+
+- **`APIEndpoints` no longer carries `createTheme`, and `POST /ai/chat/create-theme`
+  no longer exists.** The endpoint generated theme proposals from a site id and
+  had no caller anywhere — not in the dashboard, not in the SDK's own
+  `PublicAPIEndpoints`, not in the e2e or integration suites. Site creation goes
+  through `generateThemes` (`POST /theme/generate`), which is what the wizard has
+  always called. The `ThemeGenerationTurn` type it was the sole user of is
+  removed with it.
+
+- **`APIEndpoints` no longer carries `generateThemes`, and `POST /theme/generate`
+  no longer exists.** It generated three AI theme proposals for a site, and its
+  only caller was the site-creation wizard's theme step, which no navigation
+  ever reached — the page was reachable only by typing its URL. The step and the
+  whole generator chain behind it are gone. Like `createTheme`, this endpoint is
+  not in `PublicAPIEndpoints`, so the SDK's hand-written public surface is
+  unchanged; what narrows is the bundled `@riverbankcms/api` declarations.
+  `ThemeRow` stays exported from the package — it was only ever this endpoint's
+  response element there, but it is a general row type.
+
+- **`header.maxWidth` is now optional on the way in.** It gained a schema
+  default of `'container'`, so `SdkThemeWire` (`z.input<typeof themeSchema>`)
+  accepts a theme body that omits it, where before the field was required and a
+  body without it failed to parse. This is a widening — every theme that parsed
+  before still parses, and the parsed value is unchanged, since the field only
+  ever holds `'container'` in practice. Nothing authors it any more: the field
+  is layout-owned, and full-bleed headers will come back as a layout facet
+  rather than a free-form value if they are ever wanted.
+
+- **`header.interactionPalette` accepts a fourth value, `'quiet'`.** The header
+  hover-colour vocabulary was `primary | secondary | accent`, all of which fill
+  the nav link with a colour on hover and focus. `'quiet'` means "no fill" — the
+  header style's own hover treatment stands and the palette step writes nothing.
+  This is a widening of the persisted theme enum, so every theme that parsed
+  before still parses and no existing value changes meaning; a consumer that
+  exhaustively switches on the palette needs a branch for it.
+
 ### Breaking: manifest content uses explicit trust stages (#1245)
 
 - SDK rendering now exposes `RenderablePageOutline` values whose blocks carry a

package/dist/{PreviewEditorSidebar-BU5ZlhQR.mjs → PreviewEditorSidebar-Bn6cONPa.mjs}

@@ -1,8 +1,8 @@
 "use client";
-import { $ as FooterComposerPanel, $a as Monitor, $i as SelectItem, A as markApplySaved, Aa as Button, Ar as getHeaderStyle, B as resetTypographyToSaved, Ba as X$1, Bt as useEditorUiStoreInstance, C as applyTypographyDraftPatch, Ca as DropdownMenu, Ci as updateButtonStyleHoverPreference, D as dismissWarnings, Da as DropdownMenuSeparator, E as deriveStyleConfiguratorCapabilities, Ea as DropdownMenuLabel, Ei as themeButtonClassName, En as ThemeScope, Er as getCuratedSiteStyle, F as previewCuratedPalette, Fi as paletteColorsSchema, H as styleConfiguratorHistoryEntryForPersistedSelection, I as previewFooterLook, Ia as assertNever$1, Ir as curatedPalettes, Ka as Smartphone, L as previewHeaderLayout, M as openRow, Ma as cn, Mi as VARIANT_ROLES, N as palettePreviewProjection, Nt as BlockEditor, O as isPreviewingChange, Oa as DropdownMenuTrigger, Or as findFooterLook, P as previewButtonStyle, Pa as unsafeAsEditorBlockId, Pi as paletteColorEntries, Q as resolvePreviewSidebarTab, Qi as SelectContent, R as previewHeaderStyle, S as applyResolvedSelections, Sa as Surface, Si as resolveButtonStyleSelection, T as createStyleConfiguratorState, Ta as DropdownMenuItem, Ti as buttonStyleSelectionKey, U as syncStyleConfiguratorState, V as setPaletteColors, W as toggleRow, Wa as Tablet, Z as createOptimisticActionRunner, Zi as Select, _ as PREVIEW_DESIGN_SAVE_ERROR_MESSAGE, _n as listEntryPageContentSlots, aa as Popover, an as resolveContentTitle, at as useUISelector, b as cycleSiteChromeSelectionId, ba as CollapsibleContent, bi as buttonStyleSelectionParameterValue, c as selectionSnapshotFromApplySiteStyleSelectionResponse, ca as Input, cn as ManifestForm, co as ChevronDown, ct as useEntryController, d as resolveStyleConfiguratorInitialSnapshot, da as TabsList, dn as FormRenderer, ea as SelectTrigger, eo as Maximize2, fa as TabsTrigger, ia as SearchInput, in as resolvePageRouteSlug, it as ContentFieldsForm, j as markApplySaving, k as markApplyFailed, kr as getHeaderLayout, l as deriveSiteStylePreviewUpdate, la as Tabs, lo as Check, n as useSiteChromeCustomizeOptional, na as Callout, oa as PopoverContent, oo as ChevronRight, p as usePreviewDesignCoordinator, pn as createStoreBackend, qa as SlidersHorizontal, ra as CalloutDescription, rn as deriveRouteMetadataPresentation, s as buildApplySiteStyleSelectionBody, sa as PopoverTrigger, so as ChevronLeft, ta as SelectValue, tn as isAdapterReferenceKind, to as LoaderCircle, u as planSiteStylePreviewChange, ua as TabsContent, un as createManifestValidation, v as reportPreviewDesignError, w as cancelPreview, wa as DropdownMenuContent, wi as updateButtonStyleSelectionChoice, wr as curatedSiteStyles, x as planSiteChromeSelection, xa as CollapsibleTrigger, xi as findButtonStyleRecipe, y as buildSiteChromeSelectionModels, ya as Collapsible, yi as buttonStyleHoverPreferenceValue, z as previewSiteStyle, zt as useEditorUiStore } from "./SiteChromeCustomizeContext-B6d5zkog.mjs";
-import { d as unwrapResponse, f as getDashboardUrl, r as usePreviewAuth } from "./previewAuthStore-DbqBol0V.mjs";
-import { t as Separator } from "./separator-DaPLtJ1f.mjs";
-import { S as getSiteFontsStorageUrl, _ as usePreviewBlockCustomizeSelectionOptional, b as buildFontPreviewUrl, d as buildPreviewDashboardSetupUrl, f as resolvePreviewDashboardSetupHandoff, g as useBlockCustomizeControls, h as usePreviewSiteFontStorageUrl, m as resolvePreviewSidebarChromeModel, p as resolvePreviewEditorGuidanceModel, u as canInspectSiteStyle, v as PreviewFormProvider, x as generateFontFaceCss, y as previewWidgetOverrides } from "./SdkPreviewModeRuntime-CnWmj-2B.mjs";
+import { $ as FooterComposerPanel, $a as Monitor, $i as SelectItem, A as markApplySaving, Aa as Button, Ar as getHeaderStyle, B as setPaletteColors, Ba as X$1, Bt as useEditorUiStoreInstance, C as cancelPreview, Ca as DropdownMenu, Ci as updateButtonStyleHoverPreference, D as isPreviewingChange, Da as DropdownMenuSeparator, E as dismissWarnings, Ea as DropdownMenuLabel, Ei as themeButtonClassName, En as ThemeScope, Er as getCuratedSiteStyle, F as previewFooterLook, Fi as paletteColorsSchema, H as syncStyleConfiguratorState, I as previewHeaderLayout, Ia as assertNever$1, Ir as curatedPalettes, Ka as Smartphone, L as previewHeaderStyle, M as palettePreviewProjection, Ma as cn, Mi as VARIANT_ROLES, N as previewButtonStyle, Nt as BlockEditor, O as markApplyFailed, Oa as DropdownMenuTrigger, Or as findFooterLook, P as previewCuratedPalette, Pa as unsafeAsEditorBlockId, Pi as paletteColorEntries, Q as resolvePreviewSidebarTab, Qi as SelectContent, R as previewSiteStyle, S as applyTypographyDraftPatch, Sa as Surface, Si as resolveButtonStyleSelection, T as deriveStyleConfiguratorCapabilities, Ta as DropdownMenuItem, Ti as buttonStyleSelectionKey, U as toggleRow, V as styleConfiguratorHistoryEntryForPersistedSelection, Wa as Tablet, X as resolveStyleConfiguratorInitialSnapshot, Z as createOptimisticActionRunner, Zi as Select, _ as reportPreviewDesignError, _n as listEntryPageContentSlots, aa as Popover, an as resolveContentTitle, at as useUISelector, b as planSiteChromeSelection, ba as CollapsibleContent, bi as buttonStyleSelectionParameterValue, c as selectionSnapshotFromApplySiteStyleSelectionResponse, ca as Input, cn as ManifestForm, co as ChevronDown, ct as useEntryController, da as TabsList, dn as FormRenderer, ea as SelectTrigger, eo as Maximize2, f as usePreviewDesignCoordinator, fa as TabsTrigger, g as PREVIEW_DESIGN_SAVE_ERROR_MESSAGE, ia as SearchInput, in as resolvePageRouteSlug, it as ContentFieldsForm, j as openRow, k as markApplySaved, kr as getHeaderLayout, l as deriveSiteStylePreviewUpdate, la as Tabs, lo as Check, n as useSiteChromeCustomizeOptional, na as Callout, oa as PopoverContent, oo as ChevronRight, pn as createStoreBackend, qa as SlidersHorizontal, ra as CalloutDescription, rn as deriveRouteMetadataPresentation, s as buildApplySiteStyleSelectionBody, sa as PopoverTrigger, so as ChevronLeft, ta as SelectValue, tn as isAdapterReferenceKind, to as LoaderCircle, u as planConfiguratorPreview, ua as TabsContent, un as createManifestValidation, v as buildSiteChromeSelectionModels, w as createStyleConfiguratorState, wa as DropdownMenuContent, wi as updateButtonStyleSelectionChoice, wr as curatedSiteStyles, x as applyResolvedSelections, xa as CollapsibleTrigger, xi as findButtonStyleRecipe, y as cycleSiteChromeSelectionId, ya as Collapsible, yi as buttonStyleHoverPreferenceValue, z as resetTypographyToSaved, zt as useEditorUiStore } from "./SiteChromeCustomizeContext-BbkNSt5a.mjs";
+import { d as unwrapResponse, f as getDashboardUrl, r as usePreviewAuth } from "./previewAuthStore-L_cKW8Sb.mjs";
+import { t as Separator } from "./separator-BIHkie5i.mjs";
+import { S as getSiteFontsStorageUrl, _ as usePreviewBlockCustomizeSelectionOptional, b as buildFontPreviewUrl, d as buildPreviewDashboardSetupUrl, f as resolvePreviewDashboardSetupHandoff, g as useBlockCustomizeControls, h as usePreviewSiteFontStorageUrl, m as resolvePreviewSidebarChromeModel, p as resolvePreviewEditorGuidanceModel, u as canInspectSiteStyle, v as PreviewFormProvider, x as generateFontFaceCss, y as previewWidgetOverrides } from "./SdkPreviewModeRuntime-BbbGsI_v.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";
@@ -3670,7 +3670,7 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 			clearPreview("style-configurator");
 			return;
 		}
-		previewTheme("style-configurator", planSiteStylePreviewChange({
+		previewTheme("style-configurator", planConfiguratorPreview({
 			siteStyle,
 			selection: state.previewed,
 			headerLogoContext,
@@ -3706,7 +3706,7 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 			const next = previewSiteStyle(current, siteStyleId);
 			const siteStyle = getCuratedSiteStyle(siteStyleId);
 			if (!siteStyle) return next;
-			const result = planSiteStylePreviewChange({
+			const result = planConfiguratorPreview({
 				siteStyle,
 				selection: next.previewed,
 				headerLogoContext,
@@ -3754,7 +3754,7 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 			if (!current) return current;
 			const siteStyle = getCuratedSiteStyle(current.previewed.siteStyleId);
 			if (!siteStyle) return current;
-			return applyTypographyDraftPatch(current, planSiteStylePreviewChange({
+			return applyTypographyDraftPatch(current, planConfiguratorPreview({
 				siteStyle,
 				selection: current.previewed,
 				headerLogoContext,
@@ -3876,7 +3876,7 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 	});
 	const currentPalette = palettePreviewProjection(state.previewed.palette);
 	const paletteControlsDisabled = saving || !stagedCapabilities.canPreviewStaged;
-	const currentPreviewPlan = planSiteStylePreviewChange({
+	const currentPreviewPlan = planConfiguratorPreview({
 		siteStyle: currentSiteStyle,
 		selection: state.previewed,
 		headerLogoContext,

package/dist/{PreviewEditorUI-9XkHL-bC.mjs → PreviewEditorUI-LAwXZPSx.mjs}

@@ -1,7 +1,7 @@
 "use client";
-import { Aa as Button, At as useEditor, Bt as useEditorUiStoreInstance, Ca as DropdownMenu, Ga as Sparkles, Ha as Undo2, Ji as Tooltip, Ma as cn, Oa as DropdownMenuTrigger, Qa as Palette, Rt as classifyHistoryShortcut, Ta as DropdownMenuItem, Ua as TriangleAlert, Xa as Pencil, Xi as TooltipTrigger, Xt as useMultiAutosave, Ya as Redo2, Yi as TooltipContent, Za as PenLine, _a as DialogHeader, a as previewDesignHistoryDomainForCommand, ao as EllipsisVertical, co as ChevronDown, ha as DialogDescription, i as usePreviewDesignHistoryOrder, io as Eye, ja as cva, lt as useEntryEditorController, ma as DialogContent, n as useSiteChromeCustomizeOptional, o as selectPreviewDesignHistoryDomain, pa as Dialog, to as LoaderCircle, va as DialogTitle, wa as DropdownMenuContent, zt as useEditorUiStore } from "./SiteChromeCustomizeContext-B6d5zkog.mjs";
-import { d as unwrapResponse, r as usePreviewAuth } from "./previewAuthStore-DbqBol0V.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-CnWmj-2B.mjs";
+import { Aa as Button, At as useEditor, Bt as useEditorUiStoreInstance, Ca as DropdownMenu, Ga as Sparkles, Ha as Undo2, Ji as Tooltip, Ma as cn, Oa as DropdownMenuTrigger, Qa as Palette, Rt as classifyHistoryShortcut, Ta as DropdownMenuItem, Ua as TriangleAlert, Xa as Pencil, Xi as TooltipTrigger, Xt as useMultiAutosave, Ya as Redo2, Yi as TooltipContent, Za as PenLine, _a as DialogHeader, a as previewDesignHistoryDomainForCommand, ao as EllipsisVertical, co as ChevronDown, ha as DialogDescription, i as usePreviewDesignHistoryOrder, io as Eye, ja as cva, lt as useEntryEditorController, ma as DialogContent, n as useSiteChromeCustomizeOptional, o as selectPreviewDesignHistoryDomain, pa as Dialog, to as LoaderCircle, va as DialogTitle, wa as DropdownMenuContent, zt as useEditorUiStore } from "./SiteChromeCustomizeContext-BbkNSt5a.mjs";
+import { d as unwrapResponse, r as usePreviewAuth } from "./previewAuthStore-L_cKW8Sb.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-BbbGsI_v.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-wbEpXryy.mjs → PreviewQueryProvider-ztQUdsNo.mjs}

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