@riverbankcms/sdk 0.135.1 → 0.137.0

package/dist/_dts/core/src/slug.d.ts

@@ -1,15 +1,30 @@
+export type SlugifyOptions = Readonly<{
+    /**
+     * Treat `/` as a path separator: each segment is slugified independently and
+     * empty segments are dropped, so `Blog / My Post` becomes `blog/my-post`.
+     */
+    preserveSegments?: boolean;
+    /** Truncate the finished slug to at most this many characters. */
+    maxLength?: number;
+}>;
 /**
- * Convert a string to a URL-safe slug
+ * Convert a string to a URL-safe slug.
  *
- * @param text - The text to slugify
- * @returns URL-safe slug (lowercase, alphanumeric + hyphens)
+ * Every non-alphanumeric character (underscores included) is a separator and
+ * collapses to a single hyphen, which keeps output inside the `site_routes`
+ * slug constraint `^[a-z0-9]+([a-z0-9\-/]*[a-z0-9])?$`.
+ *
+ * This is the single slug implementation for the monorepo: block-form and the
+ * shop admin catalog delegate here rather than keeping their own variants.
  *
  * @example
  * slugify("Initial Consultation") // "initial-consultation"
- * slugify("90-Minute Deep Tissue") // "90-minute-deep-tissue"
  * slugify("Reiki & Energy Healing") // "reiki-energy-healing"
+ * slugify("Don't Stop") // "dont-stop"
+ * slugify("draft_post") // "draft-post"
+ * slugify("Blog / My Post", { preserveSegments: true }) // "blog/my-post"
  */
