@riverbankcms/sdk 0.144.0 → 0.146.0

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

@@ -5,6 +5,7 @@ import { type Theme } from '../../blocks/src/index';
 import type { PageDesignEditorReadModel } from '../../theme-core/src/site-styles/index';
 import { type EditorStructuralCommand } from '../../core/src/index';
 import { type CustomBlockRegistryEntry, type SdkConfigForBlockPicker } from './block-editor/sdkBlockMerger';
+import { type BlockCreationCopy } from './block-editor/EmptyState';
 import { type BlockActionPresentation } from './block-editor/actionPresentation';
 import { type ReorderControlMode } from './block-editor/reorderControlMode';
 import { type BlockEditorOwner } from './block-editor/owner';
@@ -70,6 +71,8 @@ export type BlockEditorProps = {
     customBlocks?: readonly CustomBlockRegistryEntry[];
     allowedBlockKinds?: readonly string[] | null;
     emptyUnavailableMessage?: string;
+    /** The empty state's words and the add button's label. */
+    creationCopy?: BlockCreationCopy;
     initialCollapsed?: boolean;
     reorderControlMode?: ReorderControlMode;
     actionPresentation?: BlockActionPresentation;

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

@@ -1,3 +1,15 @@
-export declare const EmptyState: ({ onAdd }: {
+/**
+ * The words the editor uses for adding. A host that calls blocks something
+ * else, such as an event page's extra sections, passes its own.
+ */
+export type BlockCreationCopy = Readonly<{
+    emptyTitle: string;
+    emptyDescription: string;
+    addLabel: string;
+}>;
+export declare const DEFAULT_BLOCK_CREATION_COPY: BlockCreationCopy;
+export declare function addBlockLabel(copy?: BlockCreationCopy): string;
+export declare const EmptyState: ({ onAdd, copy, }: {
     onAdd: () => void;
+    copy?: BlockCreationCopy;
 }) => import("react").JSX.Element;

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

@@ -1,5 +1,5 @@
-import type { EditorBlockId, EditorBlockBaselineInput, EditorDraftBlockBaselineUpdateMetaInput, EditorDraftBlockInitMetaInput, EditorStructuralDraftSnapshot } from '../../../core/src/index';
-export type BlockItem = {
+import type { EditorBlockId, EditorBlockBaselineInput, EditorDraftBlockBaselineUpdateMetaInput, EditorDraftBlockInitMetaInput, EditorStructuralDraftSnapshot, BlockContentIdentity } from '../../../core/src/index';
+export type BlockItem = Partial<BlockContentIdentity> & {
     id?: string | null;
     kind: string;
     content?: Record<string, unknown> | null;

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

@@ -1,6 +1,7 @@
 export { BlockEditor } from './BlockEditor';
 export type { BlockEditorProps } from './BlockEditor';
 export type { BlockEditorOwner } from './block-editor/owner';
+export type { BlockCreationCopy } from './block-editor/EmptyState';
 export { createCustomBlockRegistry, mergeBlockDescriptorsWithRegistry, mergeBlockDescriptors, getBlockManifestFromSdkConfig, transformSdkBlockToManifest, transformSdkBlockToDefinition, transformToBlockDescriptor, } from './block-editor/sdkBlockMerger';
 export type { CustomBlockManifestSource, CustomBlockRegistry, CustomBlockRegistryEntry, ResolvedCustomBlockManifest, SdkCustomBlock, SdkConfigForBlockPicker, } from './block-editor/sdkBlockMerger';
 export type { BlockEditorHandle, BlockFocusRequest, BlockFocusTarget, BlockItem, } from './block-editor/types';

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/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

@@ -1,10 +1,10 @@
 import type { PageOutline } from '../../../../../blocks/src/index';
 import type { EditorPreviewInspectorStore } from '../../../../../content-editor/src/index';
-import type { EditorBlockId } from '../../../../../core/src/index';
+import type { BlockContentIdentity, EditorBlockId } from '../../../../../core/src/index';
 import type { BlockItem } from '../../../../../editor-blocks/src/index';
 import type { CanonicalBlockContent, PreviewProjection, PreviewRenderContent } from '../previewProjection';
 import type { LinkedEntryRenderOverlay } from '../linkedEntryRenderOverlay';
-export type BlockWithContent = {
+export type BlockWithContent = Partial<BlockContentIdentity> & {
     [key: string]: unknown;
     id: string | null;
     kind: string;
@@ -19,7 +19,7 @@ export type DraftSnapshot = {
     baseline: CanonicalBlockContent | null;
     current: CanonicalBlockContent | null;
 };
-export type EnrichedBlock = {
+export type EnrichedBlock = BlockContentIdentity & {
     id: string | null;
     kind: string;
     purpose: string;

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

@@ -11,7 +11,7 @@ export type PreviewBlock = {
     publishedContent?: Record<string, unknown> | null;
     bindings?: Record<string, unknown> | null;
     optimisticHash?: string | null;
-};
+} & Partial<import('../../../../core/src/index').BlockContentIdentity>;
 export type PreviewPageMetadata = {
     draftTitle: string;
     draftPath: string;

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`
  */

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;

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

@@ -559,6 +559,11 @@ export type AppointmentBookingContent = {
 export type AppointmentServicesContent = {
     heading?: string | null;
     description?: unknown;
+    /**
+     * Show one appointment-service category, with its heading and intro. Unset
+     * shows every category grouped; a deleted category falls back to that.
+     */
+    categoryId?: string | null;
     _sectionStyles?: SectionStylesContent;
 };
 export type WeeklySlotAvailabilityContent = {

package/dist/_dts/sdk/src/manifest/passes/pass1-fields.d.ts

@@ -19,10 +19,10 @@ export declare const fieldTypeEnum: z.ZodEnum<{
     boolean: "boolean";
     link: "link";
     text: "text";
+    group: "group";
     select: "select";
     media: "media";
     repeater: "repeater";
-    group: "group";
     richText: "richText";
 }>;
 /**
@@ -167,8 +167,8 @@ export declare const pass1OutputSchema: z.ZodObject<{
     blockDescription: z.ZodNullable<z.ZodString>;
     category: z.ZodEnum<{
         content: "content";
-        media: "media";
         layout: "layout";
+        media: "media";
         marketing: "marketing";
         blog: "blog";
         interactive: "interactive";

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

@@ -11,7 +11,6 @@ type CommonRenderInput = Readonly<{
     content: LoadContentResult;
     entrySubrouteContext: ReturnType<typeof toEntrySubrouteContext>;
     portalToken: string | null;
-    preview: boolean;
 }>;
 export type SdkContentRenderInput = CommonRenderInput & (Readonly<{
     kind: 'themed';

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

@@ -1,8 +1,8 @@
 import type { AddressedLocationValue, BusinessAddress } from '../../../core/src/index';
 import type { ResolvedInternalLinkEntityType } from '../../../blocks/src/index';
-import type { APIEndpoints, PublicBookingService as ApiPublicBookingService, RoutableContentItem as ApiRoutableContentItem, SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject, SiteBySlugResponse as ApiSiteBySlugResponse, SiteBookingOfferingPresetSummary as ApiSiteBookingOfferingPresetSummary, SdkBlockContentAdmission } from '../../../api/src/index';
+import type { APIEndpoints, PublicBookingService as ApiPublicBookingService, PublicBookingServiceCatalogueItem as ApiPublicBookingServiceCatalogueItem, PublicBookingServicesResponse as ApiPublicBookingServicesResponse, PublicServiceCategorySummary as ApiPublicServiceCategorySummary, 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 { PageRuntimeJoin } 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';
 import type { PublicTeamMemberBlockItem } from './teamMemberContracts';
 import type { ResolveEventSubrouteResponse } from './eventSubrouteContracts';
@@ -370,7 +370,7 @@ export type SdkRuntimePage = {
         content: Record<string, unknown>;
         admission?: SdkBlockContentAdmission;
     }>;
-    runtimeBoundaries?: readonly CompiledBoundaryRuntime<string>[];
+    runtimeJoins?: readonly PageRuntimeJoin<string>[];
 };
 export type SdkTemplate = {
     id: string;
@@ -562,11 +562,9 @@ export type PublicFormsResponse = {
     forms: FormRecord[];
 };
 export type PublicBookingService = ApiPublicBookingService;
-export type PublicBookingServicesResponse = {
-    services: Array<Omit<PublicBookingService, 'description'> & {
-        description?: string;
-    }>;
-};
+export type PublicServiceCategorySummary = ApiPublicServiceCategorySummary;
+export type PublicBookingServiceCatalogueItem = ApiPublicBookingServiceCatalogueItem;
+export type PublicBookingServicesResponse = ApiPublicBookingServicesResponse;
 export type PublicWeeklySlotAvailabilityOption = {
     id: string;
     resourceId: string;

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

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import type { BlockLoaderFailures } from '../../../blocks/src/system/data/index';
 import type { RenderablePageOutline as BlocksRenderablePageOutline } from '../../../blocks/src/index';
-import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, PageRuntimeBoundary, ResolveImageUrlContextInput, RouteMap, Theme, ThemeTokens } from '../contracts';
+import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, PageRuntimeJoin, ResolveImageUrlContextInput, RouteMap, Theme, ThemeTokens } from '../contracts';
 import type { SdkCustomBlock } from '../config/types';
 import type { BlockOverrides } from './overrides';
 import type { SiteBookingOfferingPresetSummary } from '../public-api/contracts';
@@ -28,7 +28,7 @@ export type PageRendererDataContext = {
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
     mailingList?: import('../../../core/src/index').MailingListRuntimeContext;
     bookingTimeZone?: string;
-    previewStage?: 'published' | 'preview';
+    previewStage: 'published' | 'preview';
     routes?: RouteMap;
     pagesByIdentifier?: Record<string, string>;
     entriesByIdentifier?: Record<string, Record<string, string>>;
@@ -56,8 +56,8 @@ export type SdkConfigForRenderer = {
 };
 type PageRendererCommonProps<TPage> = {
     page: TPage | null;
-    runtimeBoundaries?: readonly PageRuntimeBoundary[];
-    dataContext?: PageRendererDataContext;
+    runtimeJoins?: readonly PageRuntimeJoin[];
+    dataContext: PageRendererDataContext;
     routeMap?: RouteMap;
     wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
     registry?: ComponentRegistry;

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

@@ -1,5 +1,5 @@
 import type { ReactElement } from 'react';
-import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageRuntimeBoundary, RouteMap, Theme, ThemeTokens } from '../../contracts';
+import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageRuntimeJoin, RouteMap, Theme, ThemeTokens } from '../../contracts';
 import type { ResolvedBlockData } from '../../data';
 import type { SiteBookingOfferingPresetSummary } from '../../public-api/contracts';
 import type { RuntimeSdkConfig } from '../helpers/loadPage';
@@ -10,7 +10,7 @@ import type { SdkCustomBlock } from '../../config/types';
 import type { SdkRenderingMode } from '../renderingMode';
 type PageCommonProps = {
     page: RenderablePageOutline;
-    runtimeBoundaries?: readonly PageRuntimeBoundary[];
+    runtimeJoins?: readonly PageRuntimeJoin[];
     siteId: string;
     resolvedData?: ResolvedBlockData;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
@@ -60,7 +60,7 @@ type PageCommonProps = {
      * Additional context data for content entry pages.
      * Used to pass occurrence context and content entry data to blocks.
      */
-    dataContext?: {
+    dataContext: {
         readAuthority?: import('../../../../blocks/src/api').BrowserReadAuthority;
         /** Mailing-list runtime projected for the placements on this page. */
         mailingList?: import('../../../../core/src/index').MailingListRuntimeContext;
@@ -77,7 +77,7 @@ type PageCommonProps = {
         /** Editable route metadata keys for template-page inline editing */
         editableRouteMetadataFieldIds?: ReadonlyArray<string> | null;
         /** Preview stage: 'preview' for draft content, 'published' for live content */
-        previewStage?: 'preview' | 'published';
+        previewStage: 'preview' | 'published';
         /** Canonical request pathname used by blocks when resolving same-site destinations. */
         pathname?: string;
     };

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

@@ -11,7 +11,7 @@ import type { MailingListRuntimeContext } from '../../../../core/src/index';
 import type { PageProps } from '../components/Page';
 import type { ResolvedBlockData } from '../../data/prefetchBlockData';
 import { type ResolveBlockDataDeps } from '../../data/resolveBlockData';
-import type { DataLoaderOverrides, DataLoaderSearchParams } from '../../data/types';
+import type { DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderSearchParams } from '../../data/types';
 import type { SdkCustomBlock } from '../../config/types';
 import { type RuntimeSdkConfig } from './pageRuntimeSupport';
 /**
@@ -93,6 +93,9 @@ export type PagePreviewMetadata = {
  */
 export type PageContentResult = {
     type: 'page';
+    dataContext: {
+        previewStage: DataLoaderPreviewStage;
+    };
     /** Page UUID (required for preview editing / block mutations) */
     pageId: string;
     /** Route UUID for this page (used by preview mode metadata editing) */
@@ -101,7 +104,7 @@ export type PageContentResult = {
     pageMetadata: PagePreviewMetadata;
     /** Page outline ready for rendering with <Page> component */
     page: PageProps['page'];
-    runtimeBoundaries?: PageProps['runtimeBoundaries'];
+    runtimeJoins?: PageProps['runtimeJoins'];
     /** Site theme for styling */
     theme: Theme | null;
     /** Site ID */
@@ -153,6 +156,7 @@ export type EntryContentResult = {
     bookingTimeZone?: string;
     /** Data context for template blocks (includes entry content for bindings) */
     dataContext: {
+        previewStage: DataLoaderPreviewStage;
         contentEntry: Record<string, unknown>;
     };
     /** Site theme for styling (useful if rendering with SDK components) */
@@ -217,6 +221,7 @@ export type PageSurfaceContentResult = {
     mailingList?: MailingListRuntimeContext;
     bookingTimeZone?: string;
     dataContext: {
+        previewStage: DataLoaderPreviewStage;
         pageSurface: Record<string, unknown>;
         subject: PageSurfaceContentData['subject'];
     };

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

@@ -6,7 +6,7 @@
 import type { RiverbankClient } from '../../client/types';
 import type { PageProps } from '../components/Page';
 import { type ResolveBlockDataDeps } from '../../data/resolveBlockData';
-import type { DataLoaderOverrides, DataLoaderSearchParams } from '../../data/types';
+import type { DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderSearchParams } from '../../data/types';
 import { type RuntimeSdkConfig } from './pageRuntimeSupport';
 /**
  * SDK config from API response (without siteId which is stripped at storage).
@@ -79,7 +79,10 @@ export type LoadPageParams = {
      */
     searchParams?: DataLoaderSearchParams;
 };
-export type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'blockOverrides' | 'sdkConfig'> & {
+export type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'blockOverrides' | 'sdkConfig' | 'dataContext'> & {
+    dataContext: {
+        previewStage: DataLoaderPreviewStage;
+    };
     /**
      * SDK site configuration, if available.
      * Contains SDK-defined theme palette, section backgrounds, and style options.

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

@@ -2,7 +2,8 @@ import type { MediaAssetIndexItem, PageOutline, RouteMap, Theme } from '../../co
 import type { SiteBookingOfferingPresetSummary } from '../../public-api/contracts';
 import type { SiteResponse } from '../../client/types';
 import type { SdkCustomBlock } from '../../config/types';
-import { type BlockManifest, type FieldDefinition, type PageBlockRenderAdmissionError, type RenderablePageBlock, type RenderablePageOutline } from '../../../../blocks/src/index';
+import { type BlockManifest, type FieldDefinition, type PageBlockRenderAdmissionError, type PublishedBlockPlacement, type RenderablePageBlock, type RenderablePageOutline } from '../../../../blocks/src/index';
+import type { DataLoaderPreviewStage } from '../../data/types';
 export type RuntimeSdkConfig = NonNullable<SiteResponse['sdkConfig']>;
 export type SiteData = SiteResponse['site'];
 export type SiteRenderSupport = Readonly<{
@@ -40,6 +41,8 @@ export declare function buildSiteRenderSupport(site: SiteResponse, mediaAssets:
 export declare function collectMediaAssetSidecar(mediaAssets: readonly MediaAssetIndexItem[] | null | undefined): readonly MediaAssetIndexItem[] | undefined;
 type TransportedPageBlock = PageOutline['blocks'][number] & Readonly<{
     contentVersionId?: string | null;
+    draftContentId: string | null;
+    publishedPlacement: PublishedBlockPlacement | null;
 }>;
 export declare function readInvalidBlockAdmission(value: unknown): Readonly<{
     kind: 'invalid';
@@ -51,6 +54,7 @@ export declare function buildPageOutline(input: Readonly<{
     fallbackPath: string;
     purpose: string;
     blocks: readonly unknown[];
+    previewStage: DataLoaderPreviewStage;
 }>): Omit<PageOutline, 'blocks'> & Readonly<{
     blocks: TransportedPageBlock[];
 }>;
@@ -60,6 +64,7 @@ export declare function buildRenderablePageOutline(input: Readonly<{
     fallbackPath: string;
     purpose: string;
     blocks: readonly unknown[];
+    previewStage: DataLoaderPreviewStage;
     customBlocks?: readonly SdkCustomBlock[];
 }>): RenderablePageOutline;
 export declare function projectRenderablePageOutline(page: RenderablePageOutline): PageOutline;

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

@@ -22,6 +22,8 @@ type EntrySlotBlock = {
     id: string;
     blockId?: string;
     contentVersionId: string;
+    draftContentId?: string | null;
+    publishedContentId?: string | null;
     kind: string;
     purpose: string;
     content: Record<string, unknown> | null;

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

@@ -8,6 +8,7 @@ import type { MediaAssetIndexItem, Theme } from '../../contracts';
 import type { RiverbankClient } from '../../client/types';
 import type { PageProps } from '../components/Page';
 import type { ResolvedBlockData } from '../../data/prefetchBlockData';
+import type { DataLoaderPreviewStage } from '../../data/types';
 import type { ContentEntryData } from '../helpers/loadContent';
 export type UseContentParams = {
     client: RiverbankClient;
@@ -56,11 +57,14 @@ type PageSuccessState = {
     error: null;
     type: 'page';
     page: PageProps['page'];
-    runtimeBoundaries?: PageProps['runtimeBoundaries'];
+    runtimeJoins?: PageProps['runtimeJoins'];
     entry: null;
     theme: Theme | null;
     siteId: string;
     resolvedData: ResolvedBlockData;
+    dataContext: {
+        previewStage: DataLoaderPreviewStage;
+    };
     supabaseUrl?: string;
     mediaAssets?: readonly MediaAssetIndexItem[];
 };
@@ -117,7 +121,7 @@ export declare function isEntryContentResult(result: UseContentResult): result i
  *
  *   if (isPageContentResult(content)) {
  *     if (!content.theme) return <div>This site needs a theme before it can be displayed.</div>;
- *     return <Page page={content.page} theme={content.theme} siteId={content.siteId} resolvedData={content.resolvedData} />;
+ *     return <Page page={content.page} theme={content.theme} siteId={content.siteId} resolvedData={content.resolvedData} dataContext={content.dataContext} />;
  *   }
  *
  *   // Render entry with custom UI