@riverbankcms/sdk 0.146.0 → 0.148.0

package/dist/_dts/media-editor/src/createMediaEditorProvider.d.ts

@@ -1,12 +1,11 @@
 import type { ReactNode } from 'react';
-import type { ApiClient } from '../../api/src/request';
 import { type MediaEditorProviderProps } from './provider';
 type BaseProviderProps = {
     siteId: string;
     children: ReactNode;
 };
 type CreateMediaEditorProviderOptions<P extends BaseProviderProps> = {
-    resolveApiClient: (props: P) => ApiClient;
+    resolveApiClient: (props: P) => MediaEditorProviderProps['apiClient'];
     resolveProviderProps?: (props: P) => Partial<Omit<MediaEditorProviderProps, 'apiClient' | 'children' | 'siteId'>>;
     augmentRequest?: MediaEditorProviderProps['augmentRequest'];
     getPublicUrl?: MediaEditorProviderProps['getPublicUrl'];

package/dist/_dts/media-editor/src/provider.d.ts

@@ -1,5 +1,6 @@
 import { type ReactNode } from 'react';
-import type { ApiClient, APICallParamsStrict, APIEndpoints } from '../../api/src/request';
+import type { APICallParamsStrict, APIEndpoints } from '../../api/src/request';
+import { type ApiClientFn } from '@riverbankcms/media-storage-api';
 import type { MediaAssetWithLabels } from '@riverbankcms/media-storage-supabase';
 import { type MediaAssetIndexItem } from '../../blocks/src/index';
 import { type UseApiMediaUploaderOptions } from '../../media-react/src/index';
@@ -9,7 +10,7 @@ type RequestContext = {
 type RequestAugmenter = <E extends keyof APIEndpoints>(request: APICallParamsStrict<E>, context: RequestContext) => APICallParamsStrict<E>;
 export type MediaEditorProviderProps = {
     siteId: string;
-    apiClient: ApiClient;
+    apiClient: ApiClientFn & UseApiMediaUploaderOptions['apiClient'];
     children: ReactNode;
     /**
      * Public bucket fallback used only when an asset record does not yet carry its

package/dist/_dts/media-react/src/hooks/internal/classification.d.ts

@@ -19,7 +19,7 @@ export type ClassificationHook = (payload: {
     summary?: ClassificationSummary;
 }) => void;
 export declare const triggerClassification: ({ apiClient, assetId, labelHints, onClassification, log, }: {
-    apiClient: ApiClient;
+    apiClient: ApiClient<"classifyMediaAsset">;
     assetId: string;
     labelHints?: string[];
     onClassification?: ClassificationHook;

package/dist/_dts/media-react/src/hooks/useApiMediaUploader.d.ts

@@ -7,6 +7,7 @@ import type { Result } from '../../../core/src/index';
 import type { UploadProgressHandler } from './useUploads';
 import type { BrowserVideoPrepError, BrowserVideoPrepInput, BrowserVideoPrepResult } from '../videoPrepBrowser';
 import { type ClassificationHook, type LoggerLike } from './internal/classification';
+type MediaUploadApiClient = ApiClient<'createMediaUploadUrl' | 'mediaUpload' | 'mediaUpdate' | 'classifyMediaAsset'>;
 export type UploadIntentResolver = UploadIntentContract | ((file: File) => UploadIntentContract | undefined);
 export type VideoPrepIntentResolver = VideoPrepIntent | ((file: File) => VideoPrepIntent | undefined);
 export type BrowserVideoPreparer = (input: BrowserVideoPrepInput) => Promise<Result<BrowserVideoPrepResult, BrowserVideoPrepError>>;
@@ -28,7 +29,7 @@ export declare class MediaUploaderError extends Error {
 export declare function getMediaUploaderErrorCode(error: Error | undefined): ApiErrorCode | undefined;
 export type UseApiMediaUploaderOptions = {
     siteId: string;
-    apiClient: ApiClient;
+    apiClient: MediaUploadApiClient;
     autoClassify?: boolean;
     uploadIntent?: UploadIntentResolver;
     videoPrepIntent?: VideoPrepIntentResolver;
@@ -38,3 +39,4 @@ export type UseApiMediaUploaderOptions = {
     logger?: LoggerLike;
 };
 export declare const useApiMediaUploader: ({ siteId, apiClient, autoClassify, uploadIntent, videoPrepIntent, loadVideoPrep, onClassification, onUploadError, logger: providedLogger, }: UseApiMediaUploaderOptions) => (file: File, onProgress?: UploadProgressHandler) => Promise<MediaAssetWithLabels>;
+export {};

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

@@ -1,8 +1,14 @@
 import { EditorPageRenderer as PageRenderer } from '../../../../blocks/src/index';
+import type { PageOutline } from '../../../../blocks/src/index';
 import type { ApiClient as DashboardApiClient } from '../../../../api/src/request';
 import React, { type ComponentProps } from 'react';
 type PageRendererProps = ComponentProps<typeof PageRenderer>;
-type EditablePageRendererProps = PageRendererProps & {
+type WithEditorPage<T> = T extends {
+    page: unknown;
+} ? Omit<T, 'page'> & {
+    page: PageOutline | null;
+} : never;
+type EditablePageRendererProps = WithEditorPage<PageRendererProps> & {
     blockDataApiClient?: DashboardApiClient | null;
 };
 export declare function EditablePageRenderer(props: EditablePageRendererProps): React.JSX.Element;

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

@@ -1,7 +1,12 @@
-import type { EditorBlockId } from '../../../../../core/src/index';
+import { type EditorBlockId, type EditorBlockVersions } from '../../../../../core/src/index';
 import type { BlockItem } from '../../../../../editor-blocks/src/index';
 import type { DraftSnapshot, EditorDraftInspectorStore, EnrichedBlock } from './types';
-import { type PreviewProjection } from '../previewProjection';
+import { type CanonicalBlockContent, type PreviewProjection, type PreviewRenderContent } from '../previewProjection';
 import { type LinkedEntryRenderOverlay } from '../linkedEntryRenderOverlay';
+/**
+ * Draft snapshots as the preview renders them: `current` follows the tab's render
+ * source (its own edits, or another tab's live drafts while it only views).
+ */
 export declare function getDraftSnapshots(uiStore: EditorDraftInspectorStore): Map<EditorBlockId, DraftSnapshot>;
-export declare function mergeBlockWithDraft(block: BlockItem, draftMap: Map<EditorBlockId, DraftSnapshot>, index: number, projections?: readonly PreviewProjection[], linkedEntryOverlays?: LinkedEntryRenderOverlay): EnrichedBlock;
+export declare function mergeBlockWithDraft(block: BlockItem, draftMap: Map<EditorBlockId, DraftSnapshot>, index: number, projections?: readonly PreviewProjection[], linkedEntryOverlays?: LinkedEntryRenderOverlay, versions?: EditorBlockVersions): EnrichedBlock;
+export declare function renderBlockContent(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projections: readonly PreviewProjection[], linkedEntryOverlays?: LinkedEntryRenderOverlay): PreviewRenderContent | null;

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

@@ -1,17 +1,18 @@
-import type { PageOutline } from '../../../../../blocks/src/index';
+import type { PageOutline, PublishedBlockPlacementRead } from '../../../../../blocks/src/index';
 import type { EditorPreviewInspectorStore } from '../../../../../content-editor/src/index';
-import type { BlockContentIdentity, EditorBlockId } from '../../../../../core/src/index';
+import type { EditorBlockId, EditorBlockVersions } from '../../../../../core/src/index';
 import type { BlockItem } from '../../../../../editor-blocks/src/index';
 import type { CanonicalBlockContent, PreviewProjection, PreviewRenderContent } from '../previewProjection';
 import type { LinkedEntryRenderOverlay } from '../linkedEntryRenderOverlay';
-export type BlockWithContent = Partial<BlockContentIdentity> & {
+export type BlockWithContent = {
     [key: string]: unknown;
     id: string | null;
     kind: string;
     purpose: string;
     content?: PreviewRenderContent;
     draftContent?: PreviewRenderContent | null;
-    publishedContent?: PreviewRenderContent | null;
+    publishedPlacement: PublishedBlockPlacementRead;
+    contentVersionId: string | null;
     bindings?: Record<string, unknown>;
 };
 export type DraftSnapshot = {
@@ -19,16 +20,18 @@ export type DraftSnapshot = {
     baseline: CanonicalBlockContent | null;
     current: CanonicalBlockContent | null;
 };
-export type EnrichedBlock = BlockContentIdentity & {
+export type EnrichedBlock = {
     id: string | null;
     kind: string;
     purpose: string;
     orderIndex: number;
     content: PreviewRenderContent | null;
     draftContent: PreviewRenderContent | null;
-    publishedContent: PreviewRenderContent | null;
+    versions: EditorBlockVersions;
     bindings: Record<string, unknown> | null;
 };
+/** The editor's server versions for a block, or null until known. */
+export type BlockVersionsLookup = (blockId: EditorBlockId) => EditorBlockVersions | null;
 export type CachedBlockTransform = {
     src: EnrichedBlock;
     out: BlockWithContent;
@@ -46,4 +49,5 @@ export type ComposePreviewRenderPageArgs = {
     draftSnapshots: readonly DraftSnapshot[];
     projections: readonly PreviewProjection[];
     linkedEntryOverlays?: LinkedEntryRenderOverlay;
+    blockVersions: BlockVersionsLookup;
 };

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

@@ -1,11 +1,31 @@
-import { type LinkedContentEntryId } from '../../../../content-editor/src/index';
+import { type EditorPreviewInspectorStore, type LinkedContentEntryId, type RenderedLinkedRevisions } from '../../../../content-editor/src/index';
+/**
+ * `optimisticHash` is the local draft's revision; it is absent for another tab's
+ * live draft, which keeps the revision the entry was rendered with.
+ * `handoverRevision` marks an accepted save handing over to the rendered data
+ * (issue 1553, D): it applies only to occurrences not yet rendered at that revision.
+ */
 export type LinkedEntryRenderOverlay = ReadonlyMap<LinkedContentEntryId, Readonly<{
     content: Record<string, unknown>;
-    optimisticHash: string | null;
+    optimisticHash?: string | null;
+    handoverRevision?: string;
 }>>;
+/**
+ * The linked-entry values the preview renders, following the tab's render source
+ * (its own edits, or another tab's live drafts while it only views). Entries only
+ * another tab is editing are included too. A viewer never reads its own handovers,
+ * so a later external write is never masked (row H8).
+ */
+export declare function linkedEntryRenderOverlaysFromStore(uiStore: EditorPreviewInspectorStore): LinkedEntryRenderOverlay;
 type DataContextWithResolvedData = Readonly<{
     resolvedData?: Record<string, Record<string, unknown>>;
 }>;
 export declare function applyLinkedEntryRenderOverlay<T>(value: T, overlays: LinkedEntryRenderOverlay): T;
 export declare function applyLinkedEntryRenderOverlayToDataContext<T extends DataContextWithResolvedData | undefined>(dataContext: T, overlays: LinkedEntryRenderOverlay): T;
+/**
+ * Each linked entry's rendered revisions, one per occurrence in the loader data, read
+ * before any overlay. Local handover retention compares them with the saved revision
+ * (issue 1553, DP7).
+ */
+export declare function renderedLinkedRevisions(dataContext: DataContextWithResolvedData | undefined): RenderedLinkedRevisions;
 export {};

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

@@ -0,0 +1,13 @@
+import type { BlockItem } from '../../../../../editor-blocks/src/index';
+import type { CanonicalBlockContent, EntryFieldRebindingProjection, PreviewRenderContent } from './types';
+/**
+ * Only the entry fields that changed are bound in again: unchanged fields keep
+ * the server's materialised value, which may be richer than the stored one
+ * (media the loaders have hydrated, for instance).
+ */
+export declare function entryFieldRebindingProjection(changedFields: Readonly<Record<string, unknown>>): EntryFieldRebindingProjection | null;
+/**
+ * Binds the changed entry fields into a block with template bindings. A binding
+ * whose source did not change resolves to nothing and leaves the content as it is.
+ */
+export declare function applyEntryFieldRebindingProjection(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projection: EntryFieldRebindingProjection): CanonicalBlockContent | PreviewRenderContent | null;

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

@@ -1,4 +1,5 @@
 export { applyContentFieldOverrideProjection, applyStructureProjection, blockHasContentFieldOverrideProjection, previewProjectionsFromAiOverlays, } from './aiProposalProjection';
 export { applyPreviewContentFieldProjections, applyPreviewRuntimeContentProjections, applyPreviewStructureProjections, blockHasPreviewContentFieldProjection, } from './applyPreviewProjections';
+export { entryFieldRebindingProjection } from './entryFieldRebinding';
 export { applyRuntimeContentDecorationProjection, runtimeContentDecorationProjectionFromEditorModel, } from './runtimeContentDecoration';
-export type { AiProposalProjectionState, CanonicalBlockContent, ContentFieldOverrideProjection, PreviewFieldOverride, PreviewProjection, PreviewProjectionAddedBlock, PreviewRenderContent, RuntimeContentDecorationProjection, StructureProjection, } from './types';
+export type { AiProposalProjectionState, CanonicalBlockContent, ContentFieldOverrideProjection, EntryFieldRebindingProjection, PreviewFieldOverride, PreviewProjection, PreviewProjectionAddedBlock, PreviewRenderContent, RuntimeContentDecorationProjection, StructureProjection, } from './types';

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

@@ -51,7 +51,7 @@ export type PreviewProjection = Readonly<{
     source: 'ai-proposal';
     viewMode: 'before' | 'after';
     overrides: ReadonlyMap<string, PreviewFieldOverride>;
-}> | Readonly<{
+}> | EntryFieldRebindingProjection | Readonly<{
     kind: 'runtime-content-decoration';
     source: 'page-design';
     fieldsByBlockId: ReadonlyMap<DesignBlockId, CompiledBlockRuntimeFields>;
@@ -71,3 +71,13 @@ export type ContentProjectionTarget = Readonly<{
     editorBlockId: EditorBlockId | null;
     content: CanonicalBlockContent | null;
 }>;
+/**
+ * An entry template page's blocks arrive with the entry's values already bound
+ * in by the server. When the entry's own fields change in the editor (locally,
+ * or live from another tab), the fields that changed are bound in again.
+ */
+export type EntryFieldRebindingProjection = Readonly<{
+    kind: 'entry-field-rebinding';
+    source: 'entry-draft';
+    changedFields: Readonly<Record<string, unknown>>;
+}>;

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

@@ -0,0 +1,17 @@
+import type { ComponentProps } from 'react';
+import type { EditorPageRenderer } from '../../../../blocks/src/index';
+import { type EditorUiStoreInstance } from '../../../../content-editor/src/index';
+import type { EditorBlockId } from '../../../../core/src/index';
+import type { ResolvedBlockData } from '../../../../blocks/src/system/data/index';
+type PageRendererDataContext = ComponentProps<typeof EditorPageRenderer>['dataContext'];
+/** A block's content as the preview renders it, from the tab's render source. */
+export declare function renderedBlockContent(uiStore: Pick<EditorUiStoreInstance, 'getState'>, blockId: EditorBlockId): Readonly<Record<string, unknown>> | null;
+/**
+ * An entry template page renders the entry's own fields from `contentEntry`. The
+ * server sent them as they were on load; the editor's rendered values (local
+ * edits, then another tab's live draft) take over from there.
+ */
+export declare function withRenderedContentEntry(dataContext: PageRendererDataContext | undefined, content: Readonly<Record<string, unknown>> | null): PageRendererDataContext | undefined;
+/** Loader data fetched in the browser replaces the server's, block by block. */
+export declare function mergeResolvedDataContext(dataContext: PageRendererDataContext | undefined, liveResolvedData: ResolvedBlockData | null): PageRendererDataContext | undefined;
+export {};

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

@@ -0,0 +1,20 @@
+import { type ComponentProps } from 'react';
+import type { EditorPageRenderer } from '../../../../blocks/src/index';
+import type { ResolvedBlockData } from '../../../../blocks/src/system/data/index';
+import { type EditorUiStoreInstance, type LinkedSaveHandovers } from '../../../../content-editor/src/index';
+type PageRendererDataContext = ComponentProps<typeof EditorPageRenderer>['dataContext'];
+/**
+ * The host's refresh of its server data: the same callback live drafts give a viewer
+ * whose saved remote draft lags. Absent when the host supplies none.
+ */
+export declare const PreviewRefreshBaselinesContext: import("react").Context<(() => void) | null>;
+/** Changes whenever a handover is recorded or dropped, so the renderer re-renders. */
+export declare function linkedSaveHandoversVersion(handovers: LinkedSaveHandovers): string;
+/**
+ * Local retention of this tab's linked-entry save handovers (issue 1553, DP7). The
+ * renderer holds the rendered data, so it decides catch-up: a handover whose entry is
+ * rendered at the saved revision everywhere drops with no refresh (row H1b); otherwise
+ * the shared timing asks the host for one refresh, then drops it (row H2).
+ */
+export declare function useLinkedSaveHandoverRetention(uiStore: EditorUiStoreInstance, dataContext: PageRendererDataContext | undefined, liveResolvedData: ResolvedBlockData | null): void;
+export {};

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

@@ -18,7 +18,7 @@ export { PreviewZoomControls } from './preview/PreviewZoomControls';
 export { PreviewEditorUI } from './preview/PreviewEditorUI';
 export { PreviewOpenEditorButton } from './preview/PreviewOpenEditorButton';
 export { MaintenanceModeBadge } from './preview/MaintenanceModeBadge';
-export type { PreviewBlock, PreviewContentEntryData, PreviewPageMetadata, } from './preview/PreviewEntryControllerProvider';
+export type { PreviewContentEntryData, PreviewPageMetadata, } from './preview/PreviewEntryControllerProvider';
 export { PreviewEntryControllerProvider } from './preview/PreviewEntryControllerProvider';
 export { PAGE_CONTENT_TYPE_SCHEMA } from './preview/pageSchema';
 export { PreviewThemeOverlayProvider, usePreviewThemeOverlay, } from './preview/themeOverlay';

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

@@ -12,6 +12,7 @@ type EntryEditorPanelProps = {
     siteId: string;
     dashboardBaseUrl?: string | null;
     entryData: NonNullable<PreviewEditorSidebarProps['entryData']>;
+    pageSurfaceId?: string | null;
     contentTypeSchema?: ContentTypeSchema | null;
     referenceContentTypeKeys: readonly string[];
     draftContent?: Record<string, unknown> | null;
@@ -30,5 +31,5 @@ type EntryEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function EntryEditorPanel({ siteId, dashboardBaseUrl, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, apiClient, entrySubrouteContext, metadataPanel, linkedEntrySection, widgets, sdkConfig, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: EntryEditorPanelProps): React.JSX.Element;
+export declare function EntryEditorPanel({ siteId, dashboardBaseUrl, entryData, pageSurfaceId, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, apiClient, entrySubrouteContext, metadataPanel, linkedEntrySection, widgets, sdkConfig, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: EntryEditorPanelProps): React.JSX.Element;
 export {};

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

@@ -8,10 +8,11 @@ type EntrySlotBlockEditorPanelProps = {
     dashboardBaseUrl?: string | null;
     typeKey: string;
     entryId: string;
+    pageSurfaceId?: string | null;
     theme?: Theme | null;
     apiClient: ApiClient;
     sdkConfig?: SdkConfigForBlockPicker | null;
     widgets: Record<string, FieldWidgetComponent>;
 };
-export declare function EntrySlotBlockEditorPanel({ siteId, dashboardBaseUrl, typeKey, entryId, theme, apiClient, sdkConfig, widgets, }: EntrySlotBlockEditorPanelProps): React.JSX.Element | null;
+export declare function EntrySlotBlockEditorPanel({ siteId, dashboardBaseUrl, typeKey, entryId, pageSurfaceId, theme, apiClient, sdkConfig, widgets, }: EntrySlotBlockEditorPanelProps): React.JSX.Element | null;
 export {};

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

@@ -0,0 +1,7 @@
+import type { SurfaceId } from '../../../../surfaces/src/index';
+export declare function PreviewAccessBanners({ dashboardBaseUrl, surfaceId, isEntry, pageNodeType }: Readonly<{
+    dashboardBaseUrl: string | null;
+    surfaceId: SurfaceId;
+    isEntry: boolean;
+    pageNodeType?: 'page' | 'page_surface';
+}>): import("react").JSX.Element;

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

@@ -24,6 +24,7 @@ export type PreviewEditorSidebarProps = {
     siteId: string;
     dashboardBaseUrl?: string | null;
     pageId: string | null;
+    pageNodeType?: 'page' | 'page_surface';
     entryData?: PreviewEntryData | null;
     contentTypeSchema?: ContentTypeSchema | null;
     referenceContentTypeKeys?: readonly string[];
@@ -58,4 +59,4 @@ export type PreviewEditorSidebarProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionButtonStyleRepairs, themeSelectionHeaderSelection, themeSelectionFooterLookId, themeSelectionHeaderLogo, apiClient, bearerToken, entrySubrouteContext, assistantPanel, sdkConfig, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, onFooterSaved, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;
+export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, pageNodeType, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionButtonStyleRepairs, themeSelectionHeaderSelection, themeSelectionFooterLookId, themeSelectionHeaderLogo, apiClient, bearerToken, entrySubrouteContext, assistantPanel, sdkConfig, bookingOfferingPresets, siteStyleAccess, activeTab, onTabChange, onClose, onFooterSaved, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): React.JSX.Element;

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

@@ -1,18 +1,11 @@
+import type { SdkEditorRevision } from '../../../../api/src/index';
+import type { EditLeaseChangeSubscription, LiveDraftsClient } from '../../../../content-editor/src/index';
 import React, { type ReactNode } from 'react';
 import type { ApiClient } from '../../../../api/src/request';
 import { type ContentTypeSchema } from '../../../../content-model/src/index';
-export type PreviewBlock = {
-    id: string | null;
-    kind: string;
-    purpose?: string | null;
-    orderIndex?: number | null;
-    content?: Record<string, unknown> | null;
-    draftContent?: Record<string, unknown> | null;
-    publishedContent?: Record<string, unknown> | null;
-    bindings?: Record<string, unknown> | null;
-    optimisticHash?: string | null;
-} & Partial<import('../../../../core/src/index').BlockContentIdentity>;
+import type { ServerBlockItem } from '../../../../editor-blocks/src/index';
 export type PreviewPageMetadata = {
+    draftUpdatedAt?: string | null;
     draftTitle: string;
     draftPath: string;
     draftStatus: string;
@@ -28,6 +21,7 @@ export type PreviewPageMetadata = {
 };
 export type PreviewContentEntryData = {
     id: string;
+    editorRevision?: SdkEditorRevision;
     type?: string | null;
     title?: string | null;
     slug?: string | null;
@@ -41,19 +35,35 @@ export type PreviewContentEntryData = {
     draftMetaDescription?: string | null;
     ogImageId?: string | null;
     content?: Record<string, unknown> | null;
+    /** A page surface's published content; null when it has never been published. */
+    publishedContent?: Record<string, unknown> | null;
 };
 type PreviewEntryControllerProviderProps = {
     children: ReactNode;
     siteId: string;
     pageId: string | null;
+    pageNodeType?: 'page' | 'page_surface';
     routeId: string | null;
     entryData?: PreviewContentEntryData | null;
     contentTypeSchema?: ContentTypeSchema | null;
-    draftContent?: Record<string, unknown> | null;
     initialStatus?: 'draft' | 'scheduled' | 'published';
-    initialBlocks?: PreviewBlock[];
+    blockFieldExtensions?: import('../../../../editor-blocks/src/index').BlockFieldExtensions | null;
+    initialBlocks?: ServerBlockItem[];
     pageMetadata?: PreviewPageMetadata;
     apiClient: ApiClient;
+    subscribeToLeaseChanges?: EditLeaseChangeSubscription;
+    onLeaseGranted?: () => void;
+    liveDrafts?: PreviewLiveDrafts;
 };
-export declare function PreviewEntryControllerProvider({ children, siteId, pageId, routeId: providedRouteId, entryData, contentTypeSchema, draftContent, initialStatus, initialBlocks, pageMetadata, apiClient, }: PreviewEntryControllerProviderProps): React.JSX.Element;
+/**
+ * Live drafts in preview (issue 1545): the host's own Supabase client, authorised
+ * with the preview token, and how it refreshes server props when a saved value
+ * has not arrived.
+ */
+export type PreviewLiveDrafts = Readonly<{
+    client: LiveDraftsClient;
+    previewToken: string;
+    refreshBaselines: () => void;
+}>;
+export declare function PreviewEntryControllerProvider({ children, siteId, pageId, pageNodeType, routeId: providedRouteId, entryData, contentTypeSchema, initialStatus, initialBlocks, blockFieldExtensions, pageMetadata, apiClient, subscribeToLeaseChanges, onLeaseGranted, liveDrafts, }: PreviewEntryControllerProviderProps): React.JSX.Element;
 export {};

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

@@ -0,0 +1,2 @@
+/** Derives preview editing permission from the live auth and lease authorities. */
+export declare function PreviewLeaseEditingMode(): null;

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

@@ -1,3 +1,4 @@
+import type { EditLeaseChangeSubscription } from '../../../../content-editor/src/index';
 import React, { type ComponentProps, type ReactNode } from 'react';
 import { BlockApiProvider } from '../../../../blocks/src/client';
 import type { ButtonStyleSelection, ButtonStyleSelectionRepair } from '../../../../theme-core/src/buttons/index';
@@ -5,8 +6,9 @@ import type { FooterLookId, HeaderLayoutStyleSelection, HeaderLogoContext } from
 import type { EntrySubrouteContextData, BookingOfferingPresetSummary, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
 import type { ContentTypeSchema } from '../../../../content-model/src/index';
 import type { SdkConfigForPreview } from './sdkConfig';
+import type { ServerBlockItem } from '../../../../editor-blocks/src/index';
 import type { SurfaceId } from '../../../../surfaces/src/index';
-import { type PreviewBlock, type PreviewContentEntryData, type PreviewPageMetadata } from './PreviewEntryControllerProvider';
+import { type PreviewContentEntryData, type PreviewLiveDrafts, type PreviewPageMetadata } from './PreviewEntryControllerProvider';
 import { type PreviewRenderingMode, type PreviewThemeRuntime } from './themeRuntime';
 import type { PreviewEditorSidebarProps, PreviewTemplateData } from './PreviewEditorSidebar';
 import { type PreviewRuntimeSession } from '../../auth-contract';
@@ -27,6 +29,11 @@ type PreviewShellCommonProps = {
     siteId: string;
     siteSlug: string;
     editableId: string | null;
+    pageNodeType?: 'page' | 'page_surface';
+    subscribeToLeaseChanges?: EditLeaseChangeSubscription;
+    onLeaseGranted?: () => void;
+    /** Live drafts between tabs; the host supplies a Supabase client dedicated to the preview token. */
+    liveDrafts?: Omit<PreviewLiveDrafts, 'previewToken'> | null;
     previewSession: PreviewRuntimeSession | null;
     previewToken: string;
     dashboardBaseUrl?: string | null;
@@ -64,7 +71,7 @@ type PreviewShellCommonProps = {
     draftContent?: Record<string, unknown> | null;
     currentTemplate?: PreviewTemplateData | null;
     initialStatus?: 'draft' | 'scheduled' | 'published';
-    initialBlocks?: PreviewBlock[];
+    initialBlocks?: ServerBlockItem[];
     pageMetadata?: PreviewPageMetadata;
     isSiteLaunched: boolean;
     maintenanceModeEnabled: boolean;

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

@@ -15,6 +15,7 @@ type PreviewShellLayoutCommonProps = {
     siteId: string;
     dashboardBaseUrl?: string | null;
     pageId: string | null;
+    pageNodeType?: 'page' | 'page_surface';
     entryData?: PreviewEntryData | null;
     contentTypeSchema?: ContentTypeSchema | null;
     referenceContentTypeKeys?: readonly string[];

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

@@ -0,0 +1,5 @@
+import type { PreviewCustomizeWorkflowState, PreviewCustomizeSaveBatch } from './previewCustomizeWorkflowState';
+/** Work selection and checkpoint capture share the existing transaction objects. */
+export declare function previewCustomizeCanAutosave(workflow: PreviewCustomizeWorkflowState): boolean;
+/** Preserve transaction identity and history while a checkpoint waits for an active save. */
+export declare function previewCustomizePendingBatch(workflow: PreviewCustomizeWorkflowState): PreviewCustomizeSaveBatch;

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

@@ -82,8 +82,8 @@ export type PreviewCustomizeWorkflowState = Readonly<{
     mutation: PreviewCustomizeMutationState;
 }>;
 type PreviewCustomizeTargetKey = `block:${string}:layout` | `block:${string}:look` | `block:${string}:facet:${string}` | `block:${string}:background` | `boundary:${string}:${string}`;
-type PreviewCustomizePendingAction = EditorTransaction<PreviewCustomizeAction, PreviewCustomizeHistoryEntry, PreviewCustomizeTargetKey>;
-type PreviewCustomizeSaveBatch = EditorSaveBatch<PreviewCustomizeAction, PreviewCustomizeHistoryEntry, PreviewCustomizeTargetKey>;
+export type PreviewCustomizePendingAction = EditorTransaction<PreviewCustomizeAction, PreviewCustomizeHistoryEntry, PreviewCustomizeTargetKey>;
+export type PreviewCustomizeSaveBatch = EditorSaveBatch<PreviewCustomizeAction, PreviewCustomizeHistoryEntry, PreviewCustomizeTargetKey>;
 export type PreviewCustomizeBeginResult = Readonly<{
     kind: 'started';
     state: PreviewCustomizeWorkflowState;
@@ -100,7 +100,7 @@ export declare function failedPreviewCustomizeWorkflowState(message: string): Pr
 export declare function previewCustomizeLoadSucceeded(pageState: ApiPageDesignEditorStateResponse): PreviewCustomizeWorkflowState;
 export declare function previewCustomizeWorkflowPageState(workflow: PreviewCustomizeWorkflowState): PreviewPageDesignEditorState;
 export declare function beginPreviewCustomizeApply(workflow: PreviewCustomizeWorkflowState, action: PreviewCustomizeAction): PreviewCustomizeBeginResult;
-export declare function beginPreviewCustomizeAutosave(workflow: PreviewCustomizeWorkflowState): PreviewCustomizeBeginResult;
+export declare function beginPreviewCustomizeAutosave(workflow: PreviewCustomizeWorkflowState, captured?: PreviewCustomizeSaveBatch): PreviewCustomizeBeginResult;
 export declare function beginPreviewCustomizeUndo(workflow: PreviewCustomizeWorkflowState): PreviewCustomizeBeginResult;
 export declare function beginPreviewCustomizeRedo(workflow: PreviewCustomizeWorkflowState): PreviewCustomizeBeginResult;
 export declare function confirmPreviewCustomizeMutation(workflow: PreviewCustomizeWorkflowState, response: ApplyPageDesignEditorActionResponse): PreviewCustomizeWorkflowState;
@@ -117,5 +117,4 @@ export declare function applyPreviewCustomizeActionToState(state: PreviewPageDes
 export declare function skippedPreviewCustomizeOutcome(reason: PreviewCustomizeSkipReason): Extract<PreviewPageDesignEditorApplyOutcome, {
     kind: 'skipped';
 }>;
-export declare function previewCustomizePendingActions(workflow: PreviewCustomizeWorkflowState): readonly PreviewCustomizeAction[];
 export {};

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

@@ -2,5 +2,6 @@ import type { SdkSiteLayoutConfig } from '../../../../api/src/index';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
 /** SDK config fields consumed by preview editing, beyond the block picker. */
 export type SdkConfigForPreview = SdkConfigForBlockPicker & {
+    blockFieldExtensions?: import('../../../../editor-blocks/src/index').BlockFieldExtensions;
     layout?: Pick<SdkSiteLayoutConfig, 'footerMode'>;
 };

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

@@ -0,0 +1,4 @@
+import { type SetStateAction } from 'react';
+import { type PreviewCustomizeWorkflowState } from './previewCustomizeWorkflowState';
+/** Update the scheduler's authoritative workflow before its next serialized request. */
+export declare function usePreviewCustomizeWorkflowState(): readonly [PreviewCustomizeWorkflowState, (next: SetStateAction<PreviewCustomizeWorkflowState>) => void, import("react").RefObject<PreviewCustomizeWorkflowState>];

package/dist/_dts/realtime/src/client.d.ts

@@ -0,0 +1,3 @@
+export { useSiteRealtimeReload, type SiteRealtimeReloadOptions, type RealtimeStatus, } from './useSiteRealtimeReload';
+export { joinDraftChannel, planDraftAuthChange, toDraftChannelStatus, type DraftBroadcastChannel, type DraftChannelOptions, type DraftRealtimeClient, type DraftSendResult, type DraftChannelAuth, type DraftChannelStatus, type DraftChannelHandlers, type DraftChannelConnection, } from './draftChannel';
+export { useDraftChannel, type UseDraftChannelAuth, type UseDraftChannelOptions, type DraftChannelHookStatus, type DraftHookSendResult, } from './useDraftChannel';

package/dist/_dts/realtime/src/draftChannel.d.ts

@@ -0,0 +1,91 @@
+import { type DraftStateMessage, type DraftSyncRequestMessage } from './drafts';
+/**
+ * Structural slice of a Supabase client that the drafts channel needs, so this
+ * package stays free of a supabase-js dependency. A `SupabaseClient` satisfies
+ * it (proved by the realtime drafts integration test).
+ *
+ * Method syntax keeps parameter checks bivariant, which is what lets the real
+ * overloaded Supabase methods satisfy these narrower signatures.
+ */
+export type DraftBroadcastChannel = {
+    on(type: 'broadcast', filter: {
+        event: string;
+    }, callback: (message: {
+        payload: unknown;
+    }) => void): unknown;
+    subscribe(callback: (status: string, error?: Error) => void): unknown;
+    send(args: {
+        type: 'broadcast';
+        event: string;
+        payload: unknown;
+    }): Promise<DraftSendResult>;
+};
+export type DraftChannelOptions = {
+    config: {
+        private: true;
+        broadcast: {
+            self: false;
+        };
+    };
+};
+export type DraftRealtimeClient = {
+    channel(name: string, options: DraftChannelOptions): DraftBroadcastChannel;
+    removeChannel(channel: DraftBroadcastChannel): unknown;
+    realtime: {
+        setAuth(token?: string | null): Promise<void>;
+    };
+};
+export type DraftSendResult = 'ok' | 'timed out' | 'error';
+/**
+ * How the channel authenticates:
+ * - `session`: the client's own Supabase auth session (dashboard). supabase-js
+ *   already forwards the session token and its refreshes to Realtime.
+ * - `token`: an explicit access token (preview), applied with
+ *   `realtime.setAuth(token)`. Note this pins the token for every channel on
+ *   that client until `setAuth()` is called without arguments.
+ */
+export type DraftChannelAuth = Readonly<{
+    kind: 'session';
+}> | Readonly<{
+    kind: 'token';
+    accessToken: string;
+}>;
+/** Subscribe status as reported by realtime-js, narrowed to what callers act on. */
+export type DraftChannelStatus = 'joining' | 'joined' | 'timed-out' | 'error' | 'closed';
+export type DraftChannelHandlers = Readonly<{
+    onDraftState?: (message: DraftStateMessage) => void;
+    onSyncRequest?: (message: DraftSyncRequestMessage) => void;
+    onStatus?: (status: DraftChannelStatus, error?: Error) => void;
+    onInvalidMessage?: (event: string, error: unknown) => void;
+}>;
+export type DraftChannelConnection = Readonly<{
+    sendDraftState: (message: DraftStateMessage) => Promise<DraftSendResult>;
+    sendSyncRequest: (message: DraftSyncRequestMessage) => Promise<DraftSendResult>;
+    /**
+     * Apply a rotated token to the live connection. realtime-js pushes it to
+     * every joined channel, where Realtime re-evaluates the RLS policies; no
+     * rejoin is needed while the channel is healthy (see `planDraftAuthChange`).
+     */
+    setAccessToken: (accessToken: string) => Promise<void>;
+    leave: () => Promise<void>;
+}>;
+export declare function toDraftChannelStatus(status: string): DraftChannelStatus;
+/**
+ * A token change on a healthy (or still joining) channel is applied in place.
+ * A channel that was closed, timed out or refused (typically because the old
+ * token expired or lacked access) is rebuilt with the new token.
+ */
+export declare function planDraftAuthChange(status: DraftChannelStatus): 'reauthorise' | 'rejoin';
+/**
+ * Join the private `site:{siteId}:drafts` channel. Validates every incoming
+ * message at the boundary; filtering by scope and origin/seq is the caller's
+ * decision (`isDraftForScope`, `acceptDraftState`).
+ *
+ * With token auth the join waits for `setAuth` so the join carries the token.
+ */
+export declare function joinDraftChannel(options: Readonly<{
+    client: DraftRealtimeClient;
+    siteId: string;
+    auth: DraftChannelAuth;
+    handlers: DraftChannelHandlers;
+}>): DraftChannelConnection;