@riverbankcms/sdk 0.144.0 → 0.145.0

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/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/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/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';
@@ -56,7 +56,7 @@ export type SdkConfigForRenderer = {
 };
 type PageRendererCommonProps<TPage> = {
     page: TPage | null;
-    runtimeBoundaries?: readonly PageRuntimeBoundary[];
+    runtimeJoins?: readonly PageRuntimeJoin[];
     dataContext?: PageRendererDataContext;
     routeMap?: RouteMap;
     wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;

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[];

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

@@ -101,7 +101,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 */

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

@@ -56,7 +56,7 @@ type PageSuccessState = {
     error: null;
     type: 'page';
     page: PageProps['page'];
-    runtimeBoundaries?: PageProps['runtimeBoundaries'];
+    runtimeJoins?: PageProps['runtimeJoins'];
     entry: null;
     theme: Theme | null;
     siteId: string;

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.144.0";
+export declare const SDK_VERSION = "0.145.0";

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

@@ -36,6 +36,7 @@ export type SurfaceHostContext = Readonly<{
 export declare const SURFACE_ROOT_HOSTS: Readonly<Record<SurfaceId, Readonly<Record<SurfaceTier, string>>>>;
 export declare const SURFACE_SITE_ROOT_HOSTS: Readonly<Record<SurfaceId, Readonly<Record<SurfaceTier, string>>>>;
 export declare function resolveSurfaceFontHref(surfaceId: SurfaceId): string | null;
+export declare function resolveSurfaceSiteHostContext(value: string | URL | null | undefined): SurfaceHostContext | null;
 export declare function resolveSurfaceHostContext(value: string | URL | null | undefined): SurfaceHostContext | null;
 export declare function buildSurfaceAwareDashboardOrigin(input: Readonly<{
     dashboardOrigin: string;

package/dist/_dts/theme-core/src/layout/boundaryCss.d.ts

@@ -0,0 +1,3 @@
+import { type WaveMaskId } from '../site-styles/transitionCatalogue';
+export declare function waveMaskDataUrl(mask: WaveMaskId): string;
+export declare function generateBoundaryCss(selector: string): string;

package/dist/_dts/theme-core/src/site-styles/compositionBudget.d.ts

@@ -33,6 +33,14 @@ export type CompositionBudgetValidationInput<TBlockId extends string = DesignBlo
     policy: DesignResolutionPolicy;
     budget: CompositionBudget;
     resolved: ResolvedPageDesignPlan<TBlockId, TPurpose>;
+    /**
+     * The page's resolved joins. A join counts towards the transition mix when
+     * the frame rule lets it draw; one next to a flush panel doesn't.
+     */
+    joins: readonly Readonly<{
+        previousBlockId: TBlockId;
+        nextBlockId: TBlockId;
+    }>[];
     blockContexts?: readonly BlockCompositionContext<TBlockId>[];
 }>;
 export declare function maxCompositionItemsWithinRatio(totalItems: number, allowedRatio: number): number;

package/dist/_dts/theme-core/src/site-styles/contentTemplateRuntimeCompiler.d.ts

@@ -1,6 +1,7 @@
 import type { BlockDesignMetadata } from './blockFlow';
 import { type PageDesignEditorIssue } from './pageDesignEditorModel';
-import type { CompiledBlockRuntimeFields, CompiledBoundaryRuntime, SurfaceResolutionContext } from './runtimeCompiler';
+import type { CompiledBlockRuntimeFields, SurfaceResolutionContext } from './runtimeCompiler';
+import type { PageRuntimeJoin } from './joinTreatment';
 import { type ContentTemplateBlockScope, type ContentTemplateDesignBlockId, type ContentTemplateDesignIntent } from './contentTemplateDesignIntent';
 import type { BlockDesignCapability, LayoutVariantKey } from './types';
 export type ContentTemplateRuntimeBlockInput = Readonly<{
@@ -18,7 +19,7 @@ export type CompiledContentTemplateRuntimeBlock = Readonly<{
 }>;
 export type CompiledContentTemplateRuntime = Readonly<{
     blocks: readonly CompiledContentTemplateRuntimeBlock[];
-    boundaries: readonly CompiledBoundaryRuntime<ContentTemplateDesignBlockId>[];
+    joins: readonly PageRuntimeJoin<ContentTemplateDesignBlockId>[];
     fieldsByBlockId: ReadonlyMap<ContentTemplateDesignBlockId, CompiledBlockRuntimeFields>;
     issues: readonly PageDesignEditorIssue<ContentTemplateDesignBlockId>[];
 }>;

package/dist/_dts/theme-core/src/site-styles/designState.d.ts

@@ -112,9 +112,7 @@ export declare const blockRuntimeStyleAuthoritySchema: z.ZodObject<{
         _sectionStyles: "_sectionStyles";
         _containerStyles: "_containerStyles";
         _cardStyles: "_cardStyles";
-        _transitionStyles: "_transitionStyles";
-        styleGroup: "styleGroup";
-    }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "_transitionStyles" | "styleGroup")[]>>;
+    }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles")[]>>;
     authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"theme-v2">;
         source: z.ZodEnum<{

package/dist/_dts/theme-core/src/site-styles/generatedDesignPipeline.d.ts

@@ -3,6 +3,7 @@ import type { ThemeV2StyleAuthority } from './designState';
 import { type PageDesignIntent } from './pageDesignIntent';
 import { type HeaderOpeningSectionRepair } from './headerOpeningSection';
 import type { HeaderOpeningSectionContext } from './headerLayoutStyles';
+import { type JoinIntent } from './joinTreatment';
 import { type CompiledPageRuntime } from './runtimeCompiler';
 import { type BlockDesignCapabilityMap, type BlockDesignPlan, type DesignBlockId, type DesignRepairResult, type DesignResolutionIssue, type GeneratedPageDesignIntent, type ResolvedPageDesignPlan, type SiteStyleId } from './types';
 import type { CuratedSiteStyle } from './curatedSiteStyles';
@@ -44,6 +45,8 @@ export type GeneratedDesignPipelineSuccess<TBlockId extends DesignBlockId = Desi
     intent: GeneratedPageDesignIntent<TBlockId>;
     plan: readonly BlockDesignPlan<TBlockId>[];
     resolved: ResolvedPageDesignPlan<TBlockId>;
+    /** The page's resolved joins, in block order; see `resolveJoinTreatment`. */
+    joins: readonly JoinIntent<TBlockId>[];
     headerOpeningSectionContext: HeaderOpeningSectionContext;
     headerOpeningSectionRepairs: readonly HeaderOpeningSectionRepair[];
     repairs: readonly DesignRepairResult<TBlockId>[];

package/dist/_dts/theme-core/src/site-styles/index.d.ts

@@ -23,6 +23,7 @@ export { compareCompiledHeaders, type CompiledHeaderComparison, type HeaderField
 export { compileHeaderForCuratedSelection, recompileSiteChromeHeader, recompileSiteChromeHeaderFromPersistedIntent, type CuratedHeaderSelectionRepair, type CompiledCuratedHeader, type HeaderInteractionPaletteRequest, type RecompileSiteChromeHeaderInput, type RecompiledSiteChromeHeader, } from './headerRecompile';
 export * from './headerOpeningForeground';
 export * from './headerOpeningSection';
+export * from './joinTreatment';
 export * from './lookResolution';
 export * from './lookOptionGroups';
 export * from './logoBranding';
@@ -42,6 +43,7 @@ export * from './resolver';
 export * from './runtimeCompiler';
 export * from './runtimeBackgroundResolution';
 export * from './sectionTransitions';
+export * from './sectionBoundaryComposition';
 export * from './siteChromeBackgrounds';
 export * from './siteChromeNavPreferences';
 export * from './siteStyleThemeCompiler';
@@ -49,6 +51,7 @@ export * from './siteStyleBlockPolicies';
 export * from './sourceCatalogs';
 export * from './styleTags';
 export * from './tokenRecipes';
+export * from './transitionCatalogue';
 export * from './siteStyleTypography';
 export * from './themeParity';
 export * from './types';