@riverbankcms/sdk 0.145.0 → 0.147.0

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/eventCollectionContract.d.ts

@@ -488,11 +488,15 @@ export declare const eventCollectionSourceSchemaShape: {
                 series_archived: "series_archived";
                 parent_archived: "parent_archived";
                 parent_inconsistent: "parent_inconsistent";
-                not_public: "not_public";
                 already_started: "already_started";
                 enrollment_closed: "enrollment_closed";
             }>;
         }, z.core.$strip>], "kind">;
+        bookingClosedDetail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"opensSoon">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"paused">;
+        }, z.core.$strip>], "kind">>;
         deliveryMode: z.ZodEnum<{
             in_person: "in_person";
             online: "online";
@@ -973,11 +977,15 @@ export declare const eventCollectionSourceSchemaShape: {
                 series_archived: "series_archived";
                 parent_archived: "parent_archived";
                 parent_inconsistent: "parent_inconsistent";
-                not_public: "not_public";
                 already_started: "already_started";
                 enrollment_closed: "enrollment_closed";
             }>;
         }, z.core.$strip>], "kind">;
+        bookingClosedDetail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"opensSoon">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"paused">;
+        }, z.core.$strip>], "kind">>;
         deliveryMode: z.ZodEnum<{
             in_person: "in_person";
             online: "online";
@@ -1519,11 +1527,15 @@ export declare const eventCollectionDisplaySchemaShape: {
                 series_archived: "series_archived";
                 parent_archived: "parent_archived";
                 parent_inconsistent: "parent_inconsistent";
-                not_public: "not_public";
                 already_started: "already_started";
                 enrollment_closed: "enrollment_closed";
             }>;
         }, z.core.$strip>], "kind">;
+        bookingClosedDetail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"opensSoon">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"paused">;
+        }, z.core.$strip>], "kind">>;
         deliveryMode: z.ZodEnum<{
             in_person: "in_person";
             online: "online";
@@ -2004,11 +2016,15 @@ export declare const eventCollectionDisplaySchemaShape: {
                 series_archived: "series_archived";
                 parent_archived: "parent_archived";
                 parent_inconsistent: "parent_inconsistent";
-                not_public: "not_public";
                 already_started: "already_started";
                 enrollment_closed: "enrollment_closed";
             }>;
         }, z.core.$strip>], "kind">;
