@riverbankcms/sdk 0.80.0 → 0.81.0

package/dist/_dts/editor/src/primitives/rich-text/sanitize.d.ts

@@ -0,0 +1,23 @@
+import type { Content } from '@tiptap/react';
+export type RichTextContentWarnings = {
+    unsupportedNodes: string[];
+    unsupportedMarks: string[];
+};
+type SchemaLike = {
+    nodes: {
+        get: (name: string) => unknown;
+    } | Record<string, unknown>;
+    marks: {
+        get: (name: string) => unknown;
+    } | Record<string, unknown>;
+    topNodeType?: {
+        inlineContent?: boolean;
+    };
+};
+export declare function sanitizeRichTextContentForSchema(schema: SchemaLike, content: Content | null | undefined): {
+    content: Content;
+    warnings: RichTextContentWarnings;
+};
+export declare function hasUnsupportedRichTextContent(warnings: RichTextContentWarnings): boolean;
+export declare function formatUnsupportedRichTextSummary(warnings: RichTextContentWarnings): string;
+export {};

package/dist/_dts/editor/src/primitives/rich-text/toolbar/BlockTypeDropdown.d.ts

@@ -0,0 +1,6 @@
+import type { Editor } from '@tiptap/react';
+export declare function BlockTypeDropdown({ editor, onOpenChange, tone }: {
+    editor: Editor;
+    onOpenChange: (open: boolean) => void;
+    tone?: 'light' | 'dark';
+}): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/editor/src/primitives/rich-text/toolbar/LinkPopover.d.ts

@@ -0,0 +1,10 @@
+import type { Editor } from '@tiptap/react';
+import { type RichTextRoutableItem } from './linkPopoverUtils';
+type LinkPopoverProps = {
+    editor: Editor;
+    tone?: 'light' | 'dark';
+    initialItems?: RichTextRoutableItem[];
+    loadItems?: () => Promise<RichTextRoutableItem[]>;
+};
+export { type RichTextRoutableItem };
+export declare function LinkPopover({ editor, tone, initialItems, loadItems }: LinkPopoverProps): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/editor/src/primitives/rich-text/toolbar/ToolbarIconButton.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from 'react';
+export declare function ToolbarIconButton({ children, ariaLabel, isActive, label, widthClassName, onClick, disabled, tone, }: {
+    children: ReactNode;
+    ariaLabel: string;
+    isActive: boolean;
+    label?: string;
+    widthClassName?: string;
+    onClick: () => void;
+    disabled?: boolean;
+    tone?: 'light' | 'dark';
+}): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/editor/src/primitives/rich-text/toolbar/linkPopoverUtils.d.ts

@@ -0,0 +1,58 @@
+type TabKey = 'internal' | 'external' | 'custom';
+export type RichTextRoutableItem = {
+    routeId: string;
+    entityId: string;
+    entityType: 'page' | 'content';
+    identifier: string | null;
+    contentTypeKey?: string | null;
+    contentTypeName?: string | null;
+    title: string;
+    draftTitle: string | null;
+    path: string;
+    typeLabel: string;
+    updatedAt: string | null;
+};
+export type LinkAttrs = {
+    href?: string;
+    target?: string;
+    rel?: string;
+    kind?: 'internal' | 'page' | 'entry' | 'external' | 'url';
+    identifier?: string;
+    contentType?: string;
+    routeId?: string;
+    entityId?: string;
+    entityType?: 'page' | 'content';
+    title?: string;
+    typeLabel?: string;
+    contentTypeKey?: string | null;
+    contentTypeName?: string | null;
+    updatedAt?: string | null;
+};
+export type LinkAttrsInput = LinkAttrs & {
+    href: string;
+};
+export type LinkDraftState = {
+    tab: TabKey;
+    selectedItem: RichTextRoutableItem | null;
+    externalUrlValue: string;
+    customPathValue: string;
+};
+export type DraftLinkResolution = {
+    mode: 'apply';
+    attrs: LinkAttrsInput;
+} | {
+    mode: 'clear';
+} | {
+    mode: 'noop';
+};
+export declare function isIdentifierLinkCandidate(item: RichTextRoutableItem): boolean;
+export declare function looksLikeAbsoluteUrl(value: string): boolean;
+export declare function normalizeTab(attrs: LinkAttrs): TabKey;
+export declare function normalizeCustomPath(value: string): string;
+export declare function toInternalLinkAttrs(item: RichTextRoutableItem): LinkAttrsInput | null;
+export declare function getDisplayTitle(item: Pick<RichTextRoutableItem, 'title' | 'draftTitle'>): string;
+export declare function resolveDraftLinkResolution(draft: LinkDraftState): DraftLinkResolution;
+export declare function getLoadItemsErrorMessage(error: unknown): string;
+export declare function findSelectedRouteId(attrs: LinkAttrs, items: RichTextRoutableItem[]): string | null;
+export declare function filterRoutableItems(items: RichTextRoutableItem[], searchQuery: string): RichTextRoutableItem[];
+export {};

