@riverbankcms/sdk 0.143.0 → 0.145.0

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

@@ -415,4 +415,31 @@ export declare function resolveNavigationLinkHref(link: LinkPayload | null, rout
  * ```
  */
 export declare function buildLogo(logo: Partial<LogoSource> | null, fallbackAlt: string | null | undefined): Logo;
+/** Both site logos, for chrome that picks one per surface. */
+export type LogoVariants = {
+    forLightBackgrounds: Logo;
+    forDarkBackgrounds: Logo;
+};
+/**
+ * Build both site logos from layout data. The default header and footer choose
+ * between them by the surface they sit on; custom chrome can do the same.
+ *
+ * @example
+ * ```ts
+ * const logoVariants = buildLogoVariants(siteData.layout, siteData.site.title);
+ * ```
+ */
+export declare function buildLogoVariants(layout: Readonly<{
+    logo?: Partial<LogoSource> | null;
+    logoForDarkBackgrounds?: Partial<LogoSource> | null;
+}> | null | undefined, fallbackAlt: string | null | undefined): LogoVariants;
+/**
+ * Header/footer block content for the site logos. `logo` stays populated with
+ * whichever logo exists so presence checks keep working; `logoVariants` is
+ * what the blocks select from at render.
+ */
+export declare function buildChromeLogoContent(layout: Parameters<typeof buildLogoVariants>[0], fallbackAlt: string | null | undefined): {
+    logo: Logo;
+    logoVariants: LogoVariants;
+};
 export type { NavigationMenuWithItems, NavigationItemRecord, LinkPayload } from '../public-api/contracts';

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';
@@ -184,14 +184,22 @@ export type SiteLayoutSettingsPayload = {
     header: SiteHeaderContent;
     footer: SiteFooterContent;
 };
+export type SiteLayoutLogoPayload = {
+    assetId: string | null;
+    url: string | null;
+    alt: string | null;
+    width?: number | null;
+    height?: number | null;
+};
 export type SiteLayoutResolvedPayload = SiteLayoutSettingsPayload & {
-    logo?: {
-        assetId: string | null;
-        url: string | null;
-        alt: string | null;
-        width?: number | null;
-        height?: number | null;
-    };
+    /** The site logo, designed for light backgrounds. */
+    logo?: SiteLayoutLogoPayload;
+    /**
+     * Optional logo designed for dark backgrounds. The default header and
+     * footer draw it on surfaces whose text colour resolves light. Absent or
+     * null when the site has not set one.
+     */
+    logoForDarkBackgrounds?: SiteLayoutLogoPayload | null;
 };
 export interface SiteAnalyticsCookieBannerCopyOverrides {
     title?: string;
@@ -362,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;
@@ -554,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';
@@ -44,6 +44,7 @@ export type PageRendererDataContext = {
     apiBaseUrl?: string;
     portalToken?: string | null;
     previewToken?: string | null;
+    readAuthority?: import('../../../blocks/src/api').BrowserReadAuthority;
     eventRegistrationOverlayEnabled?: boolean;
 };
 export type BlocksPageRendererDataContext = Omit<PageRendererDataContext, 'mediaAssets' | 'imageResolveContext'> & {
@@ -55,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/client.d.ts

@@ -10,6 +10,7 @@ export type BlockApiAuth = Readonly<{
     type: 'none';
 }>;
 export type BlockApiConfig = Readonly<{
+    readAuthority?: import('../../../blocks/src/api').BrowserReadAuthority;
     baseUrl: string;
     auth: BlockApiAuth;
     siteId?: string;

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

@@ -34,6 +34,7 @@ type BlockCommonProps = {
      * Portal token for customer portal Bearer auth.
      */
     portalToken?: string | null;
+    readAuthority?: import('../../../../blocks/src/api').BrowserReadAuthority;
     /** Route lookup for CMS links inside block content. */
     routeMap?: RouteMap;
     /** Page identifier to routeId lookup for { kind: 'page' } links. */

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

@@ -3,14 +3,17 @@
  *
  * Renders site header and footer around content. Fetches site data if not provided.
  */
-import { buildMenu, buildFooterMenu, buildFooterMenuForRole, buildLogo } from '../../navigation';
+import { buildMenu, buildFooterMenu, buildFooterMenuForRole, type buildLogo, type buildLogoVariants } from '../../navigation';
 import type { RiverbankClient, SiteResponse } from '../../client/types';
 import type { Theme } from '../../contracts';
 import { type SdkThemeRuntime } from '../themeRuntime';
 import { type SdkOverrideOnlyRendering } from '../renderingMode';
 export type CustomHeaderData = {
     menu: ReturnType<typeof buildMenu>;
+    /** The site logo (for light backgrounds), or the dark-background one if it is the only logo set. */
     logo: ReturnType<typeof buildLogo>;
+    /** Both logos, so a custom header can pick by its own surface. */
+    logoVariants: ReturnType<typeof buildLogoVariants>;
     site: SiteResponse['site'];
     routes: SiteResponse['routes'];
 };
@@ -18,7 +21,10 @@ export type CustomFooterData = {
     menu: ReturnType<typeof buildMenu>;
     footerMenu: ReturnType<typeof buildFooterMenu>;
     legalFooterMenu: ReturnType<typeof buildFooterMenuForRole>;
+    /** The site logo (for light backgrounds), or the dark-background one if it is the only logo set. */
     logo: ReturnType<typeof buildLogo>;
+    /** Both logos, so a custom footer can pick by its own surface. */
+    logoVariants: ReturnType<typeof buildLogoVariants>;
     site: SiteResponse['site'];
     routes: SiteResponse['routes'];
 };

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[];
@@ -55,11 +55,13 @@ type PageCommonProps = {
      * Optional because normal published rendering does not have or need one.
      */
     previewToken?: string | null;
+    readAuthority?: import('../../../../blocks/src/api').BrowserReadAuthority;
     /**
      * Additional context data for content entry pages.
      * Used to pass occurrence context and content entry data to blocks.
      */
     dataContext?: {
+        readAuthority?: import('../../../../blocks/src/api').BrowserReadAuthority;
         /** Mailing-list runtime projected for the placements on this page. */
         mailingList?: import('../../../../core/src/index').MailingListRuntimeContext;
         /** Occurrence context for event pages (from URL like /events/yoga/2025-01-15) */

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/rendering/islands/enhancers/routeIslandApiConfig.d.ts

@@ -1,9 +1,10 @@
-import type { BlockApiConfig } from '../../../../../blocks/src/api';
+import { type BlockApiConfig, type BrowserReadAuthority } from '../../../../../blocks/src/api';
 export type RouteIslandApiConfigInput = Readonly<{
     apiBaseUrl: string;
     portalToken?: string | null;
     previewToken?: string | null;
     siteId: string;
     stage?: 'preview' | 'published';
+    readAuthority?: BrowserReadAuthority;
 }>;
-export declare function buildRouteIslandApiConfig({ apiBaseUrl, portalToken, previewToken, siteId, stage, }: RouteIslandApiConfigInput): BlockApiConfig;
+export declare function buildRouteIslandApiConfig({ apiBaseUrl, portalToken, previewToken, siteId, stage, readAuthority, }: RouteIslandApiConfigInput): BlockApiConfig;

package/dist/_dts/sdk/src/rendering/islands/enhancers/shopShared.d.ts

@@ -1,7 +1,9 @@
 import { type ComponentType } from 'react';
+import type { BrowserReadAuthority } from '../../../../../blocks/src/api';
 type IslandPropsWithApi = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
+    readAuthority?: BrowserReadAuthority;
     stage?: 'preview' | 'published';
 }>;
 export declare function mountShopBlockIsland<TProps extends IslandPropsWithApi>(root: HTMLElement, props: TProps, Component: ComponentType<TProps>, label: string): (() => void) | undefined;

package/dist/_dts/sdk/src/rendering/overrides.d.ts

@@ -17,6 +17,7 @@ export type BlockOverrideProps<TContent = Record<string, unknown>, TData = Recor
     apiBaseUrl?: string;
     portalToken?: string | null;
     previewToken?: string | null;
+    readAuthority?: import('../../../blocks/src/api').BrowserReadAuthority;
     stage?: 'published' | 'preview';
     occurrenceContext?: OccurrenceContextData | null;
     entrySubrouteContext?: EntrySubrouteContextData | null;

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.143.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/buttons/affordanceSuppression.d.ts

@@ -12,6 +12,6 @@
  * overriding the twelve styles that deliberately declare none. Whether a button
  * carries a trailing affordance is the style's decision; the only caller that
  * legitimately opts out is the authored-button renderer, which reaches it
- * through `themeButtonClassNameWithTrailingIcon`.
+ * through `themeButtonExtraClassesWithTrailingIcon`.
  */
 export declare const AFFORDANCE_SUPPRESS_CLASS = "rb-affordance-off";

package/dist/_dts/theme-core/src/buttons/classNames.d.ts

@@ -1,14 +1,6 @@
 import { type ButtonSizeName, type DefaultVariantAliasId, type VariantId } from './types';
 export type ThemeButtonVariantId = VariantId | DefaultVariantAliasId;
-export type ThemeButtonClassName = string & {
-    readonly __brand: 'ThemeButtonClassName';
-};
 export type ThemeButtonSizeClassName = `btn-${ButtonSizeName}`;
-export type ThemeButtonClassSpec = Readonly<{
-    variant: ThemeButtonVariantId;
-    size: ButtonSizeName;
-    extraClassName?: string | null;
-}>;
 /**
  * Parse content/runtime variant identifiers into the closed theme-button class
  * contract. Empty input is the intentional local/unstyled escape hatch used by
@@ -18,12 +10,10 @@ export declare function parseThemeButtonVariantId(value: string | null | undefin
 export declare function themeButtonVariantClassNames(variant: ThemeButtonVariantId): readonly [string] | readonly [string, string];
 export declare function themeButtonSizeClassName(size: ButtonSizeName): ThemeButtonSizeClassName;
 export declare function themeButtonSelector(variant: ThemeButtonVariantId, size?: ButtonSizeName): string;
-export declare function themeButtonClassName(spec: ThemeButtonClassSpec): ThemeButtonClassName;
 /**
- * Button classes for an authored button that renders its own trailing icon.
+ * Extra classes for an authored button that renders its own trailing icon.
  *
- * A separate function rather than a flag on `themeButtonClassName`, because
- * there is exactly one caller and it should stay visible in a diff. The name
+ * This intent-named function has exactly one caller. The name
  * states what the caller knows to be true of its own markup — that it renders a
  * trailing icon — rather than what the theme does about it. The consequence is
  * the theme's to decide and to change; a caller naming the consequence would be
@@ -34,4 +24,4 @@ export declare function themeButtonClassName(spec: ThemeButtonClassSpec): ThemeB
  * affordance is declared by the button style, and a block overriding that is the
  * defect this replaced.
  */
-export declare function themeButtonClassNameWithTrailingIcon(spec: ThemeButtonClassSpec): ThemeButtonClassName;
+export declare function themeButtonExtraClassesWithTrailingIcon(): string;

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

@@ -9,4 +9,4 @@ export { selectorSchema, declarationValueSchema, declarationsSchema, customCssRu
 export { keyframesAtRuleSchema, fontFaceAtRuleSchema, mediaAtRuleSchema, supportsAtRuleSchema, rawAtRuleSchema, customCssAtRuleSchema, customCssAtRulesSchema, type KeyframesAtRuleInput, type FontFaceAtRuleInput, type MediaAtRuleInput, type SupportsAtRuleInput, type RawAtRuleInput, type CustomCssAtRuleInput, } from './atRuleValidation';
 export { compileCustomCssRules, compileBlockCustomCssRules, } from './compile';
 export { compileCustomCssAtRules } from './compileAtRules';
-export { type CssRulePatch, generateCssRuleId, applyCssRulePatch, applyCssRulePatches, diffCssRules, } from './patch';
+export { type CssRulePatch, applyCssRulePatch, applyCssRulePatches, diffCssRules, } from './patch';

package/dist/_dts/theme-core/src/customCss/patch.d.ts

@@ -19,11 +19,6 @@ export type CssRulePatch = {
     ruleId: string;
     changes: Partial<Omit<CustomCssRule, 'id'>>;
 };
-/**
- * Generate a unique ID for a new CSS rule.
- * Uses timestamp + random suffix for uniqueness.
- */
-export declare function generateCssRuleId(): string;
 /**
  * Apply a single patch operation to a rules array.
  *