@riverbankcms/sdk 0.60.0 → 0.60.3

package/dist/_dts/blocks/src/system/runtime/components/registry.client.d.ts

@@ -1,6 +1,38 @@
-import type React from 'react';
+import React from 'react';
 import type { ComponentRegistry } from '../resolver';
-import { type RuntimeBackedBlockKind } from './runtime-backed-blocks';
+import { BookingFormNodeClient } from '../nodes/booking-form.client';
+import { EventDetailsIslandClient } from '../nodes/event-details.client';
+import { LocationMapIslandClient } from '../nodes/location-map.client';
+import { CarouselNodeClient } from '../nodes/carousel.client';
+import { AccordionNode, AccordionItemNode } from '../nodes/accordion';
+import HeaderSectionNode from '../nodes/header-section.client';
+import { EventCombinedIslandClient } from '../nodes/events';
+import { MediaNode } from '../nodes/media.client';
+import { runtimeBackedBlockServerEntries, type RuntimeBackedBlockMode, type RuntimeBackedBlockKind, type RuntimeBackedClientBlockEntry, type RuntimeBackedClientComponentProps } from './runtime-backed-blocks';
+type SourcePropsClientEntry<TProps extends object = object> = Readonly<{
+    kind: 'source-props';
+    component: React.ComponentType<TProps>;
+}>;
+type ExplicitAdapterClientEntry<TProps extends object = object> = Readonly<{
+    kind: 'explicit-adapter';
+    component: React.ComponentType<TProps>;
+    produces: 'client-props' | 'island-props';
+}>;
+export type ClientComponentRegistryEntryByKind = Readonly<{
+    media: SourcePropsClientEntry<React.ComponentProps<typeof MediaNode>>;
+    carousel: SourcePropsClientEntry<React.ComponentProps<typeof CarouselNodeClient>>;
+    accordion: SourcePropsClientEntry<React.ComponentProps<typeof AccordionNode>>;
+    accordionItem: SourcePropsClientEntry<React.ComponentProps<typeof AccordionItemNode>>;
+    headerSection: SourcePropsClientEntry<React.ComponentProps<typeof HeaderSectionNode>>;
+    'booking-form': ExplicitAdapterClientEntry<React.ComponentProps<typeof BookingFormNodeClient>>;
+    'event-details': ExplicitAdapterClientEntry<React.ComponentProps<typeof EventDetailsIslandClient>>;
+    'location-map': ExplicitAdapterClientEntry<React.ComponentProps<typeof LocationMapIslandClient>>;
+    'event-combined': ExplicitAdapterClientEntry<React.ComponentProps<typeof EventCombinedIslandClient>>;
+}>;
+export type ClientComponentRegistryEntry = ClientComponentRegistryEntryByKind[keyof ClientComponentRegistryEntryByKind];
+export declare function defineSourcePropsClientEntry<TProps extends object>(component: React.ComponentType<TProps>): SourcePropsClientEntry<TProps>;
+export declare function defineExplicitAdapterClientEntry<TProps extends object>(component: React.ComponentType<TProps>, contract: Pick<ExplicitAdapterClientEntry<TProps>, 'produces'>): ExplicitAdapterClientEntry<TProps>;
+export declare function defineRuntimeBackedBlockClientEntry<TKind extends RuntimeBackedBlockKind>(kind: TKind, client: React.ComponentType<RuntimeBackedClientComponentProps<typeof runtimeBackedBlockServerEntries[TKind]['definition']['runtime'], RuntimeBackedBlockMode<TKind>>>): RuntimeBackedClientBlockEntry<typeof runtimeBackedBlockServerEntries[TKind]['definition']['runtime'], RuntimeBackedBlockMode<TKind>>;
 export declare const runtimeBackedBlockClientEntries: {
     readonly form: Readonly<{
         definition: import("../..").SystemBlockDefinition<unknown, Readonly<{
@@ -168,6 +200,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "progressive";
+        mode: "form";
         client: React.ElementType;
     }>;
     readonly 'event-listing': Readonly<{
@@ -612,6 +645,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "progressive";
+        mode: "event-listing";
         client: React.ElementType;
     }>;
     readonly 'event-calendar': Readonly<{
@@ -1080,6 +1114,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "progressive";
+        mode: "event-calendar";
         client: React.ElementType;
     }>;
     readonly 'newsletter-form': Readonly<{
@@ -1284,6 +1319,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "progressive";
+        mode: "newsletter-form";
         client: React.ElementType;
     }>;
     readonly 'product-list': Readonly<{
@@ -1548,6 +1584,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "progressive";
+        mode: "product-list";
         client: React.ElementType;
     }>;
     readonly 'product-detail': Readonly<{
@@ -1644,6 +1681,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "progressive";
+        mode: "product-detail";
         client: React.ElementType;
     }>;
     readonly cart: Readonly<{
@@ -1824,6 +1862,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "client-owned";
+        mode: "cart";
         client: React.ElementType;
     }>;
     readonly checkout: Readonly<{
@@ -1938,6 +1977,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "client-owned";
+        mode: "checkout";
         client: React.ElementType;
     }>;
     readonly 'course-registration': Readonly<{
@@ -2154,6 +2194,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "client-owned";
+        mode: "course-registration";
         client: React.ElementType;
     }>;
     readonly gifting: Readonly<{
@@ -2286,6 +2327,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "client-owned";
+        mode: "gifting";
         client: React.ElementType;
     }>;
     readonly 'event-registration': Readonly<{
@@ -2502,6 +2544,7 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "client-owned";
+        mode: "event-registration";
         client: React.ElementType;
     }>;
     readonly shop: Readonly<{
@@ -2742,8 +2785,136 @@ export declare const runtimeBackedBlockClientEntries: {
             }>;
         }>;
         renderKind: "progressive";
+        mode: "passes-memberships";
         client: React.ElementType;
     }>;
 };
 export declare const runtimeBackedBlockClientRegistry: Readonly<Record<RuntimeBackedBlockKind, React.ElementType>>;
