@riverbankcms/sdk 0.80.0 → 0.81.0

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

@@ -1,6 +1,7 @@
 import type { APIEndpoints } from '../../../../api/src/index';
 import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
 import { type PreviewCustomizeHistoryEntry, type PreviewCustomizeHistoryState } from './previewCustomizeHistory';
+import { type EditorSaveBatch, type EditorTransaction } from '../../../../content-editor/src/editorTransactionState';
 type ApiPageDesignEditorStateResponse = NonNullable<APIEndpoints['getPageDesignEditorState']['response']>;
 type LoadedPageDesignEditorState = Extract<ApiPageDesignEditorStateResponse, Readonly<{
     kind: 'loaded';
@@ -45,23 +46,24 @@ export type PreviewCustomizeMutationState = Readonly<{
     actions: readonly PreviewCustomizePendingAction[];
 }> | Readonly<{
     kind: 'applying';
-    action: PreviewCustomizeAction;
-    historyEntry: PreviewCustomizeHistoryEntry | null;
+    batch: PreviewCustomizeSaveBatch;
     queuedActions: readonly PreviewCustomizePendingAction[];
 }> | Readonly<{
     kind: 'undoing';
-    action: PreviewCustomizeAction;
+    actions: readonly PreviewCustomizeAction[];
     entry: PreviewCustomizeHistoryEntry;
 }> | Readonly<{
     kind: 'redoing';
-    action: PreviewCustomizeAction;
+    actions: readonly PreviewCustomizeAction[];
     entry: PreviewCustomizeHistoryEntry;
 }> | Readonly<{
     kind: 'stale';
     message: string;
+    actions: readonly PreviewCustomizePendingAction[];
 }> | Readonly<{
     kind: 'failed';
     message: string;
+    actions: readonly PreviewCustomizePendingAction[];
 }>;
 export type PreviewCustomizeWorkflowState = Readonly<{
     kind: 'unsupported';
@@ -79,14 +81,14 @@ export type PreviewCustomizeWorkflowState = Readonly<{
     history: PreviewCustomizeHistoryState;
     mutation: PreviewCustomizeMutationState;
 }>;
-type PreviewCustomizePendingAction = Readonly<{
-    action: PreviewCustomizeAction;
-    historyEntry: PreviewCustomizeHistoryEntry | null;
-}>;
+type PreviewCustomizeTargetKey = `block:${string}:layout` | `block:${string}:look` | `block:${string}:facet:${string}` | `block:${string}:background` | `boundary:${string}:${string}`;
+type PreviewCustomizePendingAction = EditorTransaction<PreviewCustomizeAction, PreviewCustomizeHistoryEntry, PreviewCustomizeTargetKey>;
+type PreviewCustomizeSaveBatch = EditorSaveBatch<PreviewCustomizeAction, PreviewCustomizeHistoryEntry, PreviewCustomizeTargetKey>;
 export type PreviewCustomizeBeginResult = Readonly<{
     kind: 'started';
     state: PreviewCustomizeWorkflowState;
-    action: PreviewCustomizeAction;
+    actions: readonly PreviewCustomizeAction[];
+    recordsHistoryEntry: boolean;
 }> | Readonly<{
     kind: 'skipped';
     reason: PreviewCustomizeSkipReason;

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

@@ -0,0 +1,18 @@
+export type PreviewDesignHistoryDomainId = 'site-style-design' | 'site-chrome-quick-controls' | 'theme-customize';
+export type PreviewDesignHistoryOrderState = Readonly<{
+    past: readonly PreviewDesignHistoryDomainId[];
+    future: readonly PreviewDesignHistoryDomainId[];
+}>;
+export type PreviewDesignHistoryCommand = 'undo' | 'redo';
+export type PreviewDesignHistoryDomainCapabilities = Readonly<{
+    canUndo: boolean;
+    canRedo: boolean;
+    isPending: boolean;
+    isStale: boolean;
+}>;
+export declare function createPreviewDesignHistoryOrderState(): PreviewDesignHistoryOrderState;
+export declare function recordPreviewDesignHistoryDomain(state: PreviewDesignHistoryOrderState, domainId: PreviewDesignHistoryDomainId): PreviewDesignHistoryOrderState;
+export declare function confirmPreviewDesignHistoryUndo(state: PreviewDesignHistoryOrderState, domainId: PreviewDesignHistoryDomainId): PreviewDesignHistoryOrderState;
+export declare function confirmPreviewDesignHistoryRedo(state: PreviewDesignHistoryOrderState, domainId: PreviewDesignHistoryDomainId): PreviewDesignHistoryOrderState;
+export declare function selectPreviewDesignHistoryDomain(state: PreviewDesignHistoryOrderState, command: PreviewDesignHistoryCommand, capabilities: Readonly<Record<PreviewDesignHistoryDomainId, PreviewDesignHistoryDomainCapabilities>>): PreviewDesignHistoryDomainId | null;
+export declare function previewDesignHistoryDomainForCommand(state: PreviewDesignHistoryOrderState, command: PreviewDesignHistoryCommand): PreviewDesignHistoryDomainId | null;

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

@@ -1,4 +1,4 @@
-export type PreviewUndoDomainId = 'content' | 'theme-customize';
+export type PreviewUndoDomainId = 'content' | 'preview-design-history' | 'theme-customize' | 'site-style-design';
 export type PreviewUndoDomainStatus = 'idle' | 'pending' | 'stale' | 'failed';
 export type PreviewUndoFocusOwner = 'preview-customize' | 'content' | 'native';
 export type PreviewUndoDomainOwnership = Readonly<{

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

@@ -0,0 +1,41 @@
+import type { Theme } from '../../../../blocks/src/index';
+import type { BrandDisplayMode, HeaderSelectionContext, LogoSizePolicy } from '../../../../theme-core/src/site-styles/index';
+export type HeaderBrandPreferences = Readonly<{
+    brandDisplay: BrandDisplayMode;
+    logoSize: LogoSizePolicy;
+}>;
+export type HeaderBrandDisplayOption = Readonly<{
+    value: BrandDisplayMode;
+    label: string;
+    disabled?: boolean;
+}>;
+export type HeaderLogoSizeOption = Readonly<{
+    value: LogoSizePolicy;
+    label: string;
+}>;
+export type HeaderBrandControlState = Readonly<{
+    kind: 'logo-available';
+    preferences: HeaderBrandPreferences;
+    brandDisplayOptions: readonly HeaderBrandDisplayOption[];
+    logoSizeOptions: readonly HeaderLogoSizeOption[];
+}> | Readonly<{
+    kind: 'no-logo';
+    preferences: HeaderBrandPreferences;
+    brandDisplayOptions: readonly HeaderBrandDisplayOption[];
+    logoSizeOptions: readonly HeaderLogoSizeOption[];
+}>;
+export declare const DEFAULT_HEADER_BRAND_PREFERENCES: HeaderBrandPreferences;
+export declare const HEADER_LOGO_SIZE_OPTIONS: readonly HeaderLogoSizeOption[];
+export declare function createHeaderBrandControlState({ theme, headerSelectionContext, }: {
+    theme: Theme | null;
+    headerSelectionContext: Partial<HeaderSelectionContext> | undefined;
+}): HeaderBrandControlState;
+export declare function createHeaderBrandControlStateFromPreferences({ preferences, headerSelectionContext, }: {
+    preferences: HeaderBrandPreferences;
+    headerSelectionContext: Partial<HeaderSelectionContext> | undefined;
+}): HeaderBrandControlState;
+export declare function readHeaderBrandPreferences(theme: Theme | null): HeaderBrandPreferences;
+export declare function normalizeHeaderBrandPreferences(preferences: HeaderBrandPreferences, hasLogo: boolean): HeaderBrandPreferences;
+export declare function withHeaderBrandThemePreferences(theme: Theme, preferences: HeaderBrandPreferences): Theme;
+export declare function withHeaderBrandPreferences(context: Partial<HeaderSelectionContext> | undefined, preferences: HeaderBrandPreferences): Partial<HeaderSelectionContext> | undefined;
+export declare function hasLogoInHeaderSelectionContext(context: Partial<HeaderSelectionContext> | undefined): boolean;

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

@@ -0,0 +1,101 @@
+import { type HistoryState } from '../../../../content-editor/src/index';
+import { type BrandDisplayMode, type FooterLookId, type LogoSizePolicy } 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'>;
+type HeaderStyleSelection = Pick<SelectionSnapshot, 'headerStyleId' | 'headerLookId'>;
+export type SiteChromeQuickControlHistoryEntry = Readonly<{
+    kind: 'header-layout';
+    previous: HeaderLayoutSelection;
+    next: HeaderLayoutSelection;
+}> | Readonly<{
+    kind: 'header-style';
+    previous: HeaderStyleSelection;
+    next: HeaderStyleSelection;
+}> | Readonly<{
+    kind: 'footer-look';
+    previous: FooterLookId | null;
+    next: FooterLookId | null;
+}> | Readonly<{
+    kind: 'header-brand-display';
+    previous: BrandDisplayMode;
+    next: BrandDisplayMode;
+}> | Readonly<{
+    kind: 'header-logo-size';
+    previous: LogoSizePolicy;
+    next: LogoSizePolicy;
+}>;
+export type SiteChromeQuickControlHistoryPresent = Readonly<{
+    selection: SelectionSnapshot;
+    headerBrandPreferences: HeaderBrandPreferences;
+    entry: SiteChromeQuickControlHistoryEntry | null;
+}>;
+export type SiteChromeQuickControlReplayPlan = Readonly<{
+    kind: 'selection';
+    surface: 'header' | 'footer';
+    selection: SelectionSnapshot;
+}> | Readonly<{
+    kind: 'brand-preferences';
+    preferences: HeaderBrandPreferences;
+}>;
+export type SiteChromeQuickControlHistoryMutation = Readonly<{
+    kind: 'idle';
+}> | Readonly<{
+    kind: 'undoing';
+    entry: SiteChromeQuickControlHistoryEntry;
+    base: SiteChromeQuickControlHistoryPresent;
+    target: SiteChromeQuickControlReplayPlan;
+}> | Readonly<{
+    kind: 'redoing';
+    entry: SiteChromeQuickControlHistoryEntry;
+    base: SiteChromeQuickControlHistoryPresent;
+    target: SiteChromeQuickControlReplayPlan;
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}> | Readonly<{
+    kind: 'stale';
+    message: string;
+}>;
+export type SiteChromeQuickControlHistoryState = Readonly<{
+    history: HistoryState<SiteChromeQuickControlHistoryPresent>;
+    mutation: SiteChromeQuickControlHistoryMutation;
+}>;
+export type SiteChromeQuickControlHistoryBeginResult = Readonly<{
+    kind: 'started';
+    state: SiteChromeQuickControlHistoryState;
+    entry: SiteChromeQuickControlHistoryEntry;
+    base: SiteChromeQuickControlHistoryPresent;
+    target: SiteChromeQuickControlReplayPlan;
+}> | Readonly<{
+    kind: 'skipped';
+    reason: SiteChromeQuickControlHistorySkipReason;
+}>;
+export type SiteChromeQuickControlHistorySkipReason = 'not-ready' | 'mutation-pending' | 'stale' | 'cannot-undo' | 'cannot-redo' | 'no-history-entry';
+export type SiteChromeQuickControlHistoryFailure = Readonly<{
+    kind: 'retryable' | 'stale';
+    message: string;
+}>;
+export type SiteChromeQuickControlSelectionTarget = 'header-layout' | 'header-style' | 'footer-look';
+export type SiteChromeQuickControlBrandTarget = 'header-brand-display' | 'header-logo-size';
+export declare function createSiteChromeQuickControlHistoryState(present: Omit<SiteChromeQuickControlHistoryPresent, 'entry'>): SiteChromeQuickControlHistoryState;
+export declare function recordSiteChromeQuickControlHistoryEntry(state: SiteChromeQuickControlHistoryState, input: Readonly<{
+    entry: SiteChromeQuickControlHistoryEntry;
+    previous?: Omit<SiteChromeQuickControlHistoryPresent, 'entry'>;
+    persisted: Omit<SiteChromeQuickControlHistoryPresent, 'entry'>;
+}>): SiteChromeQuickControlHistoryState;
+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 beginSiteChromeQuickControlHistoryUndo(state: SiteChromeQuickControlHistoryState): SiteChromeQuickControlHistoryBeginResult;
+export declare function beginSiteChromeQuickControlHistoryRedo(state: SiteChromeQuickControlHistoryState): SiteChromeQuickControlHistoryBeginResult;
+export declare function confirmSiteChromeQuickControlHistoryMutation(state: SiteChromeQuickControlHistoryState, persisted: Omit<SiteChromeQuickControlHistoryPresent, 'entry'>): SiteChromeQuickControlHistoryState;
+export declare function rejectSiteChromeQuickControlHistoryMutation(state: SiteChromeQuickControlHistoryState, failure: SiteChromeQuickControlHistoryFailure): SiteChromeQuickControlHistoryState;
+export declare function cancelSiteChromeQuickControlHistoryMutation(state: SiteChromeQuickControlHistoryState, mutation: Extract<SiteChromeQuickControlHistoryMutation, {
+    kind: 'undoing' | 'redoing';
+}>): SiteChromeQuickControlHistoryState;
+export declare function siteChromeQuickControlHistoryCanUndo(state: SiteChromeQuickControlHistoryState | null): boolean;
+export declare function siteChromeQuickControlHistoryCanRedo(state: SiteChromeQuickControlHistoryState | null): boolean;
+export declare function siteChromeQuickControlHistoryIsPending(state: SiteChromeQuickControlHistoryState | null): boolean;
+export declare function siteChromeQuickControlHistoryIsStale(state: SiteChromeQuickControlHistoryState | null): boolean;
+export declare function siteChromeQuickControlHistoryFailureMessage(state: SiteChromeQuickControlHistoryState | null): string | null;
+export {};

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

@@ -0,0 +1,29 @@
+import type { APIEndpoints } from '../../../../api/src/index';
+import type { Theme } from '../../../../blocks/src/index';
+import type { FooterSelectionContext, HeaderSelectionContext } 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';
+import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
+import { type HeaderBrandPreferences } from './siteChromeBrandPreferences';
+type SaveSiteChromeLookSelectionBody = NonNullable<APIEndpoints['saveSiteChromeLookSelection']['body']>;
+export type SiteChromeSavePlan = Readonly<{
+    compiled: SiteStylePreviewPlan;
+    themeOverlay: Theme;
+    body: SaveSiteChromeLookSelectionBody;
+}>;
+export type BuildSiteChromeSavePlanInput = Readonly<{
+    surface: SiteChromeEditableSurfaceKind;
+    siteStyle: CuratedSiteStyle;
+    selection: SelectionSnapshot;
+    baseTheme: Theme | null | undefined;
+    headerSelectionContext: Partial<HeaderSelectionContext> | undefined;
+    footerSelectionContext: Partial<FooterSelectionContext> | undefined;
+    headerBrandPreferences: HeaderBrandPreferences;
+    themeId: string | null;
+    selectionId: string | null;
+    baseSelectionUpdatedAt: string | null;
+}>;
+export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerSelectionContext, footerSelectionContext, headerBrandPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
+export declare function siteChromeSavePlanBodyForBaseRevision(plan: SiteChromeSavePlan, baseSelectionUpdatedAt: string | null): SaveSiteChromeLookSelectionBody;
+export {};

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

@@ -0,0 +1,55 @@
+import { type HistoryState } from '../../../../content-editor/src/index';
+import type { SelectionSnapshot, StyleConfiguratorHistoryEntry } from './StyleConfigurator.state';
+export type SiteStyleHistoryPresent = Readonly<{
+    selection: SelectionSnapshot;
+    entry: StyleConfiguratorHistoryEntry | null;
+}>;
+export type SiteStyleHistoryMutation = Readonly<{
+    kind: 'idle';
+}> | Readonly<{
+    kind: 'undoing';
+    entry: StyleConfiguratorHistoryEntry;
+    base: SelectionSnapshot;
+    target: SelectionSnapshot;
+}> | Readonly<{
+    kind: 'redoing';
+    entry: StyleConfiguratorHistoryEntry;
+    base: SelectionSnapshot;
+    target: SelectionSnapshot;
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}> | Readonly<{
+    kind: 'stale';
+    message: string;
+}>;
+export type SiteStyleHistoryState = Readonly<{
+    history: HistoryState<SiteStyleHistoryPresent>;
+    mutation: SiteStyleHistoryMutation;
+}>;
+export type SiteStyleHistoryBeginResult = Readonly<{
+    kind: 'started';
+    state: SiteStyleHistoryState;
+    entry: StyleConfiguratorHistoryEntry;
+    base: SelectionSnapshot;
+    target: SelectionSnapshot;
+}> | Readonly<{
+    kind: 'skipped';
+    reason: SiteStyleHistorySkipReason;
+}>;
+export type SiteStyleHistorySkipReason = 'not-ready' | 'mutation-pending' | 'stale' | 'cannot-undo' | 'cannot-redo';
+export type SiteStyleHistoryFailure = Readonly<{
+    kind: 'retryable' | 'stale';
+    message: string;
+}>;
+export declare function createSiteStyleHistoryState(selection: SelectionSnapshot): SiteStyleHistoryState;
+export declare function recordAppliedSiteStyleSelection(state: SiteStyleHistoryState, entry: StyleConfiguratorHistoryEntry): SiteStyleHistoryState;
+export declare function beginSiteStyleHistoryUndo(state: SiteStyleHistoryState): SiteStyleHistoryBeginResult;
+export declare function beginSiteStyleHistoryRedo(state: SiteStyleHistoryState): SiteStyleHistoryBeginResult;
+export declare function confirmSiteStyleHistoryMutation(state: SiteStyleHistoryState, persisted: SelectionSnapshot): SiteStyleHistoryState;
+export declare function rejectSiteStyleHistoryMutation(state: SiteStyleHistoryState, failure: SiteStyleHistoryFailure): SiteStyleHistoryState;
+export declare function siteStyleHistoryCanUndo(state: SiteStyleHistoryState | null): boolean;
+export declare function siteStyleHistoryCanRedo(state: SiteStyleHistoryState | null): boolean;
+export declare function siteStyleHistoryIsPending(state: SiteStyleHistoryState | null): boolean;
+export declare function siteStyleHistoryIsStale(state: SiteStyleHistoryState | null): boolean;
+export declare function siteStyleHistoryFailureMessage(state: SiteStyleHistoryState | null): string | null;

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

@@ -6,3 +6,4 @@ export declare function buildApplySiteStyleSelectionBody(input: Readonly<{
     previewed: SelectionSnapshot;
     selectionId?: string | null;
 }>): ApplySiteStyleSelectionBody;
+export declare function selectionSnapshotFromApplySiteStyleSelectionResponse(saved: NonNullable<APIEndpoints['applySiteStyleSelection']['response']>, fallback: SelectionSnapshot): SelectionSnapshot;

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

@@ -1,9 +1,10 @@
 import type { ApiClient } from '../../../../api/src/request';
 import { type BuiltInReferenceKind } from '../../../../content-model/src/index';
-import type { EntryPickerWidgetAdapter, LinkWidgetAdapters, ReferenceWidgetAdapter } from '../../../../editor-blocks/src/index';
+import type { EntryPickerWidgetAdapter, LinkWidgetAdapters, ReferenceWidgetAdapter, SiteOptionWidgetAdapters } from '../../../../editor-blocks/src/index';
 type BuiltInReferenceWidgetAdapters = Record<BuiltInReferenceKind, ReferenceWidgetAdapter>;
 export declare function createPreviewLinkAdapters(previewClient: ApiClient): LinkWidgetAdapters;
 export declare function createPreviewEntryPickerAdapter(previewClient: ApiClient): EntryPickerWidgetAdapter;
+export declare function createPreviewSiteOptionAdapters(previewClient: ApiClient): SiteOptionWidgetAdapters;
 /**
  * Builds the preview adapter record by iterating the canonical `referenceLoaders`
  * map. The kind ↔ loader pairing is structurally impossible to mis-couple — each

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

@@ -3,7 +3,7 @@ import type { ApiClient } from '../../../../api/src/request';
 import { type MediaAssetIndexItem, type Theme } from '../../../../blocks/src/index';
 import type { FieldWidgetComponent } from '../../../../block-form/src/client/index';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
-import { __testUtils, createPreviewEntryPickerAdapter, createPreviewLinkAdapters, createPreviewReferenceAdapters } from './widgetAdapters';
+import { __testUtils, createPreviewEntryPickerAdapter, createPreviewLinkAdapters, createPreviewReferenceAdapters, createPreviewSiteOptionAdapters } from './widgetAdapters';
 export declare function PreviewFormProvider({ siteId: rawSiteId, theme, previewClient, bearerToken, supabaseUrl, mediaAssets, sdkConfig, children, }: {
     siteId: string;
     theme?: Theme | null;
@@ -25,6 +25,7 @@ export declare const previewWidgetOverrides: {
     readonly entryPicker: FieldWidgetComponent;
     readonly iconPicker: FieldWidgetComponent;
     readonly buttonVariant: FieldWidgetComponent;
+    readonly siteOptionPicker: FieldWidgetComponent;
 };
 export type { FieldWidgetComponent };
-export { __testUtils, createPreviewEntryPickerAdapter, createPreviewLinkAdapters, createPreviewReferenceAdapters };
+export { __testUtils, createPreviewEntryPickerAdapter, createPreviewLinkAdapters, createPreviewReferenceAdapters, createPreviewSiteOptionAdapters, };

package/dist/_dts/preview-next/src/constants.d.ts

@@ -2,5 +2,4 @@ export declare const PREVIEW_COOKIE_NAME = "preview_token";
 export declare const PREVIEW_REFRESH_COOKIE_NAME = "preview_refresh_token";
 export declare const PREVIEW_COOKIE_MAX_AGE: number;
 export declare const PREVIEW_CODE_PARAM = "preview_code";
-export declare const PREVIEW_SURFACE_PARAM = "preview_surface";
 export declare const PREVIEW_THEME_COOKIE_NAME = "preview_theme_id";

package/dist/_dts/sdk/src/cli/config-loader.d.ts

@@ -4,7 +4,7 @@
  * Loads riverbank.config.ts and extracts CLI-relevant configuration
  * (contentDir and sync settings) with appropriate defaults.
  */
-import type { SyncConfig, BlockFieldExtensionsMap } from '../config/types';
+import type { SyncConfig, BlockFieldExtensionsMap, SdkCustomBlock } from '../config/types';
 /**
  * Loaded CLI configuration with defaults applied.
  */
@@ -15,6 +15,8 @@ export interface LoadedCliConfig {
     sync: Required<SyncConfig>;
     /** Custom block field extensions from config (for validation) */
     blockFieldExtensions?: BlockFieldExtensionsMap;
+    /** SDK custom block definitions from config (for validation) */
+    customBlocks?: SdkCustomBlock[];
     /** Active theme name for local loading and default push */
     activeTheme: string;
 }

package/dist/_dts/sdk/src/cli/content/reader.d.ts

@@ -42,10 +42,12 @@ export interface LocalPage {
 /**
  * Navigation link types for local navigation files.
  *
- * These types are aligned with the API NavigationLinkInput contract
- * to keep SDK file formats and management validation in sync.
+ * These types accept the SDK config/file dropdown sentinel. Push command
+ * compilation lowers dropdown containers to linkless management inputs.
  */
-export type LocalNavigationLinkType = NavigationLinkInput;
+export type LocalNavigationLinkType = NavigationLinkInput | {
+    kind: 'dropdown';
+};
 export interface LocalNavigationItem {
     label: string;
     /** Link configuration. Required for non-dropdown items. */

package/dist/_dts/sdk/src/cli/site-commands/commandSurfaceDispatch.d.ts

@@ -12,6 +12,7 @@ export type CommandSurfaceDispatchInput = Readonly<{
     local: LocalContent;
     client: ManagementClient;
     blockFieldExtensions: Parameters<typeof compilePagePushCommands>[0]['blockFieldExtensions'];
+    customBlocks?: Parameters<typeof compilePagePushCommands>[0]['customBlocks'];
     onEntryCommandCount?: (commandCount: number) => void;
     onFormCommandCount?: (commandCount: number) => void;
     onNavigationCommandCount?: (commandCount: number) => void;

package/dist/_dts/sdk/src/cli/site-commands/pageCommands.d.ts

@@ -3,7 +3,7 @@ import { type SiteCommandOf } from '../../../../site-commands/src/index';
 import type { ManagementClient } from '../../client/management/types';
 import type { LocalContent } from '../content/reader';
 import type { EnvTarget } from '../helpers';
-import type { BlockFieldExtensionsMap } from '../../config/types';
+import type { BlockFieldExtensionsMap, SdkCustomBlock } from '../../config/types';
 import type { ContentDiff } from '../sync/diff';
 import type { SyncResult } from '../sync';
 import { type CliBlockIdentifier, type CliPageIdentifier } from './commandKeys';
@@ -30,6 +30,7 @@ export type CliPageCommandCompileInput = Readonly<{
     diff: Pick<ContentDiff, 'pages'>;
     local: Pick<LocalContent, 'pages'>;
     blockFieldExtensions?: BlockFieldExtensionsMap;
+    customBlocks?: readonly SdkCustomBlock[];
 }>;
 export type CliPageCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<PageSiteCommandType, PageCommandReportSubject> & Readonly<{
     warnings: readonly string[];
@@ -78,5 +79,6 @@ export declare function pageCommandExecutionToReport(input: Readonly<{
 export declare function preflightPageCommandPlanAsReport(input: Readonly<{
     compiledPlan: PageCommandCompiledPlan;
     blockFieldExtensions?: BlockFieldExtensionsMap;
+    customBlocks?: readonly SdkCustomBlock[];
 }>): PageCommandExecutionReport;
 export declare function pageCommandReportToSyncResult(report: PageCommandExecutionReport): SyncResult;

package/dist/_dts/sdk/src/cli/site-commands/pushExecution.d.ts

@@ -18,6 +18,7 @@ export type ContentPushExecutionInput = Readonly<{
     local: LocalContent;
     client: ManagementClient;
     blockFieldExtensions: Parameters<typeof compilePagePushCommands>[0]['blockFieldExtensions'];
+    customBlocks?: Parameters<typeof compilePagePushCommands>[0]['customBlocks'];
     output: OutputContext;
     onEntryCommandCount?: (commandCount: number) => void;
     onFormCommandCount?: (commandCount: number) => void;

package/dist/_dts/sdk/src/config/types.d.ts

@@ -45,7 +45,7 @@ export type BlockCategory = 'marketing' | 'content' | 'blog' | 'media' | 'layout
  *
  * Re-exported from `@riverbankcms/blocks` (single source of truth).
  */
-export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "getPublicEventDetails", "listPublicCourses", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices"];
+export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "getPublicEventDetails", "listPublicCourses", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices"];
 export type SdkLoaderEndpoint = (typeof SUPPORTED_LOADER_ENDPOINTS)[number];
 export type LoaderParamBinding = {
     $bind: {

package/dist/_dts/sdk/src/config/validation.d.ts

@@ -56,9 +56,9 @@ export declare const containerMaxWidthSchema: z.ZodEnum<{
  * Schema for container alignment values.
  */
 export declare const containerAlignmentSchema: z.ZodEnum<{
-    center: "center";
     left: "left";
     right: "right";
+    center: "center";
 }>;
 /**
  * Schema for section options configuration.
@@ -85,9 +85,9 @@ export declare const containerOptionsSchema: z.ZodOptional<z.ZodObject<{
         wide: "wide";
     }>>, z.ZodBoolean]>>;
     alignment: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodEnum<{
-        center: "center";
         left: "left";
         right: "right";
+        center: "center";
     }>>, z.ZodBoolean]>>;
 }, z.core.$strip>>;
 /**
@@ -118,9 +118,9 @@ export declare const siteStyleConfigSchema: z.ZodOptional<z.ZodObject<{
             wide: "wide";
         }>>, z.ZodBoolean]>>;
         alignment: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodEnum<{
-            center: "center";
             left: "left";
             right: "right";
+            center: "center";
         }>>, z.ZodBoolean]>>;
     }, z.core.$strip>>;
 }, z.core.$strip>>;

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

@@ -44,6 +44,8 @@ export type CardStylesContent = {
     spacing?: string | null;
     raised?: boolean | null;
     rounded?: string | null;
+    cardVariant?: string | null;
+    treatment?: 'accent-quote' | 'editorial-rule' | 'soft-panel' | 'editorial-serif-quote' | 'editorial-open' | null;
 } | null;
 export type ContainerStylesContent = {
     background?: Record<string, unknown> | null;
@@ -232,8 +234,7 @@ export type EventCalendarContent = {
     listColumns?: ColumnOption | null;
     layout?: EventLayout | null;
     columns?: ColumnOption | null;
-    eventsPerPage?: '6' | '12' | '24' | null;
-    compactEventsPerPage?: '10' | '20' | '30' | null;
+    eventsPerPage?: '6' | '10' | '12' | '20' | '24' | '30' | null;
     loadMoreText?: string | null;
     startOfWeek?: WeekStart | null;
     calendarTabViews?: CalendarTabViews | null;
@@ -318,6 +319,30 @@ export type EventSpotlightContent = {
     emptyMessage?: string | null;
     _sectionStyles?: SectionStylesContent;
 };
+export type OfferingsPreviewSourceKey = 'eventPreset:class' | 'eventPreset:workshop' | 'eventPreset:retreat' | 'eventPreset:performance' | 'course';
+export type OfferingsPreviewCtaMode = 'auto' | 'custom' | 'hidden';
+export type OfferingsPreviewGroupPresentation = 'compact-list' | 'single-card';
+export type OfferingsPreviewGroupOverride = {
+    sourceKey?: OfferingsPreviewSourceKey | null;
+    title?: string | null;
+    intro?: string | null;
+    hidden?: boolean | null;
+    presentation?: OfferingsPreviewGroupPresentation | null;
+    ctaMode?: OfferingsPreviewCtaMode | null;
+    ctaHref?: string | null;
+    ctaLabel?: string | null;
+};
+export type OfferingsPreviewContent = {
+    heading?: string | null;
+    description?: unknown;
+    itemLimit?: '1' | '2' | '3' | '4' | '5' | '6' | null;
+    groupOverrides?: readonly OfferingsPreviewGroupOverride[] | null;
+    _cardStyles?: CardStylesContent;
+    buttonVariant?: ButtonVariant | null;
+    buttonText?: string | null;
+    emptyMessage?: string | null;
+    _sectionStyles?: SectionStylesContent;
+};
 export type FaqItem = {
     question: string;
     answer: unknown;
@@ -661,6 +686,7 @@ export type SystemBlockContentByFullKind = {
     'block.event-spotlight': EventSpotlightContent;
     'block.event-listing': EventListingContent;
     'block.event-calendar': EventCalendarContent;
+    'block.offerings-preview': OfferingsPreviewContent;
     'block.shop': ShopContent;
     'block.product-list': ProductListContent;
     'block.product-detail': ProductDetailContent;

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

@@ -275,6 +275,15 @@ export type SiteRouteRecord = {
     draftStatus?: string | null;
     publishedAt?: string | null;
 };
+export type SiteBookingOfferingCanonicalBehaviour = "class" | "workshop" | "course" | "retreat" | "performance" | "appointment";
+export type SiteBookingOfferingEngine = "event_series" | "course" | "appointment_service";
+export type SiteBookingOfferingPresetSummary = Readonly<{
+    id: string;
+    canonicalBehaviour: SiteBookingOfferingCanonicalBehaviour;
+    engine: SiteBookingOfferingEngine;
+    label: string;
+    pluralLabel: string;
+}>;
 export type SiteResponse = {
     site: {
         id: string;
@@ -318,6 +327,7 @@ export type SiteResponse = {
     appointmentsEnabled?: boolean;
     portalEnabled?: boolean;
     commerceEnabled?: boolean;
+    bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
     analytics?: SiteAnalyticsSettingsPayload;
     privacyPolicy?: SiteRuntimePrivacyPolicy;
     routes: Record<string, SiteRouteRecord>;

package/dist/_dts/sdk/src/rendering/islands/types.d.ts

@@ -48,6 +48,47 @@ export type EventCategory = {
     color: string | null;
 };
 export type PricingType = 'free' | 'paid' | 'pass_only' | 'membership_only';
+export type PublicCoursePriceDisplay = {
+    kind: 'free';
+    currency: string;
+} | {
+    kind: 'exact';
+    amount: number;
+    currency: string;
+} | {
+    kind: 'from';
+    amount: number;
+    currency: string;
+} | {
+    kind: 'unavailable';
+    currency: string;
+};
+export type PublicEventPriceDisplay = {
+    kind: 'free';
+    currency: string;
+} | {
+    kind: 'exact';
+    amount: number;
+    currency: string;
+} | {
+    kind: 'from';
+    amount: number;
+    currency: string;
+} | {
+    kind: 'mixed';
+    paidFromAmount: number;
+    currency: string;
+} | {
+    kind: 'pass_only';
+} | {
+    kind: 'membership_only';
+} | {
+    kind: 'unavailable';
+    currency: string;
+} | {
+    kind: 'course';
+    display: PublicCoursePriceDisplay;
+};
 export type AccessRestriction = 'none' | 'category';
 export type PublicEventTicketTypeAvailability = {
     kind: 'available';
@@ -152,6 +193,7 @@ export type PublicEvent = {
     pricingType: PricingType;
     price: number | null;
     currency: string;
+    priceDisplay: PublicEventPriceDisplay;
     paymentTerms: BookingPaymentTerms;
     pricingMode?: 'single' | 'ticket_types';
     ticketTypes?: PublicEventTicketType[];

package/dist/_dts/sdk/src/rendering/mediaAssets.d.ts

@@ -0,0 +1,4 @@
+import type { MediaAssetIndexItem as BlocksMediaAssetIndexItem, ResolveImageUrlContextInput as BlocksResolveImageUrlContextInput } from '../../../blocks/src/index';
+import type { MediaAssetIndexItem as SdkMediaAssetIndexItem, ResolveImageUrlContextInput as SdkResolveImageUrlContextInput } from '../contracts';
+export declare function toBlocksMediaAssets(assets: readonly SdkMediaAssetIndexItem[] | undefined): readonly BlocksMediaAssetIndexItem[] | undefined;
+export declare function toBlocksImageResolveContextInput(context: SdkResolveImageUrlContextInput | undefined): BlocksResolveImageUrlContextInput | undefined;

package/dist/_dts/sdk/src/types/block-kinds.d.ts

@@ -7,7 +7,7 @@
  * `@riverbankcms/blocks` (which is not a public dependency). This list is a
  * stable public contract; keep it in sync with the internal blocks runtime.
  */
-export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.appointment-booking", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
+export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.appointment-booking", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.offerings-preview", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
 export type SystemBlockKind = (typeof SYSTEM_BLOCK_KINDS)[number];
 export type CustomBlockKind = `custom.${string}`;
 export type BlockKind = SystemBlockKind | CustomBlockKind;