package/dist/_dts/editor/src/primitives/rich-text/useRichTextEditor.d.ts

@@ -0,0 +1,19 @@
+import type { Content, Editor } from '@tiptap/react';
+import type { RichTextVariant } from '../../../../blocks/src/index';
+import { type RichTextEditorConfig } from './config';
+import { type RichTextContentWarnings } from './sanitize';
+interface UseRichTextEditorOptions {
+    /** TipTap document content - can be JSON object, HTML string, or null */
+    content: Content;
+    editable: boolean;
+    variant: RichTextVariant;
+}
+interface UseRichTextEditorResult {
+    editor: Editor | null;
+    isEmpty: boolean;
+    config: RichTextEditorConfig;
+    warnings: RichTextContentWarnings;
+    warningSummary: string | null;
+}
+export declare function useRichTextEditor({ content, editable, variant }: UseRichTextEditorOptions): UseRichTextEditorResult;
+export {};

package/dist/_dts/editor/src/primitives/rich-text/utils.d.ts

@@ -0,0 +1,20 @@
+export interface TextNode {
+    type: 'text';
+    text: string;
+    marks?: Array<{
+        type: string;
+        [key: string]: unknown;
+    }>;
+}
+export interface ContentNode {
+    type: string;
+    content?: Array<TextNode | ContentNode>;
+    [key: string]: unknown;
+}
+export interface RichTextDoc {
+    type: 'doc';
+    content: ContentNode[];
+}
+export declare const EMPTY_DOC: RichTextDoc;
+export declare function isDocEmpty(doc: unknown): boolean;
+export declare function normaliseDoc(doc: unknown): RichTextDoc;

package/dist/_dts/editor/src/utils/optimisticTokens.d.ts

@@ -0,0 +1,27 @@
+export type OptimisticToken = number;
+type TokenState = {
+    counter: number;
+    baseline: number;
+};
+export type OptimisticTokenSnapshot = Record<string, TokenState>;
+/**
+ * Maintains monotonically increasing optimistic tokens per resource (e.g. block).
+ * Use `issue` before scheduling an optimistic write, then guard async results by checking `isCurrent`.
+ * When the server confirms, call `commit` with the token so failures for older tokens can be ignored safely.
+ */
+export declare class OptimisticTokenStore {
+    private state;
+    issue(id: string): OptimisticToken;
+    isCurrent(id: string, token: OptimisticToken): boolean;
+    isStale(id: string, token: OptimisticToken): boolean;
+    commit(id: string, token: OptimisticToken): boolean;
+    revertToBaseline(id: string): OptimisticToken;
+    getBaseline(id: string): OptimisticToken;
+    getLatest(id: string): OptimisticToken;
+    reset(id: string): void;
+    clear(): void;
+    snapshot(): OptimisticTokenSnapshot;
+    restore(snapshot: OptimisticTokenSnapshot): void;
+}
+export declare function createOptimisticTokenStore(): OptimisticTokenStore;
+export {};

package/dist/_dts/editor-blocks/src/BlockEditor.d.ts

@@ -5,7 +5,7 @@ import { type Theme } from '../../blocks/src/index';
 import type { PageDesignEditorReadModel } from '../../theme-core/src/site-styles/index';
 import { type EditorStructuralCommand } from '../../core/src/index';
 import { type CustomBlockRegistryEntry, type SdkConfigForBlockPicker } from './block-editor/sdkBlockMerger';
-import { type BlockActionControlMode } from './block-editor/actionControlMode';
+import { type BlockActionPresentation } from './block-editor/actionPresentation';
 import { type ReorderControlMode } from './block-editor/reorderControlMode';
 import type { ArrayKeysManager, BlockEditorHandle, BlockItem, BlockFocusRequest, UiSlice, DraftsSlice } from './block-editor/types';
 import type { BlockDraftSaveability, FieldWidgetComponent } from '../../block-form/src/client/index';
