@riverbankcms/sdk 0.143.0 → 0.145.0

package/dist/_dts/db/src/schemas/forms.d.ts

@@ -944,10 +944,175 @@ export type FormSlug = string & {
     readonly [formSlugBrand]: 'FormSlug';
 };
 export declare const formSlugSchema: z.ZodPipe<z.ZodString, z.ZodTransform<FormSlug, string>>;
+/**
+ * A form's fields as sent to the Forms API: the generic contract, or the
+ * booking-questions contract (which adds file uploads). Which one a form may
+ * use depends on its type, which the service checks — on update the type
+ * lives on the stored form, not the request.
+ */
+export declare const formPayloadFieldsSchema: z.ZodUnion<readonly [z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    fields: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            date: "date";
+            time: "time";
+            text: "text";
+            email: "email";
+            url: "url";
+            textarea: "textarea";
+            select: "select";
+            checkbox: "checkbox";
+            radio: "radio";
+            tel: "tel";
+            consent: "consent";
+        }>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        helpText: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>>;
+        multiple: z.ZodOptional<z.ZodBoolean>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        pattern: z.ZodOptional<z.ZodString>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        layout: z.ZodOptional<z.ZodObject<{
+            width: z.ZodDefault<z.ZodEnum<{
+                full: "full";
+                half: "half";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        helpText: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>>;
+        multiple: z.ZodOptional<z.ZodBoolean>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        pattern: z.ZodOptional<z.ZodString>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        layout: z.ZodOptional<z.ZodObject<{
+            width: z.ZodDefault<z.ZodEnum<{
+                full: "full";
+                half: "half";
+            }>>;
+        }, z.core.$strict>>;
+        type: z.ZodEnum<{
+            number: "number";
+            date: "date";
+            time: "time";
+            text: "text";
+            email: "email";
+            url: "url";
+            textarea: "textarea";
+            select: "select";
+            checkbox: "checkbox";
+            radio: "radio";
+            tel: "tel";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodLiteral<"document_upload">;
+        required: z.ZodDefault<z.ZodBoolean>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        helpText: z.ZodOptional<z.ZodString>;
+        layout: z.ZodOptional<z.ZodObject<{
+            width: z.ZodDefault<z.ZodEnum<{
+                full: "full";
+                half: "half";
+            }>>;
+        }, z.core.$strict>>;
+        allowedFileTypes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            image: "image";
+            pdf: "pdf";
+            docx: "docx";
+        }>>>;
+        maxBytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>], "type">>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    sections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            helpText: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>>>;
+            multiple: z.ZodOptional<z.ZodBoolean>;
+            minLength: z.ZodOptional<z.ZodNumber>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            pattern: z.ZodOptional<z.ZodString>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            layout: z.ZodOptional<z.ZodObject<{
+                width: z.ZodDefault<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                }>>;
+            }, z.core.$strict>>;
+            type: z.ZodEnum<{
+                number: "number";
+                date: "date";
+                time: "time";
+                text: "text";
+                email: "email";
+                url: "url";
+                textarea: "textarea";
+                select: "select";
+                checkbox: "checkbox";
+                radio: "radio";
+                tel: "tel";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodLiteral<"document_upload">;
+            required: z.ZodDefault<z.ZodBoolean>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            helpText: z.ZodOptional<z.ZodString>;
+            layout: z.ZodOptional<z.ZodObject<{
+                width: z.ZodDefault<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                }>>;
+            }, z.core.$strict>>;
+            allowedFileTypes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                image: "image";
+                pdf: "pdf";
+                docx: "docx";
+            }>>>;
+            maxBytes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>>;
+}, z.core.$strict>]>]>;
 export declare const createFormPayloadSchema: z.ZodObject<{
     name: z.ZodString;
     slug: z.ZodPipe<z.ZodString, z.ZodTransform<FormSlug, string>>;
-    schema: z.ZodObject<{
+    schema: z.ZodUnion<readonly [z.ZodObject<{
         version: z.ZodDefault<z.ZodString>;
         fields: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -986,7 +1151,126 @@ export declare const createFormPayloadSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
-    }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
+        version: z.ZodDefault<z.ZodString>;
+        fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            helpText: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>>>;
+            multiple: z.ZodOptional<z.ZodBoolean>;
+            minLength: z.ZodOptional<z.ZodNumber>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            pattern: z.ZodOptional<z.ZodString>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            layout: z.ZodOptional<z.ZodObject<{
+                width: z.ZodDefault<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                }>>;
+            }, z.core.$strict>>;
+            type: z.ZodEnum<{
+                number: "number";
+                date: "date";
+                time: "time";
+                text: "text";
+                email: "email";
+                url: "url";
+                textarea: "textarea";
+                select: "select";
+                checkbox: "checkbox";
+                radio: "radio";
+                tel: "tel";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodLiteral<"document_upload">;
+            required: z.ZodDefault<z.ZodBoolean>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            helpText: z.ZodOptional<z.ZodString>;
+            layout: z.ZodOptional<z.ZodObject<{
+                width: z.ZodDefault<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                }>>;
+            }, z.core.$strict>>;
+            allowedFileTypes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                image: "image";
+                pdf: "pdf";
+                docx: "docx";
+            }>>>;
+            maxBytes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>, z.ZodObject<{
+        schemaVersion: z.ZodLiteral<2>;
+        sections: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                required: z.ZodDefault<z.ZodBoolean>;
+                placeholder: z.ZodOptional<z.ZodString>;
+                helpText: z.ZodOptional<z.ZodString>;
+                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodString;
+                }, z.core.$strict>>>;
+                multiple: z.ZodOptional<z.ZodBoolean>;
+                minLength: z.ZodOptional<z.ZodNumber>;
+                maxLength: z.ZodOptional<z.ZodNumber>;
+                pattern: z.ZodOptional<z.ZodString>;
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                layout: z.ZodOptional<z.ZodObject<{
+                    width: z.ZodDefault<z.ZodEnum<{
+                        full: "full";
+                        half: "half";
+                    }>>;
+                }, z.core.$strict>>;
+                type: z.ZodEnum<{
+                    number: "number";
+                    date: "date";
+                    time: "time";
+                    text: "text";
+                    email: "email";
+                    url: "url";
+                    textarea: "textarea";
+                    select: "select";
+                    checkbox: "checkbox";
+                    radio: "radio";
+                    tel: "tel";
+                }>;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                type: z.ZodLiteral<"document_upload">;
+                required: z.ZodDefault<z.ZodBoolean>;
+                placeholder: z.ZodOptional<z.ZodString>;
+                helpText: z.ZodOptional<z.ZodString>;
+                layout: z.ZodOptional<z.ZodObject<{
+                    width: z.ZodDefault<z.ZodEnum<{
+                        full: "full";
+                        half: "half";
+                    }>>;
+                }, z.core.$strict>>;
+                allowedFileTypes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    image: "image";
+                    pdf: "pdf";
+                    docx: "docx";
+                }>>>;
+                maxBytes: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>], "type">>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>]>;
     settings: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"contact">;
         successMessage: z.ZodOptional<z.ZodString>;

