@riverbankcms/sdk 0.140.0 → 0.142.0

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

@@ -0,0 +1,7 @@
+import { type ReactNode } from 'react';
+import type { ColourFieldOptions } from './colourFieldVisibility';
+/** Dashboard forms opt in; preview's visual editing controls retain their own policy. */
+export declare function ColourFieldOptionsProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useColourFieldOptions(): ColourFieldOptions | undefined;

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

@@ -0,0 +1,7 @@
+import type { BlockManifest } from '../../../blocks/src/index';
+export type ColourFieldOptions = Readonly<{
+    colour: boolean;
+    gradient: boolean;
+}>;
+/** Only changes form presentation; the validation manifest and saved data stay intact. */
+export declare function hideUnavailableColourFields(manifest: BlockManifest, options: ColourFieldOptions): BlockManifest;

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

@@ -1,3 +1,4 @@
+import { type ColourFieldOptions } from './colourFieldVisibility';
 import type { BlockManifest, StyleGroups } from '../../../blocks/src/index';
 import type { SdkBlockFieldExtensionsMap, SdkBlockFieldOptionsMap } from '../../../block-form/src/index';
 export type BlockEditorManifestVisibilityPolicy = Readonly<{
@@ -18,5 +19,6 @@ export declare function prepareBlockEditorManifest(input: Readonly<{
     blockFieldOptions?: SdkBlockFieldOptionsMap | null;
     blockFieldExtensions?: SdkBlockFieldExtensionsMap | null;
     visibilityPolicy: BlockEditorManifestVisibilityPolicy;
+    colourFieldOptions?: ColourFieldOptions;
     allowedPromotedFieldPaths?: readonly string[];
 }>): PreparedBlockEditorManifest;

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

@@ -25,3 +25,4 @@ export { stripTopLevelRoutingUi } from './block-editor/settingsIntent';
 export * from './widgets/index';
 export { createBlockFormLogger, setBlockFormLoggerFactory, setBlockFormAppLogger, } from './block-form/debug';
 export type { BlockFormLogger } from './block-form/debug';
+export { ColourFieldOptionsProvider } from './block-editor/ColourFieldOptionsProvider';

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

@@ -12,6 +12,12 @@ export type SiteOptionLoadItems = (args: SiteOptionLoadItemsArgs) => Promise<Sit
 export type SiteOptionLoadErrorMapper = (error: unknown, args: SiteOptionLoadItemsArgs) => unknown;
 export type SiteOptionManageLinkRenderers = Partial<Readonly<Record<SiteOptionSource, SiteOptionWidgetAdapter['renderManageLink']>>>;
 export declare const siteOptionWidgetLabels: {
+    readonly eventSeries: {
+        readonly loading: "Loading events...";
+        readonly select: "Choose events";
+        readonly empty: "No events available. Create an event in Bookings first.";
+        readonly emptySelection: "Choose at least one event to show in this block.";
+    };
     readonly eventCategories: {
         readonly loading: "Loading categories...";
         readonly select: "Select categories";
@@ -32,14 +38,34 @@ export declare const siteOptionWidgetLabels: {
     };
 };
 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";
 };
 export declare function mapEventCategoriesToSiteOptionItems(payload: ListEventCategoriesResponse): SiteOptionWidgetItem[];
+export declare function mapEventsToSiteOptionItems(events: readonly Readonly<{
+    title: string;
+    slug: string;
+    schedules: {
+        kind: 'ordinary';
+        schedule: {
+            id: string;
+        };
+    } | {
+        kind: 'wholeSeries';
+        runs: readonly {
+            id: string;
+            title: string;
+            slug: string;
+            status?: string;
+            visibility?: string;
+        }[];
+    };
+}>[]): SiteOptionWidgetItem[];
 export declare function mapVenuesToSiteOptionItems(payload: ListVenuesResponse): SiteOptionWidgetItem[];
 export declare function mapStaffMembersToSiteOptionItems(payload: ListAppointmentResourcesResponse): SiteOptionWidgetItem[];
-export declare function loadSiteOptionItemsFromApi({ apiClient, siteId, source, }: SiteOptionLoadItemsArgs & Readonly<{
+export declare function loadSiteOptionItemsFromApi({ apiClient, siteId, source }: SiteOptionLoadItemsArgs & Readonly<{
     apiClient: ApiClient;
 }>): Promise<SiteOptionWidgetItem[]>;
 export declare function createSiteOptionApiLoader(apiClient: ApiClient): SiteOptionLoadItems;

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

@@ -1,6 +1,6 @@
 import React, { type ReactNode } from 'react';
 import type { ApiClient } from '../../../../api/src/request';
-import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
+import type { SdkConfigForPreview } from './sdkConfig';
 import type { SurfaceId } from '../../../../surfaces/src/index';
 import type { EntrySubrouteContextData, BookingOfferingPresetSummary, Theme } from '../../../../blocks/src/index';
 import { type ContentTypeSchema } from '../../../../content-model/src/index';
@@ -44,7 +44,7 @@ export type PreviewEditorSidebarProps = {
     bearerToken?: string | null;
     entrySubrouteContext?: EntrySubrouteContextData | null;
     assistantPanel?: ReactNode;
-    sdkConfig?: SdkConfigForBlockPicker | null;
+    sdkConfig?: SdkConfigForPreview | null;
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     siteStyleAccess?: SiteStyleAccess;
     activeTab: PreviewEditorSidebarTab;

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

@@ -1,11 +1,9 @@
+import { type FooterInspection } from './footerInspection';
 import type { ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
-import { type PreviewInspection } from '../../../../content-editor/src/index';
 import type { SiteStyleAccess } from './siteStyleAccess';
-type FooterInspection = Extract<PreviewInspection, Readonly<{
-    kind: 'footer' | 'footer-module';
-}>>;
-export declare function PreviewFooterEditorPanel({ apiClient, siteId, dashboardBaseUrl, theme, selectionId, selectionVersion, siteStyleAccess, inspection, canEdit, onSaved, }: Readonly<{
+export declare function PreviewFooterEditorPanel({ sdkConfig, apiClient, siteId, dashboardBaseUrl, theme, selectionId, selectionVersion, siteStyleAccess, inspection, canEdit, onSaved, }: Readonly<{
+    sdkConfig?: unknown;
     apiClient: ApiClient;
     siteId: string;
     dashboardBaseUrl: string | null;
@@ -17,4 +15,3 @@ export declare function PreviewFooterEditorPanel({ apiClient, siteId, dashboardB
     canEdit: boolean;
     onSaved?: () => void;
 }>): import("react").JSX.Element;
-export {};

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

@@ -4,7 +4,7 @@ import type { ButtonStyleSelection, ButtonStyleSelectionRepair } from '../../../
 import type { FooterLookId, HeaderLayoutStyleSelection, HeaderLogoContext } from '../../../../theme-core/src/site-styles/index';
 import type { EntrySubrouteContextData, BookingOfferingPresetSummary, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
 import type { ContentTypeSchema } from '../../../../content-model/src/index';
-import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
+import type { SdkConfigForPreview } from './sdkConfig';
 import type { SurfaceId } from '../../../../surfaces/src/index';
 import { type PreviewBlock, type PreviewContentEntryData, type PreviewPageMetadata } from './PreviewEntryControllerProvider';
 import { type PreviewRenderingMode, type PreviewThemeRuntime } from './themeRuntime';
@@ -70,7 +70,7 @@ type PreviewShellCommonProps = {
     maintenanceModeEnabled: boolean;
     entrySubrouteContext?: EntrySubrouteContextData | null;
     assistantPanel?: PreviewEditorSidebarProps['assistantPanel'];
-    sdkConfig?: SdkConfigForBlockPicker | null;
+    sdkConfig?: SdkConfigForPreview | null;
     mediaAssets?: readonly MediaAssetIndexItem[];
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     supabaseUrl?: string;

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

@@ -4,7 +4,7 @@ import type { ButtonStyleSelection, ButtonStyleSelectionRepair } from '../../../
 import type { HeaderLogoContext, FooterLookId, HeaderLayoutStyleSelection } from '../../../../theme-core/src/site-styles/index';
 import type { ContentTypeSchema } from '../../../../content-model/src/index';
 import type { ApiClient } from '../../../../api/src/request';
-import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
+import type { SdkConfigForPreview } from './sdkConfig';
 import type { SurfaceId } from '../../../../surfaces/src/index';
 import { type PreviewEntryData, type PreviewTemplateData } from './PreviewEditorSidebar';
 import { type SiteStyleAccess } from './siteStyleAccess';
@@ -36,7 +36,7 @@ type PreviewShellLayoutCommonProps = {
     maintenanceModeEnabled: boolean;
     entrySubrouteContext?: EntrySubrouteContextData | null;
     assistantPanel?: ReactNode;
-    sdkConfig?: SdkConfigForBlockPicker | null;
+    sdkConfig?: SdkConfigForPreview | null;
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     siteStyleAccess?: SiteStyleAccess;
     onFooterSaved?: () => void;

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

@@ -0,0 +1,16 @@
+import type { PreviewInspection } from '../../../../content-editor/src/index';
+export type FooterInspection = Extract<PreviewInspection, {
+    kind: 'footer' | 'footer-module';
+}>;
+/** Shared by sidebar routing and the footer panel's initial editing target. */
+export declare function resolveFooterInspection(inspection: PreviewInspection | null): FooterInspection | null;
+export declare function footerComposerInspectionProps(inspection: FooterInspection | null): {
+    initialTarget: {
+        kind: "module";
+        moduleId: import("../../../../core/src/index").FooterModuleId;
+    } | {
+        kind: "overview";
+        moduleId?: undefined;
+    };
+    initialTargetRequestId: number | undefined;
+};

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

@@ -0,0 +1,6 @@
+import type { SdkSiteLayoutConfig } from '../../../../api/src/index';
+import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
+/** SDK config fields consumed by preview editing, beyond the block picker. */
+export type SdkConfigForPreview = SdkConfigForBlockPicker & {
+    layout?: Pick<SdkSiteLayoutConfig, 'footerMode'>;
+};

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

@@ -4,6 +4,7 @@
  * These types define the schema for SDK site configuration that can be
  * declared in code and consumed by tooling.
  */
+import type { SdkSiteLayoutConfig } from '../../../api/src/index';
 import type { ContentConfig } from './content-types';
 import type { FieldDefinition } from './field-definitions';
 import type { NodeDefinition } from '../contracts';
@@ -383,24 +384,7 @@ export interface RiverbankSiteConfig {
      * These blocks are SDK-managed (source controlled) and synced to the CMS via
      * `riverbankcms push-config`.
      */
-    layout?: {
-        /**
-         * Global footer blocks list (applies to all pages).
-         *
-         * These are block instances, not persisted CMS page blocks.
-         */
-        footerBlocks?: Array<{
-            /**
-             * Optional stable identifier for list rendering.
-             * Not a CMS block UUID.
-             */
-            id?: string;
-            /** Block kind (system: block.* or custom: custom.*) */
-            kind: string;
-            /** Static content payload for the block */
-            content?: Record<string, unknown>;
-        }>;
-    };
+    layout?: SdkSiteLayoutConfig;
     /**
      * Custom blocks defined by the SDK site.
      * These blocks appear in the block picker and are edited via CMS forms.

package/dist/_dts/sdk/src/config/validation.d.ts

@@ -456,6 +456,12 @@ export declare const themeSourceSchema: z.ZodOptional<z.ZodEnum<{
  */
 export declare const activeThemeSchema: z.ZodOptional<z.ZodString>;
 export declare const layoutConfigSchema: z.ZodObject<{
+    footerMode: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        default: "default";
+        blocks: "blocks";
+        "default+blocks": "default+blocks";
+    }>>;
     footerBlocks: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         kind: z.ZodString;

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

@@ -8,6 +8,9 @@ import type { PublicTeamMemberBlockItem } from './teamMemberContracts';
 import type { ResolveEventSubrouteResponse } from './eventSubrouteContracts';
 export type { PublicTeamMemberBlockItem, PublicTeamMemberPhoto, PublicTeamMemberSummary, } from './teamMemberContracts';
 export type RuntimeSiteSdkConfig = {
+    layout?: {
+        footerMode?: import('../../../theme-core/src/footer/mode').FooterMode;
+    };
     theme?: SdkThemeConfig;
     customBlocks?: SdkCustomBlock[];
 };
@@ -286,7 +289,7 @@ export type SiteRouteRecord = {
     publishedAt?: string | null;
 };
 export type SiteBookingOfferingPresetSummary = ApiSiteBookingOfferingPresetSummary;
-type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | 'bookingAttribution' | Extract<keyof ApiSiteBySlugResponse, `selection${string}`>>;
+type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'hostedBookingAppearance' | 'themeId' | 'bookingAttribution' | Extract<keyof ApiSiteBySlugResponse, `selection${string}`>>;
 export type SiteResponse = SiteSelectionResponse & {
     site: ApiSiteBySlugResponse['site'] & {
         id: 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.140.0";
+export declare const SDK_VERSION = "0.142.0";

package/dist/_dts/theme-core/src/ThemeFontLoader.d.ts

@@ -1,8 +1,24 @@
 import * as React from "react";
 import type { Theme, Typography } from "./schema";
 import type { SiteFont } from "./fonts/types";
+/**
+ * Collect unique font families from typography config
+ */
+type FontLoadingStyle = Readonly<{
+    family: string;
+    weight?: Typography['body']['weight'] | number;
+}>;
+type FontLoadingWeight = Readonly<{
+    weight?: Typography['body']['weight'] | number | null;
+}>;
+type FontLoadingTypography = Readonly<{
+    body: FontLoadingStyle;
+    headings: Readonly<{
+        default: FontLoadingStyle;
+    }> & Partial<Record<'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6', FontLoadingWeight>>;
+}>;
 type ThemeFontLoaderProps = {
-    typography: Typography;
+    typography: FontLoadingTypography;
     /** Optional button font weight from theme.buttons.global.fontWeight */
     buttonFontWeight?: number;
     /** Optional extra weights to load for the body font (useful for UI labels, etc.) */

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

@@ -0,0 +1,17 @@
+/**
+ * Internal: the opt-out the generated affordance rule is written against.
+ *
+ * A button style may declare a trailing `affordance`, which the theme renders as
+ * a CSS `::after` on every button of that variant. An authored button that
+ * renders its own trailing icon must not also receive the theme's, or it shows
+ * two.
+ *
+ * Deliberately not exported from `./index`. This used to be public, and two
+ * block components reached past the theme to draw arrows of their own — one of
+ * them doubling up on the styles that declare an affordance, both of them
+ * 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`.
+ */
+export declare const AFFORDANCE_SUPPRESS_CLASS = "rb-affordance-off";

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

@@ -16,7 +16,7 @@ export declare const BUTTON_CONTRAST_POLICY: {
     readonly nonTextMinimumRatio: 3;
     readonly gradientSamplesPerSegment: 20;
     readonly alphaBackgrounds: "reject-without-known-surface";
-    readonly disabled: "retain-full-colour-contract";
+    readonly disabled: "validated-colour-pair-with-muted-control-opacity";
 };
 export type ButtonColourContractError = Readonly<{
     tag: 'unknown_palette_token';

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

@@ -19,3 +19,19 @@ export declare function themeButtonVariantClassNames(variant: ThemeButtonVariant
 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.
+ *
+ * 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
+ * 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
+ * asserting a policy it does not own, and would quietly become a lie the moment
+ * that policy moved.
+ *
+ * Do not reach for this to remove an arrow you simply do not want. A trailing
+ * affordance is declared by the button style, and a block overriding that is the
+ * defect this replaced.
+ */
+export declare function themeButtonClassNameWithTrailingIcon(spec: ThemeButtonClassSpec): ThemeButtonClassName;

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

@@ -1,11 +1,5 @@
 import type { Theme } from '../schema';
 import type { ButtonSystem } from './types';
-/**
- * Class the `button` runtime node adds when it renders its own trailing icon,
- * so a node-level icon suppresses the theme's CSS `::after` affordance.
- * Shared so generator and renderer can't drift.
- */
-export declare const AFFORDANCE_SUPPRESS_CLASS = "rb-affordance-off";
 export interface GenerateButtonCssOptions {
     themeId: string;
     theme: Theme;

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

@@ -11,9 +11,9 @@ export declare function resolvedButtonColourDeclarations(colour: ResolvedButtonC
 }>): readonly ButtonCssDeclaration[];
 export declare function resolvedButtonFocusDeclarations(indicator: ResolvedButtonFocusIndicator, role?: string): readonly ButtonCssDeclaration[];
 /**
- * Disabled buttons retain their validated colour pair and add a non-layout
- * visual affordance. `currentColor` keeps the cue inside the same contrast
- * relationship, while retaining pointer events lets the not-allowed cursor
- * remain observable.
+ * Disabled buttons are deliberately muted as unavailable controls. Native
+ * disabled controls are exempt from active-control contrast requirements;
+ * opacity distinguishes the state without introducing a focus-like outline.
+ * Retaining pointer events lets the not-allowed cursor remain observable.
  */
 export declare const RESOLVED_BUTTON_DISABLED_DECLARATIONS: readonly ButtonCssDeclaration[];

package/dist/_dts/theme-core/src/footer/mode.d.ts

@@ -1,4 +1,13 @@
-import type { FooterMode } from '../schema';
+import { z } from 'zod';
+export declare const footerModeSchema: z.ZodEnum<{
+    none: "none";
+    default: "default";
+    blocks: "blocks";
+    "default+blocks": "default+blocks";
+}>;
+export type FooterMode = z.infer<typeof footerModeSchema>;
+/** Reads only SDK footer intent; unrelated config and theme fields are not authorities. */
+export declare function resolveSdkFooterMode(config: unknown): FooterMode;
 export type FooterBrandVisibility = Readonly<{
     showLogo: boolean;
     showTitle: boolean;