@@ -54,7 +54,7 @@ export type BlockEditorProps = {
     sdkConfig?: SdkConfigForBlockPicker | null;
     customBlocks?: readonly CustomBlockRegistryEntry[];
     reorderControlMode?: ReorderControlMode;
-    actionControlMode?: BlockActionControlMode;
+    actionPresentation?: BlockActionPresentation;
 };
 export declare const BlockEditor: import("react").ForwardRefExoticComponent<BlockEditorProps & import("react").RefAttributes<BlockEditorHandle>>;
 export {};

package/dist/_dts/editor-blocks/src/block-editor/BlockCard.d.ts

@@ -6,7 +6,7 @@ import type { BlockDraftSaveability } from '../../../block-form/src/client/index
 import type { FieldWidgetComponent } from '../../../block-form/src/client/index';
 import type { Theme } from '../../../blocks/src/index';
 import type { SiteIconStyleGuideVersionId } from '../../../blocks/src/index';
-import { type BlockActionControlMode } from './actionControlMode';
+import { type BlockActionPresentation } from './actionPresentation';
 import { type ReorderControlMode } from './reorderControlMode';
 import type { GeneratedIconSetGenerateInput, GeneratedIconSetGenerateResult, GeneratedIconSetPreview } from './GeneratedIconSetDialog';
 import type { ArrayKeysManager, BlockFocusRequest, BlockItem, UiStore, DraftsSlice, UiSlice } from './types';
@@ -22,7 +22,7 @@ type BlockCardStore = UiStore<Pick<UiSlice, 'activeBlockId' | 'setActiveBlockId'
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'getAtPath' | 'setAtPath' | 'edit' | 'initNewBlock' | 'updateBlockBaseline' | 'clearError'>;
     arrayKeys: ArrayKeysManager;
 }>;
