@riverbankcms/sdk 0.144.0 → 0.146.0

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

@@ -94,8 +94,8 @@ export declare const eventCollectionFilterSourceSchemaShape: {
     readonly showVenueFilter: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly showStaffFilter: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly eventSurface: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        custom: "custom";
         all: "all";
+        custom: "custom";
         regularClassSchedule: "regularClassSchedule";
         specialDatedEvents: "specialDatedEvents";
     }>>>;
@@ -140,8 +140,8 @@ export declare const eventCollectionSourceSchemaShape: {
     readonly showVenueFilter: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly showStaffFilter: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly eventSurface: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        custom: "custom";
         all: "all";
+        custom: "custom";
         regularClassSchedule: "regularClassSchedule";
         specialDatedEvents: "specialDatedEvents";
     }>>>;
@@ -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";
@@ -2213,8 +2229,8 @@ export declare const eventCollectionDisplaySchemaShape: {
     readonly showVenueFilter: z.ZodBoolean;
     readonly showStaffFilter: z.ZodBoolean;
     readonly eventSurface: z.ZodEnum<{
-        custom: "custom";
         all: "all";
+        custom: "custom";
         regularClassSchedule: "regularClassSchedule";
         specialDatedEvents: "specialDatedEvents";
     }>;

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,36 @@
+import { type MailingListSignupSourceRef } from '../../../../../core/src/index';
+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: Readonly<{
+        id: string;
+        content: Record<string, unknown>;
+    }> | null;
+    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.submission.d.ts

@@ -18,12 +18,31 @@ export type NewsletterFormSubmissionFields = Readonly<{
     phone?: string;
     honeypot: string;
 }>;
+/**
+ * Why the form refused to send, before any request was made. Visitors see one
+ * neutral message for all of these; the reason is for whoever is debugging.
+ *
+ * - `missing_block_source`: a page block hydrated without a content version
+ *   to submit against, so the API could not verify the placement.
+ * - `preview_only_source`: the footer editor's live widget, which renders
+ *   unsaved composition state and has nothing published to record against.
+ * - `setup_not_configured`: no mailing-list setup reached the block.
+ * - `destination_unavailable`: the setup is there but the placement's
+ *   destination (default list, custom targeting) is not in it.
+ * - `choices_unusable`: the offered topic choices no longer fit the provider.
+ */
+export type NewsletterSignupRefusalReason = 'missing_block_source' | 'preview_only_source' | 'setup_not_configured' | 'destination_unavailable' | 'choices_unusable';
 export type NewsletterSubmitTargetResolution = Readonly<{
     tag: 'ready';
     sourceRef: MailingListSignupSourceRef;
 }> | Readonly<{
     tag: 'unavailable';
-    reason: 'missing_block_source';
+    reason: Extract<NewsletterSignupRefusalReason, 'missing_block_source' | 'preview_only_source'>;
 }>;
+/**
+ * Logs a refusal with its reason so a QA session can tell the cases apart in
+ * the console, since the visitor-facing copy deliberately does not.
+ */
+export declare function reportNewsletterSignupRefusal(reason: NewsletterSignupRefusalReason, detail?: Readonly<Record<string, unknown>>): void;
 export declare function mapNewsletterFormFieldsToSubscriberInput(fields: NewsletterFormRawSubmissionFields): NewsletterFormSubmissionFields;
 export declare function resolveNewsletterSubmitTarget(input: NewsletterFormHydrationTarget): NewsletterSubmitTargetResolution;

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

@@ -4,6 +4,7 @@ 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<{
@@ -30,7 +31,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/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/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,7 +119,7 @@ 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;
     kind: string;
     content?: EditorValueRecord | null;
@@ -130,7 +130,7 @@ export type EditorBlockItem = Readonly<{
     purpose?: string | null;
     optimisticHash?: string | null;
 }>;
-type NormalizedEditorBlockBase = Readonly<{
+type NormalizedEditorBlockBase = BlockContentIdentity & Readonly<{
     kind: string;
     content: EditorBlockValues | null;
     orderIndex: number | null;

package/dist/_dts/content-model/src/content-types/schema.d.ts

@@ -10,6 +10,7 @@ declare const BaseContentFieldSchema: z.ZodObject<{
         link: "link";
         date: "date";
         text: "text";
+        group: "group";
         url: "url";
         textarea: "textarea";
         select: "select";
@@ -17,7 +18,6 @@ declare const BaseContentFieldSchema: z.ZodObject<{
         reference: "reference";
         repeater: "repeater";
         file: "file";
-        group: "group";
         datetime: "datetime";
         button: "button";
         richText: "richText";

package/dist/_dts/core/src/appointment-service-categories.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The one grouping authority for appointment-service categories (issue 1403).
+ *
+ * Every surface that shows services by category — the public services list,
+ * the booking selector, the dashboard Services page and the CSV export — goes
+ * through `layoutServicesByCategory` rather than deciding grouping itself.
+ *
+ * Ordering is not decided here. The database owns it (category `sort_order`,
+ * then service `sort_order` within its group, with title and id as
+ * tie-breakers) and the reads hand both lists over already ordered. This
+ * module only buckets, and it preserves input order inside every bucket, so a
+ * client never re-sorts into an order the reorder compare-and-swap would not
+ * recognise.
+ */
+/** What a visitor may know about a category: its heading and optional intro. */
+export type ServiceCategorySummary = Readonly<{
+    id: string;
+    name: string;
+    description: string | null;
+}>;
+/** Anything carrying the category it belongs to; null is the "Other" group. */
+export type CategorizedService = Readonly<{
+    categoryId: string | null;
+}>;
+export type ServiceCategoryGroup<TService, TCategory extends Readonly<{
+    id: string;
+}> = ServiceCategorySummary> = Readonly<{
+    category: TCategory;
+    services: readonly TService[];
+}>;
+/**
+ * `uncategorized-site` means there is nothing to group by, so the list stays
+ * flat exactly as before categories existed. That is when the site has **no
+ * categories at all**, decided by the category list and never inferred from
+ * which categories the services happen to reference. On public surfaces
+ * (`keepEmptyGroups: false`) it is also when no category has any of the
+ * listed services, so visitors never see a lone "Other" heading (W20).
+ *
+ * `categorized-site` carries the groups in category order and `other`, the
+ * uncategorised services, which always sort last. `other` may be empty:
+ * whether an empty Other is shown is the caller's decision (the public list
+ * omits it, the dashboard always shows it).
+ */
+export type ServiceCategoryLayout<TService, TCategory extends Readonly<{
+    id: string;
+}> = ServiceCategorySummary> = Readonly<{
+    kind: 'uncategorized-site';
+    services: readonly TService[];
+}> | Readonly<{
+    kind: 'categorized-site';
+    groups: readonly ServiceCategoryGroup<TService, TCategory>[];
+    other: readonly TService[];
+}>;
+export type LayoutServicesByCategoryOptions = Readonly<{
+    /**
+     * Public surfaces drop categories with no services. The dashboard keeps
+     * them so it can show "No services in this category yet".
+     */
+    keepEmptyGroups: boolean;
+}>;
+/**
+ * Groups services under their categories.
+ *
+ * A service whose `categoryId` names no category in `categories` lands in
+ * Other. The composite foreign key keeps that from happening with stored data,
+ * so this is only the total, safe answer for a caller holding a stale list.
+ */
+export declare function layoutServicesByCategory<TService extends CategorizedService, TCategory extends Readonly<{
+    id: string;
+}>>(categories: readonly TCategory[], services: readonly TService[], options: LayoutServicesByCategoryOptions): ServiceCategoryLayout<TService, TCategory>;
+/** The services in display order: each group in turn, then Other. */
+export declare function flattenServiceCategoryLayout<TService, TCategory extends Readonly<{
+    id: string;
+}>>(layout: ServiceCategoryLayout<TService, TCategory>): TService[];
+/**
+ * What a block filtered to (at most) one category should show.
+ *
+ * - `all`: no filter is set, so every non-empty group shows, Other last.
+ * - `single`: the filter names one of the site's categories. The group can be
+ *   empty, which the caller renders as its empty state.
+ * - `fallback-all`: the filter names a category the site no longer has (it was
+ *   deleted), so everything shows, grouped. This is a first-class state rather
+ *   than a null check so the editor can warn about it.
+ */
+export type ServiceCategoryView<TService, TCategory extends Readonly<{
+    id: string;
+}> = ServiceCategorySummary> = Readonly<{
+    kind: 'all';
+    layout: ServiceCategoryLayout<TService, TCategory>;
+}> | Readonly<{
+    kind: 'single';
+    group: ServiceCategoryGroup<TService, TCategory>;
+}> | Readonly<{
+    kind: 'fallback-all';
+    missingCategoryId: string;
+    layout: ServiceCategoryLayout<TService, TCategory>;
+}>;
+/**
+ * Selects the public view for an optional category filter.
+ *
+ * It takes the category and service lists rather than a prebuilt layout
+ * because the public layout has already dropped empty categories, and then an
+ * empty category (`single` with no services) could not be told apart from a
+ * deleted one (`fallback-all`).
+ */
+export declare function selectCategoryView<TService extends CategorizedService, TCategory extends Readonly<{
+    id: string;
+}>>(categories: readonly TCategory[], services: readonly TService[], filterCategoryId: string | null | undefined): ServiceCategoryView<TService, TCategory>;

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,7 +62,7 @@ export type EditorBlockPublishedBaselineInput = Readonly<{
     kind?: string;
     publishedContent?: EditorBlockBaselineInput;
 }>;
-export type EditorPersistedBlock = Readonly<{
+export type EditorPersistedBlock = BlockContentIdentity & Readonly<{
     id: EditorBlockId;
     kind: string;
     content: EditorBlockValues | null;

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

@@ -18,6 +18,7 @@ export * from './booking-refunds';
 export * from './booking-instalments';
 export * from './booking-date-time';
 export * from './booking-consent';
+export * from './appointment-service-categories';
 export * from './dated-offering-settlement';
 export * from './person-records';
 export * from './rectification';
@@ -29,6 +30,7 @@ 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';

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

@@ -49,7 +49,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<{

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;
@@ -104,4 +106,13 @@ export declare function parsePublicProfile(value: unknown): Result<PublicProfile
  * holds a business address for every profile saved before the switch existed.
  */
 export declare function resolvePublicProfilePremises(profile: PublicProfile, hasBusinessAddress: boolean): boolean;
+/**
+ * The contact details the site may publish: the stored contact with every
+ * hidden method removed, or null when nothing is left to show.
+ *
+ * Every public reader goes through this. The privacy policy identity is the
+ * one exception and reads the stored email directly, because a hidden email
+ * can still be the policy's contact.
+ */
+export declare function publishedContactDetails(profile: Pick<PublicProfile, 'contact' | 'contactVisibility'>): PublicContactDetails | null;
 export declare function emptyPublicProfile(): PublicProfile;