@riverbankcms/sdk 0.139.0 → 0.140.0

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/MailingListGlobalSettingsSummary.d.ts

@@ -0,0 +1,10 @@
+import type { MailingListAuthoringContext } from '../../../../api/src/index';
+import type { ReactElement } from 'react';
+/**
+ * The read-only "what every signup on this site shares" card. Editors only
+ * choose targeting; fields, confirmation and copy are set once by an
+ * administrator, so this tells them what they are working inside of.
+ */
+export declare function MailingListGlobalSettingsSummary({ context }: Readonly<{
+    context: MailingListAuthoringContext;
+}>): ReactElement | null;

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/MailingListTargetingField.d.ts

@@ -1,7 +1,8 @@
 import type { FieldWidgetProps, GroupFieldConfig } from '../../../../block-form/src/index';
 import { type MailingListPlacementTargeting, type MailingListRuntimeContext } from '../../../../core/src/index';
-export declare function MailingListTargetingField({ path, backend, config }: FieldWidgetProps<MailingListPlacementTargeting, GroupFieldConfig>): import("react").JSX.Element;
-export declare function MailingListTargetingControl({ context, targeting, onChange, name }: Readonly<{
+export { MailingListGlobalSettingsSummary } from './MailingListGlobalSettingsSummary';
+export declare function MailingListTargetingField({ path, backend, config, }: FieldWidgetProps<MailingListPlacementTargeting, GroupFieldConfig>): import("react").JSX.Element;
+export declare function MailingListTargetingControl({ context, targeting, onChange, name, }: Readonly<{
     context: Extract<MailingListRuntimeContext, {
         tag: 'configured';
     }>;

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/context.d.ts

@@ -1,6 +1,7 @@
 import { type ReactNode } from 'react';
-import type { MailingListRuntimeContext, SiteId } from '../../../../core/src/index';
-export type MailingListAuthoringContextLoader = (siteId: SiteId) => Promise<MailingListRuntimeContext>;
+import type { MailingListAuthoringContext } from '../../../../api/src/index';
+import type { SiteId } from '../../../../core/src/index';
+export type MailingListAuthoringContextLoader = (siteId: SiteId) => Promise<MailingListAuthoringContext>;
 type Value = Readonly<{
     siteId: SiteId;
     load: MailingListAuthoringContextLoader;

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/loaders.d.ts

@@ -1,6 +1,7 @@
+import type { MailingListAuthoringContext } from '../../../../api/src/index';
 import type { ApiClient } from '../../../../api/src/request';
-import type { MailingListRuntimeContext, SiteId } from '../../../../core/src/index';
+import type { SiteId } from '../../../../core/src/index';
 export declare function loadMailingListAuthoringContext(input: Readonly<{
     apiClient: ApiClient;
     siteId: SiteId;
-}>): Promise<MailingListRuntimeContext>;
+}>): Promise<MailingListAuthoringContext>;

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/targetingState.d.ts

@@ -0,0 +1,19 @@
+import { type MailingListPlacementTargeting, type MailingListRuntimeContext } from '../../../../core/src/index';
+type ConfiguredContext = Extract<MailingListRuntimeContext, {
+    tag: 'configured';
+}>;
+type CustomTargeting = Exclude<MailingListPlacementTargeting, {
+    mode: 'default';
+}>;
+/** The name of the site's default topic/list/audience, or null when it no longer exists. */
+export declare function defaultItemName(context: ConfiguredContext): string | null;
+/** What the editor is choosing between, in the provider's own words. */
+export declare function choiceNoun(context: ConfiguredContext, form?: 'singular' | 'plural'): string;
+export declare function providerDisplayName(context: ConfiguredContext): string;
+export declare function providerDefaultIsAvailable(context: ConfiguredContext): boolean;
+export declare function createInitialCustom(context: ConfiguredContext): CustomTargeting;
+export declare function changeSelectionMode(context: ConfiguredContext, targeting: CustomTargeting, mode: 'fixed' | 'visitor_choice'): CustomTargeting;
+export declare function canOfferVisitorChoice(context: ConfiguredContext, targeting: CustomTargeting): boolean;
+export declare function toggle(values: readonly string[], id: string): string[];
+export declare function toggleRequired(values: readonly string[], id: string): string[];
+export {};

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

@@ -222,7 +222,6 @@ export type SitePrivacyPolicyDocument = {
     sections: SitePrivacyPolicySection[];
 };
 export type SiteLegalJurisdiction = 'UK' | 'US' | 'EU' | 'CA' | 'AU' | 'OTHER';
-/** Mirrors `SiteLegalIdentitySource` in `@riverbankcms/api`. */
 export type SiteLegalIdentitySource = 'public' | 'custom';
 export type SiteLegalProfilePayload = {
     legalEntityName: string | null;
@@ -232,7 +231,6 @@ export type SiteLegalProfilePayload = {
     privacyContactEmailSource: SiteLegalIdentitySource;
     privacyPolicyPublished: boolean;
 };
-/** Mirrors `SiteRuntimeBusinessDetails` in `@riverbankcms/api`. */
 export type SiteRuntimeBusinessDetails = {
     tagline: string | null;
     contact: {
@@ -288,10 +286,9 @@ export type SiteRouteRecord = {
     publishedAt?: string | null;
 };
 export type SiteBookingOfferingPresetSummary = ApiSiteBookingOfferingPresetSummary;
-/** Keep the SDK's selection metadata aligned with the runtime response. */
-type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | Extract<keyof ApiSiteBySlugResponse, `selection${string}`>>;
+type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | 'bookingAttribution' | Extract<keyof ApiSiteBySlugResponse, `selection${string}`>>;
 export type SiteResponse = SiteSelectionResponse & {
-    site: {
+    site: ApiSiteBySlugResponse['site'] & {
         id: string;
         title: string;
         slug: string;
@@ -356,6 +353,7 @@ export type SdkRuntimePage = {
     canonicalUrl?: string | null;
     blocks: Array<{
         id: string;
+        contentVersionId: string | null;
         kind: string;
         purpose?: string;
         content: Record<string, unknown>;
@@ -374,37 +372,34 @@ export type SdkTemplate = {
         bindings: Record<string, unknown> | null;
     }>;
 };
+type SdkSlotBlockIdentity = {
+    id: string;
+    blockId?: string;
+    contentVersionId: string;
+    kind: string;
+    purpose: string;
+    orderIndex?: number | null;
+    admission?: SdkBlockContentAdmission;
+};
 export type SdkEntrySlotContent = {
     entrySlotId: string;
     slotKey: string;
-    blocks: Array<{
-        id: string;
-        blockId?: string;
-        kind: string;
-        purpose: string;
-        orderIndex?: number | null;
+    blocks: Array<SdkSlotBlockIdentity & {
         content: Record<string, unknown> | null;
-        admission?: SdkBlockContentAdmission;
     }>;
 };
 export type SdkSurfaceSlotContent = {
     surfaceSlotId: string;
     pageSurfaceId: string;
     slotKey: string;
-    blocks: Array<{
-        id: string;
-        blockId?: string;
+    blocks: Array<SdkSlotBlockIdentity & {
         surfaceSlotId: string;
         identifier?: string | null;
-        kind: string;
-        purpose: string;
-        orderIndex?: number | null;
         content: Record<string, unknown>;
         draftContent?: unknown;
         publishedContent?: unknown;
         draftContentId?: string | null;
         publishedContentId?: string | null;
-        admission?: SdkBlockContentAdmission;
     }>;
 };
 export type SdkRuntimePageSurfaceSubject = ApiSdkRuntimePageSurfaceSubject;
@@ -555,7 +550,6 @@ export type PublicFormResponse = {
 export type PublicFormsResponse = {
     forms: FormRecord[];
 };
-/** Visitor-facing appointment service, shared with the API redaction boundary. */
 export type PublicBookingService = ApiPublicBookingService;
 export type PublicBookingServicesResponse = {
     services: Array<Omit<PublicBookingService, 'description'> & {

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

@@ -1,4 +1,5 @@
 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 { SdkCustomBlock } from '../config/types';
@@ -23,6 +24,7 @@ export type PageRendererDataContext = {
     /** Canonical request pathname used by blocks when resolving same-site destinations. */
     pathname?: string;
     resolvedData?: Record<string, Record<string, unknown>>;
+    loaderFailures?: BlockLoaderFailures;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
     mailingList?: import('../../../core/src/index').MailingListRuntimeContext;
     bookingTimeZone?: string;

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

@@ -60,6 +60,8 @@ type PageCommonProps = {
      * Used to pass occurrence context and content entry data to blocks.
      */
     dataContext?: {
+        /** 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) */
         occurrenceContext?: OccurrenceContextData | null;
         /** Event-occurrence subroute context. */

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

@@ -38,6 +38,9 @@ export type PageRecordForPreview = Readonly<{
 }>;
 export declare function buildSiteRenderSupport(site: SiteResponse, mediaAssets: readonly MediaAssetIndexItem[] | undefined): SiteRenderSupport;
 export declare function collectMediaAssetSidecar(mediaAssets: readonly MediaAssetIndexItem[] | null | undefined): readonly MediaAssetIndexItem[] | undefined;
+type TransportedPageBlock = PageOutline['blocks'][number] & Readonly<{
+    contentVersionId?: string | null;
+}>;
 export declare function readInvalidBlockAdmission(value: unknown): Readonly<{
     kind: 'invalid';
     error: PageBlockRenderAdmissionError;
@@ -48,7 +51,9 @@ export declare function buildPageOutline(input: Readonly<{
     fallbackPath: string;
     purpose: string;
     blocks: readonly unknown[];
-}>): PageOutline;
+}>): Omit<PageOutline, 'blocks'> & Readonly<{
+    blocks: TransportedPageBlock[];
+}>;
 export declare function buildRenderablePageOutline(input: Readonly<{
     name: string;
     path: string | null | undefined;
@@ -61,3 +66,4 @@ export declare function projectRenderablePageOutline(page: RenderablePageOutline
 export declare function resolveSdkBlockManifest(blockKind: string, customBlocks: readonly SdkCustomBlock[] | undefined): BlockManifest | FieldDefinition[] | null;
 export declare function invalidRenderableBlock(block: Omit<RenderablePageBlock, 'admission'>, error: PageBlockRenderAdmissionError): RenderablePageBlock;
 export declare function sanitizeSdkRuntimeBlockContent(blockKind: string, content: Record<string, unknown>): Record<string, unknown>;
+export {};

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

@@ -21,6 +21,7 @@ type TemplateBlock = {
 type EntrySlotBlock = {
     id: string;
     blockId?: string;
+    contentVersionId: string;
     kind: string;
     purpose: string;
     content: Record<string, unknown> | 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.139.0";
+export declare const SDK_VERSION = "0.140.0";

package/dist/_dts/theme-core/src/accordions/types.d.ts

@@ -3,9 +3,9 @@ import { z } from 'zod';
  * Accordion icon styles for expand/collapse indicators
  */
 export declare const accordionIconSchema: z.ZodEnum<{
+    caret: "caret";
     "plus-minus": "plus-minus";
     chevron: "chevron";
-    caret: "caret";
     arrow: "arrow";
     "circle-plus-minus": "circle-plus-minus";
 }>;
@@ -61,9 +61,9 @@ export declare const accordionSystemSchema: z.ZodObject<{
     }, z.core.$strip>>;
     icon: z.ZodObject<{
         style: z.ZodEnum<{
+            caret: "caret";
             "plus-minus": "plus-minus";
             chevron: "chevron";
-            caret: "caret";
             arrow: "arrow";
             "circle-plus-minus": "circle-plus-minus";
         }>;
@@ -122,8 +122,8 @@ export declare const accordionSystemSchema: z.ZodObject<{
             colorToken: z.ZodString;
             thickness: z.ZodEnum<{
                 medium: "medium";
-                thin: "thin";
                 thick: "thick";
+                thin: "thin";
             }>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;

package/dist/_dts/theme-core/src/cards/types.d.ts

@@ -205,8 +205,8 @@ export declare const cardAccentEdgeSchema: z.ZodObject<{
     colorToken: z.ZodString;
     width: z.ZodEnum<{
         medium: "medium";
-        thin: "thin";
         thick: "thick";
+        thin: "thin";
         heavy: "heavy";
     }>;
 }, z.core.$strip>;
@@ -214,8 +214,8 @@ export type CardAccentEdge = z.infer<typeof cardAccentEdgeSchema>;
 /** `hairline` (1px) is the widening the boxless `open` role needs. */
 export declare const cardEdgeRuleWidthSchema: z.ZodEnum<{
     medium: "medium";
-    thin: "thin";
     thick: "thick";
+    thin: "thin";
     hairline: "hairline";
     heavy: "heavy";
 }>;
@@ -226,8 +226,8 @@ export declare const cardEdgeRuleLengthSchema: z.ZodEnum<{
 }>;
 export declare const cardEdgeRuleAlignSchema: z.ZodEnum<{
     center: "center";
-    start: "start";
     end: "end";
+    start: "start";
 }>;
 /**
  * A rule drawn along one card edge. `full` renders as a border side; `short`
@@ -244,8 +244,8 @@ export declare const cardEdgeRuleSchema: z.ZodObject<{
     colorToken: z.ZodString;
     width: z.ZodEnum<{
         medium: "medium";
-        thin: "thin";
         thick: "thick";
+        thin: "thin";
         hairline: "hairline";
         heavy: "heavy";
     }>;
@@ -255,8 +255,8 @@ export declare const cardEdgeRuleSchema: z.ZodObject<{
     }>>;
     align: z.ZodOptional<z.ZodEnum<{
         center: "center";
-        start: "start";
         end: "end";
+        start: "start";
     }>>;
     alpha: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -275,8 +275,8 @@ export declare const cardDecorationSchema: z.ZodObject<{
     colorToken: z.ZodString;
     width: z.ZodEnum<{
         medium: "medium";
-        thin: "thin";
         thick: "thick";
+        thin: "thin";
         hairline: "hairline";
         heavy: "heavy";
     }>;
@@ -286,8 +286,8 @@ export declare const cardDecorationSchema: z.ZodObject<{
     }>>;
     align: z.ZodOptional<z.ZodEnum<{
         center: "center";
-        start: "start";
         end: "end";
+        start: "start";
     }>>;
     alpha: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -302,8 +302,8 @@ export declare const cardDecorationsSchema: z.ZodArray<z.ZodObject<{
     colorToken: z.ZodString;
     width: z.ZodEnum<{
         medium: "medium";
-        thin: "thin";
         thick: "thick";
+        thin: "thin";
         hairline: "hairline";
         heavy: "heavy";
     }>;
@@ -313,8 +313,8 @@ export declare const cardDecorationsSchema: z.ZodArray<z.ZodObject<{
     }>>;
     align: z.ZodOptional<z.ZodEnum<{
         center: "center";
-        start: "start";
         end: "end";
+        start: "start";
     }>>;
     alpha: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
@@ -490,8 +490,8 @@ export declare const cardVariantSchema: z.ZodPipe<z.ZodObject<{
         colorToken: z.ZodString;
         width: z.ZodEnum<{
             medium: "medium";
-            thin: "thin";
             thick: "thick";
+            thin: "thin";
             hairline: "hairline";
             heavy: "heavy";
         }>;
@@ -501,8 +501,8 @@ export declare const cardVariantSchema: z.ZodPipe<z.ZodObject<{
         }>>;
         align: z.ZodOptional<z.ZodEnum<{
             center: "center";
-            start: "start";
             end: "end";
+            start: "start";
         }>>;
         alpha: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
@@ -516,8 +516,8 @@ export declare const cardVariantSchema: z.ZodPipe<z.ZodObject<{
         colorToken: z.ZodString;
         width: z.ZodEnum<{
             medium: "medium";
-            thin: "thin";
             thick: "thick";
+            thin: "thin";
             heavy: "heavy";
         }>;
     }, z.core.$strip>>;
@@ -566,15 +566,15 @@ export declare const cardVariantSchema: z.ZodPipe<z.ZodObject<{
     decorations?: {
         edge: "left" | "right" | "bottom" | "top";
         colorToken: string;
-        width: "medium" | "thin" | "thick" | "hairline" | "heavy";
+        width: "medium" | "thick" | "thin" | "hairline" | "heavy";
         length?: "short" | "full" | undefined;
-        align?: "center" | "start" | "end" | undefined;
+        align?: "center" | "end" | "start" | undefined;
         alpha?: number | undefined;
     }[] | undefined;
     accentEdge?: {
         edge: "left" | "right" | "bottom" | "top";
         colorToken: string;
-        width: "medium" | "thin" | "thick" | "heavy";
+        width: "medium" | "thick" | "thin" | "heavy";
     } | undefined;
 }>>;
 export declare const cardSystemSchema: z.ZodPipe<z.ZodObject<{
@@ -719,8 +719,8 @@ export declare const cardSystemSchema: z.ZodPipe<z.ZodObject<{
             colorToken: z.ZodString;
             width: z.ZodEnum<{
                 medium: "medium";
-                thin: "thin";
                 thick: "thick";
+                thin: "thin";
                 hairline: "hairline";
                 heavy: "heavy";
             }>;
@@ -730,8 +730,8 @@ export declare const cardSystemSchema: z.ZodPipe<z.ZodObject<{
             }>>;
             align: z.ZodOptional<z.ZodEnum<{
                 center: "center";
-                start: "start";
                 end: "end";
+                start: "start";
             }>>;
             alpha: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
@@ -745,8 +745,8 @@ export declare const cardSystemSchema: z.ZodPipe<z.ZodObject<{
             colorToken: z.ZodString;
             width: z.ZodEnum<{
                 medium: "medium";
-                thin: "thin";
                 thick: "thick";
+                thin: "thin";
                 heavy: "heavy";
             }>;
         }, z.core.$strip>>;
@@ -795,15 +795,15 @@ export declare const cardSystemSchema: z.ZodPipe<z.ZodObject<{
         decorations?: {
             edge: "left" | "right" | "bottom" | "top";
             colorToken: string;
-            width: "medium" | "thin" | "thick" | "hairline" | "heavy";
+            width: "medium" | "thick" | "thin" | "hairline" | "heavy";
             length?: "short" | "full" | undefined;
-            align?: "center" | "start" | "end" | undefined;
+            align?: "center" | "end" | "start" | undefined;
             alpha?: number | undefined;
         }[] | undefined;
         accentEdge?: {
             edge: "left" | "right" | "bottom" | "top";
             colorToken: string;
-            width: "medium" | "thin" | "thick" | "heavy";
+            width: "medium" | "thick" | "thin" | "heavy";
         } | undefined;
     }>>>;
 }, z.core.$strip>, z.ZodTransform<CardSystem, {