@riverbankcms/sdk 0.135.1 → 0.137.0

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

@@ -9,8 +9,8 @@ import type { CreateManagementKeyRequest, CreateManagementKeyResponse, CreateSit
 import type { GetSiteInspirationAnalysisResponse, ListSiteInspirationAnalysesResponse } from './siteGeneration';
 import type { ListGscPropertiesAdminResponse, AuthStatusResponse, CronAppointmentRemindersResponse, CronBillingStatusResponse, CronEventFeedbackEmailsResponse, CronEventOccurrencesResponse, CronEventRemindersResponse, CronMediaJobsQuery, CronMediaJobsResponse, CronNewsletterSendResponse, CronPaymentReconciliationResponse, CronSeoIngestResponse, CronWaitlistExpiryResponse } from './siteOperations';
 import type { ApplySiteStyleSelectionBody, ApplySiteStyleSelectionResponse } from './siteRuntimeEndpoints';
-import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkAddEventOccurrenceRequest, SdkBackfillIdentifiersResult, SdkEventOccurrenceResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventOccurrencesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkCatalogThemeResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCapabilitiesResponse, SdkCommandApplicationResult, SdkConfigureBookingVerticalRequest, SdkConfigureBookingVerticalResponse, SdkDemoContentResponse, SdkDeleteResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullThemeResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpdateEventOccurrenceRequest, SdkUpsertBlockResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertThemeResponse, SdkUpsertVenueResponse } from './sdkContracts';
-import type { SdkThemeWire } from './sdkThemeWire';
+import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkAddEventOccurrenceRequest, SdkBackfillIdentifiersResult, SdkEventOccurrenceResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventOccurrencesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaDeleteApplyResponse, SdkMediaDeletePreviewResponse, SdkMediaDownloadResponse, SdkMediaListResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkCatalogThemeResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCapabilitiesResponse, SdkCommandApplicationResult, SdkConfigureBookingVerticalRequest, SdkConfigureBookingVerticalResponse, SdkDemoContentResponse, SdkDeleteResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullThemeResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpdateEventOccurrenceRequest, SdkUpsertBlockResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertThemeResponse, SdkUpsertVenueResponse } from './sdkContracts';
+import type { SdkThemeWireWithoutHeader } from './sdkThemeWire';
 import type { SdkEventUpsertBody } from './sdk-event-upsert';
 import type { StripeConnectDisconnectResponse, StripeConnectStartResponse, StripeConnectStatusResponse, UpdateStripeAutomaticTaxRequest } from './billing';
 import type { NavigationLinkInput } from './navigation/types';
@@ -148,6 +148,24 @@ export type SitePlatformAPIEndpoints = {
     }, {
         siteId: string;
     }, MediaResolveResponse>;
