@riverbankcms/sdk 0.101.0 → 0.103.0

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

@@ -3,7 +3,8 @@ 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 { 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;

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

@@ -11,6 +11,7 @@
  * 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 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';
@@ -37,6 +38,33 @@ export type StyleConfiguratorNotice = Readonly<{
 }> | Readonly<{
     kind: 'palette-overrides-restored';
 }>;
+type ThemeTypography = Theme['typography'];
+type BodyTypography = ThemeTypography['body'];
+type HeadingTypography = ThemeTypography['headings']['default'];
+export type TypographySelectionSnapshot = Readonly<{
+    kind: 'preset';
+    presetId: TypographyPresetId | null;
+    bodyFontOverride: string | null;
+    headingFontOverride: string | null;
+}> | Readonly<{
+    kind: 'custom';
+    typography: ThemeTypography;
+}>;
+export type TypographySelectionFlatFields = Readonly<{
+    typographyPresetId: TypographyPresetId | null;
+    typographyBodyFontOverride: string | null;
+    typographyHeadingFontOverride: string | null;
+}>;
+export type TypographyDraftPatch = Readonly<{
+    kind: 'heading';
+    patch: Partial<HeadingTypography>;
+}> | Readonly<{
+    kind: 'body';
+    patch: Partial<BodyTypography>;
+}> | Readonly<{
+    kind: 'scale';
+    scale: ThemeTypography['scale'];
+}>;
 export type SelectionSnapshot = Readonly<{
     siteStyleId: SiteStyleId;
     selectionVersion: number;
@@ -48,9 +76,7 @@ export type SelectionSnapshot = Readonly<{
     buttonPersonalityId: ButtonPersonalityId;
     paletteVariantId: PaletteVariantId;
     paletteOverrides: PaletteOverrides | null;
-    typographyPresetId: TypographyPresetId | null;
-    typographyBodyFontOverride: string | null;
-    typographyHeadingFontOverride: string | null;
+    typographySelection: TypographySelectionSnapshot;
 }>;
 type PaletteOverrideDrafts = Readonly<Partial<Record<PaletteVariantId, PaletteOverrides>>>;
 type StyleConfiguratorTargetKey = 'design:site-style';
@@ -95,9 +121,9 @@ export declare function previewHeaderLayout(state: StyleConfiguratorState, heade
 export declare function previewHeaderStyle(state: StyleConfiguratorState, headerStyleId: HeaderStyleId): StyleConfiguratorState;
 export declare function previewFooterLook(state: StyleConfiguratorState, footerLookId: FooterLookId | null): StyleConfiguratorState;
 export declare function previewTypographyPreset(state: StyleConfiguratorState, typographyPresetId: TypographyPresetId): StyleConfiguratorState;
-export declare function setTypographyBodyFontOverride(state: StyleConfiguratorState, typographyBodyFontOverride: string | null): StyleConfiguratorState;
-export declare function setTypographyHeadingFontOverride(state: StyleConfiguratorState, typographyHeadingFontOverride: string | null): StyleConfiguratorState;
-export declare function clearTypographyFontOverrides(state: StyleConfiguratorState): StyleConfiguratorState;
+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;
 /**
@@ -112,7 +138,8 @@ export declare function setPaletteOverrides(state: StyleConfiguratorState, palet
  * 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' | 'typographyPresetId' | 'typographyBodyFontOverride' | 'typographyHeadingFontOverride'>;
+    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'paletteVariantId' | 'headerLayoutId' | 'headerStyleId' | 'headerLookId'> & TypographySelectionFlatFields;
+    typographySelection?: TypographySelectionSnapshot;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>): StyleConfiguratorState;
 export declare function cancelPreview(state: StyleConfiguratorState): StyleConfiguratorState;
@@ -129,5 +156,14 @@ export declare function dismissNotices(state: StyleConfiguratorState): StyleConf
  */
 export declare function syncStyleConfiguratorState(state: StyleConfiguratorState, base: SelectionSnapshot): StyleConfiguratorState;
 export declare function selectionSnapshotsEqual(a: SelectionSnapshot, b: SelectionSnapshot): boolean;
+export declare function typographySelectionSnapshotFromFlat(input: Readonly<{
+    typographyPresetId?: TypographyPresetId | null;
+    typographyBodyFontOverride?: string | null;
+    typographyHeadingFontOverride?: string | null;
+    theme?: Theme | null;
+}>): TypographySelectionSnapshot;
+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 {};

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

@@ -2,15 +2,14 @@ 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 { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
-import { type CuratedSiteStyle, type SelectionFallbackWarning, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
+import { type CuratedSiteStyle, type CompiledTypographySelection, type SelectionFallbackWarning, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
+import type { TypographySelectionSnapshot } from './StyleConfigurator.state';
 export type SiteStylePreviewSelection = Readonly<{
     siteStyleId: SiteStyleId;
     buttonPersonalityId: ButtonPersonalityId;
     paletteVariantId: PaletteVariantId;
     paletteOverrides: PaletteOverrides | null;
-    typographyPresetId?: TypographyPresetId | null;
-    typographyBodyFontOverride?: string | null;
-    typographyHeadingFontOverride?: string | null;
+    typographySelection?: TypographySelectionSnapshot;
     headerLayoutId?: HeaderLayoutId | null;
     headerStyleId?: HeaderStyleId | null;
     headerLookId: HeaderLookId | null;
@@ -25,6 +24,7 @@ export type SiteStylePreviewPlan = Readonly<{
     resolvedSelections: Readonly<{
         buttonPersonalityId: ButtonPersonalityId;
         paletteVariantId: PaletteVariantId;
+        typographySelection: CompiledTypographySelection['resolvedSelection'];
         typographyPresetId: TypographyPresetId | null;
         typographyBodyFontOverride: string | null;
         typographyHeadingFontOverride: string | null;

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

@@ -1,5 +1,5 @@
 import type { APIEndpoints } from '../../../../api/src/index';
-import type { SelectionSnapshot } from './StyleConfigurator.state';
+import { type SelectionSnapshot } from './StyleConfigurator.state';
 export type ApplySiteStyleSelectionBody = NonNullable<APIEndpoints['applySiteStyleSelection']['body']>;
 export declare function buildApplySiteStyleSelectionBody(input: Readonly<{
     base: SelectionSnapshot;

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

@@ -1,11 +1,13 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { TypographyPresetId, TypographySelection } from '../../../../theme-core/src/site-styles/previewCompiler';
-type TypographySelectionSnapshot = Readonly<{
+import type { TypographySelectionSnapshot } from './StyleConfigurator.state';
+type TypographySelectionInputSnapshot = Readonly<{
     typographyPresetId?: TypographyPresetId | null;
     typographyBodyFontOverride?: string | null;
     typographyHeadingFontOverride?: string | null;
+    typographySelection?: TypographySelectionSnapshot;
 }>;
-export declare function typographySelectionInputForSnapshot(snapshot: TypographySelectionSnapshot, theme: Theme | null | undefined): Readonly<{
+export declare function typographySelectionInputForSnapshot(snapshot: TypographySelectionInputSnapshot, theme: Theme | null | undefined): Readonly<{
     typographySelection?: TypographySelection;
     typographyPresetId?: TypographyPresetId | null;
     typographyBodyFontOverride?: string | null;

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/manifest/passes/pass1-fields.d.ts

@@ -10,8 +10,8 @@ export declare const simpleFieldTypeEnum: z.ZodEnum<{
     boolean: "boolean";
     text: "text";
     select: "select";
-    media: "media";
     link: "link";
+    media: "media";
     richText: "richText";
 }>;
 export declare const fieldTypeEnum: z.ZodEnum<{
@@ -19,11 +19,11 @@ export declare const fieldTypeEnum: z.ZodEnum<{
     boolean: "boolean";
     text: "text";
     select: "select";
-    media: "media";
     link: "link";
+    media: "media";
+    group: "group";
     richText: "richText";
     repeater: "repeater";
-    group: "group";
 }>;
 /**
  * Combined field schema supporting all field types.
@@ -36,8 +36,8 @@ export declare const extractedFieldSchema: z.ZodUnion<readonly [z.ZodObject<{
         boolean: "boolean";
         text: "text";
         select: "select";
-        media: "media";
         link: "link";
+        media: "media";
         richText: "richText";
     }>;
     label: z.ZodString;
@@ -63,8 +63,8 @@ export declare const extractedFieldSchema: z.ZodUnion<readonly [z.ZodObject<{
             boolean: "boolean";
             text: "text";
             select: "select";
-            media: "media";
             link: "link";
+            media: "media";
             richText: "richText";
         }>;
         label: z.ZodString;
@@ -83,8 +83,8 @@ export declare const extractedFieldSchema: z.ZodUnion<readonly [z.ZodObject<{
             boolean: "boolean";
             text: "text";
             select: "select";
-            media: "media";
             link: "link";
+            media: "media";
             richText: "richText";
         }>;
         label: z.ZodString;
@@ -167,8 +167,8 @@ export declare const pass1OutputSchema: z.ZodObject<{
     blockDescription: z.ZodNullable<z.ZodString>;
     category: z.ZodEnum<{
         content: "content";
-        media: "media";
         layout: "layout";
+        media: "media";
         marketing: "marketing";
         blog: "blog";
         interactive: "interactive";
@@ -180,8 +180,8 @@ export declare const pass1OutputSchema: z.ZodObject<{
             boolean: "boolean";
             text: "text";
             select: "select";
-            media: "media";
             link: "link";
+            media: "media";
             richText: "richText";
         }>;
         label: z.ZodString;
@@ -207,8 +207,8 @@ export declare const pass1OutputSchema: z.ZodObject<{
                 boolean: "boolean";
                 text: "text";
                 select: "select";
-                media: "media";
                 link: "link";
+                media: "media";
                 richText: "richText";
             }>;
             label: z.ZodString;
@@ -227,8 +227,8 @@ export declare const pass1OutputSchema: z.ZodObject<{
                 boolean: "boolean";
                 text: "text";
                 select: "select";
-                media: "media";
                 link: "link";
+                media: "media";
                 richText: "richText";
             }>;
             label: z.ZodString;

package/dist/_dts/sdk/src/next/revalidate.d.ts

@@ -39,6 +39,10 @@ export type RevalidationRequestMetadata = Readonly<{
     correlationId?: string;
     monitorRunId?: string;
 }>;
+export type RevalidationCacheClient = Readonly<{
+    clearCache(): void | Promise<void>;
+}>;
+export type RevalidationClientCacheStatus = 'cleared' | 'failed' | 'skipped';
 /**
  * Normalize a public URL path for Next revalidation.
  */
@@ -58,6 +62,14 @@ export interface RevalidateHandlerOptions {
      * Useful for logging or analytics.
      */
     onRevalidate?: (payload: WebhookPayload, revalidatedItems: string[], metadata: RevalidationRequestMetadata) => void;
+    /**
+     * Optional Riverbank SDK client factory. When provided, the handler makes a
+     * best-effort attempt to clear this process's SDK client response cache after
+     * a valid webhook is revalidated. Serverless deployments may run webhook and
+     * render routes in different processes, so this is not a cross-instance cache
+     * invalidation mechanism.
+     */
+    getClient?: () => RevalidationCacheClient | Promise<RevalidationCacheClient>;
 }
 /**
  * Create a Next.js API route handler for webhook revalidation.
@@ -66,7 +78,8 @@ export interface RevalidateHandlerOptions {
  * 1. Verifies the webhook signature using HMAC-SHA256
  * 2. Calls `revalidateTag()` for each normalized tag in the payload
  * 3. Calls `revalidatePath()` for each normalized path in the payload
- * 4. Returns a JSON response with the revalidation results
+ * 4. Best-effort clears the current process's SDK client cache when configured
+ * 5. Returns a JSON response with the revalidation results
  *
  * @param options - Configuration options
  * @returns A Next.js Route Handler function

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

@@ -1,5 +1,7 @@
 import type { AddressedLocationValue, BusinessAddress, BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig, PublicEventPricing } from '../../../core/src/index';
+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 { 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;
@@ -371,6 +373,7 @@ export type SdkRuntimePage = {
         purpose?: string;
         content: Record<string, unknown>;
     }>;
+    runtimeBoundaries?: readonly CompiledBoundaryRuntime<string>[];
 };
 export type SdkTemplate = {
     id: string;
@@ -414,10 +417,7 @@ export type SdkSurfaceSlotContent = {
         publishedContentId?: string | null;
     }>;
 };
-export type SdkRuntimePageSurfaceSubject = Readonly<{
-    kind: 'eventSeries';
-    eventSeriesId: string;
-}>;
+export type SdkRuntimePageSurfaceSubject = ApiSdkRuntimePageSurfaceSubject;
 export type SdkRuntimePageSurfaceContentSource = Readonly<{
     kind: 'pageSurface';
     contentTypeId: string;

package/dist/_dts/sdk/src/rendering/blocks-page-renderer.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, ResolveImageUrlContextInput, RouteMap, Theme, ThemeTokens } from '../contracts';
+import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, PageRuntimeBoundary, ResolveImageUrlContextInput, RouteMap, Theme, ThemeTokens } from '../contracts';
 import type { SdkCustomBlock } from '../config/types';
 import type { BlockOverrides } from './overrides';
 import type { SiteBookingOfferingPresetSummary } from '../public-api/contracts';
@@ -32,6 +32,7 @@ export type SdkConfigForRenderer = {
 export type PageRendererProps = {
     theme: Theme;
     page: PageOutline | null;
+    runtimeBoundaries?: readonly PageRuntimeBoundary[];
     usePlaceholders?: boolean;
     dataContext?: PageRendererDataContext;
     routeMap?: RouteMap;

package/dist/_dts/sdk/src/rendering/components/pageShared.d.ts

@@ -1,5 +1,5 @@
 import type { ReactElement } from 'react';
-import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, RouteMap, Theme, ThemeTokens } from '../../contracts';
+import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, PageRuntimeBoundary, RouteMap, Theme, ThemeTokens } from '../../contracts';
 import type { ResolvedBlockData } from '../../data';
 import type { SiteBookingOfferingPresetSummary } from '../../public-api/contracts';
 import type { RuntimeSdkConfig } from '../helpers/loadPage';
@@ -9,6 +9,7 @@ import type { BlockOverrides } from '../overrides';
 import type { SdkCustomBlock } from '../../config/types';
 export type PageProps = {
     page: PageOutline;
+    runtimeBoundaries?: readonly PageRuntimeBoundary[];
     theme: Theme;
     siteId: string;
     themeTokens?: ThemeTokens;
@@ -94,4 +95,4 @@ export type PageHydrationBootstrapConfig = {
     mediaAssets?: readonly MediaAssetIndexItem[];
 };
 export declare function toPageHydrationBootstrapConfig(props: Pick<PageProps, 'siteId' | 'supabaseUrl' | 'mediaAssets'>): PageHydrationBootstrapConfig;
-export declare function PageContent({ page, theme, themeTokens: providedTokens, siteId, resolvedData, bookingOfferingPresets, routeMap, pagesByIdentifier, entriesByIdentifier, wrapBlock, registry, usePlaceholders, blockOverrides, sdkConfig, customBlocks, supabaseUrl, mediaAssets, apiBaseUrl, portalToken, previewToken, dataContext, themeRuntime, }: PageProps): ReactElement;
+export declare function PageContent({ page, runtimeBoundaries, theme, themeTokens: providedTokens, siteId, resolvedData, bookingOfferingPresets, routeMap, pagesByIdentifier, entriesByIdentifier, wrapBlock, registry, usePlaceholders, blockOverrides, sdkConfig, customBlocks, supabaseUrl, mediaAssets, apiBaseUrl, portalToken, previewToken, dataContext, themeRuntime, }: PageProps): ReactElement;

package/dist/_dts/sdk/src/rendering/helpers/loadContent.d.ts

@@ -6,6 +6,7 @@
  */
 import type { MediaAssetIndexItem, RouteMap, Theme } from '../../contracts';
 import type { RiverbankClient, PageResponse, SiteResponse } from '../../client/types';
+import type { SdkRuntimePageSurfaceSubject } from '../../public-api/contracts';
 import type { PageProps } from '../components/Page';
 import { prefetchBlockData } from '../../data/prefetchBlockData';
 import type { ResolvedBlockData } from '../../data/prefetchBlockData';
@@ -93,6 +94,7 @@ export type PageContentResult = {
     pageMetadata: PagePreviewMetadata;
     /** Page outline ready for rendering with <Page> component */
     page: PageProps['page'];
+    runtimeBoundaries?: PageProps['runtimeBoundaries'];
     /** Site theme for styling */
     theme: Theme;
     /** Site ID */
@@ -174,10 +176,7 @@ export type PageSurfaceContentData = {
     id: string;
     routeId: string;
     readinessState: 'shippable';
-    subject: {
-        kind: 'eventSeries';
-        eventSeriesId: string;
-    };
+    subject: SdkRuntimePageSurfaceSubject;
     title: string;
     slug: string | null;
     path: string | null;

package/dist/_dts/sdk/src/rendering/hooks/useContent.d.ts

@@ -56,6 +56,7 @@ type PageSuccessState = {
     error: null;
     type: 'page';
     page: PageProps['page'];
+    runtimeBoundaries?: PageProps['runtimeBoundaries'];
     entry: null;
     theme: Theme;
     siteId: string;

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.101.0";
+export declare const SDK_VERSION = "0.103.0";