+export declare const clientComponentRegistryEntries: {
+    readonly media: Readonly<{
+        kind: "source-props";
+        component: React.ComponentType<import("../nodes/media").MediaNodeProps>;
+    }>;
+    readonly carousel: Readonly<{
+        kind: "source-props";
+        component: React.ComponentType<import("../nodes/carousel.client").CarouselNodeClientProps>;
+    }>;
+    readonly accordion: Readonly<{
+        kind: "source-props";
+        component: React.ComponentType<import("../nodes/accordion").AccordionNodeProps>;
+    }>;
+    readonly accordionItem: Readonly<{
+        kind: "source-props";
+        component: React.ComponentType<import("../nodes/accordion").AccordionItemNodeProps>;
+    }>;
+    readonly headerSection: Readonly<{
+        kind: "source-props";
+        component: React.ComponentType<{
+            [key: string]: unknown;
+            className?: string;
+            blockId?: string;
+            blockKind?: string;
+            blockContent?: unknown;
+            fragmentRegistry?: unknown;
+            pathBase?: string;
+        } & {
+            children?: React.ReactNode | undefined;
+        }>;
+    }>;
+    readonly 'booking-form': Readonly<{
+        kind: "explicit-adapter";
+        component: React.ComponentType<import("../nodes/booking-form.client").BookingFormNodeClientProps>;
+        produces: "client-props" | "island-props";
+    }>;
+    readonly 'event-details': Readonly<{
+        kind: "explicit-adapter";
+        component: React.ComponentType<Readonly<{
+            occurrenceContext?: import("../../../contracts").EventDetailsOccurrenceContext | null;
+            contentEntry?: import("../../../contracts").EventDetailsContentEntry | null;
+            events?: readonly import("../..").PublicEvent[] | null;
+            showVenue?: boolean;
+            showMap?: boolean;
+            showOtherDates?: boolean;
+            otherDatesLimit?: string;
+            showCost?: boolean;
+            showAcceptedPasses?: boolean;
+            showAcceptedMemberships?: boolean;
+            sitePasses?: Readonly<{
+                passes: readonly import("../..").PublicPassProduct[];
+            }> | null;
+            siteMemberships?: Readonly<{
+                memberships: readonly import("../..").PublicMembershipProduct[];
+            }> | null;
+            className?: string | null;
+            nowIso?: string;
+        }>>;
+        produces: "client-props" | "island-props";
+    }>;
+    readonly 'location-map': Readonly<{
+        kind: "explicit-adapter";
+        component: React.ComponentType<Readonly<{
+            location?: import("../nodes/location-map.shared").NormalizedLocationMapValue | null;
+            zoom?: number | null;
+            heightPx?: number | null;
+            showAddressText?: boolean;
+            showDirections?: boolean;
+            directionsLabel?: string | null;
+            className?: string | null;
+        }>>;
+        produces: "client-props" | "island-props";
+    }>;
+    readonly 'event-combined': Readonly<{
+        kind: "explicit-adapter";
+        component: React.ComponentType<Readonly<Readonly<{
+            siteId: string;
+            apiBaseUrl?: string;
+            stage?: "preview" | "published";
+        }> & {
+            renderKind: "progressive";
+            render: Readonly<{
+                mode: "event-combined";
+            } & Readonly<{
+                display: Readonly<{
+                    kind: "event-combined";
+                    className: string | null;
+                    events: readonly import("../..").PublicEvent[];
+                    listLayout: import("../..").EventLayout;
+                    listColumns: import("../..").ColumnOption;
+                    eventsPerPage: string;
+                    loadMoreText: string;
+                    startOfWeek: import("../..").WeekStart;
+                    calendarTabViews: import("../..").CalendarTabViews;
+                    showFilters: boolean;
+                    showCategoryFilter: import("../..").FilterAutoShow;
+                    showVenueFilter: boolean;
+                    showStaffFilter: boolean;
+                    eventKind: import("../..").EventBlockKind;
+                    eventSurface: import("../..").EventSurfaceScope;
+                    filterEventPresets: string | null;
+                    scheduleScope: import("../..").EventScheduleScope;
+                    filterCategoryIds: string | null;
+                    filterStaffMemberId: string | null;
+                    filterVenueId: string | null;
+                    showVenue: boolean;
+                    showMap: boolean;
+                    showCapacity: boolean;
+                    buttonVariant: import("../..").ButtonVariant;
+                    buttonText: string;
+                    emptyMessage: string;
+                }>;
+                hydration: Readonly<{
+                    siteId: string;
+                    stage?: "preview" | "published";
+                    prefetchedEvents: boolean;
+                    eventKind: import("../..").EventBlockKind;
+                    eventSurface: import("../..").EventSurfaceScope;
+                    filterEventPresets: string | null;
+                    scheduleScope: import("../..").EventScheduleScope;
+                }>;
+            }>>;
+        }>>;
+        produces: "client-props" | "island-props";
+    }>;
+};
 export declare const clientComponentRegistry: ComponentRegistry;