+    sdkMediaList: APIEndpoint<never, {
+        siteId: string;
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }, SdkMediaListResponse>;
+    sdkMediaDownload: APIEndpoint<never, {
+        siteId: string;
+        identifier: string;
+    }, SdkMediaDownloadResponse>;
+    sdkMediaDeletePreview: APIEndpoint<never, {
+        siteId: string;
+        identifier: string;
+    }, SdkMediaDeletePreviewResponse>;
+    sdkMediaDeleteApply: APIEndpoint<never, {
+        siteId: string;
+        identifier: string;
+    }, SdkMediaDeleteApplyResponse>;
     sdkMediaUploadUrl: APIEndpoint<{
         filename: string;
         bytes: number;
@@ -317,7 +335,13 @@ export type SitePlatformAPIEndpoints = {
     }, SdkDeleteResponse>;
     sdkUpsertTheme: APIEndpoint<Readonly<{
         kind: 'update';
-        theme: SdkThemeWire;
+        /**
+         * The theme minus its header (#1318 Phase 4d, D17). The server compiles
+         * `theme.header` from the site's stored selection and header
+         * preferences and is its only author; a body carrying header bytes is
+         * rejected rather than silently stripped.
+         */
+        theme: SdkThemeWireWithoutHeader;
         themeId?: string;
         selectionId?: string;
     }> | Readonly<{

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

@@ -2,16 +2,23 @@ import type { BackgroundOverride, SystemCustomizeFacetSelection, Theme } from '.
 import type { ListMediaAssetsResult, MediaAssetWithLabels } from '@riverbankcms/media-storage-supabase';
 import type { FooterNavigationLayout } from '../../core/src/index';
 import type { DbJson } from '../../db/src/index';
-import type { PageDesignEditorReadModel, PageDesignIntent, AppearancePresetId, BoundaryOptionId, DesignBlockId, FooterLookId, HeaderLayoutId, HeaderLayoutStyleSelection, HeaderStyleId, LayoutVariantKey, SiteStyleId } from '../../theme-core/src/site-styles/index';
+import type { PageDesignEditorReadModel, PageDesignIntent, AppearancePresetId, BoundaryOptionId, DesignBlockId, FooterLookId, HeaderLayoutId, HeaderLayoutStyleSelection, HeaderPreferences, HeaderQuickControlPreferences, HeaderStyleId, LayoutVariantKey, SiteStyleId } from '../../theme-core/src/site-styles/index';
 import type { ButtonStyleSelection } from '../../theme-core/src/buttons/index';
 import type { APIEndpoint } from './apiEndpointTypes';
 import type { AnalyticsReportQuery, AnalyticsReportResponse } from './analytics';
-import type { CreateMediaAssetBody, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse } from './media';
+import type { CreateMediaAssetBody, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteResponse, MediaDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse } from './media';
 import type { MediaUsageCheckResponse } from './shared-contracts';
-import type { BlockWithContentResponse, BlockListItem, ContentEntryListStage, EntryPageContentSlotsResponse, PageSurfaceContentSlotsResponse, ListPublishedEntriesResponse, PageDraftRecord, PublishedBlockBaseline, PublishedContentEntryPreviewResponse, PublishedPostPreviewResponse, SdkBlockContent, SdkRuntimeContentByPathResponse, SdkRouteDecisionResponse, SdkRouteOutcomeResponse, SdkTemplate, SiteBySlugResponse, ThemeGenerationTurn, ThemePreferencesRecord, ThemeRow } from './contentRuntime';
+import type { BlockWithContentResponse, BlockListItem, ContentEntryListStage, EntryPageContentSlotsResponse, PageSurfaceContentSlotsResponse, ListPublishedEntriesResponse, PageDraftRecord, PublishedBlockBaseline, PublishedContentEntryPreviewResponse, PublishedPostPreviewResponse, SdkBlockContent, SdkRuntimeContentByPathResponse, SdkRouteDecisionResponse, SdkRouteOutcomeResponse, SdkTemplate, SiteBySlugResponse, ThemePreferencesRecord } from './contentRuntime';
 import type { GetVersionHistoryResponse, ListVersionHistoryResponse, RestoreVersionHistoryRequest, RestoreVersionHistoryResponse, VersionHistoryListQuery } from './contentVersionHistory';
 import type { CreateMediaUploadUrlRequest, CreateMediaUploadUrlResponse, CreateSiteLogoUploadUrlRequest, CreateSiteLogoUploadUrlResponse, MediaUploadFinalizeRequest, UploadSiteLogoRequest } from './siteInfrastructure';
 import type { DevToolsGetSiteRoleDowngradeQuery, DevToolsImpersonationResponse, DevToolsSeedResponse, DevToolsSetSiteRoleDowngradeRequest, SiteRoleDowngradeState } from './siteOperations';
+/**
+ * A theme body with no header. The server compiles `theme.header` from the
+ * row's intent and is its only author (#1318 Phase 4d).
+ */
+export type ThemeWithoutHeader = Omit<Theme, 'header'> & Readonly<{
+    header?: never;
+}>;
 /** Partial persisted selections for the Style configurator and site chrome. */
 export type SiteThemeSelectionsPayload = {
     buttonStyleSelection?: ButtonStyleSelection | null;
@@ -70,7 +77,17 @@ export type SaveSiteChromeSelectionBody = Readonly<{
     surface: 'header';
     layoutId: HeaderLayoutId;
     styleId: HeaderStyleId;
-    theme: Theme;
+    /**
+     * The header intent this save expresses, and the whole of what this
+     * surface sends (#1318 Phase 4d).
+     *
+     * The compiled `theme` that used to ride alongside it is gone. The server
+     * compiles the header from `(layoutId, styleId, preferences)` against the
+     * persisted row and is its sole author; the rest of the theme is the
+     * row's own and is not the client's to restate. The save response returns
+     * the theme the server persisted, which is what the client reconciles to.
+     */
+    preferences: HeaderQuickControlPreferences;
     themeId?: string | null;
     selectionId?: string | null;
     baseSelectionUpdatedAt?: string | null;
@@ -92,6 +109,11 @@ export type SaveSiteChromeSelectionResponse = Readonly<{
     theme: Theme;
     headerLayoutId: HeaderLayoutId;
     headerStyleId: HeaderStyleId;
+    /**
+     * The intent as persisted. `null` while the Phase 4c backfill is outstanding
+     * and this save did not write one — absent, not "the defaults".
+     */
+    headerPreferences: HeaderPreferences | null;
     footerLookId: FooterLookId | null;
 }>;
 export type PageDesignRevisionToken = {
@@ -191,17 +213,6 @@ export type SiteRuntimeAPIEndpoints = {
         mode?: 'manual';
         entryIds?: string;
     }, ListPublishedEntriesResponse>;
-    createTheme: APIEndpoint<{
-        site_id: string;
-    }, never, {
-        output: ThemeGenerationTurn[];
-        text: string[] | null;
-    }>;
-    generateThemes: APIEndpoint<{
-        site_id: string;
-    }, never, {
-        themes: ThemeRow[];
-    }>;
     extractThemeFromInspiration: APIEndpoint<{
         urls: string[];
     }, never, {
@@ -217,7 +228,16 @@ export type SiteRuntimeAPIEndpoints = {
         source: 'extracted' | 'fallback';
     }>;
     saveSiteTheme: APIEndpoint<{
-        theme: Theme;
+        /**
+         * The theme minus its header (#1318 Phase 4d, D17).
+         *
+         * `header` is compiled server-side from the row's stored selection and
+         * `header_preferences`, so a body cannot carry header bytes at all. This
+         * was the last path by which hand-written header fields reached
+         * persistence, and leaving it open would have made the single-authority
+         * claim untrue. `headerSelection` still names the selection to compile.
+         */
+        theme: ThemeWithoutHeader;
         themeId?: string | null;
         selectionId?: string | null;
         overrides?: Record<string, unknown> | null;
@@ -369,7 +389,7 @@ export type SiteRuntimeAPIEndpoints = {
         cascadeLabels?: boolean;
     }, {
         assetId: string;
-    }, void>;
+    }, MediaDeleteResponse>;
     mediaBulkDelete: APIEndpoint<{
         assetIds: string[];
         deleteObjects?: boolean;

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

@@ -1,5 +1,5 @@
 import type { CamelizeKeys, DbDatabase, DbRow } from "../../db/src/index";
-export type { AccessPolicyContract, AccessPolicyTag, AmbientBackgroundRole, CreateMediaAssetBody, EntitledCustomerAccessScopeContract, FileKindContract, FileKindTag, FileUseContract, FileUseTag, ImageFileFormat, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteAssetFailure, MediaBulkDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse, RenderableFileKindTag, SiteBackgroundAssetUse, StorageClass, UploadIntentContract, UploadIntentTag, } from "./media";
+export type { AccessPolicyContract, AccessPolicyTag, AmbientBackgroundRole, CreateMediaAssetBody, EntitledCustomerAccessScopeContract, FileKindContract, FileKindTag, FileUseContract, FileUseTag, ImageFileFormat, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteAssetFailure, MediaBulkDeleteResponse, MediaDeleteResponse, MediaDeleteWarning, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse, RenderableFileKindTag, SiteBackgroundAssetUse, StorageClass, UploadIntentContract, UploadIntentTag, } from "./media";
 export type { AnalyticsPreset, AnalyticsReferrer, AnalyticsReportFilters, AnalyticsReportQuery, AnalyticsReportResponse, AnalyticsSeriesPoint, AnalyticsTopPage, AnalyticsTotals, } from "./analytics";
 export type { AIChatMessage, AiBriefTurn, JsonPrimitive, JsonValue, MediaUsageCheckItem, MediaUsageCheckResponse, MediaUsageLocation, } from "./shared-contracts";
 export type * from "./accessAdmin";

package/dist/_dts/block-form/src/blockDraftSaveability.d.ts

@@ -1,7 +1,6 @@
-import { type BlockManifest, type FieldValidationDescriptor } from '../../blocks/src/index';
+import { type BlockManifest, type FieldValidationDescriptor, type ManifestContentAdmissionIssue } from '../../blocks/src/index';
 import type { EditorSyncState } from '../../core/src/index';
-import type { z } from 'zod';
-type ManifestValidationIssue = z.core.$ZodIssue;
+type ManifestValidationIssue = ManifestContentAdmissionIssue;
 export type BlockDraftValidationIssue = Readonly<{
     code: ManifestValidationIssue['code'];
     path: (string | number)[];

package/dist/_dts/block-form/src/utils/slug.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Path-aware slugify for form/route inputs.
+ *
+ * Delegates to `@riverbankcms/core`'s single slug implementation with segment
+ * preservation, so `Blog / My Post` becomes `blog/my-post`.
+ */
 export declare function slugify(input: string): string;
 export declare function limitSlugLength(value: string, maxLength?: number): string;
 export declare function sanitizeSlugInput(value: string, maxLength?: number): string;

package/dist/_dts/blocks/src/PageRenderer.d.ts

@@ -8,6 +8,8 @@ import type { RouteMap } from './system/transforms';
 import { type MediaAssetIndexItem, type ResolveImageUrlContext, type ResolveImageUrlContextInput } from './system/runtime/nodes/media';
 import type { BookingOfferingPresetSummary } from './system/blocks/offerings-preview/model';
 import { type PageBoundaryWrapper, type PageRuntimeBoundary } from './pageRendererBoundaries';
+import { type RenderablePageOutline } from './pageRenderAdmission';
+export type { PageBlockRenderAdmissionError, PageRenderAudience, RenderablePageBlock, RenderablePageOutline, } from './pageRenderAdmission';
 export { MissingBlockOverrideError } from './pageRenderingMode';
 export type { PageBlockPosition, PageRuntimeBoundary, } from './pageRendererBoundaries';
 /**
@@ -19,7 +21,7 @@ export type OccurrenceContextData = import('../../core/src/index').EventOccurren
  * Event-occurrence subroute context.
  */
 export type EntrySubrouteContextData = import('../../core/src/index').EventPageSubrouteContext;
-type PageRendererDataContext = {
+export type PageRendererDataContext = {
     siteId?: string;
     pageId?: string;
     resolvedData?: Record<string, Record<string, unknown>>;
@@ -40,6 +42,7 @@ type PageRendererDataContext = {
     apiBaseUrl?: string;
     portalToken?: string | null;
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[];
+    bookingTimeZone?: string;
     eventRegistrationOverlayEnabled?: boolean;
 };
 /**
@@ -75,6 +78,8 @@ export type BlockOverrideProps<TContent = Record<string, unknown>> = {
     siteId?: string;
     /** Dashboard API URL for client-side block runtime calls. */
     apiBaseUrl?: string;
+    /** Canonical site timezone for calendar/date behavior. */
+    bookingTimeZone?: string;
     /** Customer portal token for Bearer-authenticated block runtime calls. */
     portalToken?: string | null;
     /** Preview bearer token for preview-aware block runtime calls. */
@@ -146,10 +151,9 @@ export type BlockOverrides = Record<string, BlockOverrideComponent>;
 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;
@@ -160,12 +164,12 @@ type PageRendererCommonProps = {
     customBlocks?: SdkCustomBlock[];
     previewAuthoring?: ResolverContext['previewAuthoring'];
 };
-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';
     };
@@ -173,5 +177,7 @@ type OverrideOnlyPageRendererProps = PageRendererCommonProps & {
     themeTokens?: never;
     blockOverrides: BlockOverrides;
 };
-export type PageRendererProps = ThemedPageRendererProps | OverrideOnlyPageRendererProps;
+export type PageRendererProps = ThemedPageRendererProps<RenderablePageOutline> | OverrideOnlyPageRendererProps<RenderablePageOutline>;
+export type EditorPageRendererProps = ThemedPageRendererProps<PageOutline> | OverrideOnlyPageRendererProps<PageOutline>;
 export default function PageRenderer(props: PageRendererProps): React.JSX.Element;
+export declare function EditorPageRenderer(props: EditorPageRendererProps): React.JSX.Element;

package/dist/_dts/blocks/src/contracts/proof-block-islands.d.ts

@@ -365,6 +365,14 @@ export declare const proofBlockIslandCodecs: {
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>>;
         }>) => unknown;
@@ -385,6 +393,14 @@ export declare const proofBlockIslandCodecs: {
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>>;
         }>>;
@@ -871,6 +887,14 @@ export declare const runtimeIslandCodecs: {
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>>;
         }>) => unknown;
@@ -891,6 +915,14 @@ export declare const runtimeIslandCodecs: {
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>>;
         }>>;
@@ -1251,6 +1283,14 @@ export declare const runtimeIslandCodecs: {
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>>;
         }>) => unknown;
@@ -1271,6 +1311,14 @@ export declare const runtimeIslandCodecs: {
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
                     scheduleScope: import("..").EventScheduleScope;
+                    calendarContext: Readonly<{
+                        timeZone: import("../../../core/src/index").BookingTimeZone;
+                        initialToday: Readonly<{
+                            year: number;
+                            month: number;
+                            day: number;
+                        }>;
+                    }>;
                 }>;
             }>>;
         }>>;

package/dist/_dts/blocks/src/definitions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pure server-safe definitions for Builder blocks.
+ * This entry point MUST NOT import any React components or client-side code.
+ * It is safe to use in Server Components and data fetching utilities.
+ */
+export { getBlockDefinition, getBlockRenderKind, listBlockDefinitions, hasBlockDefinition, registerBlockDefinition, type SystemBlockDefinition, type BlockDataLoader, type BlockDescriptor, } from './system/registry';
+export { blockDesignCapabilityMapFromDefinitions, blockDesignMetadataMapFromDefinitions, declareBlockDesignCapability, declareNoBlockDesignCapability, resolveDeclaredBlockDesignCapability, } from './system/designCapabilities';
+export type { BlockDesignCapabilityDeclaration, NoBlockDesignCapabilityReason, } from './system/designCapabilities';
+export type { AnyBlockRuntimeDefinition, BlockRenderKind, BlockRuntimeDefinition, RuntimeContractsFor, RuntimeDisplay, RuntimeHydration, RuntimeKind, RuntimeRender, RuntimeSource, } from './contracts';
+export { ensureSystemBlockDefinitionsRegistered, systemBlockDefinitions, } from './system/blocks';
+export { resolveVariantKey as resolveBlockVariantKey } from './system/manifest/variantKey';
+export type { SystemBlockKind, } from './system/blocks';
+export * from './system/data';
+export type { PageOutline, Block } from './structure/schema';

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

@@ -1,7 +1,7 @@
-export { default as PageRenderer } from './PageRenderer';
+export { default as PageRenderer, EditorPageRenderer } from './PageRenderer';
 export { createCustomBlockRegistry, mergeBlockDescriptorsWithRegistry, planCustomBlockRegistryResolution, transformToBlockDescriptor, } from './customBlockRegistry';
 export type { CustomBlockConflictReason, CustomBlockManifestSource, CustomBlockRegistry, CustomBlockRegistryConflict, CustomBlockRegistryEntry, CustomBlockRegistryResolutionPlan, CustomBlockSourcePolicy, ResolvedCustomBlockManifest, SdkConfigForBlockPicker, } from './customBlockRegistry';
-export type { BlockOverrideComponent, BlockOverrideProps, BlockOverrides, EntrySubrouteContextData, PageRendererProps, OccurrenceContextData, PageBlockPosition, PageRuntimeBoundary, SdkConfigForRenderer, } from './PageRenderer';
+export type { BlockOverrideComponent, BlockOverrideProps, BlockOverrides, EntrySubrouteContextData, EditorPageRendererProps, PageBlockRenderAdmissionError, PageRenderAudience, PageRendererProps, RenderablePageBlock, RenderablePageOutline, OccurrenceContextData, PageBlockPosition, PageRuntimeBoundary, SdkConfigForRenderer, } from './PageRenderer';
 export { MissingBlockOverrideError } from './pageRenderingMode';
 export * from './subroutes';
 export * from './structure/schema';
@@ -47,7 +47,8 @@ export { createRichTextDocFromMarkdown, parseRichTextInlineMarkdown, parseRichTe
 export { applyInlineTextMarkToRange, coerceInlineTextWithFallback, inlineTextEqual, inlineTextAccentTones, inlineTextHighlightTones, inlineTextMarksEqual, inlineTextSchema, inlineTextToPlainText, isInlineTextEmpty, normalizeInlineText, normalizeInlineTextMarks, parseInlineTextFromUnknown, plainTextToInlineText, removeInlineTextMarkFromRange, replaceInlineTextRange, truncateInlineText, type InlineText, type InlineTextAccentTone, type InlineTextHighlightTone, type InlineTextMark, type InlineTextParseError, type InlineTextParseResult, type InlineTextRun, } from './system/inlineText';
 export { renderInlineText } from './system/runtime/nodes/renderInlineText';
 export type { RichTextDoc, RichTextHardBreakNode, RichTextInlineNode, RichTextTextNode, TipTapNode, } from './system/manifest/richTextSchema';
-export { createManifestValidator, createManifestWriteValidator, } from './system/manifest/validation';
+export { admitManifestContentForWrite, admitStoredManifestContent, admitTransportedRenderableManifestContent, compileManifestContentContract, deriveContentZodFromManifest, deriveRenderableManifestContent, findNonPortableManifestMediaPaths, resolveManifestContentFieldDescriptor, validateManifestDraft, validateManifestWriteCandidate, } from './system/manifest/validation';
+export type { CompiledManifestContentContract, ManifestContentAdmissionError, ManifestContentAdmissionIssue, ManifestContentAdmissionResult, ManifestDraftValidationResult, ManifestWriteCandidateValidationResult, RenderableManifestContent, StoredManifestContent, } from './system/manifest/validation';
 export { singleButtonManifest } from './system/blocks/single-button';
 export { Text, RichText } from './primitives/content/primitives';
 export type { PrimitiveAPI, RichTextPrimitiveProps, RichTextVariant, TextProps, } from './primitives/content/primitives';

package/dist/_dts/blocks/src/pageRenderAdmission.d.ts

@@ -0,0 +1,49 @@
+import type { Block, PageOutline } from './structure/schema';
+import type { ManifestContentAdmissionError, RenderableManifestContent } from './system/manifest/validation';
+/**
+ * Who the render is for.
+ *
+ * `public` is a visitor-facing production page: a block that cannot render is
+ * dropped rather than replaced with developer-facing text (issue 1378).
+ * `authoring` is the dashboard preview and the editor renderer entrypoint,
+ * where the diagnostic is the useful output.
+ */
+export type PageRenderAudience = 'public' | 'authoring';
+export type PageBlockRenderAdmissionError = Readonly<{
+    kind: 'invalid_manifest_content';
+    error: ManifestContentAdmissionError;
+}> | Readonly<{
+    kind: 'manifest_unavailable';
+}>;
+export type RenderablePageBlock = Readonly<{
+    id: Block['id'];
+    kind: Block['kind'];
+    purpose: Block['purpose'];
+    bindings?: Block['bindings'];
+    admission: Readonly<{
+        kind: 'renderable';
+        content: RenderableManifestContent;
+    }> | Readonly<{
+        kind: 'invalid';
+        error: PageBlockRenderAdmissionError;
+    }>;
+}>;
+export type RenderablePageOutline = Omit<PageOutline, 'blocks'> & Readonly<{
+    blocks: readonly RenderablePageBlock[];
+}>;
+export type PresentationAdmission = Readonly<{
+    kind: 'renderable';
+}> | Readonly<{
+    kind: 'editor';
+}> | Readonly<{
+    kind: 'invalid';
+    error: PageBlockRenderAdmissionError;
+}>;
+export type PresentationBlock = Block & Readonly<{
+    presentationAdmission: PresentationAdmission;
+}>;
+export type PresentationPageOutline = Omit<PageOutline, 'blocks'> & Readonly<{
+    blocks: readonly PresentationBlock[];
+}>;
+export declare function toPresentationPage(page: RenderablePageOutline | null): PresentationPageOutline | null;
+export declare function toEditorPresentationPage(page: PageOutline | null): PresentationPageOutline | null;

package/dist/_dts/blocks/src/pageRendererBlockSupport.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Support for rendering one block section: what a block that cannot render
+ * leaves behind, how an override is found, and the props both override paths
+ * hand to a component. `PageRenderer` owns the page-level composition; this
+ * module owns the pieces it reaches for per block.
+ */
+import * as React from 'react';
+import type { getBlockDefinition } from './system';
+import type { ResolverContext, SystemBlockComponent } from './system';
+import type { Block } from './structure/schema';
+import type { SdkCustomBlock } from './system/manifest/schema';
+import type { RouteMap } from './system/transforms';
+import { type ResolveImageUrlContext } from './system/runtime/nodes/media';
+import { type PageThemeResources } from './pageRenderingMode';
+import type { PageBlockRenderAdmissionError, PageRenderAudience, PresentationBlock } from './pageRenderAdmission';
+import type { BlockOverrideComponent, BlockOverrideProps, BlockOverrides, PageRendererDataContext, SdkConfigForRenderer } from './PageRenderer';
+export type MemoSectionProps = {
+    audience: PageRenderAudience;
+    themeResources: PageThemeResources;
+    block: PresentationBlock;
+    dataContext?: PageRendererDataContext;
+    blockKey: string;
+    registry?: ResolverContext['registry'];
+    routeMap?: RouteMap;
+    wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
+    blockOverrides?: BlockOverrides;
+    sdkConfig?: SdkConfigForRenderer | null;
+    customBlocks?: SdkCustomBlock[];
+    imageResolveContext: ResolveImageUrlContext;
+    previewAuthoring?: ResolverContext['previewAuthoring'];
+};
+export declare function fallback(message: string): React.JSX.Element;
+/**
+ * A page with nothing to show. Authoring surfaces get the diagnostic; a public
+ * page renders nothing at all rather than telling a visitor about the outline.
+ */
+export declare function emptyPageNotice(audience: PageRenderAudience): React.ReactElement | null;
+/**
+ * A public page dropped a block, so nothing in the rendered HTML says the
+ * content is missing. Say it in the logs instead.
+ */
+export declare function warnOmittedFromPublicPage(input: Readonly<{
+    block: PresentationBlock;
+    outcome: string;
+    admissionError?: PageBlockRenderAdmissionError;
+}>): void;
+export declare function shouldDebugCustomBlocks(): boolean;
+/**
+ * Look up a block override component by block kind.
+ * Supports both full ("block.hero") and short ("hero") keys.
+ */
+export declare function getBlockOverride(blockKind: string, overrides?: BlockOverrides): BlockOverrideComponent | undefined;
+/**
+ * Resolves block content based on stage priority.
+ * For draft/preview: draftContent takes priority over content.
+ * For published: content is the source of truth.
+ * Returns empty object if no content exists (validator will handle placeholders if needed).
+ */
+export declare function getRenderableContent(block: Block, previewStage?: 'published' | 'preview'): Record<string, unknown>;
+export declare function resolveBookingTimeZone(dataContext: PageRendererDataContext | undefined): string | undefined;
+export declare function resolvePageRendererImageResolveContext(dataContext: PageRendererDataContext | undefined): ResolveImageUrlContext;
+/**
+ * The RSC-safe props every override component receives, whether the block
+ * resolved a manifest or is being rendered from an override alone.
+ */
+export declare function buildBlockOverrideProps(input: Readonly<{
+    block: PresentationBlock;
+    content: Record<string, unknown>;
+    data: BlockOverrideProps['data'];
+    themeResources: PageThemeResources;
+    dataContext: PageRendererDataContext | undefined;
+    imageResolveContext: ResolveImageUrlContext;
+}>): BlockOverrideProps;
+export declare function getPerfSlowBlockRenderThresholdMs(): number;
+export declare function getCachedBlockComponent(manifest: NonNullable<ReturnType<typeof getBlockDefinition>>['manifest']): SystemBlockComponent<Record<string, unknown>>;

package/dist/_dts/blocks/src/pageRendererBoundaries.d.ts

@@ -6,6 +6,8 @@ export type PageRuntimeBoundary = CompiledBoundaryRuntime<string>;
 export type PageBoundaryWrapper = (boundary: PageRuntimeBoundary, rendered: React.ReactNode) => React.ReactNode;
 export declare function isSiteStyleTransitionStyleGroup(value: string | undefined): value is string;
 export declare function boundaryMapForAdjacentBlockIds(boundaries: readonly PageRuntimeBoundary[]): ReadonlyMap<string, PageRuntimeBoundary>;
+/** Keep a surviving block's outgoing treatment when omitted blocks change its neighbor. */
+export declare function boundariesForSurvivingBlocks(boundaries: readonly PageRuntimeBoundary[], blocks: readonly Block[]): readonly PageRuntimeBoundary[];
 export declare function boundaryBetweenBlocks(previousBlock: Block | null, nextBlock: Block | null, boundaries: ReadonlyMap<string, PageRuntimeBoundary>): PageRuntimeBoundary | null;
 export declare function renderBoundaryAfterBlock(input: Readonly<{
     block: Block;

package/dist/_dts/blocks/src/server.d.ts

@@ -1,4 +1,4 @@
-export { default as PageRenderer, MissingBlockOverrideError, } from './PageRenderer';
-export type { BlockOverrideComponent, BlockOverrideProps, BlockOverrides, EntrySubrouteContextData, OccurrenceContextData, PageBlockPosition, PageRuntimeBoundary, SdkConfigForRenderer, } from './PageRenderer';
+export { default as PageRenderer, EditorPageRenderer, MissingBlockOverrideError, } from './PageRenderer';
+export type { BlockOverrideComponent, BlockOverrideProps, BlockOverrides, EntrySubrouteContextData, EditorPageRendererProps, OccurrenceContextData, PageBlockRenderAdmissionError, PageRenderAudience, PageBlockPosition, PageRuntimeBoundary, RenderablePageBlock, RenderablePageOutline, SdkConfigForRenderer, } from './PageRenderer';
 export * from './subroutes';
 export { ThemeScope } from '../../theme-core/src/ThemeScope';

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

@@ -77,7 +77,7 @@ export declare const eventRegistrationManifest: import("..").DefinedBlockManifes
     }, {
         readonly id: "showCapacity";
         readonly type: "boolean";
-        readonly label: "Show available spots";
+        readonly label: "Show available places";
         readonly description: "Display remaining capacity";
         readonly required: false;
         readonly defaultValue: true;

package/dist/_dts/blocks/src/system/data/index.d.ts

@@ -10,6 +10,8 @@ export { initialPreviewResolvedDataState, previewResolvedDataReducer, selectPrev
 export type { PreviewLoaderError, PreviewResolvedDataAction, PreviewResolvedDataState, } from './previewResolvedDataState';
 export { SUPPORTED_LOADER_ENDPOINTS, isSupportedLoaderEndpoint, } from './loaderEndpoints';
 export type { SupportedLoaderEndpoint } from './loaderEndpoints';
+export { PUBLIC_LOADER_CACHE_POLICIES, getPublicLoaderCachePolicy, } from './publicLoaderCachePolicy';
+export type { PublicLoaderCachePolicy, PublicLoaderCacheTagKind, } from './publicLoaderCachePolicy';
 export { createMicrobatcher, stableSerialize, type BatchItemResult, type Microbatcher, } from './batching';
 export { normalizeLoaderParams, normalizePublicApiLoaderParams, } from './normalizeLoaderParams';
 export { normalizeDataLoaders, normalizeContent, normalizeParams, coerceToString, coercePayload, } from './utils';

package/dist/_dts/blocks/src/system/data/publicLoaderCachePolicy.d.ts

@@ -0,0 +1,78 @@
+import type { SupportedLoaderEndpoint } from './loaderEndpoints';
+export type PublicLoaderCacheTagKind = 'published_content' | 'public_whole_series_offerings' | 'public_team_members' | 'public_products' | 'site_forms';
+export type PublicLoaderCachePolicy = Readonly<{
+    kind: 'live';
+    reason: 'booking_correctness';
+}> | Readonly<{
+    kind: 'tagged';
+    tags: readonly PublicLoaderCacheTagKind[];
+}>;
+/**
+ * Canonical freshness policy for public block-loader data.
+ *
+ * Consumers may implement tagged caching differently, but a loader marked
+ * live here must not be placed in a process-local or durable stale cache.
+ */
+export declare const PUBLIC_LOADER_CACHE_POLICIES: {
+    readonly listPublishedEntries: {
+        readonly kind: "tagged";
+        readonly tags: readonly ["published_content"];
+    };
+    readonly getPublishedEntryPreview: {
+        readonly kind: "tagged";
+        readonly tags: readonly ["published_content"];
+    };
+    readonly listPublicEvents: {
+        readonly kind: "live";
+        readonly reason: "booking_correctness";
+    };
+    readonly listPublicRecurringSchedule: {
+        readonly kind: "live";
+        readonly reason: "booking_correctness";
+    };
+    readonly getPublicEventDetails: {
+        readonly kind: "live";
+        readonly reason: "booking_correctness";
+    };
+    readonly listPublicWholeSeriesOfferings: {
+        readonly kind: "tagged";
+        readonly tags: readonly ["public_whole_series_offerings"];
+    };
+    readonly getPublicWholeSeriesOffering: {
+        readonly kind: "tagged";
+        readonly tags: readonly ["public_whole_series_offerings"];
+    };
+    readonly listPublicRouteCandidates: {
+        readonly kind: "tagged";
+        readonly tags: readonly ["published_content"];
+    };
+    readonly listPublicTeamMembers: {
+        readonly kind: "tagged";
+        readonly tags: readonly ["public_team_members"];
+    };
+    readonly listPublicProducts: {
+        readonly kind: "tagged";
+        readonly tags: readonly ["public_products"];
+    };
+    readonly listPublicPasses: {
+        readonly kind: "live";
+        readonly reason: "booking_correctness";
+    };
+    readonly listPublicMemberships: {
+        readonly kind: "live";
+        readonly reason: "booking_correctness";
+    };
+    readonly getPublicFormById: {
+        readonly kind: "tagged";
+        readonly tags: readonly ["site_forms"];
+    };
+    readonly getPublicBookingServices: {
+        readonly kind: "live";
+        readonly reason: "booking_correctness";
+    };
+    readonly getPublicWeeklySlotAvailability: {
+        readonly kind: "live";
+        readonly reason: "booking_correctness";
+    };
+};
+export declare function getPublicLoaderCachePolicy(endpoint: SupportedLoaderEndpoint): PublicLoaderCachePolicy;