@riverbankcms/sdk 0.60.0 → 0.60.1

package/README.md

@@ -826,7 +826,7 @@ import type {
 
 The `Layout` component renders the site header, footer, and wraps your page content. Use this when you want consistent site chrome across all pages.
 
-`Layout` is a pure Server Component. The default `@riverbankcms/sdk/rendering` `Page` surface hydrates CMS islands automatically, and `createCatchAllPage()` keeps doing the same for the canonical Next.js catch-all flow. If you intentionally use the strict `@riverbankcms/sdk/rendering/server` surface, or otherwise bypass the default `Page` seam, mount `BlocksIslandsHydrator` explicitly when you need interactive CMS islands:
+`Layout` is a pure Server Component. The default `@riverbankcms/sdk/rendering` `Page` and `Block` surfaces hydrate CMS islands automatically, and `createCatchAllPage()` keeps doing the same for the canonical Next.js catch-all flow. If you intentionally use the strict `@riverbankcms/sdk/rendering/server` surface, mount `BlocksIslandsHydrator` explicitly when you need interactive CMS islands:
 
 ```tsx
 import { Layout } from '@riverbankcms/sdk/rendering/server';
@@ -980,12 +980,12 @@ export default async function MyPage() {
 
 ## Block Component
 
-The `Block` component renders individual CMS blocks. Use this when you want to mix CMS content with custom JSX, or render blocks outside of a full page context.
+The `Block` component renders individual CMS blocks. Use this when you want to mix CMS content with custom JSX, or render blocks outside of a full page context. The default `@riverbankcms/sdk/rendering` `Block` surface hydrates interactive CMS islands automatically. If you import `Block` from `@riverbankcms/sdk/rendering/server`, you are choosing the strict bootstrap-free surface and must mount `BlocksIslandsHydrator` yourself for interactive blocks.
 
 ### Basic Block Rendering
 
 ```tsx
-import { Block } from '@riverbankcms/sdk';
+import { Block } from '@riverbankcms/sdk/rendering';
 
 export default async function CustomPage() {
   const siteData = await client.getSite({ slug: 'my-site' });
@@ -1028,6 +1028,23 @@ Blocks can automatically load their data (e.g., blog posts, products) if they ha
 />
 ```
 
+Interactive blocks such as forms, bookings, events, and commerce also need the CMS API base URL so the hydrated island can submit requests:
+
+```tsx
+import { getRiverbankEnv } from '@riverbankcms/sdk/env';
+
+const { baseUrl } = getRiverbankEnv();
+
+<Block
+  blockKind="block.checkout"
+  blockId="checkout-block"
+  content={{ heading: 'Checkout' }}
+  theme={siteData.theme}
+  siteId={siteData.site.id}
+  apiBaseUrl={baseUrl}
+/>
+```
+
 ### Advanced Block Options
 
 ```tsx

package/dist/_dts/api/src/bookingManagementEndpoints.d.ts

@@ -315,9 +315,7 @@ export type BookingManagementAPIEndpoints = {
         siteId: string;
         resourceId: string;
     }, void>;
-    googleCalendarCallback: APIEndpoint<never, {
-        siteId: string;
-    }, void>;
+    googleCalendarCallback: APIEndpoint<never, never, void>;
     getAvailableSlots: APIEndpoint<GetAvailableSlotsQuery, {
         siteId: string;
     } & GetAvailableSlotsQuery, GetAvailableSlotsResponse>;

package/dist/_dts/api/src/bookingRecords.d.ts

@@ -663,6 +663,7 @@ export type BookingActivityListItem = {
     type: BookingActivityType;
     category: BookingActivityCategory;
     description: string;
+    participantId: string | null;
     customer: SiteCustomerRecord | null;
     relatedCustomer: SiteCustomerRecord | null;
     amountCents: number | null;

package/dist/_dts/api/src/endpoints.d.ts

@@ -912,7 +912,7 @@ export declare const API_ENDPOINTS: {
         readonly responseKind: "void";
     };
     readonly googleCalendarCallback: {
-        readonly path: "/sites/{siteId}/bookings/calendar/google/callback";
+        readonly path: "/bookings/calendar/google/callback";
         readonly method: "GET";
         readonly auth: "user";
         readonly responseKind: "void";

package/dist/_dts/billing/src/plans/types.d.ts

@@ -1,4 +1,29 @@
 export type BillingInterval = 'monthly' | 'annual';
+declare const storageBytesBrand: unique symbol;
+export type StorageBytes = number & {
+    readonly [storageBytesBrand]: 'StorageBytes';
+};
+export type StorageByteParseError = 'invalid-storage-bytes';
+export type StorageByteParseResult = Readonly<{
+    ok: true;
+    value: StorageBytes;
+}> | Readonly<{
+    ok: false;
+    error: StorageByteParseError;
+}>;
+export type StorageQuota = Readonly<{
+    tag: 'limited';
+    maxBytes: StorageBytes;
+}> | Readonly<{
+    tag: 'unlimited';
+}>;
+export declare function asStorageBytes(value: number): StorageByteParseResult;
+export declare function unsafeStorageBytes(value: number): StorageBytes;
+export declare function storageMegabytes(value: number): StorageBytes;
+export declare function storageGigabytes(value: number): StorageBytes;
+export declare function limitedStorageQuota(maxBytes: StorageBytes): StorageQuota;
+export declare function formatStorageBytes(bytes: StorageBytes): string;
+export declare function formatStorageQuota(quota: StorageQuota): string;
 export declare const BILLING_PLAN_IDS: readonly ["free", "core", "solo", "studio"];
 export type BillingPlanId = (typeof BILLING_PLAN_IDS)[number];
 export declare const PAID_BILLING_PLAN_IDS: readonly ["core", "solo", "studio"];
@@ -31,6 +56,7 @@ export interface PlanEntitlements {
     monthlyPricePence: number | null;
     availableIntervals: readonly BillingInterval[];
     monthlyBookingLimit: number | null;
+    durableStorageQuota: StorageQuota;
     stripeBookingCommission: StripeBookingCommission;
     customDomain: boolean;
     customContentTypes: boolean;
@@ -77,3 +103,4 @@ export interface DisplayPricing {
         discountPercent?: number;
     };
 }
+export {};

package/dist/_dts/blocks/src/system/blocks/events/event-calendar.d.ts

@@ -50,6 +50,7 @@ export type EventCalendarContent = {
     filterVenueId?: VenueId | null;
     buttonVariant?: ButtonVariant | null;
     buttonText?: string | null;
+    showCapacity?: boolean | null;
     emptyMessage?: string | null;
     _sectionStyles?: SectionStylesContent;
 };

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/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/editor-blocks/src/BlockEditor.d.ts

@@ -5,6 +5,7 @@ import { type Theme } from '@riverbankcms/blocks';
 import type { PageDesignEditorReadModel } from '@riverbankcms/theme-core/site-styles';
 import { type EditorStructuralCommand } from '@riverbankcms/core';
 import { type SdkConfigForBlockPicker } from './block-editor/sdkBlockMerger';
+import { type ReorderControlMode } from './block-editor/reorderControlMode';
 import type { ArrayKeysManager, BlockEditorHandle, BlockItem, BlockFocusRequest, UiSlice, DraftsSlice } from './block-editor/types';
 import type { BlockDraftSaveability, FieldWidgetComponent } from '@riverbankcms/block-form/client';
 type UiState = {
@@ -13,6 +14,7 @@ type UiState = {
     requestFocus: UiSlice['requestFocus'];
     clearFocus: () => void;
     setActiveBlockId: UiSlice['setActiveBlockId'];
+    setActivePreviewField: UiSlice['setActivePreviewField'];
     arrayKeys: ArrayKeysManager;
     blockValidation: {
         markPathEdited: (blockId: Parameters<DraftsSlice['setAtPath']>[0], path: string) => void;
@@ -49,6 +51,7 @@ export type BlockEditorProps = {
     pageDesignEditorModel?: PageDesignEditorReadModel | null;
     enabledContentTypes?: string[];
     sdkConfig?: SdkConfigForBlockPicker | null;
+    reorderControlMode?: ReorderControlMode;
 };
 export declare const BlockEditor: import("react").ForwardRefExoticComponent<BlockEditorProps & import("react").RefAttributes<BlockEditorHandle>>;
 export {};