@riverbankcms/sdk 0.79.0 → 0.81.0

package/dist/_dts/editor/src/primitives/SaveContext.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+type SaveArgs = {
+    path: string;
+    value: unknown;
+};
+type SaveFn = (args: SaveArgs) => Promise<void>;
+export declare function EditorSaveProvider({ save, children }: {
+    save: SaveFn;
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useSaveField(): SaveFn;
+export {};

package/dist/_dts/editor/src/primitives/helpers.d.ts

@@ -0,0 +1 @@
+export declare function deriveChannelId(path: string | undefined): string | null;

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

@@ -0,0 +1,26 @@
+import type { ReactNode } from 'react';
+import { type Editor } from '@tiptap/react';
+import type { RichTextEditorConfig } from './config';
+import type { PickedRichTextImage } from './imageActions';
+import type { RichTextRoutableItem } from './toolbar/linkPopoverUtils';
+export type RichTextEditorSurfaceProps = Readonly<{
+    editor: Editor | null;
+    config: RichTextEditorConfig;
+    isEmpty: boolean;
+    className?: string;
+    contentClassName?: string;
+    placeholderClassName?: string;
+    placeholderText?: string;
+    linkItems?: RichTextRoutableItem[];
+    onRequestLinkItems?: () => Promise<RichTextRoutableItem[]>;
+    onPickImage?: () => Promise<PickedRichTextImage | null | undefined>;
+    toolbarTone?: 'light' | 'dark';
+    toolbarAlwaysVisible?: boolean;
+    toolbarPortalToChrome?: boolean;
+    hideToolbar?: boolean;
+    hideContent?: boolean;
+    onClick?: () => void;
+    renderContent?: (content: ReactNode) => ReactNode;
+}>;
+export declare function shouldHandleRichTextActivationKey(container: HTMLElement, target: EventTarget | null): boolean;
+export declare function RichTextEditorSurface({ editor, config, isEmpty, className, contentClassName, placeholderClassName, placeholderText, linkItems, onRequestLinkItems, onPickImage, toolbarTone, toolbarAlwaysVisible, toolbarPortalToChrome, hideToolbar, hideContent, onClick, renderContent, }: RichTextEditorSurfaceProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,16 @@
+import type { Editor } from '@tiptap/react';
+import type { ToolbarButtonConfig } from './config';
+import type { PickedRichTextImage } from './imageActions';
+import { type RichTextRoutableItem } from './toolbar/LinkPopover';
+interface RichTextToolbarProps {
+    editor: Editor | null;
+    buttons: ToolbarButtonConfig[];
+    onPickImage?: () => Promise<PickedRichTextImage | null | undefined>;
+    linkItems?: RichTextRoutableItem[];
+    onRequestLinkItems?: () => Promise<RichTextRoutableItem[]>;
+    alwaysVisible?: boolean;
+    tone?: 'light' | 'dark';
+    portalToChrome?: boolean;
+}
+export declare function RichTextToolbar({ editor, buttons, onPickImage, linkItems, onRequestLinkItems, alwaysVisible, tone, portalToChrome, }: RichTextToolbarProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

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

@@ -0,0 +1,23 @@
+import type { AnyExtension } from '@tiptap/core';
+import type { RichTextVariant } from '../../../../blocks/src/index';
+export type ToolbarButtonConfig = {
+    type: 'blockType';
+} | {
+    type: 'bold';
+} | {
+    type: 'italic';
+} | {
+    type: 'link';
+} | {
+    type: 'bulletList';
+} | {
+    type: 'orderedList';
+} | {
+    type: 'image';
+};
+export type RichTextEditorConfig = {
+    extensions: AnyExtension[];
+    toolbar: ToolbarButtonConfig[];
+    placeholder: string;
+};
+export declare const richTextConfigs: Record<RichTextVariant, RichTextEditorConfig>;

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

@@ -0,0 +1,2 @@
+import { Node } from '@tiptap/core';
+export declare const RichTextImage: Node<any, any>;

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

@@ -0,0 +1 @@
+export declare const RichTextLink: import("@tiptap/core").Mark<import("@tiptap/extension-link").LinkOptions, any>;

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

@@ -0,0 +1,22 @@
+import type { Editor } from '@tiptap/react';
+export type PickedRichTextImage = {
+    identifier: string;
+    src?: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+};
+type RichTextImageAttrs = {
+    identifier: string;
+    alt: string;
+    src?: string;
+    width?: number;
+    height?: number;
+};
+export declare function buildRichTextImageAttrs(picked: PickedRichTextImage): RichTextImageAttrs | null;
+export declare function getSelectedRichTextImagePosition(editor: Editor): number | null;
+export declare function getRichTextImagePositionFromTarget(editor: Editor, target: EventTarget | null): number | null;
+export declare function insertOrReplaceRichTextImage(editor: Editor, picked: PickedRichTextImage, options?: {
+    replaceAtPos?: number | null;
+}): 'inserted' | 'replaced' | null;
+export {};

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,10 +6,9 @@ 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 { GeneratedIconSetGenerateResult, GeneratedIconSetPreview } from './GeneratedIconSetDialog';
-import type { getFeatureCardIconDialogCards } from './featureCardIconActions';
+import type { GeneratedIconSetGenerateInput, GeneratedIconSetGenerateResult, GeneratedIconSetPreview } from './GeneratedIconSetDialog';
 import type { ArrayKeysManager, BlockFocusRequest, BlockItem, UiStore, DraftsSlice, UiSlice } from './types';
 /** Drag listener props from dnd-kit */
 type DragListeners = SyntheticListenerMap | undefined;
@@ -23,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'];
@@ -48,14 +47,11 @@ 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;
-    onGenerateIconSet?: (input: Readonly<{
-        userStyleNote: string | null;
-        cards: ReturnType<typeof getFeatureCardIconDialogCards>;
-    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onGenerateIconSet?: (input: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -5,8 +5,7 @@ import type { ComponentProps } from 'react';
 import type { BlockItem, BlockFocusRequest } from './types';
 import type { FieldWidgetComponent } from '../../../block-form/src/client/index';
 import type { SiteIconStyleGuideVersionId } from '../../../blocks/src/index';
-import type { GeneratedIconSetGenerateResult, GeneratedIconSetPreview } from './GeneratedIconSetDialog';
-import type { getFeatureCardIconDialogCards } from './featureCardIconActions';
+import type { GeneratedIconSetGenerateInput, GeneratedIconSetGenerateResult, GeneratedIconSetPreview } from './GeneratedIconSetDialog';
 export declare function BlockCardBody({ siteId, block, manifest, uiStore, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, hideThemeV2RawStyleFields, pageDesignBlock, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, onApplyGeneratedIconSet, }: {
     siteId: string;
     block: BlockItem;
@@ -23,9 +22,6 @@ export declare function BlockCardBody({ siteId, block, manifest, uiStore, hasRec
     currentStyleGuideVersionId?: SiteIconStyleGuideVersionId | null;
     iconStyleGuideSummary?: string | null;
     iconStyleGuideEditHref?: string | null;
-    onGenerateIconSet?: (input: Readonly<{
-        userStyleNote: string | null;
-        cards: ReturnType<typeof getFeatureCardIconDialogCards>;
-    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onGenerateIconSet?: (input: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -1,18 +1,17 @@
 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 { getFeatureCardIconDialogCards } from './featureCardIconActions';
-import { type GeneratedIconSetGenerateResult, type GeneratedIconSetPreview } from './GeneratedIconSetDialog';
+import { type GeneratedIconSetGenerateInput, type GeneratedIconSetGenerateResult, type GeneratedIconSetPreview } from './GeneratedIconSetDialog';
 /** Drag listener props from dnd-kit */
 type DragListeners = SyntheticListenerMap | undefined;
 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;
@@ -27,19 +26,16 @@ 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;
-    onGenerateIconSet?: (input: Readonly<{
-        userStyleNote: string | null;
-        cards: ReturnType<typeof getFeatureCardIconDialogCards>;
-    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onGenerateIconSet?: (input: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,6 @@
 import type { SiteIconStyleGuideVersionId } from '../../../blocks/src/index';
 import type { BlockItem, DraftsSlice, UiStore } from './types';
-import { getFeatureCardIconDialogCards } from './featureCardIconActions';
-import { type GeneratedIconSetGenerateResult, type GeneratedIconSetPreview } from './GeneratedIconSetDialog';
+import { type GeneratedIconSetGenerateInput, type GeneratedIconSetGenerateResult, type GeneratedIconSetPreview } from './GeneratedIconSetDialog';
 type FeatureCardIconsPanelStore = UiStore<{
     drafts: Pick<DraftsSlice, 'getCurrentValues' | 'setAtPath'>;
 }>;
@@ -12,10 +11,7 @@ export declare function FeatureCardIconsPanel({ block, uiStore, currentStyleGuid
     currentStyleGuideVersionId?: SiteIconStyleGuideVersionId | null;
     iconStyleGuideSummary?: string | null;
     iconStyleGuideEditHref?: string | null;
-    onGenerateIconSet?: (input: Readonly<{
-        userStyleNote: string | null;
-        cards: ReturnType<typeof getFeatureCardIconDialogCards>;
-    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onGenerateIconSet?: (input: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
 }): import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -20,6 +20,11 @@ export type GeneratedIconSetGenerateResult = Readonly<{
     kind: 'failed';
     message: string;
 }>;
+export type GeneratedIconSetGenerateInput = Readonly<{
+    userStyleNote: string | null;
+    cards: readonly FeatureCardIconDialogCard[];
+    signal?: AbortSignal;
+}>;
 export type GeneratedIconSetApplyResult = Readonly<{
     kind: 'applied';
 }> | Readonly<{
@@ -32,9 +37,6 @@ export declare function GeneratedIconSetDialog({ open, onOpenChange, cards, styl
     cards: readonly FeatureCardIconDialogCard[];
     styleGuideSummary?: string | null;
     styleGuideEditHref?: string | null;
-    onGenerate?: (input: Readonly<{
-        userStyleNote: string | null;
-        cards: readonly FeatureCardIconDialogCard[];
-    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onGenerate?: (input: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApply?: (preview: GeneratedIconSetPreview) => GeneratedIconSetApplyResult | void | Promise<GeneratedIconSetApplyResult | void>;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -5,10 +5,9 @@ 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 { GeneratedIconSetGenerateResult, GeneratedIconSetPreview } from './GeneratedIconSetDialog';
-import type { getFeatureCardIconDialogCards } from './featureCardIconActions';
+import type { GeneratedIconSetGenerateInput, GeneratedIconSetGenerateResult, GeneratedIconSetPreview } from './GeneratedIconSetDialog';
 export declare const SortableBlockItem: import("react").NamedExoticComponent<{
     siteId: string;
     block: BlockItem;
@@ -34,13 +33,10 @@ 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;
-    onGenerateIconSet?: (input: Readonly<{
-        userStyleNote: string | null;
-        cards: ReturnType<typeof getFeatureCardIconDialogCards>;
-    }>) => Promise<GeneratedIconSetGenerateResult>;
+    onGenerateIconSet?: (input: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
 }>;

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/index.d.ts

@@ -18,6 +18,8 @@ export type { BlockDraftSaveability, BlockDraftValidationIssue } from '../../blo
 export { applyManifestIssuesToForm } from './manifestIssues';
 export { BlockPickerDialog } from './block-editor/BlockPickerDialog';
 export { FileField, MediaField } from './media/MediaField';
+export { hideThemeV2RawStyleFields, prepareBlockEditorManifest, } from './block-editor/preparedManifest';
+export { stripTopLevelRoutingUi, } from './block-editor/settingsIntent';
 export * from './widgets/index';
 export { createBlockFormLogger, setBlockFormLoggerFactory, setBlockFormAppLogger } from './block-form/debug';
 export type { BlockFormLogger } from './block-form/debug';

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';