-export declare function slugify(text: string): string;
+export declare function slugify(text: string, options?: SlugifyOptions): string;
 /**
  * Generate a unique slug by appending a number if needed
  *

package/dist/_dts/db/src/generated/supabase/database.types.d.ts

@@ -15968,6 +15968,7 @@ export type Database = {
                     created_at: string;
                     footer_look_id: string | null;
                     header_layout_id: string;
+                    header_preferences: Json | null;
                     header_style_id: string;
                     id: string;
                     is_current: boolean;
@@ -15984,6 +15985,7 @@ export type Database = {
                     created_at?: string;
                     footer_look_id?: string | null;
                     header_layout_id: string;
+                    header_preferences?: Json | null;
                     header_style_id: string;
                     id?: string;
                     is_current?: boolean;
@@ -16000,6 +16002,7 @@ export type Database = {
                     created_at?: string;
                     footer_look_id?: string | null;
                     header_layout_id?: string;
+                    header_preferences?: Json | null;
                     header_style_id?: string;
                     id?: string;
                     is_current?: boolean;
@@ -18422,6 +18425,7 @@ export type Database = {
                     p_button_style_options: Json;
                     p_footer_look_id?: string;
                     p_header_layout_id: string;
+                    p_header_preferences?: Json;
                     p_header_style_id: string;
                     p_selection_id?: string;
                     p_site_id: string;
@@ -20282,6 +20286,7 @@ export type Database = {
                     p_button_style_options: Json;
                     p_footer_look_id?: string;
                     p_header_layout_id: string;
+                    p_header_preferences?: Json;
                     p_header_style_id: string;
                     p_site_id: string;
                     p_theme: Json;
@@ -20293,34 +20298,10 @@ export type Database = {
                     theme_id: string;
                 }[];
             };
-            publish_authoritative_page_surface_content_guarded: {
+            publish_authoritative_page_surface_v2: {
                 Args: {
-                    p_expected_draft_version_id: string;
-                    p_expected_published_version_id: string;
-                    p_expected_source_data: Json;
-                    p_expected_source_updated_at: string;
-                    p_expected_source_version_id: string;
-                    p_owner_id: string;
-                    p_owner_kind: Database["public"]["Enums"]["content_owner_kind"];
-                    p_published_data: Json;
-                    p_site_id: string;
-                    p_source_kind: string;
-                    p_user_id: string;
-                };
-                Returns: Json;
-            };
-            publish_authoritative_surface_slot_snapshot_guarded: {
-                Args: {
-                    p_blocks: Json;
-                    p_expected_draft_version_id: string;
-                    p_expected_published_version_id: string;
-                    p_expected_source_data: Json;
-                    p_expected_source_updated_at: string;
-                    p_expected_source_version_id: string;
                     p_page_surface_id: string;
                     p_site_id: string;
-                    p_source_kind: string;
-                    p_surface_slot_id: string;
                     p_user_id: string;
                 };
                 Returns: Json;
@@ -20661,6 +20642,7 @@ export type Database = {
                     p_expected_selection_version: number;
                     p_footer_look_id?: string;
                     p_header_layout_id: string;
+                    p_header_preferences?: Json;
                     p_header_style_id: string;
                     p_selection_id?: string;
                     p_selection_overrides: Json;
@@ -21033,21 +21015,7 @@ export type Database = {
                     transition_outcome: string;
                 }[];
             };
-            transition_managed_event_availability_v1: {
-                Args: {
-                    p_event_offering_id: string;
-                    p_event_series_id?: string;
-                    p_expected_archived_at: string;
-                    p_expected_series_status?: string;
-                    p_first_live_at?: string;
-                    p_next_archived_at: string;
-                    p_next_series_status?: string;
-                    p_site_id: string;
-                    p_update_archive?: boolean;
-                };
-                Returns: boolean;
-            };
-            transition_managed_event_availability_v2: {
+            transition_managed_event_availability_v3: {
                 Args: {
                     p_command: Json;
                     p_event_offering_id: string;

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/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/EditablePageRenderer.d.ts

@@ -1,4 +1,4 @@
-import { PageRenderer } from '../../../../blocks/src/index';
+import { EditorPageRenderer as PageRenderer } from '../../../../blocks/src/index';
 import type { ApiClient as DashboardApiClient } from '../../../../api/src/request';
 import React, { type ComponentProps } from 'react';
 type PageRendererProps = ComponentProps<typeof PageRenderer>;

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/headerInteractionPaletteSurfaceState.d.ts

@@ -1,8 +1,9 @@
+import type { Theme } from '../../../../theme-core/src/data';
 import type { HeaderInteractionPalettePreference, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
 import { resolveHeaderInteractionPaletteControl } from '../../../../theme-core/src/site-styles/index';
 type HeaderInteractionPaletteSurfaceState = Readonly<{
     interactionPalette: ReturnType<typeof resolveHeaderInteractionPaletteControl>;
     diagnostics: readonly string[];
 }>;
-export declare function headerInteractionPaletteSurfaceState(styleId: HeaderStyleId, preference: HeaderInteractionPalettePreference): HeaderInteractionPaletteSurfaceState;
+export declare function headerInteractionPaletteSurfaceState(styleId: HeaderStyleId, preference: HeaderInteractionPalettePreference, theme: Pick<Theme, 'siteStyleId'> | null): HeaderInteractionPaletteSurfaceState;
 export {};

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/publicLoaderCacheAccess.d.ts

@@ -0,0 +1,6 @@
+import { type SupportedLoaderEndpoint } from '../../../blocks/src/system/data/index';
+export declare function shouldWrite(cacheEnabled: boolean, force: boolean | undefined): boolean;
+export declare function liveLoaderOptions(endpoint: SupportedLoaderEndpoint, signal: AbortSignal | undefined): Readonly<{
+    force: boolean;
+    signal: AbortSignal | undefined;
+}>;

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

@@ -1,6 +1,6 @@
 import type { AddressedLocationValue, BookingConsent, BusinessAddress } from '../../../core/src/index';
 import type { ResolvedInternalLinkEntityType } from '../../../blocks/src/index';
-import type { APIEndpoints, RoutableContentItem as ApiRoutableContentItem, SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject, SiteBySlugResponse as ApiSiteBySlugResponse, SiteBookingOfferingPresetSummary as ApiSiteBookingOfferingPresetSummary } from '../../../api/src/index';
+import type { APIEndpoints, RoutableContentItem as ApiRoutableContentItem, SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject, SiteBySlugResponse as ApiSiteBySlugResponse, SiteBookingOfferingPresetSummary as ApiSiteBookingOfferingPresetSummary, SdkBlockContentAdmission } from '../../../api/src/index';
 import type { MediaAssetIndexItem, SiteFooterContent, SiteHeaderContent } 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';
@@ -270,7 +270,8 @@ export type SiteRouteRecord = {
     publishedAt?: string | null;
 };
 export type SiteBookingOfferingPresetSummary = ApiSiteBookingOfferingPresetSummary;
-type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | 'selectionId' | 'selectionVersion' | 'selectionUpdatedAt' | 'selectionButtonStyleSelection' | 'selectionButtonStyleRepairs' | 'selectionHeaderSelection' | 'selectionFooterLookId'>;
+/** Keep the SDK's selection metadata aligned with the runtime response. */
+type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | Extract<keyof ApiSiteBySlugResponse, `selection${string}`>>;
 export type SiteResponse = SiteSelectionResponse & {
     site: {
         id: string;
@@ -295,6 +296,7 @@ export type SiteResponse = SiteSelectionResponse & {
     portalEnabled?: boolean;
     commerceEnabled?: boolean;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
+    bookingTimeZone?: string;
     analytics?: SiteAnalyticsSettingsPayload;
     privacyPolicy?: SiteRuntimePrivacyPolicy;
     routes: Record<string, SiteRouteRecord>;
@@ -337,6 +339,7 @@ export type SdkRuntimePage = {
         kind: string;
         purpose?: string;
         content: Record<string, unknown>;
+        admission?: SdkBlockContentAdmission;
     }>;
     runtimeBoundaries?: readonly CompiledBoundaryRuntime<string>[];
 };
@@ -361,6 +364,7 @@ export type SdkEntrySlotContent = {
         purpose: string;
         orderIndex?: number | null;
         content: Record<string, unknown> | null;
+        admission?: SdkBlockContentAdmission;
     }>;
 };
 export type SdkSurfaceSlotContent = {
@@ -380,6 +384,7 @@ export type SdkSurfaceSlotContent = {
         publishedContent?: unknown;
         draftContentId?: string | null;
         publishedContentId?: string | null;
+        admission?: SdkBlockContentAdmission;
     }>;
 };
 export type SdkRuntimePageSurfaceSubject = ApiSdkRuntimePageSurfaceSubject;

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

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import type { RenderablePageOutline as BlocksRenderablePageOutline } from '../../../blocks/src/index';
 import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, PageRuntimeBoundary, ResolveImageUrlContextInput, RouteMap, Theme, ThemeTokens } from '../contracts';
 import type { SdkCustomBlock } from '../config/types';
 import type { BlockOverrides } from './overrides';