+export {};

package/dist/_dts/blocks/src/system/runtime/components/runtime-backed-blocks.d.ts

@@ -1,5 +1,5 @@
 import type React from 'react';
-import type { InteractiveBlockRuntime } from '../../../contracts/runtime';
+import type { InteractiveBlockRuntime, RuntimeKind, RuntimeRender, RuntimeSource } from '../../../contracts/runtime';
 import type { SystemBlockDefinition } from '../../registry';
 type AnyInteractiveRuntime = InteractiveBlockRuntime<any, any, any>;
 type RuntimeBackedBlockDefinition<TRuntime extends AnyInteractiveRuntime = AnyInteractiveRuntime> = SystemBlockDefinition<unknown, TRuntime> & Readonly<{
@@ -8,9 +8,16 @@ type RuntimeBackedBlockDefinition<TRuntime extends AnyInteractiveRuntime = AnyIn
     }>;
     runtime: TRuntime;
 }>;
-export type RuntimeBackedClientBlockEntry<TRuntime extends AnyInteractiveRuntime> = Readonly<{
+export type RuntimeBackedClientComponentProps<TRuntime extends AnyInteractiveRuntime, TMode extends string> = Readonly<RuntimeSource<TRuntime> & {
+    renderKind: RuntimeKind<TRuntime>;
+    render: Readonly<{
+        mode: TMode;
+    } & RuntimeRender<TRuntime>>;
+}>;
+export type RuntimeBackedClientBlockEntry<TRuntime extends AnyInteractiveRuntime, TMode extends string = string> = Readonly<{
     definition: RuntimeBackedBlockDefinition<TRuntime>;
     renderKind: TRuntime['kind'];
+    mode: TMode;
     client: React.ElementType;
 }>;
 export declare const runtimeBackedBlockServerEntries: {
@@ -1387,6 +1394,21 @@ export declare const runtimeBackedBlockServerEntries: {
     }>;
 };
 export type RuntimeBackedBlockKind = keyof typeof runtimeBackedBlockServerEntries;
+export declare const runtimeBackedBlockModes: {
+    readonly form: "form";
+    readonly 'event-listing': "event-listing";
+    readonly 'event-calendar': "event-calendar";
+    readonly 'newsletter-form': "newsletter-form";
+    readonly 'product-list': "product-list";
+    readonly 'product-detail': "product-detail";
+    readonly cart: "cart";
+    readonly checkout: "checkout";
+    readonly 'course-registration': "course-registration";
+    readonly gifting: "gifting";
+    readonly 'event-registration': "event-registration";
+    readonly shop: "passes-memberships";
+};
+export type RuntimeBackedBlockMode<TKind extends RuntimeBackedBlockKind> = typeof runtimeBackedBlockModes[TKind];
 export declare const runtimeBackedBlockKinds: readonly ("form" | "event-registration" | "course-registration" | "event-listing" | "event-calendar" | "shop" | "product-list" | "product-detail" | "cart" | "checkout" | "gifting" | "newsletter-form")[];
 export declare const runtimeBackedBlockServerRegistry: Readonly<{
     readonly form: React.ElementType<any, keyof React.JSX.IntrinsicElements>;

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

@@ -12,6 +12,7 @@
  * correctly relative to the page scroll container.
  */
 export declare const POSITIONING_CLASSES: readonly ["rb-sticky", "rb-fixed", "rb-absolute", "rb-relative", "rb-top-0", "rb-left-0", "rb-right-0", "rb-bottom-0", "rb-z-40", "rb-z-50"];
+export { desktopOnlyDisplay, mobileOnlyDisplay, type ResponsiveDisplay, } from '@riverbankcms/theme-core/responsiveDisplay';
 /**
  * Split className into positioning classes (for wrapper) and content classes (for section).
  *

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

@@ -17,3 +17,4 @@ export declare const BookingFormClient: React.FC<BookingFormClientProps>;
  * harder to miswire across interactive surfaces.
  */
 export declare const BookingFormNodeClient: React.FC<BookingFormNodeClientProps>;
+export declare function buildBookingFormNodeClientProps(props: BookingFormNodeClientProps): BookingFormClientProps;

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

@@ -2,6 +2,8 @@ import React from 'react';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
 type AgendaEventCardProps = {
     event: PublicEvent;
+    /** Whether to render the capacity indicator. */
+    showCapacity: boolean;
     /** When provided, renders as button and calls onClick instead of navigating */
     onClick?: (event: PublicEvent) => void;
 };

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

@@ -3,6 +3,7 @@ import type { PublicEvent } from '../../../../blocks/events/shared/types';
 type DayEventsModalProps = {
     date: Date;
     events: PublicEvent[];
+    showCapacity: boolean;
     onClose: () => void;
     onSelectEvent: (event: PublicEvent) => void;
 };
@@ -12,5 +13,5 @@ type DayEventsModalProps = {
  * Uses AgendaEventCard with onClick prop to display events.
  * Clicking an event triggers onSelectEvent (typically opens EventDetailModal).
  */
-export declare function DayEventsModal({ date, events, onClose, onSelectEvent, }: DayEventsModalProps): React.ReactElement;
+export declare function DayEventsModal({ date, events, showCapacity, onClose, onSelectEvent, }: DayEventsModalProps): React.ReactElement;
 export default DayEventsModal;

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

@@ -2,6 +2,7 @@ import React from 'react';
 import type { PublicEvent, ButtonVariant, CardVariant } from '../../../../blocks/events/shared/types';
 type EventDetailModalProps = {
     event: PublicEvent;
+    showCapacity: boolean;
     onClose: () => void;
     cardVariant?: CardVariant;
     buttonVariant?: ButtonVariant;
@@ -14,5 +15,5 @@ type EventDetailModalProps = {
  * Reuses EventCard component directly for DRY implementation.
  * EventCard already includes the CTA button to navigate to the full event page.
  */
-export declare function EventDetailModal({ event, onClose, cardVariant, buttonVariant, buttonText, showMap, }: EventDetailModalProps): React.ReactElement;
+export declare function EventDetailModal({ event, showCapacity, onClose, cardVariant, buttonVariant, buttonText, showMap, }: EventDetailModalProps): React.ReactElement;
 export default EventDetailModal;

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

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { ButtonVariant, CardVariant } from '../../../../blocks/events/shared/types';
 type EventModalsProps = {
+    showCapacity: boolean;
     cardVariant?: CardVariant;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
@@ -13,5 +14,5 @@ type EventModalsProps = {
  * - EventDetailModal for single event view
  * - DayEventsModal for day events list (clicking an event switches to event modal)
  */
-export declare function EventModals({ cardVariant, buttonVariant, buttonText, }: EventModalsProps): React.ReactElement | null;
+export declare function EventModals({ showCapacity, cardVariant, buttonVariant, buttonText, }: EventModalsProps): React.ReactElement | null;
 export default EventModals;

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

@@ -4,6 +4,7 @@ type WeekAgendaViewProps = {
     viewDate: Date;
     events: PublicEvent[];
     startOfWeek: WeekStart;
+    showCapacity: boolean;
     emptyMessage?: string;
 };
 /**

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

@@ -4,6 +4,7 @@ type WeekTimetableViewProps = {
     viewDate: Date;
     events: PublicEvent[];
     startOfWeek: WeekStart;
+    showCapacity: boolean;
     emptyMessage?: string;
 };
 export declare const WeekTimetableView: React.FC<WeekTimetableViewProps>;

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

@@ -0,0 +1,16 @@
+import type { PublicEvent } from '../../../../blocks/events/shared/types';
+export type EventAvailability = {
+    /** Remaining spots. `null` when the event has no capacity cap. */
+    available: number | null;
+    /** True when the event has a cap and no spots remain. */
+    isFull: boolean;
+};
+/**
+ * Compute remaining spots for an event from `availableSpots` with a fallback
+ * to `capacity - registeredCount`. Returns `{ available: null, isFull: false }`
+ * for uncapped events so call sites can render no capacity indicator at all.
+ *
+ * The single source of truth for capacity math across event cards, agenda
+ * rows, and timetable cells — keep wording variations in the call sites.
+ */
+export declare function getEventAvailability(event: PublicEvent): EventAvailability;

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

@@ -10,6 +10,8 @@ export type TimetableEventCell = {
     categoryColor: string;
     timeLabel: string;
     teacherLine: string | null;
+    capacityLabel: string | null;
+    isFull: boolean;
 };
 export type TimetableDay = {
     date: Date;

package/dist/_dts/blocks/src/system/runtime/nodes/location-map.server.d.ts

@@ -4,6 +4,10 @@ export type LocationMapProps = Readonly<{
     blockId?: string | null;
     className?: string | null;
     location?: LocationMapValueInput | null;
+    businessAddress?: LocationMapValueInput | null;
+    locationSource?: string | null;
+    venueId?: string | null;
+    venuesById?: Record<string, unknown> | null;
     zoom?: number | string | null;
     heightPx?: number | string | null;
     showAddressText?: boolean | string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/location-map.shared.d.ts

@@ -18,9 +18,28 @@ export declare const LOCATION_MAP_LIMITS: {
 };
 export type LocationMapValueInput = Readonly<{
     addressText?: string | null;
+    displayAddress?: string | null;
     lat?: number | string | null;
     lng?: number | string | null;
 }>;
+export type LocationMapSource = 'business_address' | 'venue' | 'custom';
+export type LocationMapUnresolvedReason = 'missing_custom_location' | 'missing_business_address' | 'missing_venue_id' | 'missing_venue_location';
+export type LocationMapLocationsByVenueId = Readonly<Record<string, unknown>>;
+export type ResolvedLocationMapLocation = Readonly<{
+    kind: 'custom';
+    locationValue: NormalizedLocationMapValue;
+}> | Readonly<{
+    kind: 'business_address';
+    locationValue: NormalizedLocationMapValue;
+}> | Readonly<{
+    kind: 'venue';
+    venueId: string;
+    locationValue: NormalizedLocationMapValue;
+}> | Readonly<{
+    kind: 'unresolved';
+    source: LocationMapSource;
+    reason: LocationMapUnresolvedReason;
+}>;
 export type NormalizedLocationMapValue = AddressedLocationValue;
 export type LocationMapHydrationProps = Readonly<{
     location?: NormalizedLocationMapValue | null;
@@ -32,7 +51,9 @@ export type LocationMapHydrationProps = Readonly<{
     className?: string | null;
 }>;
 export type NormalizedLocationMapProps = Readonly<{
+    resolvedLocation: ResolvedLocationMapLocation;
     locationValue: NormalizedLocationMapValue | null;
+    unresolvedMessage: string | null;
     addressText: string | null;
     location: LocationCoordinates | null;
     zoom: number;
@@ -43,8 +64,21 @@ export type NormalizedLocationMapProps = Readonly<{
     className: string | null;
 }>;
 export declare function normalizeLocationMapValue(value: unknown): NormalizedLocationMapValue | null;
+export declare function normalizeLocationMapSource(value: LocationMapSource | string | null | undefined): LocationMapSource;
+export declare function resolveLocationMapLocation(input: {
+    location?: unknown;
+    businessAddress?: unknown;
+    locationSource?: LocationMapSource | string | null;
+    venueId?: string | null;
+    venuesById?: LocationMapLocationsByVenueId | null;
+}): ResolvedLocationMapLocation;
+export declare function describeUnresolvedLocationMapLocation(resolvedLocation: ResolvedLocationMapLocation): string | null;
 export declare function normalizeLocationMapProps(input: {
     location?: unknown;
+    businessAddress?: unknown;
+    locationSource?: LocationMapSource | string | null;
+    venueId?: string | null;
+    venuesById?: LocationMapLocationsByVenueId | null;
     zoom?: number | string | null;
     heightPx?: number | string | null;
     showAddressText?: boolean | string | null;
@@ -54,6 +88,10 @@ export declare function normalizeLocationMapProps(input: {
 }): NormalizedLocationMapProps;
 export declare function toLocationMapHydrationProps(input: {
     location?: unknown;
+    businessAddress?: unknown;
+    locationSource?: LocationMapSource | string | null;
+    venueId?: string | null;
+    venuesById?: Record<string, unknown> | null;
     zoom?: number | string | null;
     heightPx?: number | string | null;
     showAddressText?: boolean | string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/location-map.view.d.ts

@@ -15,7 +15,8 @@ export type LocationMapViewProps = Readonly<{
     showAddressText: boolean;
     showDirections: boolean;
     directionsLabel: string;
+    unresolvedMessage?: string | null;
     renderMap?: (args: RenderMapArgs) => React.ReactNode;
 }>;
-export declare function LocationMapView({ addressText, location, zoom, heightPx, showAddressText, showDirections, directionsLabel, renderMap, }: LocationMapViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function LocationMapView({ addressText, location, zoom, heightPx, showAddressText, showDirections, directionsLabel, unresolvedMessage, renderMap, }: LocationMapViewProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -13,8 +13,8 @@ export type { EntryEditorDriver } from './controller/driver';
 export { EditableBlockProvider, useBlockData } from './components/EditableBlockProvider';
 export { ContentFieldsForm, type ContentFieldsFormProps } from './components/ContentFieldsForm';
 export { useUISelector } from './ui/useUISelector';
-export { useEditorUiStore, useEditorUiStoreInstance, createEditorUiStore } from './ui/editorUiStore';
-export type { EditorUiStoreInstance, EditorUiState, ViewportMode, ViewportWidth, ViewportState, ZoomLevel, } from './ui/editorUiStore';
+export { useEditorUiStore, useEditorUiStoreInstance, useOptionalEditorUiStoreInstance, createEditorUiStore } from './ui/editorUiStore';
+export type { ActivePreviewField, EditorUiStoreInstance, EditorUiState, PreviewSidebarTab, ViewportMode, ViewportWidth, ViewportState, ZoomLevel, } from './ui/editorUiStore';
 export { PreviewTextEditor } from './primitives/PreviewTextEditor';
 export { PreviewRichTextEditor } from './primitives/PreviewRichTextEditor';
 export { useStoreBinding, parseEditorPath } from './primitives/shared';

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

@@ -0,0 +1,9 @@
+import type { ActivePreviewField } from '../../ui/editorUiStore';
+/**
+ * Returns true when the given editor path targets the same block-field that
+ * the sidebar has currently focused (the "linked focus" affordance).
+ *
+ * Encapsulates the `blocks.{blockId}.{fieldPath}` path convention so editor
+ * primitives and tests share a single source of truth.
+ */
+export declare function isLinkedSidebarField(editorPath: string, activeField: ActivePreviewField): boolean;

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

@@ -1,2 +1,3 @@
 export { parseEditorPath, useStoreBinding } from './storeBinding';
+export { isLinkedSidebarField } from './activePreviewField';
 export type { PathInfo } from './types';

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

@@ -14,6 +14,11 @@ export type { ViewportState } from "./stores/viewportStore";
 export type { EditorCommand, EditorBlockItem, EditorDraftSnapshot, EditorHistorySnapshot, EditorEffect, } from "./editorHistory";
 export type MetadataSnapshot = EditorValueSnapshot<EditorMetadataValues | null>;
 export type ContentSnapshot = EditorValueSnapshot<EditorContentValues | null>;
+export type PreviewSidebarTab = "editor" | "assistant";
+export type ActivePreviewField = Readonly<{
+    blockId: EditorBlockId;
+    fieldPath: string;
+}> | null;
 /**
  * Form-facing metadata facade. Consumers pass plain records for ergonomics;
  * the reducer core normalizes and brands values at this boundary.
@@ -98,9 +103,13 @@ type RestoreListener = (transition: {
 }) => void;
 export type EditorUiState = {
     drawerOpen: boolean;
+    previewSidebarTab: PreviewSidebarTab;
+    activePreviewField: ActivePreviewField;
     focusRequest: FocusRequest;
     activeBlockId: EditorBlockId | null;
     setDrawerOpen: (open: boolean) => void;
+    setPreviewSidebarTab: (tab: PreviewSidebarTab) => void;
+    setActivePreviewField: (field: ActivePreviewField) => void;
     requestFocus: (payload: Omit<NonNullable<FocusRequest>, "requestId">) => void;
     clearFocus: () => void;
     setActiveBlockId: (id: EditorBlockId | null) => void;
@@ -139,3 +148,4 @@ export type EditorUiStoreInstance = ReturnType<typeof createEditorUiStore>;
 export declare const EditorUiStoreProvider: import("react").Provider<import("zustand").StoreApi<EditorUiState> | null>;
 export declare function useEditorUiStore<T>(selector: (state: EditorUiState) => T): T;
 export declare function useEditorUiStoreInstance(): EditorUiStoreInstance;
+export declare function useOptionalEditorUiStoreInstance(): EditorUiStoreInstance | null;

package/dist/_dts/core/src/business-address.d.ts

@@ -0,0 +1,38 @@
+export type BusinessAddressDraft = Readonly<{
+    addressLine1?: string | null;
+    addressLine2?: string | null;
+    locality?: string | null;
+    region?: string | null;
+    postalCode?: string | null;
+    countryCode?: string | null;
+    displayAddress?: string | null;
+    lat?: number | null;
+    lng?: number | null;
+}>;
+export type BusinessAddress = Readonly<{
+    addressLine1: string;
+    addressLine2: string | null;
+    locality: string;
+    region: string | null;
+    postalCode: string | null;
+    countryCode: string;
+    displayAddress: string;
+    lat: number;
+    lng: number;
+}>;
+export type BusinessAddressValidationErrorCode = 'missing_address_line_1' | 'missing_locality' | 'missing_country_code' | 'missing_display_address' | 'missing_latitude' | 'missing_longitude' | 'invalid_latitude' | 'invalid_longitude';
+export type BusinessAddressValidationResult = Readonly<{
+    success: true;
+    address: BusinessAddress;
+}> | Readonly<{
+    success: false;
+    errors: readonly BusinessAddressValidationErrorCode[];
+}>;
+export declare function buildBusinessAddressDisplayText(input: BusinessAddressDraft): string | null;
+export declare function validateBusinessAddressDraft(input: BusinessAddressDraft): BusinessAddressValidationResult;
+export declare function isCompleteBusinessAddress(value: BusinessAddressDraft | null | undefined): value is BusinessAddress;
+export declare function businessAddressToAddressedLocation(address: BusinessAddress | null | undefined): Readonly<{
+    addressText: string | null;
+    lat: number | null;
+    lng: number | null;
+}> | null;

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

@@ -10,6 +10,7 @@ export * from "./booking-date-time";
 export * from "./person-records";
 export * from "./rectification";
 export * from "./location";
+export * from "./business-address";
 export * from "./result";
 export { assertNever } from "./assert-never";
 export { tryAsync } from "./try-async";