@riverbankcms/sdk 0.135.1 → 0.136.0

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

@@ -1,7 +1,9 @@
 import React from 'react';
+import type { CalendarDate } from '../../../../../../../calendar/src/index';
 import type { PublicEvent, WeekStart } from '../../../../blocks/events/shared/types';
 type WeekTimetableViewProps = {
-    viewDate: Date;
+    viewDate: CalendarDate;
+    today: CalendarDate;
     events: PublicEvent[];
     startOfWeek: WeekStart;
     showCapacity: boolean;

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

@@ -1,5 +1,7 @@
 import { z } from "zod";
 import { type CardRole } from "../../../../../../../theme-core/src/cards/index";
+import { type BookingTimeZone } from "../../../../../../../core/src/index";
+import type { CalendarDate } from '../../../../../../../calendar/src/index';
 import type { ButtonVariant, CalendarTabViews, CalendarView, ColumnOption, EventLayout, EventScheduleScope, EventSurfaceScope, FilterAutoShow, PublicEvent, WeekStart } from "../../../../blocks/events/shared/types";
 import { type EventListPaginationAction, type EventListPaginationMode, type EventPageSize } from "./listOptions";
 import type { EventListingDisplay } from "../EventListing.interactive";
@@ -35,6 +37,7 @@ export type EventCollectionSourceProps = Readonly<{
     buttonText?: string;
     emptyMessage?: string;
     className?: string;
+    bookingTimeZone?: string;
 }>;
 export type EventCollectionDisplay = Readonly<{
     events: readonly PublicEvent[];
@@ -70,6 +73,10 @@ export type EventCollectionHydration = Readonly<{
     eventSurface: EventSurfaceScope;
     filterEventPresets: string | null;
     scheduleScope: EventScheduleScope;
+    calendarContext: Readonly<{
+        timeZone: BookingTimeZone;
+        initialToday: CalendarDate;
+    }>;
 }>;
 export declare const eventCollectionFilterSourceSchemaShape: {
     readonly showFilters: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
@@ -116,6 +123,7 @@ export declare const eventCollectionSourceSchemaShape: {
     readonly buttonText: z.ZodOptional<z.ZodString>;
     readonly emptyMessage: z.ZodOptional<z.ZodString>;
     readonly className: z.ZodOptional<z.ZodString>;
+    readonly bookingTimeZone: z.ZodOptional<z.ZodString>;
     readonly showFilters: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly showCategoryFilter: z.ZodOptional<z.ZodEnum<{
         auto: "auto";
@@ -1658,5 +1666,5 @@ export declare const eventCollectionDisplaySchemaShape: {
 };
 export declare const eventCollectionHydrationSchema: z.ZodType<EventCollectionHydration>;
 export declare function buildEventCollectionDisplay(source: EventCollectionSourceProps): EventCollectionDisplay;
-export declare function buildEventCollectionHydration(source: EventCollectionSourceProps): EventCollectionHydration;
+export declare function buildEventCollectionHydration(source: EventCollectionSourceProps, now?: Date): EventCollectionHydration;
 export declare function buildEventCollectionListingDisplay(display: EventCollectionDisplay, prefetchedEvents: boolean, className: string | null): EventListingDisplay;

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

@@ -6,7 +6,7 @@
  * categoryColor with theme fallback). Renderers (WeekTimetableView,
  * EventCalendar.server) consume this shape.
  */
-import { type WeekStart } from '../../../../../../../calendar/src/index';
+import { type WeekStart, type CalendarDate } from '../../../../../../../calendar/src/index';
 import type { PublicEvent } from '../../../../blocks/events/shared/types';
 export type TimetableEventCell = {
     event: PublicEvent;
@@ -24,7 +24,7 @@ export type TimetableEventCell = {
     isFull: boolean;
 };
 export type TimetableDay = {
-    date: Date;
+    date: CalendarDate;
     dateKey: string;
     label: string;
     shortLabel: string;
@@ -41,7 +41,8 @@ export type TimetableModel = {
 };
 type BuildTimetableModelInput = {
     events: readonly PublicEvent[];
-    viewDate: Date;
+    viewDate: CalendarDate;
+    today: CalendarDate;
     startOfWeek: WeekStart;
 };
 export declare function buildTimetableModel(input: BuildTimetableModelInput): TimetableModel;

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

@@ -57,14 +57,14 @@ 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 { 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';
+export { addDays, addMonths, buildCalendarViewport, formatCalendarTitle, formatDateKey, getEndOfMonth, getMonthCalendarDays, getOrderedDayNames, getStartOfMonth, getWeekCalendarDays, getWeekCalendarDayTuple, isToday, MAX_EVENTS_PER_DAY, shiftCalendarAnchorDate, } from '../../../../../../../calendar/src/index';
+export type { CalendarDate, 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; preserves the historical `Map<string, PublicEvent[]>` shape.
  */
-export declare function groupEventsByDate(events: PublicEvent[]): Map<string, PublicEvent[]>;
+export declare function groupEventsByDate(events: PublicEvent[], calendarTimeZone: string): Map<string, PublicEvent[]>;
 /**
  * Format event price for display.
  * @returns "Free", "£25", "£12 - £25", "Free / £12 - £25", "Course (From £40)", etc.

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

@@ -17,7 +17,6 @@ export declare const headerLogoTextVisibleTransform: TransformDefinition;
  * Consumed by the site-header block's `$when` gates so the two classic rows are
  * mutually exclusive without introducing a new top-level header variant.
  */
-export declare const classicNavModeTransform: TransformDefinition;
 declare const maxWidthClassSchema: z.ZodObject<{
     base: z.ZodOptional<z.ZodString>;
     container: z.ZodOptional<z.ZodString>;

package/dist/_dts/calendar/src/grid.d.ts

@@ -1,87 +1,45 @@
-/**
- * Calendar grid helpers — pure date math.
- *
- * No items. No timezones beyond the runtime locale. No domain.
- * Use these to lay out month/week views; group items into the resulting
- * cells with `groupItemsByDate` from `./group`.
- */
+/** Calendar grid helpers over date-only values. */
+export type CalendarDate = Readonly<{
+    year: number;
+    month: number;
+    day: number;
+}>;
 export type WeekStart = 'sunday' | 'monday';
 export type CalendarViewportKind = 'month' | 'week';
-export type WeekCalendarDays = readonly [Date, Date, Date, Date, Date, Date, Date];
+export type WeekCalendarDays = readonly [CalendarDate, CalendarDate, CalendarDate, CalendarDate, CalendarDate, CalendarDate, CalendarDate];
 export type MonthCalendarViewport = Readonly<{
     kind: 'month';
-    anchorDate: Date;
-    days: readonly Date[];
+    anchorDate: CalendarDate;
+    days: readonly CalendarDate[];
     title: string;
 }>;
 export type WeekCalendarViewport = Readonly<{
     kind: 'week';
-    anchorDate: Date;
+    anchorDate: CalendarDate;
     days: WeekCalendarDays;
     title: string;
 }>;
 export type CalendarViewport = MonthCalendarViewport | WeekCalendarViewport;
 export declare const DAY_NAMES: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
 export declare const MONTH_NAMES: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
-/**
- * Convention default: maximum events to show per calendar day before a
- * "+N more" overflow indicator. Renderers may override.
- */
 export declare const MAX_EVENTS_PER_DAY = 3;
-/** Format a date as YYYY-MM-DD using the runtime's local timezone. */
-export declare function formatDateKey(date: Date): string;
-/**
- * True when `date` and `now` are the same local calendar day.
- * `now` defaults to `new Date()` so casual callers don't need to thread it,
- * but tests and snapshot-rendering should pass an explicit value.
- */
-export declare function isToday(date: Date, now?: Date): boolean;
-/** True when two dates fall on the same local calendar day. */
-export declare function isSameLocalDay(left: Date, right: Date): boolean;
-export declare function getStartOfMonth(date: Date): Date;
-export declare function getEndOfMonth(date: Date): Date;
-/**
- * Add (or subtract) months to a date, clamping the day-of-month to the
- * target month's last day. Avoids JS Date overflow (Jan 29 + 1 month → Mar 1
- * in non-leap years).
- */
-export declare function addMonths(date: Date, months: number): Date;
-/** Add (or subtract) days while preserving local time-of-day fields. */
-export declare function addDays(date: Date, days: number): Date;
-/** Shift a calendar anchor by the natural unit for a viewport kind. */
-export declare function shiftCalendarAnchorDate(date: Date, view: CalendarViewportKind, steps: number): Date;
-/**
- * Get an inclusive 3-month window around `date`, returned as ISO strings
- * with UTC midnight bounds. Suitable for prefetching event windows when
- * the consumer handles timezone conversion downstream.
- */
-export declare function getThreeMonthRange(date: Date): {
-    from: string;
-    to: string;
-};
-/**
- * Build the calendar days for a month view. Returns 42 dates (6 rows × 7
- * days) including padding from prior/next months for a stable grid.
- */
-export declare function getMonthCalendarDays(year: number, month: number, startOfWeek: WeekStart): Date[];
-/** Build the 7 dates of the week containing `baseDate`. */
-export declare function getWeekCalendarDays(baseDate: Date, startOfWeek: WeekStart): Date[];
-/** Build the 7 dates of the week containing `baseDate` as a fixed-width tuple. */
-export declare function getWeekCalendarDayTuple(baseDate: Date, startOfWeek: WeekStart): WeekCalendarDays;
-/**
- * Day-name labels reordered for the chosen week start. Pass a custom
- * `dayNames` array (length 7, Sunday-first) to localize.
- */
+export declare function formatDateKey(date: CalendarDate): string;
+export declare function isToday(date: CalendarDate, today: CalendarDate): boolean;
+export declare function isSameCalendarDay(left: CalendarDate, right: CalendarDate): boolean;
+export declare function getStartOfMonth(date: CalendarDate): CalendarDate;
+export declare function getEndOfMonth(date: CalendarDate): CalendarDate;
+export declare function addMonths(date: CalendarDate, months: number): CalendarDate;
+export declare function addDays(date: CalendarDate, days: number): CalendarDate;
+export declare function shiftCalendarAnchorDate(date: CalendarDate, view: CalendarViewportKind, steps: number): CalendarDate;
+export declare function getMonthCalendarDays(year: number, month: number, startOfWeek: WeekStart): CalendarDate[];
+export declare function getWeekCalendarDays(baseDate: CalendarDate, startOfWeek: WeekStart): CalendarDate[];
+export declare function getDayOfWeek(date: CalendarDate): number;
+export declare function getWeekCalendarDayTuple(baseDate: CalendarDate, startOfWeek: WeekStart): WeekCalendarDays;
 export declare function getOrderedDayNames(startOfWeek: WeekStart, dayNames?: readonly string[]): string[];
-/**
- * Header title for a calendar view.
- *   - month: "January 2025"
- *   - week:  "January 5 - 11, 2025" or "December 30 - January 5, 2025"
- */
-export declare function formatCalendarTitle(viewDate: Date, view: 'month' | 'week', days: Date[], monthNames?: readonly string[]): string;
+export declare function formatCalendarTitle(viewDate: CalendarDate, view: CalendarViewportKind, days: readonly CalendarDate[], monthNames?: readonly string[]): string;
 export declare function buildCalendarViewport(input: Readonly<{
     view: CalendarViewportKind;
-    anchorDate: Date;
+    anchorDate: CalendarDate;
     startOfWeek: WeekStart;
     monthNames?: readonly string[];
 }>): CalendarViewport;

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

@@ -1,5 +1,5 @@
-export type { CalendarViewport, CalendarViewportKind, MonthCalendarViewport, WeekCalendarDays, WeekCalendarViewport, WeekStart, } from './grid';
-export { addDays, buildCalendarViewport, getMonthCalendarDays, getWeekCalendarDays, getWeekCalendarDayTuple, getOrderedDayNames, formatCalendarTitle, formatDateKey, isToday, isSameLocalDay, addMonths, shiftCalendarAnchorDate, getStartOfMonth, getEndOfMonth, getThreeMonthRange, DAY_NAMES, MONTH_NAMES, MAX_EVENTS_PER_DAY, } from './grid';
+export type { CalendarViewport, CalendarViewportKind, CalendarDate, MonthCalendarViewport, WeekCalendarDays, WeekCalendarViewport, WeekStart, } from './grid';
+export { addDays, buildCalendarViewport, getMonthCalendarDays, getWeekCalendarDays, getWeekCalendarDayTuple, getDayOfWeek, getOrderedDayNames, formatCalendarTitle, formatDateKey, isToday, isSameCalendarDay, addMonths, shiftCalendarAnchorDate, getStartOfMonth, getEndOfMonth, DAY_NAMES, MONTH_NAMES, MAX_EVENTS_PER_DAY, } from './grid';
 export type { TimetableInput, TimetableModel, TimetableDay, TimetableCell, TimetableBounds, TimetableDiagnostic, InvalidItemReason, TimetableView, } from './timetable';
 export { buildTimetableModel } from './timetable';
 export type { GroupItemsByDateAccessors } from './group';

package/dist/_dts/calendar/src/timetable.d.ts

@@ -9,7 +9,7 @@
  * the same output. The model has no opinion on what an item is — pass
  * accessors.
  */
-import { type WeekStart } from './grid';
+import { type CalendarDate, type WeekStart } from './grid';
 export type TimetableBounds = Readonly<{
     /** Hour ticks below this are clipped. Default 5. */
     minStartHour?: number;
@@ -24,7 +24,7 @@ export type TimetableBounds = Readonly<{
 }>;
 export type TimetableInput<T> = Readonly<{
     items: readonly T[];
-    viewDate: Date;
+    viewDate: CalendarDate;
     view?: TimetableView;
     startOfWeek: WeekStart;
     getId: (item: T) => string;
@@ -35,12 +35,8 @@ export type TimetableInput<T> = Readonly<{
     /** Sort tiebreak when two items have identical start+end. Defaults to getId. */
     getOrderKey?: (item: T) => string;
     bounds?: TimetableBounds;
-    /**
-     * "Now" reference for the `isToday` flag on each day. Defaults to
-     * `new Date()`; pass an explicit value to keep the model fully deterministic
-     * for snapshot tests.
-     */
-    now?: Date;
+    /** The calendar's explicit site-local current date. */
+    today: CalendarDate;
 }>;
 export type InvalidItemReason = 'invalid-start' | 'invalid-end' | 'invalid-timezone' | 'non-positive-duration' | 'out-of-visible-hours';
 export type TimetableDiagnostic<T> = Readonly<{
@@ -68,7 +64,7 @@ export type TimetableCell<T> = Readonly<{
     color: string | null;
 }>;
 export type TimetableDay<T> = Readonly<{
-    date: Date;
+    date: CalendarDate;
     dateKey: string;
     isToday: boolean;
     cells: readonly TimetableCell<T>[];

package/dist/_dts/commerce/src/purchase/allocation.d.ts

@@ -0,0 +1,11 @@
+import { type NonNegativeCents } from '../../../core/src/index';
+/**
+ * Allocate an integer total proportionally using largest remainders.
+ *
+ * Negative weights are treated as zero. When every weight is zero, the total
+ * is spread evenly instead, with residual units assigned in input order.
+ */
+export declare function allocateTotalByWeight<TLineId extends string>(total: number, lines: readonly Readonly<{
+    id: TLineId;
+    weight: number;
+}>[]): ReadonlyMap<TLineId, NonNegativeCents>;

package/dist/_dts/commerce/src/purchase/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types';
+export * from './allocation';
 export * from './orderTypes';
 export * from './orderPlanningTypes';
 export * from './bookingInstalmentSchedule';
@@ -52,4 +53,5 @@ export * from './refundPolicy';
 export * from './settlement';
 export * from './shopRefundPlanning';
 export * from './stripeMinimumCharge';
+export * from './stripeCheckoutReturnUrl';
 export * from './stateTransitions';

package/dist/_dts/commerce/src/purchase/settlement.d.ts

@@ -89,6 +89,39 @@ export declare function buildRefundableLineSettlement<TLineId extends string>(op
     stripeChargeCents: number;
     alreadyRefundedCents: number;
 }>): Result<RefundableLineSettlement, RefundableLineSettlementError<TLineId>>;
+export type OrderItemCashAllocation = Readonly<{
+    orderItemId: string;
+    amountCents: number;
+}>;
+/**
+ * Cash actually collected against one order line, summed from its payment
+ * receipt allocations. Shared so every refundable-remainder caller measures
+ * funding the same way.
+ */
+export declare function orderItemCashFundedCents(allocations: ReadonlyArray<OrderItemCashAllocation>, orderItemId: string): number;
+/**
+ * Funding facts for a single order line, expressed the way the refund runtime
+ * sees them: cash actually collected against the line (payment receipt
+ * allocations), plus any store credit applied to it, minus what has already
+ * been refunded.
+ */
+export type OrderItemRefundFunding = Readonly<{
+    /** Cash collected for this line so far (receipt allocation totals). */
+    cashFundedCents: number;
+    /** Store credit applied to this line. */
+    creditAppliedCents: number;
+    /** Refunds already applied to this line. */
+    refundedCents: number;
+}>;
+/**
+ * The single authority on how much of an order line is still refundable.
+ *
+ * Every surface that shows or enforces a refundable remainder MUST go through
+ * this function. Computing it from the line's net total instead of its actual
+ * funding overstates the remainder on partially collected orders, which used to
+ * let the dashboard offer a refund the runtime then refused.
+ */
+export declare function orderItemRefundableRemainingCents(funding: OrderItemRefundFunding): NonNegativeCents;
 export declare function refundableRemainingCents(settlement: RefundableLineSettlement): NonNegativeCents;
 export declare function ensureSingleCurrency(lines: ReadonlyArray<{
     currency: string;

package/dist/_dts/commerce/src/purchase/stripeCheckoutReturnUrl.d.ts

@@ -0,0 +1,8 @@
+export declare const STRIPE_CHECKOUT_SESSION_ID_PLACEHOLDER = "{CHECKOUT_SESSION_ID}";
+/**
+ * Completes a Stripe success URL with the session correlation parameter.
+ *
+ * URL owns the query/fragment boundary so the parameter can never be appended
+ * inside a hash fragment. Stripe requires its placeholder to remain literal.
+ */
+export declare function ensureStripeCheckoutSessionIdInSuccessUrl(successUrl: string): string;

package/dist/_dts/content-model/src/templates/defaults.d.ts

@@ -124,6 +124,9 @@ export declare const DEFAULT_TEMPLATE_DEFINITIONS: {
         }, {
             readonly blockKind: "block.body-text";
             readonly scope: "entry";
+            readonly content: {
+                readonly body: import("../../../core/src/index").RichTextDoc;
+            };
             readonly bindings: import("./types").TemplateBindingRecord;
         }, {
             readonly blockKind: "system.entry-slot";
@@ -189,6 +192,9 @@ export declare const DEFAULT_TEMPLATE_DEFINITIONS: {
         }, {
             readonly blockKind: "block.body-text";
             readonly scope: "entry";
+            readonly content: {
+                readonly body: import("../../../core/src/index").RichTextDoc;
+            };
             readonly bindings: import("./types").TemplateBindingRecord;
         }];
     };

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

@@ -1,15 +1,30 @@
+export type SlugifyOptions = Readonly<{
+    /**
+     * Treat `/` as a path separator: each segment is slugified independently and
+     * empty segments are dropped, so `Blog / My Post` becomes `blog/my-post`.
+     */
+    preserveSegments?: boolean;
+    /** Truncate the finished slug to at most this many characters. */
+    maxLength?: number;
+}>;
 /**
- * Convert a string to a URL-safe slug
+ * Convert a string to a URL-safe slug.
  *
- * @param text - The text to slugify
- * @returns URL-safe slug (lowercase, alphanumeric + hyphens)
+ * Every non-alphanumeric character (underscores included) is a separator and
+ * collapses to a single hyphen, which keeps output inside the `site_routes`
+ * slug constraint `^[a-z0-9]+([a-z0-9\-/]*[a-z0-9])?$`.
+ *
+ * This is the single slug implementation for the monorepo: block-form and the
+ * shop admin catalog delegate here rather than keeping their own variants.
  *
  * @example
  * slugify("Initial Consultation") // "initial-consultation"
- * slugify("90-Minute Deep Tissue") // "90-minute-deep-tissue"
  * slugify("Reiki & Energy Healing") // "reiki-energy-healing"
+ * slugify("Don't Stop") // "dont-stop"
+ * slugify("draft_post") // "draft-post"
+ * slugify("Blog / My Post", { preserveSegments: true }) // "blog/my-post"
  */
-export declare function slugify(text: string): string;
+export declare function slugify(text: string, options?: SlugifyOptions): string;
 /**
  * Generate a unique slug by appending a number if needed
  *

package/dist/_dts/preview-next/src/client/blocks/EditablePageRenderer.d.ts

@@ -1,4 +1,4 @@
-import { PageRenderer } from '../../../../blocks/src/index';
+import { EditorPageRenderer as PageRenderer } from '../../../../blocks/src/index';
 import type { ApiClient as DashboardApiClient } from '../../../../api/src/request';
 import React, { type ComponentProps } from 'react';
 type PageRendererProps = ComponentProps<typeof PageRenderer>;

package/dist/_dts/preview-next/src/client/preview/headerInteractionPaletteSurfaceState.d.ts

@@ -1,8 +1,9 @@
+import type { Theme } from '../../../../theme-core/src/data';
 import type { HeaderInteractionPalettePreference, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
 import { resolveHeaderInteractionPaletteControl } from '../../../../theme-core/src/site-styles/index';
 type HeaderInteractionPaletteSurfaceState = Readonly<{
     interactionPalette: ReturnType<typeof resolveHeaderInteractionPaletteControl>;
     diagnostics: readonly string[];
 }>;
-export declare function headerInteractionPaletteSurfaceState(styleId: HeaderStyleId, preference: HeaderInteractionPalettePreference): HeaderInteractionPaletteSurfaceState;
+export declare function headerInteractionPaletteSurfaceState(styleId: HeaderStyleId, preference: HeaderInteractionPalettePreference, theme: Pick<Theme, 'siteStyleId'> | null): HeaderInteractionPaletteSurfaceState;
 export {};

package/dist/_dts/sdk/src/client/publicLoaderCacheAccess.d.ts

@@ -0,0 +1,6 @@
+import { type SupportedLoaderEndpoint } from '../../../blocks/src/system/data/index';
+export declare function shouldWrite(cacheEnabled: boolean, force: boolean | undefined): boolean;
+export declare function liveLoaderOptions(endpoint: SupportedLoaderEndpoint, signal: AbortSignal | undefined): Readonly<{
+    force: boolean;
+    signal: AbortSignal | undefined;
+}>;

package/dist/_dts/sdk/src/public-api/contracts.d.ts

@@ -1,6 +1,6 @@
 import type { AddressedLocationValue, BookingConsent, BusinessAddress } from '../../../core/src/index';
 import type { ResolvedInternalLinkEntityType } from '../../../blocks/src/index';
-import type { APIEndpoints, RoutableContentItem as ApiRoutableContentItem, SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject, SiteBySlugResponse as ApiSiteBySlugResponse, SiteBookingOfferingPresetSummary as ApiSiteBookingOfferingPresetSummary } from '../../../api/src/index';
+import type { APIEndpoints, RoutableContentItem as ApiRoutableContentItem, SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject, SiteBySlugResponse as ApiSiteBySlugResponse, SiteBookingOfferingPresetSummary as ApiSiteBookingOfferingPresetSummary, SdkBlockContentAdmission } from '../../../api/src/index';
 import type { MediaAssetIndexItem, SiteFooterContent, SiteHeaderContent } from '../contracts';
 import type { CompiledBoundaryRuntime } from '../../../theme-core/src/site-styles/index';
 import type { BlockFieldConfig as SdkBlockFieldConfig, BlockFieldOptionsMap as SdkBlockFieldOptionsMap, ContentConfig as SdkContentConfig, ContainerOptionsConfig as SdkContainerOptionsConfig, FieldSelectOption as SdkFieldSelectOption, SdkCustomBlock, SdkThemeConfig, SdkThemePalette, SectionBackground as SdkSectionBackground, SectionOptionsConfig as SdkSectionOptionsConfig, SiteStyleConfig as SdkSiteStyleConfig } from '../config/types';
@@ -295,6 +295,7 @@ export type SiteResponse = SiteSelectionResponse & {
     portalEnabled?: boolean;
     commerceEnabled?: boolean;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
+    bookingTimeZone?: string;
     analytics?: SiteAnalyticsSettingsPayload;
     privacyPolicy?: SiteRuntimePrivacyPolicy;
     routes: Record<string, SiteRouteRecord>;
@@ -337,6 +338,7 @@ export type SdkRuntimePage = {
         kind: string;
         purpose?: string;
         content: Record<string, unknown>;
+        admission?: SdkBlockContentAdmission;
     }>;
     runtimeBoundaries?: readonly CompiledBoundaryRuntime<string>[];
 };
@@ -361,6 +363,7 @@ export type SdkEntrySlotContent = {
         purpose: string;
         orderIndex?: number | null;
         content: Record<string, unknown> | null;
+        admission?: SdkBlockContentAdmission;
     }>;
 };
 export type SdkSurfaceSlotContent = {
@@ -380,6 +383,7 @@ export type SdkSurfaceSlotContent = {
         publishedContent?: unknown;
         draftContentId?: string | null;
         publishedContentId?: string | null;
+        admission?: SdkBlockContentAdmission;
     }>;
 };
 export type SdkRuntimePageSurfaceSubject = ApiSdkRuntimePageSurfaceSubject;

package/dist/_dts/sdk/src/rendering/blocks-page-renderer.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import type { RenderablePageOutline as BlocksRenderablePageOutline } from '../../../blocks/src/index';
 import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, PageRuntimeBoundary, ResolveImageUrlContextInput, RouteMap, Theme, ThemeTokens } from '../contracts';
 import type { SdkCustomBlock } from '../config/types';
 import type { BlockOverrides } from './overrides';
@@ -6,6 +7,7 @@ import type { SiteBookingOfferingPresetSummary } from '../public-api/contracts';
 import { type BlocksImageResolveContextInput, type BlocksMediaAssetIndexItem } from './mediaAssets';
 import type { EventPageSurfaceSubjectWire } from '../../../core/src/index';
 export type ComponentRegistry = Record<string, React.ElementType>;
+export type RenderablePageOutline = BlocksRenderablePageOutline;
 export type MissingBlockOverrideError = Error & Readonly<{
     code: 'missing_block_override';
     blockKind: string;
@@ -20,6 +22,7 @@ export type PageRendererDataContext = {
     pageId?: string;
     resolvedData?: Record<string, Record<string, unknown>>;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
+    bookingTimeZone?: string;
     previewStage?: 'published' | 'preview';
     routes?: RouteMap;
     pagesByIdentifier?: Record<string, string>;
@@ -45,10 +48,9 @@ export type BlocksPageRendererDataContext = Omit<PageRendererDataContext, 'media
 export type SdkConfigForRenderer = {
     customBlocks?: SdkCustomBlock[];
 };
-type PageRendererCommonProps = {
-    page: PageOutline | null;
+type PageRendererCommonProps<TPage> = {
+    page: TPage | null;
     runtimeBoundaries?: readonly PageRuntimeBoundary[];
-    usePlaceholders?: boolean;
     dataContext?: PageRendererDataContext;
     routeMap?: RouteMap;
     wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
@@ -57,12 +59,12 @@ type PageRendererCommonProps = {
     sdkConfig?: SdkConfigForRenderer | null;
     customBlocks?: SdkCustomBlock[];
 };
-type ThemedPageRendererProps = PageRendererCommonProps & {
+type ThemedPageRendererProps<TPage> = PageRendererCommonProps<TPage> & {
     rendering?: never;
     theme: Theme;
     themeTokens?: ThemeTokens;
 };
-type OverrideOnlyPageRendererProps = PageRendererCommonProps & {
+type OverrideOnlyPageRendererProps<TPage> = PageRendererCommonProps<TPage> & {
     rendering: {
         kind: 'overrides-only';
     };
@@ -70,7 +72,9 @@ type OverrideOnlyPageRendererProps = PageRendererCommonProps & {
     themeTokens?: never;
     blockOverrides: BlockOverrides;
 };
-export type PageRendererProps = ThemedPageRendererProps | OverrideOnlyPageRendererProps;
+export type PageRendererProps = ThemedPageRendererProps<BlocksRenderablePageOutline> | OverrideOnlyPageRendererProps<BlocksRenderablePageOutline>;
+export type EditorPageRendererProps = ThemedPageRendererProps<PageOutline> | OverrideOnlyPageRendererProps<PageOutline>;
 export declare function toBlocksPageRendererDataContext(dataContext: PageRendererDataContext): BlocksPageRendererDataContext;
 export declare function PageRenderer(props: PageRendererProps): React.ReactElement;
+export declare function EditorPageRenderer(props: EditorPageRendererProps): React.ReactElement;
 export {};

package/dist/_dts/sdk/src/rendering/components/Block.shared.d.ts

@@ -43,7 +43,6 @@ type BlockCommonProps = {
     pageId?: string;
     previewStage?: 'published' | 'preview';
     client?: RiverbankClient;
-    usePlaceholders?: boolean;
     /**
      * Custom component to override default block rendering. When provided, renders
      * this component instead of the manifest-based default. Override components

package/dist/_dts/sdk/src/rendering/components/pageShared.d.ts

@@ -1,19 +1,20 @@
 import type { ReactElement } from 'react';
-import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, PageRuntimeBoundary, RouteMap, Theme, ThemeTokens } from '../../contracts';
+import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageRuntimeBoundary, RouteMap, Theme, ThemeTokens } from '../../contracts';
 import type { ResolvedBlockData } from '../../data';
 import type { SiteBookingOfferingPresetSummary } from '../../public-api/contracts';
 import type { RuntimeSdkConfig } from '../helpers/loadPage';
-import { type ComponentRegistry } from '../blocks-page-renderer';
+import { type ComponentRegistry, type RenderablePageOutline } from '../blocks-page-renderer';
 import { type SdkThemeRuntime } from '../themeRuntime';
 import type { BlockOverrides } from '../overrides';
 import type { SdkCustomBlock } from '../../config/types';
 import type { SdkRenderingMode } from '../renderingMode';
 type PageCommonProps = {
-    page: PageOutline;
+    page: RenderablePageOutline;
     runtimeBoundaries?: readonly PageRuntimeBoundary[];
     siteId: string;
     resolvedData?: ResolvedBlockData;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
+    bookingTimeZone?: string;
     routeMap?: RouteMap;
     /** Page identifier to routeId lookup for { kind: 'page' } CTA links */
     pagesByIdentifier?: Record<string, string>;
@@ -75,7 +76,6 @@ type PageCommonProps = {
     };
     wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
     registry?: ComponentRegistry;
-    usePlaceholders?: boolean;
     /**
      * Custom components to override default block rendering.
      * Keys can be full block kind ("block.hero") or short form ("hero").

package/dist/_dts/sdk/src/rendering/helpers/footerPageOutline.d.ts

@@ -0,0 +1,3 @@
+import type { SiteResponse } from '../../client/types';
+import type { SiteFooterBlock } from '../../public-api/contracts';
+export declare function buildFooterRenderablePageOutline(siteData: SiteResponse, blocks: readonly SiteFooterBlock[]): import("../../../../blocks/src/index").RenderablePageOutline;

package/dist/_dts/sdk/src/rendering/helpers/loadContent.d.ts

@@ -111,6 +111,7 @@ export type PageContentResult = {
     resolvedData: ResolvedBlockData;
     /** Selected booking offering presets exposed to SSR blocks. */
     bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
+    bookingTimeZone?: string;
     /** Site data for metadata generation */
     site: SiteData;
     /**
@@ -146,6 +147,7 @@ export type EntryContentResult = {
     resolvedData: ResolvedBlockData;
     /** Selected booking offering presets exposed to SSR blocks. */
     bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
+    bookingTimeZone?: string;
     /** Data context for template blocks (includes entry content for bindings) */
     dataContext: {
         contentEntry: Record<string, unknown>;
@@ -209,6 +211,7 @@ export type PageSurfaceContentResult = {
     templatePage: PageProps['page'] | null;
     resolvedData: ResolvedBlockData;
     bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
+    bookingTimeZone?: string;
     dataContext: {
         pageSurface: Record<string, unknown>;
         subject: PageSurfaceContentData['subject'];

package/dist/_dts/sdk/src/rendering/helpers/loadPage.d.ts

@@ -79,7 +79,7 @@ export type LoadPageParams = {
      */
     searchParams?: DataLoaderSearchParams;
 };
-export type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'usePlaceholders' | 'blockOverrides' | 'sdkConfig'> & {
+export type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'blockOverrides' | 'sdkConfig'> & {
     /**
      * SDK site configuration, if available.
      * Contains SDK-defined theme palette, section backgrounds, and style options.