@riverbankcms/sdk 0.136.0 → 0.138.0

package/dist/_dts/db/src/index.d.ts

@@ -6,3 +6,4 @@ export type { CamelizeKeys, CamelToSnake, DecamelizeKeys, DeepCamelizeKeys, Deep
 export { createPatchApplier } from './utils/patch';
 export * from './schemas/forms';
 export * from './schemas/standard-contact';
+export { escapePostgrestFilterValue } from './utils/postgrestFilter';

package/dist/_dts/db/src/utils/postgrestFilter.d.ts

@@ -0,0 +1,2 @@
+/** Escape literal search text embedded in a PostgREST ilike expression. */
+export declare function escapePostgrestFilterValue(value: string): string;

package/dist/_dts/editor-blocks/src/BlockForm.d.ts

@@ -3,7 +3,7 @@ import type { BlockDraftSaveability } from '../../block-form/src/blockDraftSavea
 import type { BlockManifest, Theme } from '../../blocks/src/index';
 import { type PageDesignEditorBlock } from '../../theme-core/src/site-styles/index';
 import { type EditorBlockId } from '../../core/src/index';
-import type { ArrayKeysManager, DraftsSlice, UiStore as BlockEditorUiStore } from './block-editor/types';
+import type { ArrayKeysManager, DraftsSlice, BlockFocusRequest, UiStore as BlockEditorUiStore } from './block-editor/types';
 import type { GeneratedIconApplyState } from './block-editor/generatedIconApplyCoordination';
 export type BlockFormUiStoreState = GeneratedIconApplyState & {
     setActivePreviewField: (field: {
@@ -31,11 +31,7 @@ type BlockItem = {
     publishedContent?: Record<string, unknown> | null;
     orderIndex?: number | null;
 };
-type BlockFormFocusSignal = {
-    requestId: number;
-    fieldPath?: string | null;
-    itemIndex?: number | null;
-};
+type BlockFormFocusSignal = BlockFocusRequest;
 export declare function BlockForm({ siteId: _siteId, block, manifest, uiStore, hasRecoveryConflict, focusSignal, onFocusHandled, onSaveSuccess, theme, widgetOverrides, hideThemeV2RawStyleFields, pageDesignBlock, }: {
     siteId: string;
     block: BlockItem;

package/dist/_dts/editor-blocks/src/block-editor/BlockCard.d.ts

@@ -13,7 +13,7 @@ import type { ArrayKeysManager, BlockFocusRequest, BlockItem, UiStore, DraftsSli
 import type { GeneratedIconApplyState } from './generatedIconApplyCoordination';
 /** Drag listener props from dnd-kit */
 type DragListeners = SyntheticListenerMap | undefined;
-type BlockCardStore = UiStore<Pick<UiSlice, 'activeBlockId' | 'setActiveBlockId' | 'setActivePreviewField'> & {
+type BlockCardStore = UiStore<Pick<UiSlice, 'activeBlockId' | 'setActiveBlockId' | 'setActivePreviewField' | 'focusRequest' | 'clearFocus'> & {
     blockValidation: {
         markPathEdited: (blockId: EditorBlockId, path: string) => void;
         isPathEdited: (blockId: EditorBlockId, path: string) => boolean;

package/dist/_dts/editor-blocks/src/block-editor/BlockCardHeader.d.ts

@@ -3,12 +3,12 @@ import type { FieldWidgetComponent } from '../../../block-form/src/index';
 import { type SiteIconStyleGuideVersionId, type SystemBlockDefinition, type Theme } from '../../../blocks/src/index';
 import { type BlockActionPresentation } from './actionPresentation';
 import type { ReorderControlMode } from './reorderControlMode';
-import type { BlockItem, UiStore, DraftsSlice, ArrayKeysManager } from './types';
+import type { BlockItem, UiStore, DraftsSlice, UiSlice, ArrayKeysManager } from './types';
 import { type GeneratedIconSetGenerateInput, type GeneratedIconSetGenerateResult } from './GeneratedIconSetDialog';
 import { type GeneratedIconApplyState } from './generatedIconApplyCoordination';
 /** Drag listener props from dnd-kit */
 type DragListeners = SyntheticListenerMap | undefined;
-type BlockCardHeaderStore = UiStore<GeneratedIconApplyState & {
+type BlockCardHeaderStore = UiStore<GeneratedIconApplyState & Pick<UiSlice, 'focusRequest' | 'clearFocus'> & {
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'initNewBlock' | 'updateBlockBaseline' | 'clearError' | 'setAtPath' | 'getAtPath'>;
     arrayKeys: ArrayKeysManager;
 }>;

package/dist/_dts/editor-blocks/src/block-editor/BlockSettingsModal.d.ts

@@ -1,11 +1,13 @@
 import type { ReactNode } from 'react';
+import { type EditorBlockId } from '../../../core/src/index';
 import type { SystemBlockDefinition, Theme } from '../../../blocks/src/index';
 import { type FieldWidgetComponent } from '../../../block-form/src/index';
-import type { ArrayKeysManager, BlockItem, DraftsSlice, UiStore } from './types';
-type BlockSettingsModalStore = UiStore<{
+import type { ArrayKeysManager, BlockItem, BlockFocusRequest, DraftsSlice, UiSlice, UiStore } from './types';
+type BlockSettingsModalStore = UiStore<Pick<UiSlice, 'focusRequest' | 'clearFocus'> & {
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'clearError' | 'setAtPath' | 'getAtPath'>;
     arrayKeys: ArrayKeysManager;
 }>;
+export declare function settingsFocusPath(signal: BlockFocusRequest | null, blockId: EditorBlockId | null): string | null;
 export declare function BlockSettingsModal({ block, manifest, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, showSettingsTrigger, open: controlledOpen, onOpenChange, onAvailabilityChange, }: {
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];

package/dist/_dts/editor-blocks/src/block-editor/hooks/useBlockValidationManifests.d.ts

@@ -9,6 +9,7 @@ type ValidationManifestStore = Readonly<{
             setValidationManifests: (entries: readonly Readonly<{
                 blockId: EditorBlockId;
                 manifest: BlockManifest;
+                editorManifest: BlockManifest;
             }>[]) => void;
         }>;
     }>;

package/dist/_dts/editor-blocks/src/block-editor/types.d.ts

@@ -39,11 +39,7 @@ export type UiSlice = {
     activeBlockId: EditorBlockId | null;
     setActiveBlockId: (id: EditorBlockId | null) => void;
     focusRequest: BlockFocusRequest | null;
-    requestFocus: (payload: {
-        blockId: EditorBlockId;
-        fieldPath?: string | null;
-        itemIndex?: number | null;
-    }) => void;
+    requestFocus: (payload: BlockFocusTarget) => void;
     clearFocus: () => void;
     setActivePreviewField: (field: {
         kind: 'block';
@@ -70,9 +66,28 @@ export type UiStore<T = {
     subscribe: (listener: () => void) => () => void;
 };
 export type BlockFocusTarget = {
+    kind: 'block';
+    blockId: EditorBlockId;
+} | {
+    kind: 'main-field';
+    blockId: EditorBlockId;
+    fieldPath: string;
+} | {
+    kind: 'settings-field';
+    blockId: EditorBlockId;
+    fieldPath: string;
+    settingsTab: 'display' | 'behavior' | 'style';
+} | {
+    kind: 'nested-main-field';
+    blockId: EditorBlockId;
+    fieldPath: string;
+    ownerPaths: readonly string[];
+} | {
+    kind: 'nested-settings-field';
     blockId: EditorBlockId;
-    fieldPath?: string | null;
-    itemIndex?: number | null;
+    fieldPath: string;
+    ownerPaths: readonly string[];
+    settingsTab: 'display' | 'behavior' | 'style';
 };
 export type BlockFocusRequest = BlockFocusTarget & {
     requestId: number;

package/dist/_dts/editor-blocks/src/block-editor/useSettingsFieldFocus.d.ts

@@ -0,0 +1,18 @@
+import { type RefObject } from 'react';
+import type { BlockFocusRequest } from './types';
+import type { EditorBlockId } from '../../../core/src/index';
+type SettingsTabId = 'display' | 'behavior' | 'style';
+type SettingsFieldFocusInput = Readonly<{
+    blockId: EditorBlockId | null;
+    focusSignal?: BlockFocusRequest | null;
+    settingsAvailable: boolean;
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    activeTab: SettingsTabId;
+    setActiveTab: (tab: SettingsTabId) => void;
+    formRootRef: RefObject<HTMLDivElement | null>;
+    onFocusHandled?: (requestId: number) => void;
+    onFocusAbandoned?: (requestId: number) => void;
+}>;
+export declare function useSettingsFieldFocus(input: SettingsFieldFocusInput): void;
+export {};

package/dist/_dts/media-core/src/bulkDeletePlanning.d.ts

@@ -7,6 +7,7 @@ export type MediaUsageCheckResponseWithCounts = Readonly<{
 export type BulkDeleteResultLike = Readonly<{
     deleted: number;
     failed: number;
+    warnings?: readonly unknown[];
 }>;
 export type BulkDeleteOptions = Readonly<{
     deleteObjects?: boolean;
@@ -16,6 +17,9 @@ export declare const BULK_DELETE_IN_PROGRESS_MESSAGE = "Delete already in progre
 export type BulkDeleteCompletionToast = Readonly<{
     kind: 'success';
     message: string;
+}> | Readonly<{
+    kind: 'warning';
+    message: string;
 }> | Readonly<{
     kind: 'error';
     message: string;

package/dist/_dts/media-core/src/fileDomain.d.ts

@@ -426,6 +426,8 @@ export declare const FILE_SIZE_LIMITS: {
     readonly instagramZip: PositiveByteCount;
     readonly bookingEvidence: PositiveByteCount;
 };
+/** Shared admission ceiling for SDK-management media uploads before intent-specific finalization. */
+export declare const MAX_MANAGEMENT_MEDIA_UPLOAD_BYTES: PositiveByteCount;
 export declare const DEFAULT_PRIVATE_FILE_SIGNED_URL_EXPIRY_SECONDS: PositiveSeconds;
 export declare const MAX_SAFE_DOWNLOAD_FILENAME_LENGTH = 180;
 export declare function asPositiveByteCount(value: number): Result<PositiveByteCount, 'not-positive-byte-count'>;
@@ -438,6 +440,7 @@ export declare function asSafeDownloadFilename(value: string): Result<SafeDownlo
 export declare const parseSafeDownloadFilename: typeof asSafeDownloadFilename;
 export declare function deriveUploadPolicy(actor: FileActor, intent: UploadIntent): Result<UploadPolicy, UploadPolicyError>;
 export declare function classifyKnownMimeType(mimeType: string | DeclaredMimeType | DetectedMimeType | undefined | null): Result<FileKind, MimeTypeClassificationError>;
+export declare function managementMediaLibraryUploadLimitForMimeType(mimeType: string | DeclaredMimeType | DetectedMimeType | undefined | null): Result<PositiveByteCount, MimeTypeClassificationError>;
 export declare function isMimeTypeAllowedForPolicy(mimeType: string | DeclaredMimeType | DetectedMimeType | undefined | null, policy: UploadPolicy): boolean;
 export declare function isFileKindAllowed(kind: FileKind, policy: UploadPolicy): boolean;
 export declare function isFileUseAllowed(requestedUse: FileUse, allowedUses: NonEmptyArray<FileUse>): boolean;

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

@@ -2,5 +2,7 @@ import { type APIEndpoints } from '../../../../api/src/index';
 type BatchBody = NonNullable<APIEndpoints['batchBlockLoaders']['body']>;
 type BatchRequest = BatchBody['requests'][number];
 export type PreviewBatchableLoaderEndpoint = BatchRequest['endpoint'];
+export declare function isBatchableEndpoint(endpoint: string): endpoint is PreviewBatchableLoaderEndpoint;
+export declare function buildBatchLoaderRequest(id: string, endpoint: PreviewBatchableLoaderEndpoint, params: BatchRequest['params']): BatchRequest;
 export declare function toPreviewBatchParams(endpoint: PreviewBatchableLoaderEndpoint, params: Record<string, string>): BatchRequest['params'];
 export {};

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

@@ -52,6 +52,7 @@ type PreviewShellCommonProps = {
      */
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
     themeSelectionButtonStyleRepairs?: readonly ButtonStyleSelectionRepair[];
+    themeSelectionHeaderPreferences?: import('../../../../theme-core/src/site-styles/index').HeaderPreferences | null;
     themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderLogo?: HeaderLogoContext;

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

@@ -28,6 +28,7 @@ type PreviewShellLayoutCommonProps = {
     themeSelectionUpdatedAt?: string | null;
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
     themeSelectionButtonStyleRepairs?: readonly ButtonStyleSelectionRepair[];
+    themeSelectionHeaderPreferences?: import('../../../../theme-core/src/site-styles/index').HeaderPreferences | null;
     themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderLogo?: HeaderLogoContext;

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

@@ -1,7 +1,7 @@
 import React, { type ReactNode } from 'react';
 import { type ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
-import type { BrandDisplayMode, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderInteractionPalettePreference, HeaderLogoContext, LogoSizePolicy, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
+import type { BrandDisplayMode, HeaderNavFontSizePreference, HeaderPreferences, HeaderNavTypographyPreference, HeaderInteractionPalettePreference, HeaderLogoContext, LogoSizePolicy, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
 import { type StyleConfiguratorHistoryEntry } from './StyleConfigurator.state';
 import type { SiteStyleAccess } from './siteStyleAccess';
 import { type StyleConfiguratorInitialSelections } from './styleConfiguratorSnapshot';
@@ -63,6 +63,7 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     siteId: string;
     apiClient: ApiClient;
     theme?: Theme | null;
+    headerPreferences?: HeaderPreferences | null;
     themeId?: string | null;
     selectionId?: string | null;
     selectionVersion?: number | null;
@@ -72,5 +73,5 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     siteStyleAccess?: SiteStyleAccess;
     canOpenDesignEditor?: boolean;
 }>;
-export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerLogoContext, siteStyleAccess, canOpenDesignEditor, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
+export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, headerPreferences, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerLogoContext, siteStyleAccess, canOpenDesignEditor, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
 export declare function useSiteChromeCustomizeOptional(): SiteChromeCustomizeContextValue | null;

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

@@ -1,5 +1,6 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { BrandDisplayMode, HeaderBrandPreferences, HeaderLogoContext, LogoSizePolicy } from '../../../../theme-core/src/site-styles/index';
+export { withHeaderBrandThemePreferences } from '../../../../theme-core/src/site-styles/index';
 export type { HeaderBrandPreferences } from '../../../../theme-core/src/site-styles/index';
 export type HeaderBrandDisplayOption = Readonly<{
     value: BrandDisplayMode;
@@ -36,6 +37,5 @@ export declare function createHeaderBrandControlStateFromPreferences({ preferenc
 }): 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: HeaderLogoContext | undefined, preferences: HeaderBrandPreferences): HeaderLogoContext | undefined;
 export declare function hasLogoInHeaderLogoContext(context: HeaderLogoContext | undefined): boolean;

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

@@ -70,6 +70,8 @@ export type SiteChromeQuickControlReplayPlan = Readonly<{
     preferences: HeaderNavPreferences;
 }> | Readonly<{
     kind: 'background-preferences';
+    /** Which surface's background this replays — the save needs it (#1318 Phase 4d). */
+    surface: 'header' | 'footer';
     preferences: SiteChromeBackgroundPreferences;
 }>;
 export type SiteChromeQuickControlHistoryMutation = Readonly<{

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

@@ -0,0 +1,51 @@
+import type { HeaderNavPreferences, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { SelectionSnapshot } from './StyleConfigurator.state';
+import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
+import type { HeaderBrandPreferences } from './siteChromeBrandPreferences';
+import { type SiteChromeQuickControlBackgroundTarget, type SiteChromeQuickControlBrandTarget, type SiteChromeQuickControlHistoryMutation, type SiteChromeQuickControlNavTarget, type SiteChromeQuickControlReplayPlan, type SiteChromeQuickControlSelectionTarget } from './siteChromeQuickControlHistoryState';
+export type SiteChromeQuickControlPendingMutation = Extract<SiteChromeQuickControlHistoryMutation, {
+    kind: 'undoing' | 'redoing';
+}>;
+type ConfirmMutation = Readonly<{
+    kind: 'confirm-mutation';
+    mutation: SiteChromeQuickControlPendingMutation;
+}>;
+type History<TTarget> = ConfirmMutation | Readonly<{
+    kind: 'record';
+    target: TTarget;
+}>;
+/**
+ * What one quick-control save is asking for.
+ *
+ * `surface` travels with the requests that can name one. It has to, from
+ * #1318 Phase 4d: a header save carries no theme any more, so a footer
+ * background change sent under the header surface would have nowhere to be
+ * written.
+ */
+export type SiteChromeQuickControlSaveRequest = Readonly<{
+    kind: 'selection';
+    surface: SiteChromeEditableSurfaceKind;
+    selection: SelectionSnapshot;
+    history: History<SiteChromeQuickControlSelectionTarget>;
+}> | Readonly<{
+    kind: 'brand-preferences';
+    preferences: HeaderBrandPreferences;
+    history: History<SiteChromeQuickControlBrandTarget>;
+}> | Readonly<{
+    kind: 'background-preferences';
+    surface: SiteChromeEditableSurfaceKind;
+    preferences: SiteChromeBackgroundPreferences;
+    history: History<SiteChromeQuickControlBackgroundTarget>;
+}> | Readonly<{
+    kind: 'nav-preferences';
+    preferences: HeaderNavPreferences;
+    history: History<SiteChromeQuickControlNavTarget>;
+}>;
+/**
+ * Which surface a save is for. Selection and background changes name their own;
+ * the brand and nav controls only ever edit the header.
+ */
+export declare function saveRequestSurface(request: SiteChromeQuickControlSaveRequest): SiteChromeEditableSurfaceKind;
+/** Replaying an undo or redo is the same save, with a confirmation attached. */
+export declare function saveRequestFromQuickControlReplayPlan(plan: SiteChromeQuickControlReplayPlan, mutation: SiteChromeQuickControlPendingMutation): SiteChromeQuickControlSaveRequest;
+export {};

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 { HeaderNavPreferences, HeaderLogoContext, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { HeaderNavPreferences, HeaderLogoContext, HeaderPreferences, 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';
@@ -25,8 +25,30 @@ export type BuildSiteChromeSavePlanInput = Readonly<{
     themeId: string | null;
     selectionId: string | null;
     baseSelectionUpdatedAt: string | null;
+    /** Persisted intent, including the structural fields quick controls cannot edit. */
+    persistedHeaderPreferences: HeaderPreferences;
 }>;
-export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerLogoContext, headerBrandPreferences, headerNavPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
+export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerLogoContext, headerBrandPreferences, headerNavPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, persistedHeaderPreferences, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
+/**
+ * The nav half of the record the server persisted, read back rather than
+ * re-derived from the saved bytes. The theme is compiled output from 4b
+ * onward; the record is the intent, so it is the better answer to "what is the
+ * control set to". Falls back to the bytes while the column is still absent on
+ * a row the Phase 4c backfill has not reached.
+ */
+export declare function headerNavPreferencesFromSiteChromeSaveResponse(saved: SaveSiteChromeSelectionResponse): HeaderNavPreferences;
+/**
+ * The header half comes from the persisted record; the footer half has no
+ * entry in `HeaderPreferences` and stays derived from the saved theme.
+ */
+export declare function backgroundPreferencesFromSiteChromeSaveResponse(saved: SaveSiteChromeSelectionResponse): SiteChromeBackgroundPreferences;
+/**
+ * The brand half of the record the server persisted. Same rule as the nav and
+ * background halves: the record is the intent, the saved theme is compiled
+ * output, so the controls read the record when there is one and fall back to
+ * the bytes while the Phase 4c backfill is outstanding.
+ */
+export declare function headerBrandPreferencesFromSiteChromeSaveResponse(saved: SaveSiteChromeSelectionResponse, headerLogoContext: HeaderLogoContext | undefined): HeaderBrandPreferences;
 export declare function siteChromeSavePlanBodyForBaseRevision(plan: SiteChromeSavePlan, baseSelectionUpdatedAt: string | null): SaveSiteChromeSelectionBody;
 export declare function selectionSnapshotFromSiteChromeSaveResponse({ saved, fallback, savePlan, }: Readonly<{
     saved: SaveSiteChromeSelectionResponse;

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

@@ -1,6 +1,6 @@
 import type { Theme } from '../../../../blocks/src/index';
 import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
-import type { FooterLookId, HeaderLayoutId, HeaderLogoContext, HeaderStyleId, SiteChromeSurface } from '../../../../theme-core/src/site-styles/index';
+import type { HeaderBrandPresentationPreference, FooterLookId, HeaderLayoutId, HeaderLogoContext, HeaderStyleId, SiteChromeSurface } from '../../../../theme-core/src/site-styles/index';
 import { type CuratedSiteStyle, type SelectionFallbackWarning, type SiteThemeSelectionsResult, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
 export type SiteStylePreviewSelection = Readonly<{
     siteStyleId: SiteStyleId;
@@ -20,6 +20,16 @@ type SiteStylePreviewPlanCommonInput = Readonly<{
     siteStyle: CuratedSiteStyle;
     selection: SiteStylePreviewSelection;
     headerLogoContext?: HeaderLogoContext;
+    /**
+     * The row's brand-presentation mode, which the preview must honour or it
+     * renders a treatment the save will not persist (#1318 D24).
+     *
+     * Required, with no default, so a caller that does not hold the record has to
+     * say `'recommended'` in its own source rather than inherit it invisibly.
+     * That is the difference between a stated assumption and a silent one, and
+     * the assumption is wrong for exactly the rows D24 exists for.
+     */
+    headerBrandPresentation: HeaderBrandPresentationPreference;
 }>;
 export type SiteStylePreviewPlanInput = SiteStylePreviewPlanCommonInput & (Readonly<{
     compilation: Readonly<{
@@ -42,4 +52,16 @@ export declare function deriveSiteStylePreviewUpdate(baseTheme: Theme | null | u
     kind: 'derive-update';
 }>;
 export declare function planSiteStylePreviewChange(input: SiteStylePreviewPlanInput): SiteStylePreviewPlan;
+/**
+ * The configurator's previews, with the one assumption they make written down
+ * once instead of four times.
+ *
+ * `planSiteStylePreviewChange` requires the brand-presentation mode (#1318 D24)
+ * so that no caller inherits it invisibly. Nothing hands the site-style
+ * configurator the row's persisted record yet, so it states `'recommended'` —
+ * correct for every row except a `'plain'` one, where the preview is a round
+ * trip behind until the first save teaches it otherwise. The plan's closing
+ * checklist has what closing that costs.
+ */
+export declare function planConfiguratorPreview(input: SiteStylePreviewPlanInput extends infer TInput ? TInput extends unknown ? Omit<TInput, 'headerBrandPresentation'> : never : never): SiteStylePreviewPlan;
 export {};

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

@@ -0,0 +1,8 @@
+import { type RefObject } from 'react';
+import type { Theme } from '../../../../blocks/src/index';
+import { type HeaderLogoContext, type HeaderPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { SelectionSnapshot } from './StyleConfigurator.state';
+import type { SiteChromeCustomizeProviderProps } from './SiteChromeCustomizeContext';
+/** Keep the row-owned intent across optimistic edits and server responses. */
+export declare function usePersistedHeaderPreferences(stored: HeaderPreferences | null, theme: Theme | null | undefined, selection: SelectionSnapshot | null, logo: HeaderLogoContext | undefined): RefObject<HeaderPreferences>;
+export declare function useSiteChromeInitialSnapshot({ theme, initialSelections, selectionVersion, selectionUpdatedAt, headerLogoContext, }: Pick<SiteChromeCustomizeProviderProps, 'theme' | 'initialSelections' | 'selectionVersion' | 'selectionUpdatedAt' | 'headerLogoContext'>): SelectionSnapshot | null;

package/dist/_dts/sdk/src/client/{eventSubrouteReadOperations.d.ts → publicEventReadOperations.d.ts}

@@ -1,11 +1,12 @@
 import type { ApiClient, ApiResult } from '../../../api/src/public/index';
 import type { RiverbankClient } from './types';
-type EventSubrouteReadDeps = Readonly<{
+type PublicEventReadDeps = Readonly<{
     apiClient: ApiClient;
     resilientFetchData: <T>(cacheKey: string, fetcher: (signal: AbortSignal) => Promise<ApiResult<T>>, options: Readonly<{
         signal?: AbortSignal;
+        force?: boolean;
     }>) => Promise<T>;
 }>;
-type EventSubrouteReadOperations = Pick<RiverbankClient, 'resolveEventOccurrence' | 'resolveEventRun'>;
-export declare function createEventSubrouteReadOperations(deps: EventSubrouteReadDeps): EventSubrouteReadOperations;
+type PublicEventReadOperations = Pick<RiverbankClient, 'resolveEventOccurrence' | 'resolveEventRun' | 'listPublicEventCalendarWindow'>;
+export declare function createPublicEventReadOperations(deps: PublicEventReadDeps): PublicEventReadOperations;
 export {};

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

@@ -1,7 +1,8 @@
-import type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicEventsResponse, PublicWholeSeriesOfferingResponse, ResolveEventOccurrenceResponse, ResolveEventRunResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, PublicProductCategorySelector } from '../public-api/contracts';
+import type { CalendarWindowRequest, CalendarWindowPage } from '../../../blocks/src/contracts/index';
+import type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicEventsResponse, ResolveEventOccurrenceResponse, ResolveEventRunResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, PublicProductCategorySelector } from '../public-api/contracts';
 import type { PublishedRuntimeCacheAdapter, PublishedRuntimeCacheAdapterErrorKind } from './runtimeCachePolicy';
 import type { EventPageSurfaceSubjectRefWire } from '../../../core/src/index';
-export type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicEventsResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, PublicWholeSeriesOfferingResponse, ResolveEventOccurrenceResponse, ResolveEventRunResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, } from '../public-api/contracts';
+export type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityResponse, PublicEventsResponse, PublicFormResponse, PublicFormsResponse, PublicProductsResponse, PublicTeamMembersResponse, PublicMembershipsResponse, PublicPassesResponse, PublicEventDetailsResponse, ResolveEventOccurrenceResponse, ResolveEventRunResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, } from '../public-api/contracts';
 /**
  * Pagination metadata returned when `includeMeta: true`
  */
@@ -470,6 +471,9 @@ export interface RiverbankClient {
     /**
      * List public events for a site (optionally time-filtered)
      */
+    listPublicEventCalendarWindow(params: {
+        siteId: string;
+    } & CalendarWindowRequest & SdkMethodOptions): Promise<CalendarWindowPage>;
     listPublicEvents(params: {
         siteId: string;
         limit?: number;
@@ -513,14 +517,6 @@ export interface RiverbankClient {
         seriesId?: string;
         includeOccurrenceId?: string;
     } & SdkMethodOptions): Promise<PublicEventDetailsResponse>;
-    /**
-     * Fetch one whole-series offering for a registration surface.
-     */
-    getPublicWholeSeriesOffering(params: {
-        siteId: string;
-        eventSeriesId: string;
-        stage?: string;
-    } & SdkMethodOptions): Promise<PublicWholeSeriesOfferingResponse>;
     /**
      * List public team members for a site (for Team Members block)
      */

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", "listPublicRecurringSchedule", "getPublicEventDetails", "listPublicWholeSeriesOfferings", "getPublicWholeSeriesOffering", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
+export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "listPublicEventCalendarWindow", "listPublicRecurringSchedule", "getPublicEventDetails", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
 export type SdkLoaderEndpoint = (typeof SUPPORTED_LOADER_ENDPOINTS)[number];
 export type LoaderParamBinding = {
     $bind: {

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

@@ -136,9 +136,9 @@ export declare const sdkLoaderEndpointSchema: z.ZodEnum<{
     listPublishedEntries: "listPublishedEntries";
     getPublishedEntryPreview: "getPublishedEntryPreview";
     listPublicEvents: "listPublicEvents";
+    listPublicEventCalendarWindow: "listPublicEventCalendarWindow";
     listPublicRecurringSchedule: "listPublicRecurringSchedule";
     getPublicEventDetails: "getPublicEventDetails";
-    getPublicWholeSeriesOffering: "getPublicWholeSeriesOffering";
     listPublicRouteCandidates: "listPublicRouteCandidates";
     listPublicTeamMembers: "listPublicTeamMembers";
     listPublicProducts: "listPublicProducts";
@@ -226,9 +226,9 @@ export declare const sdkConfigLoaderSchema: z.ZodObject<{
         listPublishedEntries: "listPublishedEntries";
         getPublishedEntryPreview: "getPublishedEntryPreview";
         listPublicEvents: "listPublicEvents";
+        listPublicEventCalendarWindow: "listPublicEventCalendarWindow";
         listPublicRecurringSchedule: "listPublicRecurringSchedule";
         getPublicEventDetails: "getPublicEventDetails";
-        getPublicWholeSeriesOffering: "getPublicWholeSeriesOffering";
         listPublicRouteCandidates: "listPublicRouteCandidates";
         listPublicTeamMembers: "listPublicTeamMembers";
         listPublicProducts: "listPublicProducts";
@@ -293,9 +293,9 @@ export declare const sdkDataLoadersSchema: z.ZodOptional<z.ZodRecord<z.ZodString
         listPublishedEntries: "listPublishedEntries";
         getPublishedEntryPreview: "getPublishedEntryPreview";
         listPublicEvents: "listPublicEvents";
+        listPublicEventCalendarWindow: "listPublicEventCalendarWindow";
         listPublicRecurringSchedule: "listPublicRecurringSchedule";
         getPublicEventDetails: "getPublicEventDetails";
-        getPublicWholeSeriesOffering: "getPublicWholeSeriesOffering";
         listPublicRouteCandidates: "listPublicRouteCandidates";
         listPublicTeamMembers: "listPublicTeamMembers";
         listPublicProducts: "listPublicProducts";

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

@@ -210,6 +210,11 @@ export type EventSpotlightContent = {
     emptyMessage?: string | null;
     _sectionStyles?: SectionStylesContent;
 };
+/**
+ * Authored (persisted) block values. `'course'` selects whole-series Events;
+ * it is stored in published page content, so it stays as the authored value and
+ * is normalised to the `wholeSeries` runtime source when the block is parsed.
+ */
 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' | 'featured-summary';

package/dist/_dts/sdk/src/data/prefetchBlockData.d.ts

@@ -13,9 +13,8 @@ export type PrefetchContext = {
     root?: Record<string, unknown>;
 };
 export type ResolvedBlockData = Record<string, Record<string, unknown>>;
-type SdkSupportedLoaderEndpoint = Exclude<SupportedLoaderEndpoint, 'listPublicWholeSeriesOfferings'>;
-export declare const SUPPORTED_LOADER_ENDPOINTS: SdkSupportedLoaderEndpoint[];
-export type { SdkSupportedLoaderEndpoint as SupportedLoaderEndpoint };
+export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "listPublicEventCalendarWindow", "listPublicRecurringSchedule", "getPublicEventDetails", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
+export type { SupportedLoaderEndpoint };
 /**
  * Options for SDK block data prefetching.
  */