@riverbankcms/sdk 0.80.0 → 0.82.0

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventCombined.interactive.d.ts

@@ -1,6 +1,7 @@
 import type { ButtonVariant, CalendarTabViews, ColumnOption, EventBlockKind, EventLayout, EventScheduleScope, EventSurfaceScope, FilterAutoShow, PublicEvent, WeekStart } from "../../../blocks/events/shared/types";
 import { type InteractiveIslandProps } from "../../../../contracts/islands";
 import type { EventListingDisplay } from "./EventListing.interactive";
+import { type EventListPaginationAction, type EventListPaginationMode, type EventPageSize } from "./shared/listOptions";
 export type EventCombinedSourceProps = Readonly<{
     events?: PublicEvent[] | null;
     siteId: string;
@@ -9,7 +10,8 @@ export type EventCombinedSourceProps = Readonly<{
     listLayout?: EventLayout;
     listColumns?: ColumnOption;
     eventsPerPage?: string;
-    compactEventsPerPage?: string;
+    paginationMode?: EventListPaginationMode;
+    seeAllUrl?: string;
     loadMoreText?: string;
     startOfWeek?: WeekStart;
     calendarTabViews?: CalendarTabViews;
@@ -38,8 +40,8 @@ export type EventCombinedDisplay = Readonly<{
     events: readonly PublicEvent[];
     listLayout: EventLayout;
     listColumns: ColumnOption;
-    eventsPerPage: string;
-    loadMoreText: string;
+    eventsPerPage: EventPageSize;
+    paginationAction: EventListPaginationAction;
     startOfWeek: WeekStart;
     calendarTabViews: CalendarTabViews;
     showFilters: boolean;
@@ -90,7 +92,8 @@ export declare const eventCombinedBlockRuntime: Readonly<{
         listLayout?: EventLayout;
         listColumns?: ColumnOption;
         eventsPerPage?: string;
-        compactEventsPerPage?: string;
+        paginationMode?: EventListPaginationMode;
+        seeAllUrl?: string;
         loadMoreText?: string;
         startOfWeek?: WeekStart;
         calendarTabViews?: CalendarTabViews;
@@ -119,8 +122,8 @@ export declare const eventCombinedBlockRuntime: Readonly<{
             events: readonly PublicEvent[];
             listLayout: EventLayout;
             listColumns: ColumnOption;
-            eventsPerPage: string;
-            loadMoreText: string;
+            eventsPerPage: EventPageSize;
+            paginationAction: EventListPaginationAction;
             startOfWeek: WeekStart;
             calendarTabViews: CalendarTabViews;
             showFilters: boolean;
@@ -161,7 +164,8 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                 listLayout?: EventLayout;
                 listColumns?: ColumnOption;
                 eventsPerPage?: string;
-                compactEventsPerPage?: string;
+                paginationMode?: EventListPaginationMode;
+                seeAllUrl?: string;
                 loadMoreText?: string;
                 startOfWeek?: WeekStart;
                 calendarTabViews?: CalendarTabViews;
@@ -192,7 +196,8 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                 listLayout?: EventLayout;
                 listColumns?: ColumnOption;
                 eventsPerPage?: string;
-                compactEventsPerPage?: string;
+                paginationMode?: EventListPaginationMode;
+                seeAllUrl?: string;
                 loadMoreText?: string;
                 startOfWeek?: WeekStart;
                 calendarTabViews?: CalendarTabViews;
@@ -224,8 +229,8 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                     events: readonly PublicEvent[];
                     listLayout: EventLayout;
                     listColumns: ColumnOption;
-                    eventsPerPage: string;
-                    loadMoreText: string;
+                    eventsPerPage: EventPageSize;
+                    paginationAction: EventListPaginationAction;
                     startOfWeek: WeekStart;
                     calendarTabViews: CalendarTabViews;
                     showFilters: boolean;
@@ -263,8 +268,8 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                     events: readonly PublicEvent[];
                     listLayout: EventLayout;
                     listColumns: ColumnOption;
-                    eventsPerPage: string;
-                    loadMoreText: string;
+                    eventsPerPage: EventPageSize;
+                    paginationAction: EventListPaginationAction;
                     startOfWeek: WeekStart;
                     calendarTabViews: CalendarTabViews;
                     showFilters: boolean;
@@ -314,8 +319,8 @@ export declare const eventCombinedInteractiveIslandPropsCodec: Readonly<{
                 events: readonly PublicEvent[];
                 listLayout: EventLayout;
                 listColumns: ColumnOption;
-                eventsPerPage: string;
-                loadMoreText: string;
+                eventsPerPage: EventPageSize;
+                paginationAction: EventListPaginationAction;
                 startOfWeek: WeekStart;
                 calendarTabViews: CalendarTabViews;
                 showFilters: boolean;
@@ -362,8 +367,8 @@ export declare const eventCombinedInteractiveIslandPropsCodec: Readonly<{
                 events: readonly PublicEvent[];
                 listLayout: EventLayout;
                 listColumns: ColumnOption;
-                eventsPerPage: string;
-                loadMoreText: string;
+                eventsPerPage: EventPageSize;
+                paginationAction: EventListPaginationAction;
                 startOfWeek: WeekStart;
                 calendarTabViews: CalendarTabViews;
                 showFilters: boolean;

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventListing.interactive.d.ts

@@ -1,5 +1,6 @@
 import type { ButtonVariant, CardOrientation, CardVariant, ColumnOption, EventBlockKind, EventCardVariantInput, EventLayout, EventScheduleScope, EventSurfaceScope, FilterAutoShow, PublicEvent } from "../../../blocks/events/shared/types";
 import { type InteractiveIslandProps } from "../../../../contracts/islands";
+import { type EventListPaginationAction, type EventListPaginationMode, type EventPageSize } from "./shared/listOptions";
 export type EventListingSourceProps = Readonly<{
     events?: PublicEvent[] | null;
     siteId: string;
@@ -8,7 +9,7 @@ export type EventListingSourceProps = Readonly<{
     layout?: EventLayout;
     columns?: ColumnOption;
     eventsPerPage?: string;
-    paginationMode?: "loadMore" | "seeAllLink";
+    paginationMode?: EventListPaginationMode;
     seeAllUrl?: string;
     loadMoreText?: string;
     cardVariant?: EventCardVariantInput;
@@ -51,10 +52,8 @@ export type EventListingDisplay = Readonly<{
 export type EventListingHydration = Readonly<{
     siteId: string;
     stage?: "preview" | "published";
-    eventsPerPage: string;
-    paginationMode: "loadMore" | "seeAllLink";
-    seeAllUrl?: string;
-    loadMoreText: string;
+    eventsPerPage: EventPageSize;
+    paginationAction: EventListPaginationAction;
     showFilters: boolean;
     showCategoryFilter: FilterAutoShow;
     showVenueFilter: boolean;
@@ -84,7 +83,7 @@ export declare const eventListingBlockRuntime: Readonly<{
         layout?: EventLayout;
         columns?: ColumnOption;
         eventsPerPage?: string;
-        paginationMode?: "loadMore" | "seeAllLink";
+        paginationMode?: EventListPaginationMode;
         seeAllUrl?: string;
         loadMoreText?: string;
         cardVariant?: EventCardVariantInput;
@@ -127,10 +126,8 @@ export declare const eventListingBlockRuntime: Readonly<{
         hydration: Readonly<{
             siteId: string;
             stage?: "preview" | "published";
-            eventsPerPage: string;
-            paginationMode: "loadMore" | "seeAllLink";
-            seeAllUrl?: string;
-            loadMoreText: string;
+            eventsPerPage: EventPageSize;
+            paginationAction: EventListPaginationAction;
             showFilters: boolean;
             showCategoryFilter: FilterAutoShow;
             showVenueFilter: boolean;
@@ -155,7 +152,7 @@ export declare const eventListingBlockRuntime: Readonly<{
                 layout?: EventLayout;
                 columns?: ColumnOption;
                 eventsPerPage?: string;
-                paginationMode?: "loadMore" | "seeAllLink";
+                paginationMode?: EventListPaginationMode;
                 seeAllUrl?: string;
                 loadMoreText?: string;
                 cardVariant?: EventCardVariantInput;
@@ -186,7 +183,7 @@ export declare const eventListingBlockRuntime: Readonly<{
                 layout?: EventLayout;
                 columns?: ColumnOption;
                 eventsPerPage?: string;
-                paginationMode?: "loadMore" | "seeAllLink";
+                paginationMode?: EventListPaginationMode;
                 seeAllUrl?: string;
                 loadMoreText?: string;
                 cardVariant?: EventCardVariantInput;
@@ -232,10 +229,8 @@ export declare const eventListingBlockRuntime: Readonly<{
                 hydration: Readonly<{
                     siteId: string;
                     stage?: "preview" | "published";
-                    eventsPerPage: string;
-                    paginationMode: "loadMore" | "seeAllLink";
-                    seeAllUrl?: string;
-                    loadMoreText: string;
+                    eventsPerPage: EventPageSize;
+                    paginationAction: EventListPaginationAction;
                     showFilters: boolean;
                     showCategoryFilter: FilterAutoShow;
                     showVenueFilter: boolean;
@@ -271,10 +266,8 @@ export declare const eventListingBlockRuntime: Readonly<{
                 hydration: Readonly<{
                     siteId: string;
                     stage?: "preview" | "published";
-                    eventsPerPage: string;
-                    paginationMode: "loadMore" | "seeAllLink";
-                    seeAllUrl?: string;
-                    loadMoreText: string;
+                    eventsPerPage: EventPageSize;
+                    paginationAction: EventListPaginationAction;
                     showFilters: boolean;
                     showCategoryFilter: FilterAutoShow;
                     showVenueFilter: boolean;
@@ -322,10 +315,8 @@ export declare const eventListingInteractiveIslandPropsCodec: Readonly<{
             hydration: Readonly<{
                 siteId: string;
                 stage?: "preview" | "published";
-                eventsPerPage: string;
-                paginationMode: "loadMore" | "seeAllLink";
-                seeAllUrl?: string;
-                loadMoreText: string;
+                eventsPerPage: EventPageSize;
+                paginationAction: EventListPaginationAction;
                 showFilters: boolean;
                 showCategoryFilter: FilterAutoShow;
                 showVenueFilter: boolean;
@@ -370,10 +361,8 @@ export declare const eventListingInteractiveIslandPropsCodec: Readonly<{
             hydration: Readonly<{
                 siteId: string;
                 stage?: "preview" | "published";
-                eventsPerPage: string;
-                paginationMode: "loadMore" | "seeAllLink";
-                seeAllUrl?: string;
-                loadMoreText: string;
+                eventsPerPage: EventPageSize;
+                paginationAction: EventListPaginationAction;
                 showFilters: boolean;
                 showCategoryFilter: FilterAutoShow;
                 showVenueFilter: boolean;

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventListing.view.d.ts

@@ -7,4 +7,4 @@ export declare function EventListingFrameView(props: Readonly<{
     emptyState?: React.ReactNode;
     footer?: React.ReactNode;
     renderEventCard: (event: PublicEvent) => React.ReactNode;
-}>): import("react/jsx-runtime").JSX.Element;
+}>): React.JSX.Element;

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

@@ -1,3 +1,4 @@
+import React from 'react';
 export type DateTimeTileProps = {
     startsAt: string;
     endsAt: string;
@@ -7,4 +8,4 @@ export type DateTimeTileProps = {
  * Shared tile content for displaying date and time range.
  * Used by event-details "Other dates" and course-details "Sessions".
  */
-export declare function DateTimeTile({ startsAt, endsAt, timeZone }: DateTimeTileProps): import("react/jsx-runtime").JSX.Element;
+export declare function DateTimeTile({ startsAt, endsAt, timeZone }: DateTimeTileProps): React.JSX.Element;

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

@@ -6,6 +6,7 @@ type DayEventsModalProps = {
     showCapacity: boolean;
     onClose: () => void;
     onSelectEvent: (event: PublicEvent) => void;
+    portalRoot?: HTMLElement | null;
 };
 /**
  * DayEventsModal - Modal overlay showing all events for a specific day
@@ -13,5 +14,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, showCapacity, onClose, onSelectEvent, }: DayEventsModalProps): React.ReactElement;
+export declare function DayEventsModal({ date, events, showCapacity, onClose, onSelectEvent, portalRoot, }: DayEventsModalProps): React.ReactElement;
 export default DayEventsModal;

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

@@ -4,6 +4,7 @@ type EventDetailModalProps = {
     event: PublicEvent;
     showCapacity: boolean;
     onClose: () => void;
+    portalRoot?: HTMLElement | null;
     cardVariant?: EventCardVariantInput;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
@@ -15,5 +16,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, showCapacity, onClose, cardVariant, buttonVariant, buttonText, showMap, }: EventDetailModalProps): React.ReactElement;
+export declare function EventDetailModal({ event, showCapacity, onClose, portalRoot, cardVariant, buttonVariant, buttonText, showMap, }: EventDetailModalProps): React.ReactElement;
 export default EventDetailModal;

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

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
 import type { EventListingDisplay } from '../EventListing.interactive';
+import type { EventListPaginationAction } from './listOptions';
 type EventPaginatedListViewProps = {
     filters?: React.ReactNode;
     display: EventListingDisplay;
@@ -9,9 +10,7 @@ type EventPaginatedListViewProps = {
     error: Error | null;
     hasMore: boolean;
     loadMore: () => void;
-    paginationMode?: 'loadMore' | 'seeAllLink';
-    seeAllUrl?: string;
-    loadMoreText: string;
+    paginationAction: EventListPaginationAction;
     /** Whether filters are currently applied (non-default values) */
     hasActiveFilters?: boolean;
     /** Callback to reset all filters to default values */

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

@@ -1,9 +1,9 @@
 import React from 'react';
-import type { PublicEvent, WeekStart } from '../../../../blocks/events/shared/types';
+import type { PublicEvent } from '../../../../blocks/events/shared/types';
+import { type WeekCalendarDays } from './utils';
 type WeekAgendaViewProps = {
-    viewDate: Date;
+    days: WeekCalendarDays;
     events: PublicEvent[];
-    startOfWeek: WeekStart;
     showCapacity: boolean;
     emptyMessage?: string;
 };

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

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import type { EventBlockKind, EventScheduleScope, EventSurfaceScope } from "../../../../blocks/events/shared/types";
+type Writable<T> = {
+    -readonly [K in keyof T]: T[K];
+};
+export declare const eventPageSizeValues: readonly [3, 6, 10, 12, 20, 24, 30];
+export type EventPageSize = (typeof eventPageSizeValues)[number];
+export declare const eventPageSizeSchema: z.ZodType<EventPageSize>;
+export declare function resolveEventPageSize(value: string | number | null | undefined, fallback?: EventPageSize): EventPageSize;
+export declare function resolveEventCalendarListPageSize(input: {
+    eventsPerPage?: string | number | null;
+}): EventPageSize;
+export type EventListPaginationMode = "loadMore" | "seeAllLink";
+export type EventListPaginationAction = Readonly<{
+    kind: "loadMore";
+    label: string;
+}> | Readonly<{
+    kind: "seeAllLink";
+    label: string;
+    href: string;
+}>;
+export declare const eventListPaginationActionSchema: z.ZodType<EventListPaginationAction>;
+export declare function resolveEventListPaginationAction(input: {
+    paginationMode?: EventListPaginationMode | null;
+    seeAllUrl?: string | null;
+    loadMoreText?: string | null;
+    defaultLabel?: string;
+}): EventListPaginationAction;
+export type EventRuntimeFilters = Readonly<{
+    categoryIds?: string;
+    staffMemberId?: string;
+    venueId?: string;
+    kind?: "courses" | "events";
+    eventSurface?: Exclude<EventSurfaceScope, "all">;
+    eventPresets?: string;
+    scheduleScope?: Exclude<EventScheduleScope, "any">;
+}>;
+export type EventRuntimeFiltersDraft = Writable<EventRuntimeFilters>;
+export type EventRuntimeFilterInput = Readonly<{
+    eventKind?: EventBlockKind | null;
+    eventSurface?: EventSurfaceScope | null;
+    filterEventPresets?: string | null;
+    scheduleScope?: EventScheduleScope | null;
+    filterCategoryIds?: string | null;
+    filterStaffMemberId?: string | null;
+    filterVenueId?: string | null;
+}>;
+export declare function buildEventRuntimeFilters(input: EventRuntimeFilterInput): EventRuntimeFilters;
+export declare function getEventRuntimeFiltersKey(filters: EventRuntimeFilters | undefined): string;
+export {};

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

@@ -53,7 +53,8 @@ export type EventCompactDateRail = Readonly<{
 export declare function formatEventCompactDateRail(isoTimestamp: string, options?: DateTimeFormatOptions): EventCompactDateRail;
 export declare function formatTeamMemberNames(names: readonly string[]): string | null;
 export declare function formatEventTeacherLine(event: PublicEvent): string | null;
-export { addMonths, formatCalendarTitle, formatDateKey, getEndOfMonth, getMonthCalendarDays, getOrderedDayNames, getStartOfMonth, getThreeMonthRange, getWeekCalendarDays, isToday, MAX_EVENTS_PER_DAY, } from '../../../../../../../calendar/src/index';
+export { addDays, addMonths, buildCalendarViewport, formatCalendarTitle, formatDateKey, getEndOfMonth, getMonthCalendarDays, getOrderedDayNames, getStartOfMonth, getThreeMonthRange, getWeekCalendarDays, getWeekCalendarDayTuple, isToday, MAX_EVENTS_PER_DAY, shiftCalendarAnchorDate, } from '../../../../../../../calendar/src/index';
+export type { CalendarViewport, CalendarViewportKind, MonthCalendarViewport, WeekCalendarDays, WeekCalendarViewport, } from '../../../../../../../calendar/src/index';
 /**
  * Group events by their local date (YYYY-MM-DD key in each event's own
  * timezone). Thin domain wrapper over `groupItemsByDate` from the calendar

package/dist/_dts/blocks/src/system/runtime/nodes/gifting.client.d.ts

@@ -1,4 +1,5 @@
+import React from 'react';
 import type { GiftingInteractiveIslandProps } from './gifting.interactive';
 type GiftingClientProps = GiftingInteractiveIslandProps;
-export declare function GiftingClient(props: GiftingClientProps): import("react/jsx-runtime").JSX.Element;
+export declare function GiftingClient(props: GiftingClientProps): React.JSX.Element;
 export default GiftingClient;

package/dist/_dts/blocks/src/system/runtime/nodes/gifting.server.d.ts

@@ -1,6 +1,7 @@
+import React from 'react';
 import { type GiftingSourceProps } from './gifting.interactive';
 type GiftingSSRProps = Readonly<{
     blockId?: string | null;
 }> & GiftingSourceProps;
-export declare function GiftingSSR({ blockId, ...rest }: GiftingSSRProps): import("react/jsx-runtime").JSX.Element;
+export declare function GiftingSSR({ blockId, ...rest }: GiftingSSRProps): React.JSX.Element;
 export default GiftingSSR;

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

@@ -11,6 +11,6 @@ export type LocationMapClientProps = Readonly<{
     children?: React.ReactNode;
 }>;
 export type LocationMapIslandClientProps = LocationMapIslandProps;
-export declare function LocationMapClient(props: LocationMapClientProps): import("react/jsx-runtime").JSX.Element;
-export declare function LocationMapIslandClient(props: LocationMapIslandClientProps): import("react/jsx-runtime").JSX.Element;
+export declare function LocationMapClient(props: LocationMapClientProps): React.JSX.Element;
+export declare function LocationMapIslandClient(props: LocationMapIslandClientProps): React.JSX.Element;
 export default LocationMapClient;

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

@@ -15,5 +15,5 @@ export type LocationMapProps = Readonly<{
     directionsLabel?: string | null;
     children?: React.ReactNode;
 }>;
-export declare function LocationMapSSR(props: LocationMapProps): import("react/jsx-runtime").JSX.Element;
+export declare function LocationMapSSR(props: LocationMapProps): React.JSX.Element;
 export default LocationMapSSR;

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

@@ -64,11 +64,11 @@ 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 normalizeLocationMapSource(value: string | null | undefined): LocationMapSource;
 export declare function resolveLocationMapLocation(input: {
     location?: unknown;
     businessAddress?: unknown;
-    locationSource?: LocationMapSource | string | null;
+    locationSource?: string | null;
     venueId?: string | null;
     venuesById?: LocationMapLocationsByVenueId | null;
 }): ResolvedLocationMapLocation;
@@ -76,7 +76,7 @@ export declare function describeUnresolvedLocationMapLocation(resolvedLocation:
 export declare function normalizeLocationMapProps(input: {
     location?: unknown;
     businessAddress?: unknown;
-    locationSource?: LocationMapSource | string | null;
+    locationSource?: string | null;
     venueId?: string | null;
     venuesById?: LocationMapLocationsByVenueId | null;
     zoom?: number | string | null;
@@ -89,7 +89,7 @@ export declare function normalizeLocationMapProps(input: {
 export declare function toLocationMapHydrationProps(input: {
     location?: unknown;
     businessAddress?: unknown;
-    locationSource?: LocationMapSource | string | null;
+    locationSource?: string | null;
     venueId?: string | null;
     venuesById?: Record<string, unknown> | null;
     zoom?: number | string | null;

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

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

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

@@ -1,5 +1,5 @@
 import React from 'react';
-import { type ResolvedMediaTransform, type DirectImageUrlOptions } from '../../../../../media-core/src/index';
+import { type ResolvedMediaTransform, type DirectImageUrlOptions, type RenderableMediaAsset, type RenderableMediaAssetIndex } from '../../../../../media-core/src/index';
 import type { Media } from '../../../lib/media';
 /**
  * Options for image URL resolution.
@@ -33,19 +33,8 @@ export type ResolveImageUrlContextInput = Readonly<{
     mediaAssetIndex?: MediaAssetIndex;
     mediaAssets?: readonly MediaAssetIndexItem[];
 }>;
-export type MediaAssetIndexItem = Readonly<{
-    id: string;
-    identifier?: string | null;
-    storageBucket?: string;
-    storagePath?: string;
-    width?: number | null;
-    height?: number | null;
-    mimeType?: string;
-}>;
-export type MediaAssetIndex = Readonly<{
-    byId: ReadonlyMap<string, MediaAssetIndexItem>;
-    byIdentifier: ReadonlyMap<string, MediaAssetIndexItem>;
-}>;
+export type MediaAssetIndexItem = RenderableMediaAsset;
+export type MediaAssetIndex = RenderableMediaAssetIndex;
 export declare function buildMediaAssetIndex(assets: readonly MediaAssetIndexItem[] | undefined): MediaAssetIndex | undefined;
 export type ResolveImageSourceSetOptions = {
     widthCandidates?: readonly number[];
@@ -65,8 +54,30 @@ export type ResolvedImageSourceSet = {
      */
     fallbackSrc?: string;
 };
+export type MediaUrlResolution = Readonly<{
+    kind: 'resolved';
+    url: string;
+}> | Readonly<{
+    kind: 'unsupported-media-type';
+    mediaType: string | undefined;
+}> | Readonly<{
+    kind: 'missing-storage-path';
+    assetId?: string;
+    identifier?: string | null;
+}> | Readonly<{
+    kind: 'missing-site-context';
+    storagePath: string;
+}> | Readonly<{
+    kind: 'missing-supabase-url';
+    message: string;
+}> | Readonly<{
+    kind: 'missing-image-url';
+    assetId?: string;
+    identifier?: string | null;
+}>;
 export declare function buildResolveImageUrlContext(input: ResolveImageUrlContextInput | undefined): ResolveImageUrlContext;
 export declare function resolveMediaStorageUrl(value: Media, context?: ResolveImageUrlContext | null, transformOptions?: DirectImageUrlOptions): string | undefined;
+export declare function resolveMediaStorageUrlResult(value: Media, context?: ResolveImageUrlContext | null, transformOptions?: DirectImageUrlOptions): MediaUrlResolution;
 /**
  * Common image size presets.
  * Use these for consistent sizing across the application.
@@ -176,6 +187,8 @@ export type MediaNodeProps = {
     /** Optional block metadata injected by the runtime resolver */
     blockKind?: string | null;
     blockContent?: unknown;
+    /** Render-scoped media sidecar/context injected by PageRenderer. */
+    imageResolveContext?: ResolveImageUrlContext | null;
 };
 export type VideoPlaybackMode = 'inline' | 'background';
 export declare function resolveMediaNodeResponsiveImage(value: Media, size: ImageOptions, style: React.CSSProperties | undefined, slot: {
@@ -227,6 +240,8 @@ export declare const MediaNode: React.FC<MediaNodeProps>;
  * ```
  */
 export declare function resolveImageUrl(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null): string | undefined;
+export declare function resolveImageUrlResult(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null): MediaUrlResolution;
 export declare function resolveImageUrlWithContext(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null, transformAspectRatio?: number | string): string | undefined;
+export declare function resolveImageUrlWithContextResult(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null, transformAspectRatio?: number | string): MediaUrlResolution;
 export declare function resolveImageSourceSetWithContext(value: Media, options: ResolveImageSourceSetOptions, context?: ResolveImageUrlContext | null): ResolvedImageSourceSet | undefined;
 export {};

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import type { NewsletterFormProps } from './newsletter-form.types';
 /**
  * Newsletter Form Server Component
@@ -5,5 +6,5 @@ import type { NewsletterFormProps } from './newsletter-form.types';
  * Renders the newsletter signup form for SSR with hydration support.
  * Uses the islands architecture pattern to hydrate on the client.
  */
-export declare function NewsletterFormSSR({ blockId, siteId, apiBaseUrl, listId, preset, includePhone, buttonLabel, successMessage, privacyNote, tags, spamProtectionEnabled, className, }: NewsletterFormProps): import("react/jsx-runtime").JSX.Element;
+export declare function NewsletterFormSSR({ blockId, siteId, apiBaseUrl, listId, preset, includePhone, buttonLabel, successMessage, privacyNote, tags, spamProtectionEnabled, className, }: NewsletterFormProps): React.JSX.Element;
 export default NewsletterFormSSR;

package/dist/_dts/blocks/src/system/runtime/nodes/offerings-preview.d.ts

@@ -0,0 +1,23 @@
+import React from "react";
+import type { PublicCourse } from "../../blocks/courses/shared/types";
+import type { ButtonVariant, PublicEvent } from "../../blocks/events/shared/types";
+import type { CardStylesContent } from "../../fields/boxStyles";
+import { type BookingOfferingPresetSummary, type OfferingsPreviewEventDataKey, type OfferingsPreviewGroupOrder, type OfferingsPreviewGroupOverride, type OfferingsPreviewRouteCandidate } from "../../blocks/offerings-preview/model";
+type OfferingsPreviewProps = Readonly<{
+    bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
+    groupOrder?: OfferingsPreviewGroupOrder | null;
+    groupOverrides?: readonly OfferingsPreviewGroupOverride[] | null;
+    cardStyles?: CardStylesContent;
+    itemLimit?: string | null;
+    buttonVariant?: ButtonVariant | null;
+    buttonText?: string | null;
+    emptyMessage?: string | null;
+    failedMessage?: string | null;
+    previewStage?: "published" | "preview" | null;
+    routeCandidates?: Readonly<{
+        routes?: readonly OfferingsPreviewRouteCandidate[] | null;
+    }> | null;
+    courses?: readonly PublicCourse[] | null;
+}> & Partial<Record<OfferingsPreviewEventDataKey, readonly PublicEvent[] | null>>;
+export declare function OfferingsPreviewNode(props: OfferingsPreviewProps): React.JSX.Element | null;
+export default OfferingsPreviewNode;

package/dist/_dts/blocks/src/system/runtime/nodes/product-detail.client.d.ts

@@ -1,4 +1,5 @@
+import React from 'react';
 import type { ProductDetailInteractiveIslandProps } from './shop.interactive';
 export type ProductDetailClientProps = ProductDetailInteractiveIslandProps;
-export declare function ProductDetailClient(props: ProductDetailClientProps): import("react/jsx-runtime").JSX.Element;
+export declare function ProductDetailClient(props: ProductDetailClientProps): React.JSX.Element;
 export default ProductDetailClient;

package/dist/_dts/blocks/src/system/runtime/nodes/product-detail.server.d.ts

@@ -7,5 +7,5 @@ type ProductDetailProps = Readonly<{
     stage?: 'preview' | 'published';
     children?: React.ReactNode;
 }> & ShopDisplayConfig;
-export declare function ProductDetailSSR({ blockId, siteId, apiBaseUrl, stage, children, ...rest }: ProductDetailProps): import("react/jsx-runtime").JSX.Element;
+export declare function ProductDetailSSR({ blockId, siteId, apiBaseUrl, stage, children, ...rest }: ProductDetailProps): React.JSX.Element;
 export default ProductDetailSSR;

package/dist/_dts/blocks/src/system/runtime/nodes/product-list.client.d.ts

@@ -1,4 +1,5 @@
+import React from 'react';
 import type { ProductListInteractiveIslandProps } from './shop.interactive';
 export type ProductListClientProps = ProductListInteractiveIslandProps;
-export declare function ProductListClient(props: ProductListClientProps): import("react/jsx-runtime").JSX.Element;
+export declare function ProductListClient(props: ProductListClientProps): React.JSX.Element;
 export default ProductListClient;

package/dist/_dts/blocks/src/system/runtime/nodes/product-list.server.d.ts

@@ -7,5 +7,5 @@ type ProductListProps = Readonly<{
     stage?: 'preview' | 'published';
     children?: React.ReactNode;
 }> & ShopDisplayConfig;
-export declare function ProductListSSR({ blockId, siteId, apiBaseUrl, stage, children, ...rest }: ProductListProps): import("react/jsx-runtime").JSX.Element;
+export declare function ProductListSSR({ blockId, siteId, apiBaseUrl, stage, children, ...rest }: ProductListProps): React.JSX.Element;
 export default ProductListSSR;

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

@@ -1,3 +1,4 @@
+import React from 'react';
 export type MagicLinkFormProps = {
     /** Initial email to pre-populate the form */
     initialEmail?: string;
@@ -20,5 +21,5 @@ export type MagicLinkFormProps = {
  * Reusable magic link login form.
  * Used by Customer Portal and Event Registration blocks.
  */
-export declare function MagicLinkForm({ initialEmail, title, subtitle, buttonText, successMessage, onSuccess, classPrefix, compact, }: MagicLinkFormProps): import("react/jsx-runtime").JSX.Element;
+export declare function MagicLinkForm({ initialEmail, title, subtitle, buttonText, successMessage, onSuccess, classPrefix, compact, }: MagicLinkFormProps): React.JSX.Element;
 export default MagicLinkForm;

package/dist/_dts/blocks/src/system/runtime/nodes/shop-add-feedback.d.ts

@@ -7,4 +7,4 @@ export declare function useTransientShopAddFeedback(timeoutMs?: number): {
 export declare function ShopAddFeedback(props: Readonly<{
     active: boolean;
     itemLabel: string;
-}>): import("react/jsx-runtime").JSX.Element | null;
+}>): React.JSX.Element | null;