+        bookingClosedDetail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"opensSoon">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"paused">;
+        }, z.core.$strip>], "kind">>;
         deliveryMode: z.ZodEnum<{
             in_person: "in_person";
             online: "online";

package/dist/_dts/blocks/src/system/runtime/nodes/form.fields.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { FormFieldDef } from './form.types';
+export declare function FormFieldControl({ field }: Readonly<{
+    field: FormFieldDef;
+}>): React.ReactElement;

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.block-submission.d.ts

@@ -0,0 +1,34 @@
+import { type MailingListSignupSourceRef } from '../../../../../core/src/index';
+import type { PublishedBlockPlacementRead } from '../../../pageRenderAdmission';
+export type NewsletterBlockSubmission = Readonly<{
+    tag: 'ready';
+    sourceRef: Extract<MailingListSignupSourceRef, {
+        tag: 'block_ref';
+    }>;
+}> | Readonly<{
+    tag: 'unpublished-form';
+}> | Readonly<{
+    tag: 'unpublished-settings';
+}> | Readonly<{
+    tag: 'unavailable';
+}>;
+type BlockPlacement = Readonly<{
+    blockId: string | null;
+    selectedContentVersionId: string | null;
+    publishedPlacement: PublishedBlockPlacementRead;
+    renderedContent: Record<string, unknown>;
+    stage: 'published' | 'preview' | undefined;
+}>;
+/** Authorise one block source for both public and preview rendering. */
+export declare function planNewsletterBlockSubmission(placement: BlockPlacement): NewsletterBlockSubmission;
+type PreviewPlacement = Readonly<{
+    blockId: string | null;
+    publishedContentId: string | null;
+    renderedContent: Record<string, unknown>;
+    publishedContent: Record<string, unknown> | null;
+}>;
+/** Decide whether the visible draft can safely cite the published placement. */
+export declare function planNewsletterPreviewSubmission(placement: PreviewPlacement): Exclude<NewsletterBlockSubmission, {
+    tag: 'unavailable';
+}>;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.client.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { NewsletterFormInteractiveIslandProps } from './newsletter-form.interactive';
+import { type NewsletterFormInteractiveIslandProps } from './newsletter-form.interactive';
 /**
  * Newsletter Form Client Component
  *

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.interactive.d.ts

@@ -31,7 +31,12 @@ export type NewsletterFormHydrationTarget = Readonly<{
     sourceRef: MailingListSignupSignedSourceRef;
 }> | Readonly<{
     tag: 'preview';
+}> | Readonly<{
+    tag: 'unpublished-preview';
+    reason: 'unpublished-form' | 'unpublished-settings';
 }>;
+export declare const NEWSLETTER_SIGNUPS_PAUSED_MESSAGE = "We can\u2019t accept signups right now. Please try again later.";
+export declare function newsletterBlockSubmissionMessage(target: NewsletterFormHydrationTarget): string | null;
 type MailingListSignupBlockSourceRef = Extract<MailingListSignupSourceRef, {
     tag: 'block_ref';
 }>;
@@ -42,7 +47,7 @@ type NewsletterIslandMeta = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
 }>;
-export declare function buildNewsletterDisplay(source: NewsletterFormSourceProps): NewsletterFormDisplay;
+export declare function buildNewsletterDisplay(source: Pick<NewsletterFormSourceProps, 'source' | 'mailingList' | 'targeting' | 'buttonVariant' | 'className'>): NewsletterFormDisplay;
 export type NewsletterFormInteractiveIslandProps = InteractiveIslandProps<NewsletterIslandMeta, 'newsletter-form', typeof newsletterFormBlockRuntime>;
 export declare const newsletterFormBlockRuntime: Readonly<{
     kind: "progressive";

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.parts.d.ts

@@ -0,0 +1,46 @@
+import React from 'react';
+import type { NewsletterButtonVariant, NewsletterFieldDef } from './newsletter-form.types';
+/**
+ * Newsletter form pieces shared by the SSR render and the hydrated island, so
+ * both produce the same markup.
+ *
+ * Labels are visually hidden: every field has a placeholder, and a visible
+ * "Email *" label over a single field reads like a generic form. Screen
+ * readers still get the label.
+ */
+export declare const TOPIC_CHOICE_FIELD_ID = "mailingListChoice";
+type FieldState = Readonly<{
+    disabled?: boolean;
+    error?: string | null;
+}>;
+/** Splits the preset's fields into the email (joined with the button) and the rest. */
+export declare function partitionNewsletterFields(fields: readonly NewsletterFieldDef[]): Readonly<{
+    email: NewsletterFieldDef | null;
+    extra: readonly NewsletterFieldDef[];
+}>;
+export declare function NewsletterExtraField({ field, disabled, error, }: Readonly<{
+    field: NewsletterFieldDef;
+}> & FieldState): React.ReactElement;
+/** The email field and submit button sharing one input-styled shell. */
+export declare function NewsletterEmailEntry({ field, buttonVariant, buttonLabel, disabled, error, }: Readonly<{
+    field: NewsletterFieldDef;
+    buttonVariant: NewsletterButtonVariant;
+    buttonLabel: string;
+}> & FieldState): React.ReactElement;
+/**
+ * The submit action: joined to the email field when the preset has one
+ * (every current preset does), otherwise a plain themed button.
+ */
+export declare function NewsletterSubmitRow({ emailField, buttonVariant, buttonLabel, disabled, error, }: Readonly<{
+    emailField: NewsletterFieldDef | null;
+    buttonVariant: NewsletterButtonVariant;
+    buttonLabel: string;
+}> & FieldState): React.ReactElement;
+/** Visitor-chosen topics as toggle chips. Real checkboxes underneath. */
+export declare function NewsletterTopicChips({ choices, disabled, error, }: Readonly<{
+    choices: readonly Readonly<{
+        id: string;
+        label: string;
+    }>[];
+}> & FieldState): React.ReactElement;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.types.d.ts

@@ -5,6 +5,7 @@
  */
 import type { MailingListGlobalForm, MailingListPlacementTargeting, MailingListRuntimeContext, MailingListSignupSourceRef } from '../../../../../core/src/index';
 import type { BlockButtonRole } from '../../constants/buttonRoles';
+import type { NewsletterBlockSubmission } from './newsletter-form.block-submission';
 export type NewsletterPreset = MailingListGlobalForm['fields']['preset'];
 export type NewsletterFieldDef = {
     id: string;
@@ -33,7 +34,7 @@ type NewsletterFormCommonProps = {
 type BlockNewsletterFormSource = Readonly<{
     source: 'block';
     blockId?: string | null;
-    contentVersionId?: string | null;
+    newsletterBlockSubmission: NewsletterBlockSubmission;
 }>;
 type SignedFooterNewsletterFormSource = Readonly<{
     source: 'signed-footer';

package/dist/_dts/blocks/src/system/runtime/resolver.d.ts

@@ -1,9 +1,11 @@
 import React from "react";
+import type { ThemeColorToken } from '../../../../theme-core/src/tokens/index';
 import type { ConditionalAuthoringPresence, NodeDefinition } from "../node";
 import { bindingSchema } from "../node";
 import { type ThemeTokens } from "../theme";
 import type { TransformRegistry, RouteMap, PageIdentifierMap, EntryIdentifierMap } from "../transforms";
 import type { ResolveImageUrlContext } from "./nodes/media";
+import type { NewsletterBlockSubmission } from './nodes/newsletter-form.block-submission';
 export type ViewModel = Record<string, unknown>;
 export type ComponentRegistry = Record<string, React.ElementType>;
 export type PreviewTextFieldConstraints = Readonly<{
@@ -23,6 +25,7 @@ export type ResolverContext = {
     registry: ComponentRegistry;
     transforms?: TransformRegistry;
     theme?: ThemeTokens;
+    proseHoverCandidate?: ThemeColorToken;
     routes?: RouteMap;
     /** Page identifier -> routeId lookup for { kind: 'page' } links */
     pagesByIdentifier?: PageIdentifierMap;
@@ -30,7 +33,7 @@ export type ResolverContext = {
     entriesByIdentifier?: EntryIdentifierMap;
     pathBase?: string;
     blockId?: string | null;
-    contentVersionId?: string | null;
+    newsletterBlockSubmission?: NewsletterBlockSubmission;
     blockKind?: string;
     blockContent?: unknown;
     blockBindings?: Record<string, unknown>;

package/dist/_dts/blocks/src/system/runtime/shared/components/BookingMailingListNote.d.ts

@@ -0,0 +1,6 @@
+import type { BookingMailingListNote as Note } from '../../../../../../core/src/index';
+export declare function BookingMailingListNote(props: Readonly<{
+    note: Note;
+    context: 'booking' | 'waitlist';
+    className?: string;
+}>): import("react").JSX.Element;

package/dist/_dts/blocks/src/system/runtime/shared/components/CheckboxChoice.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+type CheckboxChoiceProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'className'> & Readonly<{
+    label: React.ReactNode;
+    /**
+     * `row` for options and plain checkbox fields. `tile` for agreements the
+     * customer must accept (booking consent, consent fields): a bordered,
+     * fully clickable panel that tints when ticked.
+     */
+    presentation?: 'row' | 'tile';
+    className?: string;
+}>;
+/**
+ * The customer-facing checkbox every block renders. Styling comes from the
+ * theme's input CSS (`.form-check`, `.form-checkbox`), so it follows each
+ * site's input colours, borders and corners.
+ */
+export declare function CheckboxChoice({ label, presentation, className, ...inputProps }: CheckboxChoiceProps): React.ReactElement;
+export {};

package/dist/_dts/blocks/src/system/runtime/shared/components/index.d.ts

@@ -1,6 +1,7 @@
 /**
  * Shared Components Barrel Export
  */
+export { CheckboxChoice } from './CheckboxChoice';
 export { CheckIcon } from './CheckIcon';
 export { ClockIcon } from './ClockIcon';
 export { CrossIcon } from './CrossIcon';

package/dist/_dts/blocks/src/system/runtime/shared/mailingListSignupCopy.d.ts

@@ -0,0 +1,6 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../core/src/index';
+export declare const MAILING_LIST_CONFIRMATION_MESSAGE = "Please check your inbox to confirm your signup.";
+export declare function getBookingMailingListNoteCopy(note: BookingSignupNote, context: 'booking' | 'waitlist'): Readonly<{
+    title: string;
+    detail: string | null;
+}>;

package/dist/_dts/blocks/src/system/runtime/shared/types.d.ts

@@ -13,6 +13,7 @@ export type FormData = {
     phone: string;
     notes: string;
     consentAccepted?: boolean;
+    mailingListOptIn?: boolean;
 };
 /**
  * Button style variants.

package/dist/_dts/blocks/src/system/transforms/registry/_utils/surfaceForegroundStyles.d.ts

@@ -1,8 +1,9 @@
 import { resolveSurfaceForeground, type ResolvedSurfaceForeground } from '../../../../../../theme-core/src/surfaces/index';
-import type { ThemeHeader } from '../../../../../../theme-core/src/schema';
+import type { ThemeFooter, ThemeHeader } from '../../../../../../theme-core/src/schema';
+import type { ThemeColorToken } from '../../../../../../theme-core/src/tokens/index';
 import type { TransformContext } from '../core';
-export declare function resolveHeaderLeafTextColor(header: Partial<ThemeHeader> | undefined): NonNullable<ThemeHeader['textColor']>;
 export declare function resolveHeaderRootForeground(header: Partial<ThemeHeader> | undefined, palette: Parameters<typeof resolveSurfaceForeground>[1], isTransparent: boolean): ResolvedSurfaceForeground;
+export declare function resolveFooterRootForeground(footer: Partial<ThemeFooter> | undefined, palette: Parameters<typeof resolveSurfaceForeground>[1], proseHoverCandidate?: ThemeColorToken): ResolvedSurfaceForeground;
 export declare function resolveSurfaceForegroundStyles(value: unknown, context: TransformContext, options?: Readonly<{
     fallbackToken?: string;
 }>): Record<string, string>;

package/dist/_dts/blocks/src/system/transforms/registry/core.d.ts

@@ -1,6 +1,7 @@
 import type { z } from "zod";
 import type { ThemeTokens } from "../../theme";
 import type { ButtonSystem } from "../../../../../theme-core/src/buttons/index";
+import type { ThemeColorToken } from "../../../../../theme-core/src/tokens/index";
 type BivariantCallback<TArgs extends unknown[], TResult> = {
     bivarianceHack(...args: TArgs): TResult;
 }["bivarianceHack"];
@@ -20,6 +21,7 @@ export type TransformContext = {
     theme: ThemeTokens & Readonly<{
         buttons?: ButtonSystem;
     }>;
+    proseHoverCandidate?: ThemeColorToken;
     locale?: string;
     stage?: "preview" | "published";
     /**

package/dist/_dts/blocks/src/system/transforms/registry/layout.d.ts

@@ -1,7 +1,6 @@
 import { z } from 'zod';
-import { type ThemeFooter, type ThemeHeader } from '../../../../../theme-core/src/schema';
+import { type ThemeHeader } from '../../../../../theme-core/src/schema';
 import { type TransformDefinition } from './core';
-import { resolveSurfaceForeground, type ResolvedSurfaceForeground } from '../../../../../theme-core/src/surfaces/index';
 declare const headerLogoClassSchema: z.ZodObject<{
     base: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -42,7 +41,6 @@ export declare function resolveHeaderVisualStyles(header: Partial<ThemeHeader> |
     readonly backgroundToken: "transparent";
     readonly isTransparent: true;
 };
-export declare function resolveFooterRootForeground(footer: Partial<ThemeFooter> | undefined, palette: Parameters<typeof resolveSurfaceForeground>[1]): ResolvedSurfaceForeground;
 export declare const headerRootClassTransform: TransformDefinition<HeaderRootOptions>;
 declare const footerRootClassSchema: z.ZodObject<{
     base: z.ZodOptional<z.ZodString>;

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

@@ -21,6 +21,7 @@ export { useUISelector } from './ui/useUISelector';
 export { EditorUiStoreProvider, useEditorUiStore, useEditorUiStoreInstance, useOptionalEditorUiStoreInstance, createEditorUiStore, } from './ui/editorUiStore';
 export type { ActivePreviewField, EditorUiStoreInstance, EditorUiState, EditorPreviewInspectorStore, EditorLinkedEntrySnapshot, PreviewDesignRow, PreviewDesignOpenRequest, PreviewEditorOpenIntent, PreviewInspection, PreviewSidebarTab, ViewportMode, ViewportWidth, ViewportState, ZoomLevel, } from './ui/editorUiStore';
 export { PreviewTextEditor } from './primitives/PreviewTextEditor';
+export { PREVIEW_EDITABLE_OUTLINE, PREVIEW_EDITABLE_OUTLINE_OFFSET, } from './primitives/previewEditableOutline';
 export { PreviewInlineTextEditor } from './primitives/PreviewInlineTextEditor';
 export { PreviewRichTextEditor } from './primitives/PreviewRichTextEditor';
 export { recordsEqual as editorValuesEqual } from './ui/stores/utils';

package/dist/_dts/content-editor/src/primitives/previewEditableOutline.d.ts

@@ -0,0 +1,2 @@
+export declare const PREVIEW_EDITABLE_OUTLINE = "1px dashed rgba(156, 163, 175, 0.75)";
+export declare const PREVIEW_EDITABLE_OUTLINE_OFFSET = "2px";

package/dist/_dts/content-editor/src/ui/editorBlockEquality.d.ts

@@ -0,0 +1,3 @@
+import type { NormalizedEditorBlockItem } from './editorSnapshot';
+export declare function normalizedBlockEqual(left: NormalizedEditorBlockItem, right: NormalizedEditorBlockItem): boolean;
+export declare function normalizedBlocksEqual(left: readonly NormalizedEditorBlockItem[], right: readonly NormalizedEditorBlockItem[]): boolean;

package/dist/_dts/content-editor/src/ui/editorSnapshot.d.ts

@@ -1,4 +1,4 @@
-import { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockBaselineInput, type EditorBlockId, type EditorBlockPublishedBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorPersistedBlock, type EditorSiteId, type EditorStructuralCommand, type EditorStructuralDraftSnapshot, type EditorSyncState, type EditorValueRecord } from '../../../core/src/index';
+import { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockBaselineInput, type EditorBlockId, type EditorBlockPublishedBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorPersistedBlock, type BlockContentIdentity, type EditorSiteId, type EditorStructuralCommand, type EditorStructuralDraftSnapshot, type EditorSyncState, type EditorValueRecord } from '../../../core/src/index';
 import { type LinkedContentEntryId, type LinkedContentTypeKey } from '../linkedEntries/domain';
 export { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockId, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorSiteId, };
 export type EditorCommand = {
@@ -119,9 +119,8 @@ export type DraftBlockInitMetaInput = EditorDraftBlockInitMetaInput;
 export type DraftBlockBaselineUpdateMetaInput = EditorDraftBlockBaselineUpdateMetaInput;
 export type DraftBlockBaselineInput = EditorBlockBaselineInput;
 export type BlockPublishedBaselineInput = EditorBlockPublishedBaselineInput;
-export type EditorBlockItem = Readonly<{
+export type EditorBlockItem = Partial<BlockContentIdentity> & Readonly<{
     id?: string | null;
-    contentVersionId?: string | null;
     kind: string;
     content?: EditorValueRecord | null;
     orderIndex?: number | null;
@@ -131,8 +130,7 @@ export type EditorBlockItem = Readonly<{
     purpose?: string | null;
     optimisticHash?: string | null;
 }>;
-type NormalizedEditorBlockBase = Readonly<{
-    contentVersionId: string | null;
+type NormalizedEditorBlockBase = BlockContentIdentity & Readonly<{
     kind: string;
     content: EditorBlockValues | null;
     orderIndex: number | null;

package/dist/_dts/core/src/block-content-identity.d.ts

@@ -0,0 +1,5 @@
+/** A block version ID is meaningful only with its draft or published stage. */
+export type BlockContentIdentity = Readonly<{
+    draftContentId: string | null;
+    publishedContentId: string | null;
+}>;

package/dist/_dts/core/src/editor-state.d.ts

@@ -1,4 +1,5 @@
 import type { Brand } from './branded';
+import type { BlockContentIdentity } from './block-content-identity';
 export type EditorSiteId = Brand<string, 'EditorSiteId'>;
 export type EditorPageId = Brand<string, 'EditorPageId'>;
 export type EditorEntryId = Brand<string, 'EditorEntryId'>;
@@ -61,14 +62,8 @@ export type EditorBlockPublishedBaselineInput = Readonly<{
     kind?: string;
     publishedContent?: EditorBlockBaselineInput;
 }>;
-export type EditorPersistedBlock = Readonly<{
+export type EditorPersistedBlock = BlockContentIdentity & Readonly<{
     id: EditorBlockId;
-    /**
-     * 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, so the editor must carry it rather than strip it.
-     */
-    contentVersionId?: string | null;
     kind: string;
     content: EditorBlockValues | null;
     orderIndex: number | null;

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

@@ -30,10 +30,10 @@ export { tryAsync } from './try-async';
 export * from './narrow-result';
 export * from './non-empty-array';
 export * from './editor-state';
+export * from './block-content-identity';
 export * from './sensitive-collection';
 export * from './assertNever';
 export * from './participants';
-export * from './participant-identity';
 export * from './public-url-validation';
 export * from './public-profile';
 export * from './public-experience';
@@ -75,5 +75,6 @@ export * from './public-read-cache-contract';
 export * from './booking-verticals';
 export * from './event-series-behaviour';
 export * from './navigation-locations';
+export * from './navigation-portal-labels';
 export * from './event-preset-vocabulary';
 export * from './event-catalogue';

package/dist/_dts/core/src/mailing-list-runtime.d.ts

@@ -6,6 +6,7 @@ export type MailingListRuntimeContext = Readonly<{
 }> | Readonly<{
     tag: 'configured';
     revision: MailingListSetupRevision;
+    bookingSignup: BookingSignupOffer;
     form: MailingListGlobalForm;
     provider: MailingListRuntimeProvider;
 }>;
@@ -40,3 +41,17 @@ export type MailingListRuntimeContextParseError = Readonly<{
     tag: 'invalid_mailing_list_runtime_context';
 }>;
 export declare function parseMailingListRuntimeContext(value: unknown): Result<MailingListRuntimeContext, MailingListRuntimeContextParseError>;
+export type BookingSignupOffer = Readonly<{
+    tag: 'offered';
+}> | Readonly<{
+    tag: 'unavailable';
+    reason: 'disabled' | 'fields' | 'destination';
+}>;
+/** Destination facts are resolved once by the provider adapter, before projection. */
+export declare function planBookingSignupOffer(setup: Readonly<{
+    bookingOptInEnabled: boolean;
+    form: MailingListGlobalForm;
+}>, destination: 'available' | 'unavailable'): BookingSignupOffer;
+export declare function resolveBookingSignupOffer(context: MailingListRuntimeContext | undefined, siteName: string | undefined): Readonly<{
+    siteName: string;
+}> | null;

package/dist/_dts/core/src/mailing-list-setup.d.ts

@@ -73,6 +73,7 @@ export type MailingListSiteSetup = Readonly<{
     tag: 'configured';
     siteId: SiteId;
     revision: MailingListSetupRevision;
+    bookingOptInEnabled: boolean;
     form: MailingListGlobalForm;
     provider: ConfiguredMailingListProvider;
 }>;
@@ -111,6 +112,7 @@ export declare function planMailingListFieldCompatibility(input: Readonly<{
     form: MailingListGlobalForm;
     destinations: readonly MailingListDestinationFieldRequirements[];
 }>): MailingListFieldCompatibilityPlan;
+export declare function resolveRequiredGlobalFields(fields: MailingListGlobalFields): readonly MailingListProfileField[];
 export type MailingListSetupSwitchPlan = Readonly<{
     tag: 'activate';
     affectedPlacementCount: 0;

package/dist/_dts/core/src/mailing-list-submission.d.ts

@@ -29,6 +29,10 @@ export type MailingListSignupSource = Readonly<{
     tag: 'sdk_footer_block';
     blockId: MailingListSdkFooterBlockId;
     contentHash: MailingListSdkContentHash;
+}> | Readonly<{
+    tag: 'booking';
+    kind: 'event' | 'appointment';
+    attemptId: string;
 }>;
 /** Public proof of which published placement owns a signup request. */
 export type MailingListSignupSourceRef = Readonly<{
@@ -49,7 +53,9 @@ export type MailingListSignupTokenSource = Readonly<{
     blockId: MailingListSdkFooterBlockId;
     contentHash: MailingListSdkContentHash;
 }>;
-export declare function buildMailingListSignupBlockSourceRef(blockId: unknown, contentVersionId: unknown): MailingListSignupSourceRef | null;
+export declare function buildMailingListSignupBlockSourceRef(blockId: unknown, contentVersionId: unknown): Extract<MailingListSignupSourceRef, {
+    tag: 'block_ref';
+}> | null;
 type MailingListSignupProfileBase = Readonly<{
     email: NormalizedSubscriberEmail;
     phone: Readonly<{
@@ -221,4 +227,6 @@ export type ExternalSignupConsentRecord = (ExternalSignupConsentRecordBase & Rea
     }>;
     confirmation: BrevoConfirmation;
 }>);
+/** Absence of a note means booking proceeds without a signup message. */
+export type BookingMailingListNote = 'confirmation_required' | 'not_confirmed';
 export {};

package/dist/_dts/core/src/navigation-portal-labels.d.ts

@@ -0,0 +1,9 @@
+/**
+ * What a customer sign-in link in a site's menu says when the site hasn't set
+ * its own text. The site renderer falls back to these, and the dashboard's
+ * menu editor shows them, so what an editor sees is what visitors get.
+ */
+export declare const PORTAL_NAV_DEFAULT_LABELS: {
+    readonly loggedOut: "Login";
+    readonly loggedIn: "My Account";
+};

package/dist/_dts/core/src/participants.d.ts

@@ -115,30 +115,6 @@ export type ParticipantRosterProjection = Readonly<{
     slots: readonly ParticipantRosterSlot[];
     issues: readonly ParticipantRosterReconciliationIssue[];
 }>;
-export type ExistingParticipantByEmail = Readonly<{
-    participantId: ParticipantId;
-    email: ParticipantEmail;
-}>;
-export type ParticipantSubjectResolution = {
-    kind: 'create_participant';
-    slotKey: ParticipantSlotKey;
-    email: ParticipantEmail;
-    displayName: string | null;
-    phone: string | null;
-} | {
-    kind: 'reuse_participant_by_site_email';
-    slotKey: ParticipantSlotKey;
-    email: ParticipantEmail;
-    participantId: ParticipantId;
-} | {
-    kind: 'staff_managed_slot';
-    slotKey: ParticipantSlotKey;
-} | {
-    kind: 'blocked_duplicate_participant_in_booking';
-    slotKey: ParticipantSlotKey;
-    email: ParticipantEmail;
-    conflictingSlotKeys: readonly ParticipantSlotKey[];
-};
 type ParticipantContactInput = Readonly<{
     name: string | null;
     email: string | null;
@@ -166,13 +142,6 @@ export type EventSeriesRegistrationParticipantProjectionInput = Readonly<{
         customerId: CustomerId;
     };
 }>;
-export type EventSeriesSessionAttendanceParticipantProjectionInput = Readonly<{
-    attendeeId: AttendeeId;
-    registrationId: EventSeriesRegistrationId;
-    enrollmentSlot: ParticipantParticipationLinkSlot<Extract<ParticipantParticipation, {
-        kind: 'event_series_registration';
-    }>>;
-}>;
 export type SingleSubjectParticipantRosterTarget = Readonly<{
     kind: 'appointment';
     appointmentId: AppointmentId;
@@ -211,16 +180,9 @@ export declare function projectEventSeriesRegistrationParticipantSlot(input: Eve
 }>>;
 export declare function projectSingleSubjectParticipantRoster(input: SingleSubjectParticipantRosterProjectionInput): ParticipantRosterProjection;
 export declare function buildSingleSubjectParticipantPersistenceIntent(input: SingleSubjectParticipantRosterProjectionInput): SingleSubjectParticipantPersistenceIntent;
-export declare function projectEventSeriesSessionAttendanceParticipantSlot(input: EventSeriesSessionAttendanceParticipantProjectionInput): ParticipantParticipationLinkSlot<Extract<ParticipantParticipation, {
-    kind: 'event_series_session_attendance';
-}>>;
 export declare function projectEventRegistrationParticipantRoster(input: EventRegistrationParticipantProjectionInput): ParticipantRosterProjection;
 export declare function reconcileParticipantRoster(input: {
     expectedCount: ParticipantCount;
     slots: readonly ParticipantRosterSlot[];
 }): readonly ParticipantRosterReconciliationIssue[];
-export declare function planParticipantSubjectResolution(input: {
-    projection: ParticipantRosterProjection;
-    existingParticipantsByEmail: readonly ExistingParticipantByEmail[];
-}): readonly ParticipantSubjectResolution[];
 export {};

package/dist/_dts/core/src/public-event-booking-availability.d.ts

@@ -1,4 +1,4 @@
-export type PublicEventBookingClosedReason = 'occurrence_cancelled' | 'occurrence_completed' | 'series_draft' | 'series_cancelled' | 'series_completed' | 'series_archived' | 'parent_archived' | 'parent_inconsistent' | 'not_public' | 'already_started' | 'enrollment_closed';
+export type PublicEventBookingClosedReason = 'occurrence_cancelled' | 'occurrence_completed' | 'series_draft' | 'series_cancelled' | 'series_completed' | 'series_archived' | 'parent_archived' | 'parent_inconsistent' | 'already_started' | 'enrollment_closed';
 /** Public wire projection; persisted facts remain authoritative. */
 export type PublicEventBookingAvailability = Readonly<{
     kind: 'open';
@@ -6,3 +6,22 @@ export type PublicEventBookingAvailability = Readonly<{
     kind: 'closed';
     reason: PublicEventBookingClosedReason;
 }>;
+/**
+ * Why an event's own page is up while bookings are shut.
+ *
+ * `series_draft` is one reason from the booking decision's point of view, but a
+ * visitor standing on the page is owed two different sentences: an event that
+ * has never opened will open, and one that was open and was taken offline has
+ * closed. The difference is whether the unit has ever been live, which is a
+ * persisted fact the public wire deliberately does not carry as a timestamp.
+ *
+ * This refines `bookingAvailability` rather than replacing it. It is only ever
+ * present alongside a closed `series_draft`, so nothing that already reads the
+ * availability changes its mind because of it, and booking stays refused
+ * wherever it is refused today.
+ */
+export type PublicEventBookingClosedDetail = Readonly<{
+    kind: 'opensSoon';
+}> | Readonly<{
+    kind: 'paused';
+}>;

package/dist/_dts/core/src/public-profile.d.ts

@@ -5,8 +5,10 @@ export type OpeningHoursTime = Brand<string, 'OpeningHoursTime'>;
 export type PublicSocialLinkId = Brand<string, 'PublicSocialLinkId'>;
 export declare const publicProfileWeekdays: readonly ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"];
 export type PublicProfileWeekday = (typeof publicProfileWeekdays)[number];
-export declare const knownSocialPlatforms: readonly ["facebook", "instagram", "linkedin", "tiktok", "x", "youtube"];
+export declare const knownSocialPlatforms: readonly ["facebook", "instagram", "linkedin", "tiktok", "whatsapp", "x", "youtube"];
 export type KnownSocialPlatform = (typeof knownSocialPlatforms)[number];
+/** How each platform is named wherever people see it (settings, composer, footer link labels). */
+export declare const knownSocialPlatformLabels: Readonly<Record<KnownSocialPlatform, string>>;
 export type PublicContactDetails = Readonly<{
     kind: 'phone';
     phone: string;