@@ -6,6 +7,7 @@ import type { SiteBookingOfferingPresetSummary } from '../public-api/contracts';
 import { type BlocksImageResolveContextInput, type BlocksMediaAssetIndexItem } from './mediaAssets';
 import type { EventPageSurfaceSubjectWire } from '../../../core/src/index';
 export type ComponentRegistry = Record<string, React.ElementType>;
+export type RenderablePageOutline = BlocksRenderablePageOutline;
 export type MissingBlockOverrideError = Error & Readonly<{
     code: 'missing_block_override';
     blockKind: string;
@@ -20,6 +22,7 @@ export type PageRendererDataContext = {
     pageId?: string;
     resolvedData?: Record<string, Record<string, unknown>>;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
+    bookingTimeZone?: string;
     previewStage?: 'published' | 'preview';
     routes?: RouteMap;
     pagesByIdentifier?: Record<string, string>;
@@ -45,10 +48,9 @@ export type BlocksPageRendererDataContext = Omit<PageRendererDataContext, 'media
 export type SdkConfigForRenderer = {
     customBlocks?: SdkCustomBlock[];
 };
-type PageRendererCommonProps = {
-    page: PageOutline | null;
+type PageRendererCommonProps<TPage> = {
+    page: TPage | null;
     runtimeBoundaries?: readonly PageRuntimeBoundary[];
-    usePlaceholders?: boolean;
     dataContext?: PageRendererDataContext;
     routeMap?: RouteMap;
     wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
@@ -57,12 +59,12 @@ type PageRendererCommonProps = {
     sdkConfig?: SdkConfigForRenderer | null;
     customBlocks?: SdkCustomBlock[];
 };
-type ThemedPageRendererProps = PageRendererCommonProps & {
+type ThemedPageRendererProps<TPage> = PageRendererCommonProps<TPage> & {
     rendering?: never;
     theme: Theme;
     themeTokens?: ThemeTokens;
 };
-type OverrideOnlyPageRendererProps = PageRendererCommonProps & {
+type OverrideOnlyPageRendererProps<TPage> = PageRendererCommonProps<TPage> & {
     rendering: {
         kind: 'overrides-only';
     };
@@ -70,7 +72,9 @@ type OverrideOnlyPageRendererProps = PageRendererCommonProps & {
     themeTokens?: never;
     blockOverrides: BlockOverrides;
 };
-export type PageRendererProps = ThemedPageRendererProps | OverrideOnlyPageRendererProps;
+export type PageRendererProps = ThemedPageRendererProps<BlocksRenderablePageOutline> | OverrideOnlyPageRendererProps<BlocksRenderablePageOutline>;
+export type EditorPageRendererProps = ThemedPageRendererProps<PageOutline> | OverrideOnlyPageRendererProps<PageOutline>;
 export declare function toBlocksPageRendererDataContext(dataContext: PageRendererDataContext): BlocksPageRendererDataContext;
 export declare function PageRenderer(props: PageRendererProps): React.ReactElement;
+export declare function EditorPageRenderer(props: EditorPageRendererProps): React.ReactElement;
 export {};

package/dist/_dts/sdk/src/rendering/components/Block.shared.d.ts

@@ -43,7 +43,6 @@ type BlockCommonProps = {
     pageId?: string;
     previewStage?: 'published' | 'preview';
     client?: RiverbankClient;
-    usePlaceholders?: boolean;
     /**
      * Custom component to override default block rendering. When provided, renders
      * this component instead of the manifest-based default. Override components

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

@@ -1,19 +1,20 @@
 import type { ReactElement } from 'react';
-import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, PageRuntimeBoundary, RouteMap, Theme, ThemeTokens } from '../../contracts';
+import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageRuntimeBoundary, RouteMap, Theme, ThemeTokens } from '../../contracts';
 import type { ResolvedBlockData } from '../../data';
 import type { SiteBookingOfferingPresetSummary } from '../../public-api/contracts';
 import type { RuntimeSdkConfig } from '../helpers/loadPage';
-import { type ComponentRegistry } from '../blocks-page-renderer';
+import { type ComponentRegistry, type RenderablePageOutline } from '../blocks-page-renderer';
 import { type SdkThemeRuntime } from '../themeRuntime';
 import type { BlockOverrides } from '../overrides';
 import type { SdkCustomBlock } from '../../config/types';
 import type { SdkRenderingMode } from '../renderingMode';
 type PageCommonProps = {
-    page: PageOutline;
+    page: RenderablePageOutline;
     runtimeBoundaries?: readonly PageRuntimeBoundary[];
     siteId: string;
     resolvedData?: ResolvedBlockData;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
+    bookingTimeZone?: string;
     routeMap?: RouteMap;
     /** Page identifier to routeId lookup for { kind: 'page' } CTA links */
     pagesByIdentifier?: Record<string, string>;
@@ -75,7 +76,6 @@ type PageCommonProps = {
     };
     wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
     registry?: ComponentRegistry;
-    usePlaceholders?: boolean;
     /**
      * Custom components to override default block rendering.
      * Keys can be full block kind ("block.hero") or short form ("hero").

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

@@ -0,0 +1,3 @@
+import type { SiteResponse } from '../../client/types';
+import type { SiteFooterBlock } from '../../public-api/contracts';
+export declare function buildFooterRenderablePageOutline(siteData: SiteResponse, blocks: readonly SiteFooterBlock[]): import("../../../../blocks/src/index").RenderablePageOutline;

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

@@ -111,6 +111,7 @@ export type PageContentResult = {
     resolvedData: ResolvedBlockData;
     /** Selected booking offering presets exposed to SSR blocks. */
     bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
+    bookingTimeZone?: string;
     /** Site data for metadata generation */
     site: SiteData;
     /**
@@ -146,6 +147,7 @@ export type EntryContentResult = {
     resolvedData: ResolvedBlockData;
     /** Selected booking offering presets exposed to SSR blocks. */
     bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
+    bookingTimeZone?: string;
     /** Data context for template blocks (includes entry content for bindings) */
     dataContext: {
         contentEntry: Record<string, unknown>;
@@ -209,6 +211,7 @@ export type PageSurfaceContentResult = {
     templatePage: PageProps['page'] | null;
     resolvedData: ResolvedBlockData;
     bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
+    bookingTimeZone?: string;
     dataContext: {
         pageSurface: Record<string, unknown>;
         subject: PageSurfaceContentData['subject'];

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

@@ -79,7 +79,7 @@ export type LoadPageParams = {
      */
     searchParams?: DataLoaderSearchParams;
 };
-export type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'usePlaceholders' | 'blockOverrides' | 'sdkConfig'> & {
+export type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'blockOverrides' | 'sdkConfig'> & {
     /**
      * SDK site configuration, if available.
      * Contains SDK-defined theme palette, section backgrounds, and style options.