@riverbankcms/sdk 0.103.0 → 0.104.0

package/dist/_dts/editor-blocks/src/widgets/icon-picker/GeneratedIconLibraryContext.d.ts

@@ -0,0 +1,28 @@
+import { type ReactNode } from 'react';
+import type { GeneratedIconLibrarySet } from '../../../../api/src/index';
+export type GeneratedIconLibraryLoadState = Readonly<{
+    kind: 'loading';
+    sets: readonly GeneratedIconLibrarySet[];
+    nextCursor: string | null;
+}> | Readonly<{
+    kind: 'loading_more';
+    sets: readonly GeneratedIconLibrarySet[];
+    nextCursor: string;
+}> | Readonly<{
+    kind: 'ready';
+    sets: readonly GeneratedIconLibrarySet[];
+    nextCursor: string | null;
+}> | Readonly<{
+    kind: 'failed';
+    sets: readonly GeneratedIconLibrarySet[];
+    nextCursor: string | null;
+    message: string;
+}>;
+export type GeneratedIconLibraryState = GeneratedIconLibraryLoadState & Readonly<{
+    loadMore: (() => void) | null;
+}>;
+export declare function GeneratedIconLibraryProvider({ value, children, }: {
+    value: GeneratedIconLibraryState;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useGeneratedIconLibrary(): GeneratedIconLibraryState;

package/dist/_dts/editor-blocks/src/widgets/icon-picker/index.d.ts

@@ -1 +1,3 @@
 export * from './IconPickerField';
+export * from './GeneratedIconLibraryContext';
+export * from './loaders';

package/dist/_dts/editor-blocks/src/widgets/icon-picker/loaders.d.ts

@@ -0,0 +1,7 @@
+import type { ApiClient } from '../../../../api/src/request';
+import type { GeneratedIconSetListResponse } from '../../../../api/src/index';
+export declare function loadGeneratedIconLibraryPage(apiClient: ApiClient, input: Readonly<{
+    siteId: string;
+    cursor?: string;
+    limit?: number;
+}>): Promise<GeneratedIconSetListResponse>;

package/dist/_dts/preview-next/src/client/preview/CustomizeBackgroundControlRows.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+export type CustomizeBackgroundCycleDirection = 'prev' | 'next';
+export declare function CustomizeBackgroundControlRows({ modeLabel, valueLabel, valueAriaLabel, swatch, chooserOpen, chooser, canCycleMode, canCycleValue, onCycleMode, onCycleValue, onToggleChooser, }: Readonly<{
+    modeLabel: string;
+    valueLabel: string;
+    valueAriaLabel: string;
+    swatch: React.ReactNode;
+    chooserOpen: boolean;
+    chooser?: React.ReactNode;
+    canCycleMode: boolean;
+    canCycleValue: boolean;
+    onCycleMode: (direction: CustomizeBackgroundCycleDirection, event: React.MouseEvent) => void;
+    onCycleValue: (direction: CustomizeBackgroundCycleDirection, event: React.MouseEvent) => void;
+    onToggleChooser: (event: React.MouseEvent) => void;
+}>): React.JSX.Element;

package/dist/_dts/preview-next/src/client/preview/EntryEditorPanel.d.ts

@@ -10,6 +10,7 @@ import type { PreviewEditorSidebarProps, PreviewTemplateData } from './PreviewEd
 import { type PreviewLinkedEntrySidebarSection } from './PreviewSidebarSection';
 type EntryEditorPanelProps = {
     siteId: string;
+    dashboardBaseUrl?: string | null;
     entryData: NonNullable<PreviewEditorSidebarProps['entryData']>;
     contentTypeSchema?: ContentTypeSchema | null;
     referenceContentTypeKeys: readonly string[];
@@ -32,5 +33,5 @@ type EntryEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function EntryEditorPanel({ siteId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, metadataPanel, linkedEntrySection, mediaAssets, widgets, sdkConfig, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: EntryEditorPanelProps): React.JSX.Element;
+export declare function EntryEditorPanel({ siteId, dashboardBaseUrl, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, metadataPanel, linkedEntrySection, mediaAssets, widgets, sdkConfig, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: EntryEditorPanelProps): React.JSX.Element;
 export {};

package/dist/_dts/preview-next/src/client/preview/EntrySlotBlockEditorPanel.d.ts

@@ -5,6 +5,7 @@ import type { FieldWidgetComponent } from "../../../../block-form/src/client/ind
 import type { SdkConfigForBlockPicker } from "../../../../editor-blocks/src/index";
 type EntrySlotBlockEditorPanelProps = {
     siteId: string;
+    dashboardBaseUrl?: string | null;
     typeKey: string;
     entryId: string;
     theme?: Theme | null;
@@ -15,5 +16,5 @@ type EntrySlotBlockEditorPanelProps = {
     mediaAssets?: MediaAssetIndexItem[];
     widgets: Record<string, FieldWidgetComponent>;
 };
-export declare function EntrySlotBlockEditorPanel({ siteId, typeKey, entryId, theme, apiClient, bearerToken, supabaseUrl, sdkConfig, mediaAssets, widgets, }: EntrySlotBlockEditorPanelProps): React.JSX.Element | null;
+export declare function EntrySlotBlockEditorPanel({ siteId, dashboardBaseUrl, typeKey, entryId, theme, apiClient, bearerToken, supabaseUrl, sdkConfig, mediaAssets, widgets, }: EntrySlotBlockEditorPanelProps): React.JSX.Element | null;
 export {};

package/dist/_dts/preview-next/src/client/preview/PageBlockEditorPanel.d.ts

@@ -10,6 +10,7 @@ import { type PreviewLinkedEntrySidebarSection } from './PreviewSidebarSection';
 type PageBlockEditorPanelProps = {
     siteId: string;
     pageId: string;
+    dashboardBaseUrl?: string | null;
     theme?: Theme | null;
     apiClient: ApiClient;
     bearerToken?: string | null;
@@ -32,5 +33,5 @@ type PageBlockEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PageBlockEditorPanel({ siteId, pageId, theme, apiClient, bearerToken, supabaseUrl, blockItems, uiStoreForBlockEditor, blockEditorRef, onBlocksChange, metadataPanel, linkedEntrySection, designPanel, designOpenRequestId, sdkConfig, mediaAssets, bookingOfferingPresets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): React.JSX.Element;
+export declare function PageBlockEditorPanel({ siteId, pageId, dashboardBaseUrl, theme, apiClient, bearerToken, supabaseUrl, blockItems, uiStoreForBlockEditor, blockEditorRef, onBlocksChange, metadataPanel, linkedEntrySection, designPanel, designOpenRequestId, sdkConfig, mediaAssets, bookingOfferingPresets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): React.JSX.Element;
 export {};

package/dist/_dts/preview-next/src/client/preview/PreviewEditorSidebar.d.ts

@@ -6,7 +6,7 @@ import type { EntrySubrouteContextData, BookingOfferingPresetSummary, MediaAsset
 import { type ContentTypeSchema } from "../../../../content-model/src/index";
 import { type ZoomLevel } from "../../../../content-editor/src/index";
 import type { ButtonPersonalityId } from "../../../../theme-core/src/buttons/index";
-import type { PaletteOverrides, PaletteVariantId } from "../../../../theme-core/src/palette/index";
+import type { CuratedPaletteId, PaletteOverrides, RuntimePaletteState } from "../../../../theme-core/src/palette/index";
 import type { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId, TypographyPresetId } from "../../../../theme-core/src/site-styles/index";
 import type { PreviewDesignRow } from "./sidebarTabPreference";
 import type { ViewportMode, ViewportWidth } from "./PreviewViewportControls";
@@ -37,7 +37,8 @@ export type PreviewEditorSidebarProps = {
     themeSelectionUpdatedAt?: string | null;
     /** Persisted Style configurator selections (Phase C / E). */
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
-    themeSelectionPaletteVariantId?: PaletteVariantId | null;
+    runtimePaletteState?: RuntimePaletteState | null;
+    themeSelectionPaletteVariantId?: CuratedPaletteId | null;
     themeSelectionPaletteOverrides?: PaletteOverrides | null;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
@@ -71,4 +72,4 @@ export type PreviewEditorSidebarProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionTypographyPresetId, themeSelectionTypographyBodyFontOverride, themeSelectionTypographyHeadingFontOverride, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, designRowRequest, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;
+export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionTypographyPresetId, themeSelectionTypographyBodyFontOverride, themeSelectionTypographyHeadingFontOverride, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, designRowRequest, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;

package/dist/_dts/preview-next/src/client/preview/PreviewShell.d.ts

@@ -1,7 +1,7 @@
 import React, { type ComponentProps, type ReactNode } from 'react';
 import { BlockApiProvider } from '../../../../blocks/src/client';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
-import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
+import type { CuratedPaletteId, PaletteOverrides } from '../../../../theme-core/src/palette/index';
 import type { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import type { EntrySubrouteContextData, BookingOfferingPresetSummary, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
 import type { ContentTypeSchema } from '../../../../content-model/src/index';
@@ -43,7 +43,8 @@ export type PreviewShellProps = {
      * and sparse overrides instead of falling back to the site style defaults.
      */
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
-    themeSelectionPaletteVariantId?: PaletteVariantId | null;
+    runtimePaletteState?: import('../../../../theme-core/src/palette/index').RuntimePaletteState | null;
+    themeSelectionPaletteVariantId?: CuratedPaletteId | null;
     themeSelectionPaletteOverrides?: PaletteOverrides | null;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
@@ -76,7 +77,7 @@ export type PreviewShellProps = {
     designEditorEligibility?: PreviewDesignEditorEligibility;
     baseFetch?: BaseFetch;
 };
-export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionTypographyPresetId, themeSelectionTypographyBodyFontOverride, themeSelectionTypographyHeadingFontOverride, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, supabaseUrl, themeRuntime, designEditorEligibility, baseFetch, }: PreviewShellProps): React.JSX.Element;
+export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionTypographyPresetId, themeSelectionTypographyBodyFontOverride, themeSelectionTypographyHeadingFontOverride, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, supabaseUrl, themeRuntime, designEditorEligibility, baseFetch, }: PreviewShellProps): React.JSX.Element;
 export declare function defaultDesignEditorEligibility(input: Readonly<{
     pageId: string | null;
     entryData?: PreviewContentEntryData | null;

package/dist/_dts/preview-next/src/client/preview/PreviewShellLayout.d.ts

@@ -1,7 +1,7 @@
 import React, { type ReactNode } from "react";
 import { type EntrySubrouteContextData, type BookingOfferingPresetSummary, type MediaAssetIndexItem, type Theme } from "../../../../blocks/src/index";
 import type { ButtonPersonalityId } from "../../../../theme-core/src/buttons/index";
-import type { PaletteOverrides, PaletteVariantId } from "../../../../theme-core/src/palette/index";
+import type { CuratedPaletteId, PaletteOverrides } from "../../../../theme-core/src/palette/index";
 import type { FooterSelectionContext, HeaderSelectionContext, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId, TypographyPresetId } from "../../../../theme-core/src/site-styles/index";
 import type { ContentTypeSchema } from "../../../../content-model/src/index";
 import type { ApiClient } from "../../../../api/src/request";
@@ -29,7 +29,8 @@ export type PreviewShellLayoutProps = {
     themeSelectionVersion?: number | null;
     themeSelectionUpdatedAt?: string | null;
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
-    themeSelectionPaletteVariantId?: PaletteVariantId | null;
+    runtimePaletteState?: import('../../../../theme-core/src/palette/index').RuntimePaletteState | null;
+    themeSelectionPaletteVariantId?: CuratedPaletteId | null;
     themeSelectionPaletteOverrides?: PaletteOverrides | null;
     themeSelectionHeaderLayoutId?: HeaderLayoutId | null;
     themeSelectionHeaderStyleId?: HeaderStyleId | null;
@@ -51,4 +52,4 @@ export type PreviewShellLayoutProps = {
     themeRuntime?: PreviewThemeRuntime;
     siteStyleAccess?: SiteStyleAccess;
 };
-export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionTypographyPresetId, themeSelectionTypographyBodyFontOverride, themeSelectionTypographyHeadingFontOverride, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, }: PreviewShellLayoutProps): React.JSX.Element;
+export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, runtimePaletteState, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionTypographyPresetId, themeSelectionTypographyBodyFontOverride, themeSelectionTypographyHeadingFontOverride, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, }: PreviewShellLayoutProps): React.JSX.Element;

package/dist/_dts/preview-next/src/client/preview/SiteChromeCustomizeContext.d.ts

@@ -2,7 +2,7 @@ import React, { type ReactNode } from 'react';
 import { type ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
-import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
+import type { RuntimePaletteState } from '../../../../theme-core/src/palette/index';
 import type { BrandDisplayMode, FooterLayoutId, FooterLookId, HeaderNavFontSizePreference, HeaderNavTypographyPreference, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import { headerNavFontSizeOptions, headerNavTypographyOptions } from '../../../../theme-core/src/site-styles/index';
 import { type StyleConfiguratorHistoryEntry } from './StyleConfigurator.state';
@@ -118,8 +118,7 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
         selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
         buttonPersonalityId: ButtonPersonalityId | null;
-        paletteVariantId: PaletteVariantId | null;
-        paletteOverrides: PaletteOverrides | null;
+        runtimePaletteState?: RuntimePaletteState | null;
         headerLayoutId?: HeaderLayoutId | null;
         headerStyleId?: HeaderStyleId | null;
         typographyPresetId?: TypographyPresetId | null;
@@ -127,7 +126,7 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
         typographyHeadingFontOverride?: string | null;
         headerLookId?: HeaderLookId | null;
         footerLookId?: FooterLookId | null;
-    }>;
+    }> & Readonly<Record<string, unknown>>;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
     footerSelectionContext?: Partial<FooterSelectionContext>;
     siteStyleAccess?: SiteStyleAccess;

package/dist/_dts/preview-next/src/client/preview/StyleConfigurator.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 import type { ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
 import { type ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
-import { type PaletteVariantId, type PaletteOverrides } from '../../../../theme-core/src/palette/index';
+import { type CuratedPaletteId, type PaletteOverrides, type RuntimePaletteState } from '../../../../theme-core/src/palette/index';
 import { type FooterSelectionContext, type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId, type TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import { type VisibleSiteStyleAccess } from './siteStyleAccess';
 import type { PreviewDesignRow } from './sidebarTabPreference';
@@ -19,8 +19,9 @@ export type StyleConfiguratorProps = Readonly<{
         selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
         buttonPersonalityId: ButtonPersonalityId | null;
-        paletteVariantId: PaletteVariantId | null;
-        paletteOverrides: PaletteOverrides | null;
+        runtimePaletteState?: RuntimePaletteState | null;
+        paletteVariantId?: CuratedPaletteId | null;
+        paletteOverrides?: PaletteOverrides | null;
         headerLayoutId?: HeaderLayoutId | null;
         headerStyleId?: HeaderStyleId | null;
         typographyPresetId?: TypographyPresetId | null;
@@ -28,7 +29,7 @@ export type StyleConfiguratorProps = Readonly<{
         typographyHeadingFontOverride?: string | null;
         headerLookId?: HeaderLookId | null;
         footerLookId?: FooterLookId | null;
-    }>;
+    }> & Readonly<Record<string, unknown>>;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
     footerSelectionContext?: Partial<FooterSelectionContext>;
     expandedRowRequest?: Readonly<{

package/dist/_dts/preview-next/src/client/preview/StyleConfigurator.state.d.ts

@@ -5,14 +5,14 @@
  * switch.
  *
  * The configurator surfaces three site-level decisions (site style, button
- * personality, palette variant) plus optional sparse palette overrides. The
+ * personality, palette state). The
  * "base" snapshot is what the server has persisted; "previewed" is what the
  * preview pane is currently rendering. They diverge while the user is
  * picking and converge on apply-success.
  */
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
 import type { Theme } from '../../../../blocks/src/index';
-import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
+import type { CuratedPaletteId, PaletteColors, PaletteMode, RuntimePaletteState, SitePaletteId, SitePaletteVersion } from '../../../../theme-core/src/palette/index';
 import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderStyleId, type TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionFallbackWarning, SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
 import { type EditorStagedSessionCapabilities, type EditorStagedSessionState } from '../../../../content-editor/src/editorTransactionState';
@@ -33,11 +33,7 @@ export type StyleConfiguratorExpandedRow = 'style' | 'header-layout' | 'header-s
  * `compileSiteThemeFromSelections`) so the layers stay clean: warnings are
  * compiler-emitted, notices are UI-level decisions the configurator makes.
  */
-export type StyleConfiguratorNotice = Readonly<{
-    kind: 'palette-overrides-hidden';
-}> | Readonly<{
-    kind: 'palette-overrides-restored';
-}>;
+export type StyleConfiguratorNotice = never;
 type ThemeTypography = Theme['typography'];
 type BodyTypography = ThemeTypography['body'];
 type HeadingTypography = ThemeTypography['headings']['default'];
@@ -65,6 +61,25 @@ export type TypographyDraftPatch = Readonly<{
     kind: 'scale';
     scale: ThemeTypography['scale'];
 }>;
+export type PaletteSelectionSnapshot = Readonly<{
+    kind: 'migrated-curated';
+    paletteId: CuratedPaletteId;
+    colors: PaletteColors;
+    mode: PaletteMode;
+}> | Readonly<{
+    kind: 'migrated-site';
+    paletteId: SitePaletteId;
+    colors: PaletteColors;
+    mode: PaletteMode;
+    version: SitePaletteVersion;
+}> | Readonly<{
+    kind: 'legacy-unmigrated';
+    colors: PaletteColors;
+    mode: PaletteMode;
+}> | Readonly<{
+    kind: 'invalid';
+    reason: string;
+}>;
 export type SelectionSnapshot = Readonly<{
     siteStyleId: SiteStyleId;
     selectionVersion: number;
@@ -74,11 +89,9 @@ export type SelectionSnapshot = Readonly<{
     headerLookId: HeaderLookId | null;
     footerLookId: FooterLookId | null;
     buttonPersonalityId: ButtonPersonalityId;
-    paletteVariantId: PaletteVariantId;
-    paletteOverrides: PaletteOverrides | null;
+    palette: PaletteSelectionSnapshot;
     typographySelection: TypographySelectionSnapshot;
 }>;
-type PaletteOverrideDrafts = Readonly<Partial<Record<PaletteVariantId, PaletteOverrides>>>;
 type StyleConfiguratorTargetKey = 'design:site-style';
 export type StyleConfiguratorHistoryEntry = Readonly<{
     kind: 'site-style-design';
@@ -101,11 +114,22 @@ export type StyleConfiguratorState = Readonly<{
     saveStatus: StyleConfiguratorSaveStatus;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
     notices: ReadonlyArray<StyleConfiguratorNotice>;
-    paletteOverrideDrafts: PaletteOverrideDrafts;
+    paletteDrafts: Readonly<Partial<Record<CuratedPaletteId, Readonly<{
+        colors: PaletteColors;
+        mode: PaletteMode;
+    }>>>>;
     expandedRow: StyleConfiguratorExpandedRow;
     stagedSession: StyleConfiguratorStagedSession;
 }>;
+export type PaletteMutationCapability = Readonly<{
+    kind: 'editable';
+}> | Readonly<{
+    kind: 'blocked';
+    reason: 'invalid-palette';
+    message: string;
+}>;
 export declare function createStyleConfiguratorState(base: SelectionSnapshot): StyleConfiguratorState;
+export declare function paletteMutationCapability(state: StyleConfiguratorState): PaletteMutationCapability;
 export declare function openRow(state: StyleConfiguratorState, row: Exclude<StyleConfiguratorExpandedRow, null>): StyleConfiguratorState;
 /**
  * True iff the user has previewed a change that hasn't been applied yet.
@@ -124,8 +148,12 @@ export declare function previewTypographyPreset(state: StyleConfiguratorState, t
 export declare function setCustomTypography(state: StyleConfiguratorState, typography: ThemeTypography): StyleConfiguratorState;
 export declare function applyTypographyDraftPatch(state: StyleConfiguratorState, currentTypography: ThemeTypography, patch: TypographyDraftPatch): StyleConfiguratorState;
 export declare function resetTypographyToSaved(state: StyleConfiguratorState): StyleConfiguratorState;
-export declare function previewPaletteVariant(state: StyleConfiguratorState, paletteVariantId: PaletteVariantId): StyleConfiguratorState;
-export declare function setPaletteOverrides(state: StyleConfiguratorState, paletteOverrides: PaletteOverrides | null): StyleConfiguratorState;
+export declare function previewCuratedPalette(state: StyleConfiguratorState, palette: Readonly<{
+    paletteId: CuratedPaletteId;
+    colors: PaletteColors;
+    mode: PaletteMode;
+}>): StyleConfiguratorState;
+export declare function setPaletteColors(state: StyleConfiguratorState, colors: PaletteColors): StyleConfiguratorState;
 /**
  * Records the post-compile resolved selection + any fallback warnings.
  * Used after `compileSiteThemeFromSelections` runs against a new site style:
@@ -133,12 +161,9 @@ export declare function setPaletteOverrides(state: StyleConfiguratorState, palet
  * previous selection is not offered for the new style, or a different palette
  * if the persisted palette ID is no longer known.
  *
- * Palette overrides are scoped by palette variant. If the resolver moves the
- * preview to a different palette, the current sparse overrides are stashed
- * under the previous palette ID and any draft for the new palette is restored.
  */
 export declare function applyResolvedSelections(state: StyleConfiguratorState, input: Readonly<{
-    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'paletteVariantId' | 'headerLayoutId' | 'headerStyleId' | 'headerLookId'> & TypographySelectionFlatFields;
+    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'headerLayoutId' | 'headerStyleId' | 'headerLookId'> & TypographySelectionFlatFields;
     typographySelection?: TypographySelectionSnapshot;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>): StyleConfiguratorState;
@@ -165,5 +190,6 @@ export declare function typographySelectionSnapshotFromFlat(input: Readonly<{
 export declare function typographySelectionFlatFields(selection: TypographySelectionSnapshot): TypographySelectionFlatFields;
 export declare function customTypographyForSelection(selection: TypographySelectionSnapshot): ThemeTypography | null;
 export declare function typographySelectionsEqual(a: TypographySelectionSnapshot, b: TypographySelectionSnapshot): boolean;
-export declare function paletteOverridesEqual(a: PaletteOverrides | null, b: PaletteOverrides | null): boolean;
+export declare function paletteSelectionSnapshotFromRuntime(runtime: RuntimePaletteState | null | undefined): PaletteSelectionSnapshot;
+export declare function paletteSelectionSnapshotsEqual(left: PaletteSelectionSnapshot, right: PaletteSelectionSnapshot): boolean;
 export {};

package/dist/_dts/preview-next/src/client/preview/siteStylePreviewPlanner.d.ts

@@ -1,14 +1,13 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
-import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
+import { type CuratedPaletteId } from '../../../../theme-core/src/palette/index';
 import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import { type CuratedSiteStyle, type CompiledTypographySelection, type SelectionFallbackWarning, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
-import type { TypographySelectionSnapshot } from './StyleConfigurator.state';
+import type { PaletteSelectionSnapshot, TypographySelectionSnapshot } from './StyleConfigurator.state';
 export type SiteStylePreviewSelection = Readonly<{
     siteStyleId: SiteStyleId;
     buttonPersonalityId: ButtonPersonalityId;
-    paletteVariantId: PaletteVariantId;
-    paletteOverrides: PaletteOverrides | null;
+    palette: PaletteSelectionSnapshot;
     typographySelection?: TypographySelectionSnapshot;
     headerLayoutId?: HeaderLayoutId | null;
     headerStyleId?: HeaderStyleId | null;
@@ -23,7 +22,7 @@ export type SiteStylePreviewPlan = Readonly<{
     themeOverlay: Theme;
     resolvedSelections: Readonly<{
         buttonPersonalityId: ButtonPersonalityId;
-        paletteVariantId: PaletteVariantId;
+        paletteVariantId: CuratedPaletteId;
         typographySelection: CompiledTypographySelection['resolvedSelection'];
         typographyPresetId: TypographyPresetId | null;
         typographyBodyFontOverride: string | null;

package/dist/_dts/preview-next/src/client/preview/styleConfiguratorApplyPayload.d.ts

@@ -1,9 +1,30 @@
 import type { APIEndpoints } from '../../../../api/src/index';
+import { type PaletteCommand } from '../../../../theme-core/src/palette/index';
 import { type SelectionSnapshot } from './StyleConfigurator.state';
 export type ApplySiteStyleSelectionBody = NonNullable<APIEndpoints['applySiteStyleSelection']['body']>;
+export type PaletteApplyCommandPlan = Readonly<{
+    ok: true;
+    command: PaletteCommand;
+}> | Readonly<{
+    ok: false;
+    error: 'invalid-palette-state' | 'curated-palette-missing';
+}>;
+export declare function planPaletteApplyCommand(input: Readonly<{
+    base: SelectionSnapshot;
+    previewed: SelectionSnapshot;
+}>): PaletteApplyCommandPlan;
+export type ApplySiteStyleSelectionBodyBuildResult = Readonly<{
+    ok: true;
+    body: ApplySiteStyleSelectionBody;
+}> | Readonly<{
+    ok: false;
+    error: Extract<PaletteApplyCommandPlan, {
+        ok: false;
+    }>['error'];
+}>;
 export declare function buildApplySiteStyleSelectionBody(input: Readonly<{
     base: SelectionSnapshot;
     previewed: SelectionSnapshot;
     selectionId?: string | null;
-}>): ApplySiteStyleSelectionBody;
+}>): ApplySiteStyleSelectionBodyBuildResult;
 export declare function selectionSnapshotFromApplySiteStyleSelectionResponse(saved: NonNullable<APIEndpoints['applySiteStyleSelection']['response']>, fallback: SelectionSnapshot): SelectionSnapshot;

package/dist/_dts/preview-next/src/client/preview/styleConfiguratorSnapshot.d.ts

@@ -1,16 +1,17 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
-import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
+import { type CuratedPaletteId, type PaletteOverrides, type RuntimePaletteState } from '../../../../theme-core/src/palette/index';
 import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
-export declare function resolveStyleConfiguratorInitialSnapshot(input: Readonly<{
+type StyleConfiguratorSnapshotInput = Readonly<{
     theme?: Theme | null;
     initialSelections: Readonly<{
         selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
         buttonPersonalityId: ButtonPersonalityId | null;
-        paletteVariantId: PaletteVariantId | null;
-        paletteOverrides: PaletteOverrides | null;
+        runtimePaletteState?: RuntimePaletteState | null;
+        paletteVariantId?: CuratedPaletteId | null;
+        paletteOverrides?: PaletteOverrides | null;
         headerLayoutId?: HeaderLayoutId | null;
         headerStyleId?: HeaderStyleId | null;
         typographyPresetId?: TypographyPresetId | null;
@@ -21,4 +22,11 @@ export declare function resolveStyleConfiguratorInitialSnapshot(input: Readonly<
     }>;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
     footerSelectionContext?: Partial<FooterSelectionContext>;
+}>;
+export declare function resolveStyleConfiguratorInitialSnapshot(input: Readonly<{
+    theme?: Theme | null;
+    initialSelections: StyleConfiguratorSnapshotInput['initialSelections'];
+    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    footerSelectionContext?: Partial<FooterSelectionContext>;
 }>): SelectionSnapshot | null;
+export {};

package/dist/_dts/sdk/src/client/management/types.d.ts

@@ -9,6 +9,7 @@ import type { SdkEventPricing, SdkEventPricingInput, SdkEventTicketTypeInput } f
 import type { SdkEventPaymentTerms, SdkEventPaymentTermsInput } from '../../../../api/src/sdk-event-payment-terms';
 import type { SdkEventUpsertBody } from '../../../../api/src/sdk-event-upsert';
 import type { SdkManagementEventSeries } from '../../../../api/src/sdkContracts';
+import type { PaletteSelection } from '../../../../theme-core/src/palette/index';
 import type { Theme } from '../../contracts';
 export interface ManagementClientConfig {
     /**
@@ -522,6 +523,8 @@ export interface ThemeStyleSelectionApplyResult {
     buttonPersonalityId: string;
     paletteVariantId: string;
     paletteOverrides: Record<string, string> | null;
+    activePaletteSelection: PaletteSelection;
+    activeSitePaletteVersion: number | null;
     headerLookId: string | null;
     headerLayoutId: string;
     headerStyleId: string;

package/dist/_dts/sdk/src/contracts/system-block-content.d.ts

@@ -65,7 +65,6 @@ export type BlockIconValue = {
     kind: 'generated';
     setId: Brand<string, 'GeneratedIconSetId'>;
     assetId: Brand<string, 'GeneratedIconAssetId'>;
-    semanticFallbackIconId: SemanticIconId;
     styleGuideVersionId: Brand<string, 'SiteIconStyleGuideVersionId'>;
 };
 export type FeatureCardIconTreatment = 'plain' | 'soft-badge' | 'utility-badge';

package/dist/_dts/sdk/src/public-api/contracts.d.ts

@@ -2,6 +2,7 @@ import type { AddressedLocationValue, BusinessAddress, BookingFlexibleBalanceCon
 import type { SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject } from '../../../api/src/index';
 import type { Media, MediaAssetIndexItem, SiteFooterContent, SiteHeaderContent, Theme } from '../contracts';
 import type { CompiledBoundaryRuntime } from '../../../theme-core/src/site-styles/index';
+import type { PaletteOverrides, RuntimePaletteState } from '../../../theme-core/src/palette/index';
 import type { BlockFieldConfig as SdkBlockFieldConfig, BlockFieldOptionsMap as SdkBlockFieldOptionsMap, ContentConfig as SdkContentConfig, ContainerOptionsConfig as SdkContainerOptionsConfig, FieldSelectOption as SdkFieldSelectOption, SdkCustomBlock, SdkThemeConfig, SdkThemePalette, SectionBackground as SdkSectionBackground, SectionOptionsConfig as SdkSectionOptionsConfig, SiteStyleConfig as SdkSiteStyleConfig } from '../config/types';
 export type PublicTeamMemberSummary = {
     id: string;
@@ -314,10 +315,12 @@ export type SiteResponse = {
      * Persisted design selections. Optional so legacy
      * payloads without these columns still satisfy the type — consumers fall
      * back to the site style's defaults when null.
-     */
+    */
     selectionButtonPersonalityId?: string | null;
+    runtimePaletteState?: RuntimePaletteState | null;
+    /** Temporary legacy compatibility projection for stale runtime clients. */
     selectionPaletteVariantId?: string | null;
-    selectionPaletteOverrides?: Record<string, string> | null;
+    selectionPaletteOverrides?: PaletteOverrides | null;
     selectionHeaderLayoutId?: string | null;
     selectionHeaderStyleId?: string | null;
     selectionTypographyPresetId?: string | null;

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.103.0";
+export declare const SDK_VERSION = "0.104.0";