-export declare function BlockCard({ siteId, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onCollapsedChange, highlighted, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, uiStore, hideThemeV2RawStyleFields, pageDesignBlock, reorderControlMode, actionControlMode, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, onApplyGeneratedIconSet, }: {
+export declare function BlockCard({ siteId, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onCollapsedChange, highlighted, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, uiStore, hideThemeV2RawStyleFields, pageDesignBlock, reorderControlMode, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, onApplyGeneratedIconSet, }: {
     siteId: string;
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
@@ -47,7 +47,7 @@ export declare function BlockCard({ siteId, block, manifest, isFirst, isLast, is
     hideThemeV2RawStyleFields?: boolean;
     pageDesignBlock?: PageDesignEditorBlock | null;
     reorderControlMode?: ReorderControlMode;
-    actionControlMode?: BlockActionControlMode;
+    actionPresentation?: BlockActionPresentation;
     currentStyleGuideVersionId?: SiteIconStyleGuideVersionId | null;
     iconStyleGuideSummary?: string | null;
     iconStyleGuideEditHref?: string | null;

package/dist/_dts/editor-blocks/src/block-editor/BlockCardHeader.d.ts

@@ -1,7 +1,7 @@
 import type { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
 import type { FieldWidgetComponent } from '../../../block-form/src/client/index';
 import { type SiteIconStyleGuideVersionId, type SystemBlockDefinition, type Theme } from '../../../blocks/src/index';
-import { type BlockActionControlMode } from './actionControlMode';
+import { type BlockActionPresentation } from './actionPresentation';
 import type { ReorderControlMode } from './reorderControlMode';
 import type { BlockItem, UiStore, DraftsSlice, ArrayKeysManager } from './types';
 import { type GeneratedIconSetGenerateInput, type GeneratedIconSetGenerateResult, type GeneratedIconSetPreview } from './GeneratedIconSetDialog';
@@ -11,7 +11,7 @@ type BlockCardHeaderStore = UiStore<{
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'initNewBlock' | 'updateBlockBaseline' | 'clearError' | 'setAtPath' | 'getAtPath'>;
     arrayKeys: ArrayKeysManager;
 }>;
-export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, actionControlMode, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, onApplyGeneratedIconSet, }: {
+export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, onApplyGeneratedIconSet, }: {
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
     isFirst: boolean;
@@ -26,12 +26,12 @@ export declare function BlockCardHeader({ block, manifest, isFirst, isLast, isMo
     onToggleCollapsed: () => void;
     contentId?: string;
     uiStore: BlockCardHeaderStore;
-    /** Optional widget overrides for block settings form fields */
+    /** Optional widget overrides for block customization form fields */
     widgetOverrides?: Record<string, FieldWidgetComponent>;
     theme?: Theme | null;
     hideThemeV2RawStyleFields?: boolean;
     reorderControlMode?: ReorderControlMode;
-    actionControlMode?: BlockActionControlMode;
+    actionPresentation?: BlockActionPresentation;
     currentStyleGuideVersionId?: SiteIconStyleGuideVersionId | null;
     iconStyleGuideSummary?: string | null;
     iconStyleGuideEditHref?: string | null;

package/dist/_dts/editor-blocks/src/block-editor/SortableBlockItem.d.ts

@@ -5,7 +5,7 @@ import type { BlockFocusRequest, BlockItem } from './types';
 import { type CustomBlockRegistryEntry, type SdkConfigForBlockPicker } from './sdkBlockMerger';
 import { BlockCard } from './BlockCard';
 import type { FieldWidgetComponent } from '../../../block-form/src/client/index';
-import { type BlockActionControlMode } from './actionControlMode';
+import { type BlockActionPresentation } from './actionPresentation';
 import { type ReorderControlMode } from './reorderControlMode';
 import type { GeneratedIconSetGenerateInput, GeneratedIconSetGenerateResult, GeneratedIconSetPreview } from './GeneratedIconSetDialog';
 export declare const SortableBlockItem: import("react").NamedExoticComponent<{
@@ -33,7 +33,7 @@ export declare const SortableBlockItem: import("react").NamedExoticComponent<{
     hideThemeV2RawStyleFields?: boolean;
     pageDesignBlock?: PageDesignEditorBlock | null;
     reorderControlMode?: ReorderControlMode;
-    actionControlMode?: BlockActionControlMode;
+    actionPresentation?: BlockActionPresentation;
     currentStyleGuideVersionId?: SiteIconStyleGuideVersionId | null;
     iconStyleGuideSummary?: string | null;
     iconStyleGuideEditHref?: string | null;

package/dist/_dts/editor-blocks/src/block-editor/actionPresentation.d.ts

@@ -0,0 +1,15 @@
+import type { EditorBlockId } from '../../../core/src/index';
+export type BlockCustomizePresentation = Readonly<{
+    kind: 'modal';
+}> | Readonly<{
+    kind: 'external';
+    onSelect: (blockId: EditorBlockId) => void;
+}>;
+export type BlockActionPresentation = Readonly<{
+    kind: 'inline';
+}> | Readonly<{
+    kind: 'menu';
+    customize: BlockCustomizePresentation;
+}>;
+export declare const DEFAULT_BLOCK_ACTION_PRESENTATION: BlockActionPresentation;
+export declare const MENU_MODAL_BLOCK_ACTION_PRESENTATION: BlockActionPresentation;

package/dist/_dts/editor-blocks/src/block-editor/blockHeaderActionPlan.d.ts

@@ -0,0 +1,49 @@
+import type { EditorBlockId } from '../../../core/src/index';
+import type { BlockActionPresentation } from './actionPresentation';
+export type BlockHeaderCustomizeAction = Readonly<{
+    kind: 'customize';
+    presentation: 'modal';
+}> | Readonly<{
+    kind: 'customize';
+    presentation: 'external';
+    blockId: EditorBlockId;
+}>;
+export type BlockHeaderMenuAction = BlockHeaderCustomizeAction | Readonly<{
+    kind: 'suggest-icons';
+    disabled: boolean;
+}> | Readonly<{
+    kind: 'generated-icon-set';
+    disabled: boolean;
+    stale: boolean;
+}> | Readonly<{
+    kind: 'duplicate';
+    disabled: boolean;
+}> | Readonly<{
+    kind: 'delete';
+    disabled: boolean;
+}>;
+export type BlockHeaderMenuActionGroup = Readonly<{
+    id: 'customize' | 'icons' | 'structure';
+    actions: readonly BlockHeaderMenuAction[];
+}>;
+export type BlockHeaderActionPlan = Readonly<{
+    layout: BlockActionPresentation['kind'];
+    customizeAction: BlockHeaderCustomizeAction | null;
+    menuGroups: readonly BlockHeaderMenuActionGroup[];
+    hasMenuActions: boolean;
+}>;
+export type DeriveBlockHeaderActionPlanInput = Readonly<{
+    actionPresentation: BlockActionPresentation;
+    blockId: EditorBlockId | null;
+    settingsAvailable: boolean;
+    featureCardIconActionsAvailable: boolean;
+    featureCardIconsComplete: boolean;
+    generatedIconSetActionsAvailable: boolean;
+    hasStaleGeneratedIcons: boolean;
+    featureCardIconDialogCardsCount: number;
+    duplicateAvailable: boolean;
+    duplicateDisabled: boolean;
+    deleteAvailable: boolean;
+    deleteDisabled: boolean;
+}>;
+export declare function deriveBlockHeaderActionPlan({ actionPresentation, blockId, settingsAvailable, featureCardIconActionsAvailable, featureCardIconsComplete, generatedIconSetActionsAvailable, hasStaleGeneratedIcons, featureCardIconDialogCardsCount, duplicateAvailable, duplicateDisabled, deleteAvailable, deleteDisabled, }: DeriveBlockHeaderActionPlanInput): BlockHeaderActionPlan;

package/dist/_dts/editor-blocks/src/widgets/index.d.ts

@@ -5,3 +5,4 @@ export * from './icon-picker/index';
 export * from './link/index';
 export * from './reference/index';
 export * from './rich-text/index';
+export * from './site-option-picker/index';

package/dist/_dts/editor-blocks/src/widgets/rich-text/RichTextWidgetProvider.d.ts

@@ -1,6 +1,6 @@
 import { type ReactNode } from 'react';
 import type { Theme } from '../../../../blocks/src/index';
-import type { PickedRichTextImage } from '@riverbankcms/editor';
+import type { PickedRichTextImage } from '../../../../editor/src/index';
 export type OnPickImage = () => Promise<PickedRichTextImage | null>;
 export type RichTextWidgetContextValue = {
     theme: Theme | null;

package/dist/_dts/editor-blocks/src/widgets/rich-text/useImagePicker.d.ts

@@ -1,4 +1,4 @@
-import type { PickedRichTextImage } from '@riverbankcms/editor';
+import type { PickedRichTextImage } from '../../../../editor/src/index';
 export declare function useRichTextImagePicker(): {
     readonly onPickImage: () => Promise<PickedRichTextImage | null>;
     readonly picker: import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,3 @@
+import type { SelectFieldConfig, FieldWidgetProps } from '../../../../block-form/src/client/index';
+import { type SiteOptionValue } from './utils';
+export declare function SiteOptionPickerField({ path, backend, config, }: FieldWidgetProps<SiteOptionValue, SelectFieldConfig>): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,14 @@
+import { type ReactNode } from 'react';
+import type { SiteOptionWidgetAdapters } from './types';
+type SiteOptionWidgetContextValue = {
+    siteId: string;
+    adapters: SiteOptionWidgetAdapters | undefined;
+};
+export declare function SiteOptionWidgetProvider({ siteId, adapters, children, }: {
+    siteId: string;
+    adapters?: SiteOptionWidgetAdapters;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useSiteOptionWidgetContext(): SiteOptionWidgetContextValue;
+export declare function useOptionalSiteOptionWidgetContext(): SiteOptionWidgetContextValue | null;
+export {};

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

@@ -0,0 +1,6 @@
+export { SiteOptionPickerField } from './SiteOptionPickerField';
+export { SiteOptionWidgetProvider, useOptionalSiteOptionWidgetContext, useSiteOptionWidgetContext, } from './SiteOptionWidgetProvider';
+export { createSiteOptionApiLoader, createSiteOptionWidgetAdapters, loadSiteOptionItemsFromApi, mapEventCategoriesToSiteOptionItems, mapStaffMembersToSiteOptionItems, mapVenuesToSiteOptionItems, siteOptionLoadFailureMessages, siteOptionWidgetLabels, } from './loaders';
+export { getSiteOptionSource, normalizeSiteOptionMultiValue, } from './utils';
+export type { SiteOptionLoadErrorMapper, SiteOptionLoadItems, SiteOptionLoadItemsArgs, SiteOptionManageLinkRenderers, } from './loaders';
+export type { SiteOptionWidgetAdapter, SiteOptionWidgetAdapterArgs, SiteOptionWidgetAdapterLabels, SiteOptionWidgetAdapters, SiteOptionWidgetItem, SiteOptionWidgetSelectionLabelArgs, } from './types';

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,10 +1,11 @@
 import { type Theme } from '../../../../blocks/src/index';
 import { type BackgroundColorPalette } from '../../../../blocks/src/system/customize/backgrounds';
-export declare function BlockToolbar({ blockId, blockKind, content, theme, headerClearancePx, }: {
+import { type PreviewChromeFloatingPlacement } from '../preview/previewChromePlacement';
+export declare function BlockToolbar({ blockId, blockKind, content, theme, placement, }: {
     blockId: string;
     blockKind: string;
     content: Record<string, unknown>;
     theme?: Theme | null;
-    headerClearancePx?: number;
+    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;