@riverbankcms/sdk 0.79.0 → 0.81.0

package/dist/_dts/editor-blocks/src/widgets/site-option-picker/loaders.d.ts

@@ -0,0 +1,51 @@
+import type { GetEndpoint, ApiClient } from '../../../../api/src/index';
+import type { SiteOptionSource } from '../../../../blocks/src/index';
+import type { SiteOptionWidgetAdapter, SiteOptionWidgetAdapters, SiteOptionWidgetItem } from './types';
+type ListEventCategoriesResponse = NonNullable<GetEndpoint<'listEventCategories'>['response']>;
+type ListVenuesResponse = NonNullable<GetEndpoint<'listVenues'>['response']>;
+type ListAppointmentResourcesResponse = NonNullable<GetEndpoint<'listAppointmentResources'>['response']>;
+export type SiteOptionLoadItemsArgs = Readonly<{
+    siteId: string;
+    source: SiteOptionSource;
+}>;
+export type SiteOptionLoadItems = (args: SiteOptionLoadItemsArgs) => Promise<SiteOptionWidgetItem[]>;
+export type SiteOptionLoadErrorMapper = (error: unknown, args: SiteOptionLoadItemsArgs) => unknown;
+export type SiteOptionManageLinkRenderers = Partial<Readonly<Record<SiteOptionSource, SiteOptionWidgetAdapter['renderManageLink']>>>;
+export declare const siteOptionWidgetLabels: {
+    readonly eventCategories: {
+        readonly loading: "Loading categories...";
+        readonly select: "Select categories";
+        readonly empty: "No categories yet";
+        readonly emptySelection: "Choose which event categories to include.";
+    };
+    readonly venues: {
+        readonly loading: "Loading venues...";
+        readonly select: "Select a venue";
+        readonly empty: "No venues yet";
+        readonly emptySelection: "Choose a venue to restrict this block.";
+    };
+    readonly staffMembers: {
+        readonly loading: "Loading staff...";
+        readonly select: "Select a staff member";
+        readonly empty: "No staff yet";
+        readonly emptySelection: "Choose a staff member to restrict this block.";
+    };
+};
+export declare const siteOptionLoadFailureMessages: {
+    readonly eventCategories: "Failed to load event categories";
+    readonly venues: "Failed to load venues";
+    readonly staffMembers: "Failed to load staff members";
+};
+export declare function mapEventCategoriesToSiteOptionItems(payload: ListEventCategoriesResponse): SiteOptionWidgetItem[];
+export declare function mapVenuesToSiteOptionItems(payload: ListVenuesResponse): SiteOptionWidgetItem[];
+export declare function mapStaffMembersToSiteOptionItems(payload: ListAppointmentResourcesResponse): SiteOptionWidgetItem[];
+export declare function loadSiteOptionItemsFromApi({ apiClient, siteId, source, }: SiteOptionLoadItemsArgs & Readonly<{
+    apiClient: ApiClient;
+}>): Promise<SiteOptionWidgetItem[]>;
+export declare function createSiteOptionApiLoader(apiClient: ApiClient): SiteOptionLoadItems;
+export declare function createSiteOptionWidgetAdapters({ loadItems, mapLoadError, renderManageLink, }: Readonly<{
+    loadItems: SiteOptionLoadItems;
+    mapLoadError?: SiteOptionLoadErrorMapper;
+    renderManageLink?: SiteOptionManageLinkRenderers;
+}>): SiteOptionWidgetAdapters;
+export {};

package/dist/_dts/editor-blocks/src/widgets/site-option-picker/types.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+import type { SiteOptionSource } from '../../../../blocks/src/index';
+import type { PickerLabels, PickerOption } from '../../../../ui/src/index';
+export type SiteOptionWidgetItem = PickerOption;
+export type SiteOptionWidgetAdapterArgs = {
+    siteId?: string;
+    source: SiteOptionSource;
+};
+export type SiteOptionWidgetSelectionLabelArgs = {
+    value: string;
+    items: readonly SiteOptionWidgetItem[];
+};
+export type SiteOptionWidgetAdapterLabels = PickerLabels;
+export type SiteOptionWidgetAdapter = {
+    loadItems: (args: SiteOptionWidgetAdapterArgs) => Promise<SiteOptionWidgetItem[]>;
+    renderManageLink?: (args: SiteOptionWidgetAdapterArgs) => ReactNode;
+    formatSelectionLabel?: (args: SiteOptionWidgetSelectionLabelArgs) => string;
+    labels?: SiteOptionWidgetAdapterLabels;
+};
+export type SiteOptionWidgetAdapters = Record<SiteOptionSource, SiteOptionWidgetAdapter>;

