@riverbankcms/sdk 0.102.0 → 0.104.0

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,8 +2,9 @@ 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 { BrandDisplayMode, FooterLayoutId, FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride, TypographyPresetId } from '../../../../theme-core/src/site-styles/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';
 import type { SiteStyleAccess } from './siteStyleAccess';
 import { type SiteChromeLookOption } from './siteChromeLookRows';
@@ -51,7 +52,7 @@ export type SiteChromeBackgroundControlState = Readonly<{
     quickTokens: readonly SiteChromeBackgroundColorToken[];
     advancedTokens: readonly SiteChromeBackgroundColorToken[];
 }>;
-type SiteChromeCustomizeSurfaceState = Readonly<{
+export type SiteChromeCustomizeSurfaceState = Readonly<{
     kind: 'unavailable';
 }> | Readonly<{
     kind: 'available';
@@ -65,8 +66,13 @@ type SiteChromeCustomizeSurfaceState = Readonly<{
     options: readonly SiteChromeLookOption<HeaderStyleId>[];
     brandDisplay: BrandDisplayMode;
     brandDisplayOptions: readonly HeaderBrandDisplayOption[];
+    brandSizeLabel: string;
     logoSize: LogoSizePolicy;
     logoSizeOptions: readonly HeaderLogoSizeOption[];
+    menuFont: HeaderNavTypographyPreference;
+    menuFontOptions: typeof headerNavTypographyOptions;
+    menuFontSize: HeaderNavFontSizePreference;
+    menuFontSizeOptions: typeof headerNavFontSizeOptions;
     diagnostics: readonly string[];
     background: SiteChromeBackgroundControlState;
     failure: string | null;
@@ -92,6 +98,8 @@ type SiteChromeCustomizeContextValue = Readonly<{
     cycleSurfaceLayout: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
     setHeaderBrandDisplay: (value: BrandDisplayMode) => void;
     setHeaderLogoSize: (value: LogoSizePolicy) => void;
+    setHeaderMenuFont: (value: HeaderNavTypographyPreference) => void;
+    setHeaderMenuFontSize: (value: HeaderNavFontSizePreference) => void;
     cycleSurfaceBackground: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
     chooseSurfaceBackground: (surface: SiteChromeEditableSurfaceKind, override: SiteChromeBackgroundOverride) => void;
     siteStyleHistory: SiteStyleHistoryController;
@@ -110,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;
@@ -119,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/sidebarTabPreference.d.ts

@@ -1,6 +1,6 @@
 import type { PreviewSidebarTab } from '../../../../content-editor/src/index';
 export type { PreviewSidebarTab };
-export type PreviewDesignRow = 'header' | 'footer';
+export type PreviewDesignRow = 'header' | 'footer' | 'header-layout' | 'header-style' | 'footer-layout';
 export type PreviewSidebarOpenRequest = Readonly<{
     tab: PreviewSidebarTab;
     designRow?: PreviewDesignRow;

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

@@ -1,5 +1,5 @@
 import { type HistoryState } from '../../../../content-editor/src/index';
-import { type BrandDisplayMode, type FooterLookId, type LogoSizePolicy, type SiteChromeBackgroundOverride, type SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
+import { type BrandDisplayMode, type FooterLookId, type HeaderNavFontSizePreference, type HeaderNavPreferences, type HeaderNavTypographyPreference, type LogoSizePolicy, type SiteChromeBackgroundOverride, type SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import type { HeaderBrandPreferences } from './siteChromeBrandPreferences';
 type HeaderLayoutSelection = Pick<SelectionSnapshot, 'headerLayoutId' | 'headerStyleId' | 'headerLookId'>;
@@ -36,16 +36,26 @@ export type SiteChromeQuickControlHistoryEntry = Readonly<{
     kind: 'header-logo-size';
     previous: LogoSizePolicy;
     next: LogoSizePolicy;
+}> | Readonly<{
+    kind: 'header-menu-font';
+    previous: HeaderNavTypographyPreference;
+    next: HeaderNavTypographyPreference;
+}> | Readonly<{
+    kind: 'header-menu-font-size';
+    previous: HeaderNavFontSizePreference;
+    next: HeaderNavFontSizePreference;
 }>;
 export type SiteChromeQuickControlHistoryPresent = Readonly<{
     selection: SelectionSnapshot;
     headerBrandPreferences: HeaderBrandPreferences;
+    headerNavPreferences: HeaderNavPreferences;
     backgroundPreferences: SiteChromeBackgroundPreferences;
     entry: SiteChromeQuickControlHistoryEntry | null;
 }>;
 type SiteChromeQuickControlHistoryPresentInput = Readonly<{
     selection: SelectionSnapshot;
     headerBrandPreferences: HeaderBrandPreferences;
+    headerNavPreferences?: HeaderNavPreferences;
     backgroundPreferences?: SiteChromeBackgroundPreferences;
 }>;
 export type SiteChromeQuickControlReplayPlan = Readonly<{
@@ -55,6 +65,9 @@ export type SiteChromeQuickControlReplayPlan = Readonly<{
 }> | Readonly<{
     kind: 'brand-preferences';
     preferences: HeaderBrandPreferences;
+}> | Readonly<{
+    kind: 'nav-preferences';
+    preferences: HeaderNavPreferences;
 }> | Readonly<{
     kind: 'background-preferences';
     preferences: SiteChromeBackgroundPreferences;
@@ -99,6 +112,7 @@ export type SiteChromeQuickControlHistoryFailure = Readonly<{
 }>;
 export type SiteChromeQuickControlSelectionTarget = 'header-layout' | 'header-style' | 'footer-layout' | 'footer-look';
 export type SiteChromeQuickControlBrandTarget = 'header-brand-display' | 'header-logo-size';
+export type SiteChromeQuickControlNavTarget = 'header-menu-font' | 'header-menu-font-size';
 export type SiteChromeQuickControlBackgroundTarget = 'header-background' | 'footer-background';
 export declare function createSiteChromeQuickControlHistoryState(present: SiteChromeQuickControlHistoryPresentInput): SiteChromeQuickControlHistoryState;
 export declare function recordSiteChromeQuickControlHistoryEntry(state: SiteChromeQuickControlHistoryState, input: Readonly<{
@@ -109,6 +123,7 @@ export declare function recordSiteChromeQuickControlHistoryEntry(state: SiteChro
 export declare function quickControlHistoryEntryFromSelectionChange(previous: SelectionSnapshot, next: SelectionSnapshot, target: SiteChromeQuickControlSelectionTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function quickControlHistoryEntryFromBrandPreferenceChange(previous: HeaderBrandPreferences, next: HeaderBrandPreferences, target: SiteChromeQuickControlBrandTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function quickControlHistoryEntryFromBackgroundPreferenceChange(previous: SiteChromeBackgroundPreferences, next: SiteChromeBackgroundPreferences, target: SiteChromeQuickControlBackgroundTarget): SiteChromeQuickControlHistoryEntry | null;
+export declare function quickControlHistoryEntryFromNavPreferenceChange(previous: HeaderNavPreferences, next: HeaderNavPreferences, target: SiteChromeQuickControlNavTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function beginSiteChromeQuickControlHistoryUndo(state: SiteChromeQuickControlHistoryState): SiteChromeQuickControlHistoryBeginResult;
 export declare function beginSiteChromeQuickControlHistoryRedo(state: SiteChromeQuickControlHistoryState): SiteChromeQuickControlHistoryBeginResult;
 export declare function confirmSiteChromeQuickControlHistoryMutation(state: SiteChromeQuickControlHistoryState, persisted: SiteChromeQuickControlHistoryPresentInput): SiteChromeQuickControlHistoryState;

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

@@ -1,6 +1,6 @@
 import type { APIEndpoints } from '../../../../api/src/index';
 import type { Theme } from '../../../../blocks/src/index';
-import type { FooterSelectionContext, HeaderSelectionContext, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { FooterSelectionContext, HeaderNavPreferences, HeaderSelectionContext, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import { type SiteStylePreviewPlan } from './siteStylePreviewPlanner';
@@ -20,11 +20,12 @@ export type BuildSiteChromeSavePlanInput = Readonly<{
     headerSelectionContext: Partial<HeaderSelectionContext> | undefined;
     footerSelectionContext: Partial<FooterSelectionContext> | undefined;
     headerBrandPreferences: HeaderBrandPreferences;
+    headerNavPreferences: HeaderNavPreferences;
     backgroundPreferences: SiteChromeBackgroundPreferences;
     themeId: string | null;
     selectionId: string | null;
     baseSelectionUpdatedAt: string | null;
 }>;
-export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerSelectionContext, footerSelectionContext, headerBrandPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
+export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerSelectionContext, footerSelectionContext, headerBrandPreferences, headerNavPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
 export declare function siteChromeSavePlanBodyForBaseRevision(plan: SiteChromeSavePlan, baseSelectionUpdatedAt: string | null): SaveSiteChromeLookSelectionBody;
 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/config/validation.d.ts

@@ -39,9 +39,9 @@ export declare const sectionBackgroundSchema: z.ZodObject<{
  * Schema for section spacing values.
  */
 export declare const sectionSpacingSchema: z.ZodEnum<{
+    default: "default";
     compact: "compact";
     spacious: "spacious";
-    default: "default";
 }>;
 /**
  * Schema for container max-width values.
@@ -68,9 +68,9 @@ export declare const sectionOptionsSchema: z.ZodOptional<z.ZodObject<{
     backgroundImage: z.ZodOptional<z.ZodBoolean>;
     backgroundGradient: z.ZodOptional<z.ZodBoolean>;
     spacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodEnum<{
+        default: "default";
         compact: "compact";
         spacious: "spacious";
-        default: "default";
     }>>, z.ZodBoolean]>>;
     textColor: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>;
@@ -104,9 +104,9 @@ export declare const siteStyleConfigSchema: z.ZodOptional<z.ZodObject<{
         backgroundImage: z.ZodOptional<z.ZodBoolean>;
         backgroundGradient: z.ZodOptional<z.ZodBoolean>;
         spacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodEnum<{
+            default: "default";
             compact: "compact";
             spacious: "spacious";
-            default: "default";
         }>>, z.ZodBoolean]>>;
         textColor: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;

package/dist/_dts/sdk/src/contracts/index.d.ts

@@ -1,6 +1,6 @@
 export type { TipTapNode, TipTapMark, InlineText, InlineTextAccentTone, InlineTextHighlightTone, InlineTextMark, InlineTextRun, Media, LinkValue, InternalRouteOnlyLinkValue, InternalResolvedLinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, } from './content';
 export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CourseDetailsContent, CourseRegistrationContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, ProductDetailContent, ProductListContent, SectionStylesContent, SemanticIconId, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, BlockIconValue, FeatureCardIconTreatment, } from './system-block-content';
-export type { PageOutline, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, } from './page';
+export type { PageOutline, PageRuntimeBoundary, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, } from './page';
 export type { Theme, ThemeTokens } from './theme';
 export type { CustomCssDeclarationsInput, CustomCssRuleInput, CustomCssNestedRuleInput, CustomCssAtRuleInput, KeyframesAtRuleInput, FontFaceAtRuleInput, MediaAtRuleInput, SupportsAtRuleInput, RawAtRuleInput, } from './custom-css';
 export type { BindingSource, BindingTransformName, BindingDescriptor, BindingInput, BindingMap, BindingContext, } from './bindings';

package/dist/_dts/sdk/src/contracts/page.d.ts

@@ -3,6 +3,7 @@
  *
  * Keep these types structurally compatible with the API responses.
  */
+import type { CompiledBoundaryRuntime } from '../../../theme-core/src/site-styles/index';
 export type BlockOutline = {
     id: string | null;
     kind: string;
@@ -18,6 +19,7 @@ export type PageOutline = {
     purpose: string;
     blocks: BlockOutline[];
 };
+export type PageRuntimeBoundary = CompiledBoundaryRuntime<string>;
 export type RouteMapEntry = string | {
     path?: string | null;
     href?: string | null;

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';