package/dist/_dts/editor-blocks/src/block-editor/{BlockCardHeader.d.ts → BlockCardFrame.d.ts}

@@ -1,3 +1,4 @@
+import { type ReactNode } from 'react';
 import type { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
 import type { FieldWidgetComponent } from '../../../block-form/src/index';
 import { type SiteIconStyleGuideVersionId, type SystemBlockDefinition, type Theme } from '../../../blocks/src/index';
@@ -8,11 +9,15 @@ import { type GeneratedIconSetGenerateInput, type GeneratedIconSetGenerateResult
 import { type GeneratedIconApplyState } from './generatedIconApplyCoordination';
 /** Drag listener props from dnd-kit */
 type DragListeners = SyntheticListenerMap | undefined;
-type BlockCardHeaderStore = UiStore<GeneratedIconApplyState & Pick<UiSlice, 'focusRequest' | 'clearFocus'> & {
+type BlockCardFrameStore = UiStore<GeneratedIconApplyState & Pick<UiSlice, 'focusRequest' | 'clearFocus'> & {
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'initNewBlock' | 'updateBlockBaseline' | 'clearError' | 'setAtPath' | 'getAtPath'>;
     arrayKeys: ArrayKeysManager;
 }>;
-export declare function BlockCardHeader({ interactionReady, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, }: {
+/**
+ * One block in the block editor: the shared editor item card, with the
+ * block's own actions, dialogs and body.
+ */
+export declare function BlockCardFrame({ interactionReady, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, highlighted, children, }: {
     interactionReady: boolean;
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
@@ -27,7 +32,10 @@ export declare function BlockCardHeader({ interactionReady, block, manifest, isF
     collapsed: boolean;
     onToggleCollapsed: () => void;
     contentId?: string;
-    uiStore: BlockCardHeaderStore;
+    highlighted?: boolean;
+    /** The block's body, shown when expanded. */
+    children?: ReactNode;
+    uiStore: BlockCardFrameStore;
     /** Optional widget overrides for block customization form fields */
     widgetOverrides?: Record<string, FieldWidgetComponent>;
     theme?: Theme | null;

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

@@ -1,6 +1,12 @@
 import type { EditorBlockId, EditorBlockBaselineInput, EditorDraftBlockBaselineUpdateMetaInput, EditorDraftBlockInitMetaInput, EditorStructuralDraftSnapshot } from '../../../core/src/index';
 export type BlockItem = {
     id?: string | null;
+    /**
+     * The content version the block was loaded with. Runtime blocks that
+     * submit to the API (newsletter signup) cite it so the server can verify
+     * the placement; dropping it turns the form off in preview.
+     */
+    contentVersionId?: string | null;
     kind: string;
     content?: Record<string, unknown> | null;
     orderIndex?: number | null;

package/dist/_dts/editor-blocks/src/widgets/site-option-picker/loaders.d.ts

@@ -1,9 +1,10 @@
 import type { GetEndpoint, ApiClient } from '../../../../api/src/index';
 import type { SiteOptionSource } from '../../../../blocks/src/index';
-import type { SiteOptionWidgetAdapter, SiteOptionWidgetAdapters, SiteOptionWidgetItem } from './types';
+import type { SiteOptionSingleSelectionConfig, SiteOptionWidgetAdapter, SiteOptionWidgetAdapters, SiteOptionWidgetItem } from './types';
 type ListEventCategoriesResponse = NonNullable<GetEndpoint<'listEventCategories'>['response']>;
 type ListVenuesResponse = NonNullable<GetEndpoint<'listVenues'>['response']>;
 type ListAppointmentResourcesResponse = NonNullable<GetEndpoint<'listAppointmentResources'>['response']>;
+type ListAppointmentServiceCategoriesResponse = NonNullable<GetEndpoint<'listAppointmentServiceCategories'>['response']>;
 export type SiteOptionLoadItemsArgs = Readonly<{
     siteId: string;
     source: SiteOptionSource;
@@ -36,12 +37,19 @@ export declare const siteOptionWidgetLabels: {
         readonly empty: "No staff yet";
         readonly emptySelection: "Choose a staff member to restrict this block.";
     };
+    readonly appointmentServiceCategories: {
+        readonly loading: "Loading categories...";
+        readonly select: "All categories";
+        readonly empty: "No categories yet";
+        readonly emptySelection: "All categories";
+    };
 };
 export declare const siteOptionLoadFailureMessages: {
     readonly eventSeries: "We couldn't load your events. Please try again.";
     readonly eventCategories: "Failed to load event categories";
     readonly venues: "Failed to load venues";
     readonly staffMembers: "Failed to load staff members";
+    readonly appointmentServiceCategories: "Failed to load service categories";
 };
 export declare function mapEventCategoriesToSiteOptionItems(payload: ListEventCategoriesResponse): SiteOptionWidgetItem[];
 export declare function mapEventsToSiteOptionItems(events: readonly Readonly<{
@@ -65,6 +73,13 @@ export declare function mapEventsToSiteOptionItems(events: readonly Readonly<{
 }>[]): SiteOptionWidgetItem[];
 export declare function mapVenuesToSiteOptionItems(payload: ListVenuesResponse): SiteOptionWidgetItem[];
 export declare function mapStaffMembersToSiteOptionItems(payload: ListAppointmentResourcesResponse): SiteOptionWidgetItem[];
+export declare function mapAppointmentServiceCategoriesToSiteOptionItems(payload: ListAppointmentServiceCategoriesResponse): SiteOptionWidgetItem[];
+/**
+ * Sources whose single selection has an explicit default option and can go
+ * stale (issue 1403). Only appointment-service categories opt in: the event
+ * calendar pickers keep their existing behaviour.
+ */
+export declare const siteOptionSingleSelection: Partial<Readonly<Record<SiteOptionSource, SiteOptionSingleSelectionConfig>>>;
 export declare function loadSiteOptionItemsFromApi({ apiClient, siteId, source }: SiteOptionLoadItemsArgs & Readonly<{
     apiClient: ApiClient;
 }>): Promise<SiteOptionWidgetItem[]>;

package/dist/_dts/editor-blocks/src/widgets/site-option-picker/types.d.ts

@@ -11,10 +11,23 @@ export type SiteOptionWidgetSelectionLabelArgs = {
     items: readonly SiteOptionWidgetItem[];
 };
 export type SiteOptionWidgetAdapterLabels = PickerLabels;
+/**
+ * Opt-in behaviour for a single-select source. The empty value is offered as
+ * a named default option, and a stored value missing from the loaded options
+ * (it was deleted) shows `missingSelection.label` with its warning.
+ */
+export type SiteOptionSingleSelectionConfig = Readonly<{
+    defaultOptionLabel: string;
+    missingSelection: Readonly<{
+        label: string;
+        warning: string;
+    }>;
+}>;
 export type SiteOptionWidgetAdapter = {
     loadItems: (args: SiteOptionWidgetAdapterArgs) => Promise<SiteOptionWidgetItem[]>;
     renderManageLink?: (args: SiteOptionWidgetAdapterArgs) => ReactNode;
     formatSelectionLabel?: (args: SiteOptionWidgetSelectionLabelArgs) => string;
     labels?: SiteOptionWidgetAdapterLabels;
+    singleSelection?: SiteOptionSingleSelectionConfig;
 };
 export type SiteOptionWidgetAdapters = Record<SiteOptionSource, SiteOptionWidgetAdapter>;

package/dist/_dts/editor-blocks/src/widgets/site-option-picker/utils.d.ts

@@ -2,4 +2,33 @@ import { type SiteOptionSource } from '../../../../blocks/src/index';
 import type { SelectFieldConfig } from '../../../../block-form/src/index';
 export type SiteOptionValue = string | string[] | null | undefined;
 export declare function normalizeSiteOptionMultiValue(value: SiteOptionValue): string[];
+/**
+ * A single selection read against the loaded options.
+ *
+ * - `default`: nothing stored, so the source's default option applies.
+ * - `selected`: the stored value is one of the options.
+ * - `unresolved`: the options haven't loaded (or failed), so a stored value
+ *   can't be judged yet. It must not be reported as deleted.
+ * - `missing`: the options loaded and the stored value isn't among them, so
+ *   whatever it pointed at has been deleted.
+ */
+export type SiteOptionSingleSelectionState = Readonly<{
+    kind: 'default';
+}> | Readonly<{
+    kind: 'selected';
+    value: string;
+}> | Readonly<{
+    kind: 'unresolved';
+    value: string;
+}> | Readonly<{
+    kind: 'missing';
+    value: string;
+}>;
+export declare function resolveSiteOptionSingleSelection(input: Readonly<{
+    value: SiteOptionValue;
+    items: readonly Readonly<{
+        value: string;
+    }>[];
+    loaded: boolean;
+}>): SiteOptionSingleSelectionState;
 export declare function getSiteOptionSource(config: SelectFieldConfig): SiteOptionSource | null;

package/dist/_dts/logger/src/console.d.ts

@@ -0,0 +1,3 @@
+import type { AppLogger } from './api';
+export declare const logger: AppLogger;
+export type { AppLogger, LogFields } from './api';

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

@@ -1,10 +1,15 @@
 import React from 'react';
-import { type DesignBlockId } from '../../../../theme-core/src/site-styles/index';
+import { type BoundaryOutcome, type DesignBlockId } from '../../../../theme-core/src/site-styles/index';
 type BoundaryControlProps = Readonly<{
     previousBlockId: DesignBlockId;
     nextBlockId: DesignBlockId;
     previousBlockKind: string;
     nextBlockKind: string;
+    /**
+     * What the renderer composed for this join, or null when the pair has no
+     * break. Informational only: it never changes the controls or the choice.
+     */
+    outcome: BoundaryOutcome | null;
 }>;
-export declare function BoundaryControl({ previousBlockId, nextBlockId, previousBlockKind, nextBlockKind, }: BoundaryControlProps): React.JSX.Element | null;
+export declare function BoundaryControl({ previousBlockId, nextBlockId, previousBlockKind, nextBlockKind, outcome, }: BoundaryControlProps): React.JSX.Element | null;
 export {};

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

@@ -4,4 +4,4 @@ import type { DraftSnapshot, EditorDraftInspectorStore, EnrichedBlock } from './
 import { type PreviewProjection } from '../previewProjection';
 import { type LinkedEntryRenderOverlay } from '../linkedEntryRenderOverlay';
 export declare function getDraftSnapshots(uiStore: EditorDraftInspectorStore): Map<EditorBlockId, DraftSnapshot>;
-export declare function mergeBlockWithDraft(block: BlockItem, draftMap: Map<EditorBlockId, DraftSnapshot>, index: number, projections?: readonly PreviewProjection[], linkedEntryOverlays?: LinkedEntryRenderOverlay, nextBlock?: BlockItem | null): EnrichedBlock;
+export declare function mergeBlockWithDraft(block: BlockItem, draftMap: Map<EditorBlockId, DraftSnapshot>, index: number, projections?: readonly PreviewProjection[], linkedEntryOverlays?: LinkedEntryRenderOverlay): EnrichedBlock;

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

@@ -21,6 +21,7 @@ export type DraftSnapshot = {
 };
 export type EnrichedBlock = {
     id: string | null;
+    contentVersionId: string | null;
     kind: string;
     purpose: string;
     orderIndex: number;

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

@@ -3,7 +3,5 @@ import type { BlockItem } from '../../../../../editor-blocks/src/index';
 import type { CanonicalBlockContent, PreviewProjection, PreviewRenderContent } from './types';
 export declare function applyPreviewStructureProjections(blockItems: readonly BlockItem[], projections: readonly PreviewProjection[]): BlockItem[];
 export declare function applyPreviewContentFieldProjections(blockId: EditorBlockId, content: CanonicalBlockContent | null, projections: readonly PreviewProjection[]): CanonicalBlockContent | PreviewRenderContent | null;
-export declare function applyPreviewRuntimeContentProjections(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projections: readonly PreviewProjection[], adjacency?: Readonly<{
-    nextContent: Record<string, unknown> | null | undefined;
-}>): CanonicalBlockContent | PreviewRenderContent | null;
+export declare function applyPreviewRuntimeContentProjections(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projections: readonly PreviewProjection[]): CanonicalBlockContent | PreviewRenderContent | null;
 export declare function blockHasPreviewContentFieldProjection(blockId: EditorBlockId, projections: readonly PreviewProjection[]): boolean;

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

@@ -1,6 +1,6 @@
 import type { BlockItem } from '../../../../../editor-blocks/src/index';
-import { type DesignRuntimeRules, type PageDesignEditorReadModel, type RuntimeContentAdjacency, type SurfaceResolutionContext } from '../../../../../theme-core/src/site-styles/previewCompiler';
+import { type DesignRuntimeRules, type PageDesignEditorReadModel, type SurfaceResolutionContext } from '../../../../../theme-core/src/site-styles/previewCompiler';
 import type { CanonicalBlockContent, PreviewRenderContent, RuntimeContentDecorationProjection } from './types';
 import type { ComponentRuntimeRules } from '../../../../../theme-core/src/site-styles/previewCompiler';
 export declare function runtimeContentDecorationProjectionFromEditorModel(editorModel: PageDesignEditorReadModel, surfaceResolutionContext: SurfaceResolutionContext, designRules?: DesignRuntimeRules, componentRules?: ComponentRuntimeRules): RuntimeContentDecorationProjection;
-export declare function applyRuntimeContentDecorationProjection(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projection: RuntimeContentDecorationProjection, adjacency?: Pick<RuntimeContentAdjacency, 'nextContent'>): PreviewRenderContent;
+export declare function applyRuntimeContentDecorationProjection(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projection: RuntimeContentDecorationProjection): PreviewRenderContent;

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

@@ -1,6 +1,6 @@
 import type { EditorBlockId } from '../../../../../core/src/index';
 import type { BlockItem } from '../../../../../editor-blocks/src/index';
-import type { CompiledBlockRuntimeFields, CompiledBoundaryRuntime, DesignBlockId } from '../../../../../theme-core/src/site-styles/previewCompiler';
+import type { CompiledBlockRuntimeFields, DesignBlockId, PageRuntimeJoin } from '../../../../../theme-core/src/site-styles/previewCompiler';
 export type CanonicalBlockContent = Record<string, unknown> & {
     readonly __contentAuthority?: 'canonical-block-content';
 };
@@ -55,7 +55,7 @@ export type PreviewProjection = Readonly<{
     kind: 'runtime-content-decoration';
     source: 'page-design';
     fieldsByBlockId: ReadonlyMap<DesignBlockId, CompiledBlockRuntimeFields>;
-    boundaries: readonly CompiledBoundaryRuntime<DesignBlockId>[];
+    joins: readonly PageRuntimeJoin<DesignBlockId>[];
 }>;
 export type StructureProjection = Extract<PreviewProjection, {
     kind: 'structure-overlay';

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

@@ -3,6 +3,7 @@ import type { ApiClient } from '../../../../api/src/request';
 import { type ContentTypeSchema } from '../../../../content-model/src/index';
 export type PreviewBlock = {
     id: string | null;
+    contentVersionId?: string | null;
     kind: string;
     purpose?: string | null;
     orderIndex?: number | null;

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

@@ -6,6 +6,7 @@ type PublicEventReadDeps = Readonly<{
     resilientFetchData: <T>(policyEndpoint: PublicReadEndpoint, cacheKey: string, fetcher: (signal: AbortSignal) => Promise<ApiResult<T>>, options: Readonly<{
         signal?: AbortSignal;
         force?: boolean;
+        preview?: boolean;
     }>) => Promise<T>;
 }>;
 type PublicEventReadOperations = Pick<RiverbankClient, 'resolveEventOccurrence' | 'resolveEventRun' | 'listPublicEventCalendarWindow'>;

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

@@ -7,6 +7,14 @@ export type PublishedRuntimeCacheKey = string & {
 export type PublishedRuntimeCachePayloadSchemaVersion = number & {
     readonly [publishedRuntimeCachePayloadSchemaVersionBrand]: 'PublishedRuntimeCachePayloadSchemaVersion';
 };
+/**
+ * Bump when a cached payload's shape changes incompatibly, so readers skip
+ * entries written in the old shape until publish or a live success rewrites
+ * them.
+ *
+ * - 2: pages carry intent-only `runtimeJoins` in place of compiled
+ *   `runtimeBoundaries` (issue 1422).
+ */
 export declare const DEFAULT_PUBLISHED_RUNTIME_CACHE_PAYLOAD_SCHEMA_VERSION: PublishedRuntimeCachePayloadSchemaVersion;
 export type GetSiteRuntimeCacheParams = Readonly<Pick<GetSiteParams, 'id' | 'slug' | 'domain' | 'currentPath' | 'force'>>;
 export type GetContentByPathRuntimeCacheParams = Readonly<Pick<GetPageParams, 'siteId' | 'path' | 'preview'>>;

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

@@ -2,7 +2,7 @@ import type { CalendarWindowRequest, CalendarWindowPage } from '../../../blocks/
 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, ResolveEventOccurrenceResponse, ResolveEventRunResponse, RouteDecisionResponse, RouteOutcomeResponse, RoutableContentResponse, SiteResponse, SitemapRoutesResponse, } from '../public-api/contracts';
+export type { CheckRedirectResponse, EntriesResponse, EntryResponse, PageResponse, PublicBookingServiceCatalogueItem, PublicBookingServicesResponse, PublicServiceCategorySummary, 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`
  */
@@ -574,12 +574,15 @@ export interface RiverbankClient {
         siteId: string;
         subject: EventPageSurfaceSubjectRefWire;
         segment: string;
+        /** Include draft subroutes; the API still validates preview credentials. */
+        preview?: boolean;
     } & SdkMethodOptions): Promise<ResolveEventOccurrenceResponse>;
     /** Resolve one run slug within a canonical parent Event. */
     resolveEventRun(params: {
         siteId: string;
         subject: EventPageSurfaceSubjectRefWire;
         segment: string;
+        preview?: boolean;
     } & SdkMethodOptions): Promise<ResolveEventRunResponse>;
     /**
      * Check if a path has a configured redirect rule

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

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

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

@@ -3,7 +3,7 @@
  *
  * Keep these types structurally compatible with the API responses.
  */
-import type { CompiledBoundaryRuntime } from '../../../theme-core/src/site-styles/index';
+import type { PageRuntimeJoin as ThemeCorePageRuntimeJoin } from '../../../theme-core/src/site-styles/index';
 export type BlockOutline = {
     id: string | null;
     kind: string;
@@ -19,7 +19,12 @@ export type PageOutline = {
     purpose: string;
     blocks: BlockOutline[];
 };
-export type PageRuntimeBoundary = CompiledBoundaryRuntime<string>;
+/**
+ * A section break between two adjacent blocks, sent as intent only. The
+ * renderer composes placement, paint and reserves from the blocks' final
+ * content; the boundary id derives from the two block ids.
+ */
+export type PageRuntimeJoin = ThemeCorePageRuntimeJoin<string>;
 export type RouteMapEntry = string | {
     path?: string | null;
     href?: string | null;