package/dist/_dts/editor-blocks/src/widgets/site-option-picker/utils.d.ts

@@ -0,0 +1,5 @@
+import { type SiteOptionSource } from '../../../../blocks/src/index';
+import type { SelectFieldConfig } from '../../../../block-form/src/client/index';
+export type SiteOptionValue = string | string[] | null | undefined;
+export declare function normalizeSiteOptionMultiValue(value: SiteOptionValue): string[];
+export declare function getSiteOptionSource(config: SelectFieldConfig): SiteOptionSource | null;

package/dist/_dts/media-core/src/index.d.ts

@@ -42,3 +42,4 @@ export { walkAndCollectImageAttrs, pickFilenameFromUrl, type RichTextImageAttrsR
 export * from './richTextImageWriteNormalizer';
 export * from './mediaUsageProjection';
 export * from './portableMediaReferences';
+export * from './renderableMediaAsset';

package/dist/_dts/media-core/src/renderableMediaAsset.d.ts

@@ -0,0 +1,18 @@
+import type { MediaAssetId } from '../../core/src/index';
+export type RenderableMediaAsset = Readonly<{
+    id: MediaAssetId;
+    identifier?: string | null;
+    storageBucket?: string;
+    storagePath?: string;
+    width?: number | null;
+    height?: number | null;
+    mimeType?: string;
+}>;
+export type RenderableMediaAssetIndex = Readonly<{
+    byId: ReadonlyMap<string, RenderableMediaAsset>;
+    byIdentifier: ReadonlyMap<string, RenderableMediaAsset>;
+}>;
+export declare function buildRenderableMediaAssetIndex(assets: readonly RenderableMediaAsset[] | undefined): RenderableMediaAssetIndex | undefined;
+export declare function attachRenderableMediaAssetFields<TMedia extends Readonly<Record<string, unknown>>>(media: TMedia, asset: RenderableMediaAsset): TMedia & RenderableMediaAsset & Readonly<{
+    assetId: MediaAssetId;
+}>;

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

@@ -1,6 +1,7 @@
 import type { MediaAssetWithLabels, MediaKind } from '@riverbankcms/media-storage-supabase';
 import { type UploadIntentResolver, type VideoPrepIntentResolver } from '../../media-react/src/index';
 import type { VideoPrepIntent } from '../../media-core/src/index';
+import { type MediaPickerPolicy } from './MediaPickerDialog';
 import type { MediaValue } from './types';
 export type MediaEditorProps = {
     value: MediaValue | undefined;
@@ -13,6 +14,8 @@ export type MediaEditorProps = {
     cropEditorMode?: 'dialog' | 'inline';
     cropEditorAutoOpen?: boolean;
     mediaPickerAutoOpen?: boolean;
+    mediaPickerDialogMaxWidth?: string;
+    mediaPickerPolicy?: MediaPickerPolicy;
     showPreview?: boolean;
     showActionOverlay?: boolean;
     onEditDetails?: () => void;
@@ -26,4 +29,4 @@ export type MediaEditorProps = {
     videoPrepIntent?: VideoPrepIntentResolver;
     videoSelectionIntent?: VideoPrepIntent;
 };
-export declare const MediaEditor: ({ value, onChange, allowedKinds, previewAspectRatio, minSourceWidth, minSourceHeight, showAltInput, cropEditorMode, cropEditorAutoOpen, mediaPickerAutoOpen, showPreview, showActionOverlay, onEditDetails, fullWidth, previewVariant, showRemoveAction, previewMaxWidth, preventPreviewUpscale, onUploadComplete, uploadIntent, videoPrepIntent, videoSelectionIntent, }: MediaEditorProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MediaEditor: ({ value, onChange, allowedKinds, previewAspectRatio, minSourceWidth, minSourceHeight, showAltInput, cropEditorMode, cropEditorAutoOpen, mediaPickerAutoOpen, mediaPickerDialogMaxWidth, mediaPickerPolicy, showPreview, showActionOverlay, onEditDetails, fullWidth, previewVariant, showRemoveAction, previewMaxWidth, preventPreviewUpscale, onUploadComplete, uploadIntent, videoPrepIntent, videoSelectionIntent, }: MediaEditorProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -16,6 +16,7 @@ export type MediaPickerDialogProps = {
     statusMessage?: string | null;
     statusTone?: 'info' | 'error';
     title?: string;
+    dialogMaxWidth?: string;
     uploadButtonLabel?: string;
     uploadAccept?: string;
     showCameraInput?: boolean;
@@ -32,4 +33,4 @@ export type MediaPickerAssetSelection = Readonly<{
     tag: 'disabled';
     reason: string;
 }>;
-export declare const MediaPickerDialog: ({ allowedKinds, open, onOpenChange, assets, loading, hasMore, selectAsset, loadMore, enqueueUploads, uploads, closeOnSelect, disableSelection, statusMessage, statusTone, title, uploadButtonLabel, uploadAccept, showCameraInput, policy, }: MediaPickerDialogProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MediaPickerDialog: ({ allowedKinds, open, onOpenChange, assets, loading, hasMore, selectAsset, loadMore, enqueueUploads, uploads, closeOnSelect, disableSelection, statusMessage, statusTone, title, dialogMaxWidth, uploadButtonLabel, uploadAccept, showCameraInput, policy, }: MediaPickerDialogProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,7 +1,7 @@
 export { MediaEditor } from './MediaEditor';
 export type { MediaEditorProps } from './MediaEditor';
 export { MediaPickerDialog } from './MediaPickerDialog';
-export type { MediaPickerDialogProps } from './MediaPickerDialog';
+export type { MediaPickerAssetSelection, MediaPickerDialogProps, MediaPickerPolicy, } from './MediaPickerDialog';
 export { FileAssetPreview, classifyMimeForPreview } from './FileAssetPreview';
 export { CropDialog } from './CropDialog';
 export type { CropDialogProps } from './CropDialog';

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

@@ -1,6 +1,11 @@
-export declare function BlockToolbar({ blockId, blockKind, content, headerClearancePx, }: {
+import { type Theme } from '../../../../blocks/src/index';
+import { type BackgroundColorPalette } from '../../../../blocks/src/system/customize/backgrounds';
+import { type PreviewChromeFloatingPlacement } from '../preview/previewChromePlacement';
+export declare function BlockToolbar({ blockId, blockKind, content, theme, placement, }: {
     blockId: string;
     blockKind: string;
     content: Record<string, unknown>;
-    headerClearancePx?: number;
+    theme?: Theme | null;
+    placement?: PreviewChromeFloatingPlacement;
 }): import("react/jsx-runtime").JSX.Element;
+export declare function readBackgroundColorPaletteSnapshot(): BackgroundColorPalette | null;

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

@@ -1,5 +1,9 @@
 import { PageRenderer } from '../../../../blocks/src/index';
+import type { ApiClient as DashboardApiClient } from '../../../../api/src/request';
 import { type ComponentProps } from 'react';
-type EditablePageRendererProps = ComponentProps<typeof PageRenderer>;
+type PageRendererProps = ComponentProps<typeof PageRenderer>;
+type EditablePageRendererProps = PageRendererProps & {
+    blockDataApiClient?: DashboardApiClient | null;
+};
 export declare function EditablePageRenderer(props: EditablePageRendererProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,25 @@
+import type { PageDesignEditorBlock } from '../../../../theme-core/src/site-styles/previewCompiler';
+import type { PreviewCustomizeFacetControl } from './customizeFacetControls';
+export type BlockCustomizeBuiltinRow = Readonly<{
+    kind: 'variant';
+    block: PageDesignEditorBlock;
+}> | Readonly<{
+    kind: 'unsupported-variant-warning';
+}> | Readonly<{
+    kind: 'look';
+    block: PageDesignEditorBlock;
+}> | Readonly<{
+    kind: 'background';
+}> | Readonly<{
+    kind: 'facet';
+    control: PreviewCustomizeFacetControl;
+}>;
+export type BuildBlockCustomizeBuiltinRowsInput = Readonly<{
+    designBlock: PageDesignEditorBlock | null;
+    facetControls: readonly PreviewCustomizeFacetControl[];
+    hasLayoutControls: boolean;
+    hasLookControls: boolean;
+    hasBackgroundControls: boolean;
+}>;
+export declare function buildBlockCustomizeBuiltinRows({ designBlock, facetControls, hasLayoutControls, hasLookControls, hasBackgroundControls, }: BuildBlockCustomizeBuiltinRowsInput): readonly BlockCustomizeBuiltinRow[];
+export declare function blockCustomizeBuiltinRowBudget(rows: readonly BlockCustomizeBuiltinRow[]): number;

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

@@ -2,5 +2,6 @@ import type { EditorBlockId } 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 LinkedEntryRenderOverlay } from '../linkedEntryRenderOverlay';
 export declare function getDraftSnapshots(uiStore: EditorDraftInspectorStore): Map<EditorBlockId, DraftSnapshot>;
-export declare function mergeBlockWithDraft(block: BlockItem, draftMap: Map<EditorBlockId, DraftSnapshot>, index: number, projections?: readonly PreviewProjection[]): EnrichedBlock;
+export declare function mergeBlockWithDraft(block: BlockItem, draftMap: Map<EditorBlockId, DraftSnapshot>, index: number, projections?: readonly PreviewProjection[], linkedEntryOverlays?: LinkedEntryRenderOverlay): EnrichedBlock;

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

@@ -1,7 +1,9 @@
 import type { PageOutline } from '../../../../../blocks/src/index';
+import type { EditorPreviewInspectorStore } from '../../../../../content-editor/src/index';
 import type { EditorBlockId } 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 = {
     [key: string]: unknown;
     id: string | null;
@@ -31,36 +33,7 @@ export type CachedBlockTransform = {
     src: EnrichedBlock;
     out: BlockWithContent;
 };
-export type EditorDraftInspectorStore = {
-    getState: () => {
-        drafts: {
-            inspect: () => DraftSnapshot[];
-        };
-        aiOverlays?: {
-            viewMode: 'before' | 'after';
-            overrides: Map<string, {
-                proposalId: string;
-                before: unknown;
-                after: unknown;
-            }>;
-            structure?: {
-                proposalId: string;
-                includeUnspecified?: boolean;
-                before: {
-                    blockIds: string[];
-                };
-                after: {
-                    blockIds: string[];
-                    addedBlocks?: Array<{
-                        id: string;
-                        kind: string;
-                        content?: Record<string, unknown> | null;
-                    }>;
-                };
-            } | null;
-        };
-    };
-};
+export type EditorDraftInspectorStore = EditorPreviewInspectorStore;
 export type ComposePageArgs = {
     page: PageOutline | null;
     blockItems: BlockItem[];
@@ -72,4 +45,5 @@ export type ComposePreviewRenderPageArgs = {
     blockItems: BlockItem[];
     draftSnapshots: readonly DraftSnapshot[];
     projections: readonly PreviewProjection[];
+    linkedEntryOverlays?: LinkedEntryRenderOverlay;
 };

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

@@ -0,0 +1,11 @@
+import { type LinkedContentEntryId } from '../../../../content-editor/src/index';
+export type LinkedEntryRenderOverlay = ReadonlyMap<LinkedContentEntryId, Readonly<{
+    content: Record<string, unknown>;
+    optimisticHash: string | null;
+}>>;
+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;
+export {};

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

@@ -1,6 +1,6 @@
-import type { AppearancePresetId, BoundaryOptionId, DesignBlockId, LayoutVariantKey, PageDesignEditorBlock, PageDesignEditorBoundary } from '../../../../theme-core/src/site-styles/index';
+import type { AppearancePresetId, BoundaryOptionId, DesignBlockId, LayoutVariantKey, PageDesignEditorBlock } from '../../../../theme-core/src/site-styles/index';
 import { type SystemCustomizeFacetId, type SystemCustomizeFacetTransition, type SystemCustomizeFacetValue } from '../../../../blocks/src/system/customize/facets';
-import { type BackgroundImagePoolItem, type BackgroundOverride } from '../../../../blocks/src/system/customize/backgrounds';
+import { type BackgroundImagePoolItem, type BackgroundImagePoolMediaAsset, type BackgroundOverride } from '../../../../blocks/src/system/customize/backgrounds';
 export type PreviewCustomizeCycleDirection = 'prev' | 'next';
 export type PreviewCustomizeAction = Readonly<{
     kind: 'set-layout';
@@ -21,6 +21,7 @@ export type PreviewCustomizeAction = Readonly<{
     override: BackgroundOverride;
     fromOverride: BackgroundOverride;
     baseContentId: string | null;
+    imageAsset?: BackgroundImagePoolMediaAsset;
 }> | Readonly<{
     kind: 'set-boundary';
     previousBlockId: DesignBlockId;
@@ -43,12 +44,6 @@ type PreviewSetBlockFacetAction = Extract<PreviewCustomizeAction, {
 type PreviewSetBackgroundAction = Extract<PreviewCustomizeAction, {
     kind: 'set-background';
 }>;
-type PreviewSetBoundaryAction = Extract<PreviewCustomizeAction, {
-    kind: 'set-boundary';
-}>;
-type PreviewResetBoundaryAction = Extract<PreviewCustomizeAction, {
-    kind: 'reset-boundary';
-}>;
 export declare function cyclePageDesignBlockLayout(block: PageDesignEditorBlock, direction: PreviewCustomizeCycleDirection): PreviewSetLayoutAction | null;
 export declare function cyclePageDesignBlockLook(block: PageDesignEditorBlock, direction: PreviewCustomizeCycleDirection): PreviewSetLookAction | null;
 export declare function cyclePageDesignBlockFacet(input: Readonly<{
@@ -64,5 +59,4 @@ export declare function setPageDesignBlockBackground(input: Readonly<{
     fromOverride?: BackgroundOverride;
     imagePool?: readonly BackgroundImagePoolItem[];
 }>): PreviewSetBackgroundAction | null;
-export declare function cyclePageDesignBoundaryBreak(boundary: PageDesignEditorBoundary, direction: PreviewCustomizeCycleDirection): PreviewSetBoundaryAction | PreviewResetBoundaryAction | null;
 export {};

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

@@ -0,0 +1,24 @@
+import type { FieldConfig, FieldIntent } from '../../../../block-form/src/index';
+export type PreviewCustomizeControl = Readonly<{
+    kind: 'manifest-field';
+    field: FieldConfig;
+    placement: 'quick' | 'panel';
+    intent: Extract<FieldIntent, 'display' | 'behavior'>;
+}>;
+export type PreviewCustomizeControlPlan = Readonly<{
+    quickControls: readonly PreviewCustomizeControl[];
+    panelControls: readonly PreviewCustomizeControl[];
+    hiddenControls: readonly PreviewCustomizeHiddenControl[];
+}>;
+export type PreviewCustomizeHiddenControl = Readonly<{
+    fieldId: string;
+    reason: 'theme-v2-raw-style-field' | 'unsupported-intent' | 'header-field' | 'not-visible';
+}>;
+export type CreatePreviewCustomizeControlPlanInput = Readonly<{
+    blockKind: string;
+    fields: readonly FieldConfig[];
+    content: Readonly<Record<string, unknown>>;
+    maxQuickFields?: number;
+}>;
+export declare function createPreviewCustomizeControlPlan({ blockKind, fields, content, maxQuickFields, }: CreatePreviewCustomizeControlPlanInput): PreviewCustomizeControlPlan;
+export declare function isRawThemeV2CustomizeFieldPath(fieldPath: string): boolean;

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

@@ -0,0 +1,35 @@
+import { type BlockManifest, type Theme } from '../../../../blocks/src/index';
+import { type FieldConfig, type FormBackend } from '../../../../block-form/src/client/index';
+import type { EditorBlockId } from '../../../../core/src/index';
+import { type SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
+import type { EditorUiState } from '../../../../content-editor/src/index';
+import type { PreviewZustandStoreApi } from '../preview/storeTypes';
+import { type PreviewCustomizeControlPlan } from './previewCustomizeControlPlan';
+export declare const MAX_CUSTOMIZE_POPOVER_ROWS = 6;
+export declare const MAX_QUICK_MANIFEST_FIELDS = 3;
+export type BlockCustomizeControls = Readonly<{
+    manifest: BlockManifest | null;
+    controlPlan: PreviewCustomizeControlPlan;
+    quickFields: FieldConfig[];
+    panelFields: FieldConfig[];
+    backend: FormBackend | null;
+    hasControls: boolean;
+    hasOverflowControls: boolean;
+}>;
+export declare function useBlockCustomizeControls({ blockId, blockKind, content, uiStore, theme, sdkConfig, maxQuickFields, maxPopoverRows, builtInPopoverRows, }: {
+    blockId: EditorBlockId;
+    blockKind: string;
+    content: Readonly<Record<string, unknown>>;
+    uiStore: PreviewZustandStoreApi<EditorUiState>;
+    theme?: Theme | null;
+    sdkConfig?: SdkConfigForBlockPicker | null;
+    maxQuickFields?: number;
+    maxPopoverRows?: number;
+    builtInPopoverRows?: number;
+}): BlockCustomizeControls;
+export declare function resolveQuickFieldBudget({ requestedMaxQuickFields, maxPopoverRows, builtInPopoverRows, hasOverflowControls, }: {
+    requestedMaxQuickFields: number;
+    maxPopoverRows?: number;
+    builtInPopoverRows: number;
+    hasOverflowControls: boolean;
+}): number;

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

@@ -29,7 +29,6 @@ export { PreviewAuthInit } from "./preview/PreviewAuthInit";
 export { PreviewAuthBanner } from "./preview/PreviewAuthBanner";
 export { PreviewKeepAliveClient } from "./preview/PreviewKeepAliveClient";
 export { PreviewQueryProvider, createPreviewQueryClient, } from "./preview/PreviewQueryProvider";
-export { resolvePreviewSurfaceId, resolvePreviewSurfaceIdFromSearch, } from "./preview/previewSurface";
 export { PreviewShell } from "./preview/PreviewShell";
 export type { PreviewShellProps } from "./preview/PreviewShell";
 export { PreviewShellLayout } from "./preview/PreviewShellLayout";

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

@@ -6,6 +6,7 @@ import type { EntrySubrouteContextData, MediaAssetIndexItem, Theme } from '../..
 import type { FieldWidgetComponent } from '../../../../block-form/src/client/index';
 import { type ViewportMode, type ViewportWidth } from './PreviewViewportControls';
 import type { PreviewEditorSidebarProps, PreviewTemplateData } from './PreviewEditorSidebar';
+import { type PreviewLinkedEntrySidebarSection } from './PreviewSidebarSection';
 type EntryEditorPanelProps = {
     siteId: string;
     entryData: NonNullable<PreviewEditorSidebarProps['entryData']>;
@@ -19,6 +20,7 @@ type EntryEditorPanelProps = {
     supabaseUrl?: string;
     entrySubrouteContext?: EntrySubrouteContextData | null;
     metadataPanel: ReactNode;
+    linkedEntrySection?: PreviewLinkedEntrySidebarSection | null;
     mediaAssets?: MediaAssetIndexItem[];
     widgets: Record<string, FieldWidgetComponent>;
     viewportMode: ViewportMode;
@@ -28,5 +30,5 @@ type EntryEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function EntryEditorPanel({ siteId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, metadataPanel, mediaAssets, widgets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: EntryEditorPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function EntryEditorPanel({ siteId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, metadataPanel, linkedEntrySection, mediaAssets, widgets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: EntryEditorPanelProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1 @@
+export declare function LinkedEntryEditEventBridge(): null;

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

@@ -5,10 +5,8 @@ import type { BlockEditorHandle, BlockItem } from '../../../../editor-blocks/src
 import type { MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
 import type { EditorUiState, ZoomLevel } from '../../../../content-editor/src/index';
 import { type ViewportMode, type ViewportWidth } from './PreviewViewportControls';
-type StoreApi<T> = {
-    getState: () => T;
-    subscribe: (listener: () => void) => () => void;
-};
+import type { PreviewZustandStoreApi } from './storeTypes';
+import { type PreviewLinkedEntrySidebarSection } from './PreviewSidebarSection';
 type PageBlockEditorPanelProps = {
     siteId: string;
     pageId: string;
@@ -17,10 +15,11 @@ type PageBlockEditorPanelProps = {
     bearerToken?: string | null;
     supabaseUrl?: string;
     blockItems: BlockItem[];
-    uiStoreForBlockEditor: StoreApi<EditorUiState>;
+    uiStoreForBlockEditor: PreviewZustandStoreApi<EditorUiState>;
     blockEditorRef: MutableRefObject<BlockEditorHandle | null>;
     onBlocksChange: (nextItems: BlockItem[]) => void;
     metadataPanel: ReactNode;
+    linkedEntrySection?: PreviewLinkedEntrySidebarSection | null;
     designPanel?: ReactNode;
     sdkConfig?: SdkConfigForBlockPicker | null;
     mediaAssets?: MediaAssetIndexItem[];
@@ -31,5 +30,5 @@ type PageBlockEditorPanelProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PageBlockEditorPanel({ siteId, pageId, theme, apiClient, bearerToken, supabaseUrl, blockItems, uiStoreForBlockEditor, blockEditorRef, onBlocksChange, metadataPanel, designPanel, sdkConfig, mediaAssets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function PageBlockEditorPanel({ siteId, pageId, theme, apiClient, bearerToken, supabaseUrl, blockItems, uiStoreForBlockEditor, blockEditorRef, onBlocksChange, metadataPanel, linkedEntrySection, designPanel, sdkConfig, mediaAssets, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PageBlockEditorPanelProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -3,6 +3,7 @@ import type { BackgroundImagePoolItem } from '../../../../blocks/src/system/cust
 import { type ApiClient } from '../../../../api/src/request';
 import type { PreviewCustomizeAction } from '../blocks/previewCustomizeActions';
 import { type PreviewPageDesignEditorApplyOutcome, type PreviewPageDesignEditorState } from './previewCustomizeWorkflowState';
+import { type PreviewEditorRuntimeContent } from './previewCustomizeRuntimePatch';
 export type { PreviewPageDesignEditorApplyOutcome, PreviewPageDesignEditorState, } from './previewCustomizeWorkflowState';
 type PageDesignEditorStateContextValue = Readonly<{
     state: PreviewPageDesignEditorState;
@@ -10,7 +11,9 @@ type PageDesignEditorStateContextValue = Readonly<{
     backgroundImagePool: readonly BackgroundImagePoolItem[];
     backgroundImagePoolStatus: 'idle' | 'loading' | 'loaded' | 'failed';
     loadBackgroundImagePool: () => Promise<readonly BackgroundImagePoolItem[]>;
-    applyAction: (action: PreviewCustomizeAction) => Promise<PreviewPageDesignEditorApplyOutcome>;
+    applyAction: (action: PreviewCustomizeAction, options?: Readonly<{
+        runtimeContent?: PreviewEditorRuntimeContent | null;
+    }>) => Promise<PreviewPageDesignEditorApplyOutcome>;
     undo: () => Promise<PreviewPageDesignEditorApplyOutcome>;
     redo: () => Promise<PreviewPageDesignEditorApplyOutcome>;
     canUndo: boolean;

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

@@ -0,0 +1,20 @@
+import { type ReactNode } from 'react';
+import type { EditorBlockId } from '../../../../core/src/index';
+export type PreviewBlockCustomizeSelection = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'selected';
+    blockId: EditorBlockId;
+    requestId: number;
+}>;
+type PreviewBlockCustomizeSelectionContextValue = Readonly<{
+    selection: PreviewBlockCustomizeSelection;
+    inspectBlock: (blockId: EditorBlockId) => void;
+    clearInspection: () => void;
+}>;
+export declare function PreviewBlockCustomizeSelectionProvider({ children, }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function usePreviewBlockCustomizeSelection(): PreviewBlockCustomizeSelectionContextValue;
+export declare function usePreviewBlockCustomizeSelectionOptional(): PreviewBlockCustomizeSelectionContextValue | null;
+export {};

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

@@ -0,0 +1,20 @@
+import { type CSSProperties, type ReactNode } from 'react';
+import { type PreviewChromeAnchorBox, type PreviewChromeFloatingPlacement } from './previewChromePlacement';
+type PreviewChromeLayerContextValue = Readonly<{
+    portalTarget: HTMLElement | null;
+    subscribeLayout: (listener: () => void) => () => void;
+}>;
+export declare function PreviewChromeLayerProvider({ children, }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function usePreviewChromeLayerOptional(): PreviewChromeLayerContextValue | null;
+export declare function PreviewChromeFloatingControl({ anchorSelector, placement, fallbackClassName, fallbackStyle, portalClassName, forceVisible, children, }: {
+    anchorSelector: string;
+    placement: PreviewChromeFloatingPlacement | ((anchorBox: PreviewChromeAnchorBox | null) => PreviewChromeFloatingPlacement);
+    fallbackClassName: string;
+    fallbackStyle?: CSSProperties;
+    portalClassName?: string;
+    forceVisible?: boolean;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+import { type PreviewDesignHistoryDomainId, type PreviewDesignHistoryOrderState } from './previewDesignHistoryOrder';
+type PreviewDesignHistoryOrderContextValue = Readonly<{
+    state: PreviewDesignHistoryOrderState;
+    record: (domainId: PreviewDesignHistoryDomainId) => void;
+    confirmUndo: (domainId: PreviewDesignHistoryDomainId) => void;
+    confirmRedo: (domainId: PreviewDesignHistoryDomainId) => void;
+}>;
+export declare function PreviewDesignHistoryOrderProvider({ children, }: Readonly<{
+    children: ReactNode;
+}>): import("react/jsx-runtime").JSX.Element;
+export declare function usePreviewDesignHistoryOrder(): PreviewDesignHistoryOrderContextValue;
+export {};

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

@@ -1 +1,3 @@
+import type { StatusBarMenuItem } from '../../../../editor/src/index';
+export declare function usePreviewOpenEditorMobileMenuItems(): StatusBarMenuItem[];
 export declare function PreviewOpenEditorButton(): import("react/jsx-runtime").JSX.Element;

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

@@ -1,29 +1,29 @@
-import { type ComponentProps, type ReactNode } from "react";
-import { BlockApiProvider } from "../../../../blocks/src/client";
-import type { ButtonPersonalityId } from "../../../../theme-core/src/buttons/index";
-import type { PaletteOverrides, PaletteVariantId } from "../../../../theme-core/src/palette/index";
-import type { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId, TypographyPresetId } from "../../../../theme-core/src/site-styles/index";
-import type { EntrySubrouteContextData, MediaAssetIndexItem, Theme } from "../../../../blocks/src/index";
-import type { ContentTypeSchema } from "../../../../content-model/src/index";
-import type { SdkConfigForBlockPicker } from "../../../../editor-blocks/src/index";
-import type { SurfaceId } from "../../../../surfaces/src/index";
-import { type PreviewBlock, type PreviewContentEntryData, type PreviewPageMetadata } from "./PreviewEntryControllerProvider";
-import type { PreviewEditorSidebarProps, PreviewTemplateData } from "./PreviewEditorSidebar";
-import { type PreviewRuntimeSession } from "../../auth-contract";
+import { type ComponentProps, type ReactNode } from 'react';
+import { BlockApiProvider } from '../../../../blocks/src/client';
+import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
+import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
+import type { FooterSelectionContext, FooterLookId, HeaderLayoutId, HeaderSelectionContext, HeaderLookId, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import type { EntrySubrouteContextData, MediaAssetIndexItem, Theme } from '../../../../blocks/src/index';
+import type { ContentTypeSchema } from '../../../../content-model/src/index';
+import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
+import type { SurfaceId } from '../../../../surfaces/src/index';
+import { type PreviewBlock, type PreviewContentEntryData, type PreviewPageMetadata } from './PreviewEntryControllerProvider';
+import type { PreviewEditorSidebarProps, PreviewTemplateData } from './PreviewEditorSidebar';
+import { type PreviewRuntimeSession } from '../../auth-contract';
 type BaseFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 export type PreviewDesignEditorEligibility = Readonly<{
-    kind: "managed-page";
+    kind: 'managed-page';
 }> | Readonly<{
-    kind: "content-entry";
+    kind: 'content-entry';
 }> | Readonly<{
-    kind: "sdk-page";
+    kind: 'sdk-page';
 }> | Readonly<{
-    kind: "unsupported";
+    kind: 'unsupported';
 }>;
 export type PreviewShellProps = {
     children: ReactNode;
     apiBaseUrl: string;
-    blockApiConfig: ComponentProps<typeof BlockApiProvider>["config"];
+    blockApiConfig: ComponentProps<typeof BlockApiProvider>['config'];
     siteId: string;
     siteSlug: string;
     editableId: string | null;
@@ -60,13 +60,13 @@ export type PreviewShellProps = {
     referenceContentTypeKeys?: readonly string[];
     draftContent?: Record<string, unknown> | null;
     currentTemplate?: PreviewTemplateData | null;
-    initialStatus?: "draft" | "scheduled" | "published";
+    initialStatus?: 'draft' | 'scheduled' | 'published';
     initialBlocks?: PreviewBlock[];
     pageMetadata?: PreviewPageMetadata;
     isSiteLaunched: boolean;
     maintenanceModeEnabled: boolean;
     entrySubrouteContext?: EntrySubrouteContextData | null;
-    assistantPanel?: PreviewEditorSidebarProps["assistantPanel"];
+    assistantPanel?: PreviewEditorSidebarProps['assistantPanel'];
     sdkConfig?: SdkConfigForBlockPicker | null;
     mediaAssets?: MediaAssetIndexItem[];
     supabaseUrl?: string;

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

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+export type PreviewSidebarSectionProps = Readonly<{
+    label: string;
+    defaultOpen?: boolean;
+    openRequestId?: number | null;
+    children: ReactNode;
+}>;
+export type PreviewLinkedEntrySidebarSection = Readonly<{
+    label: string;
+    openRequestId: number;
+    content: ReactNode;
+}>;
+export declare function PreviewSidebarSection({ label, defaultOpen, openRequestId, children, }: PreviewSidebarSectionProps): import("react/jsx-runtime").JSX.Element;