@riverbankcms/sdk 0.80.0 → 0.82.0

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

@@ -6,6 +6,7 @@ import { type EditorBlockId } from '../../core/src/index';
 import type { ArrayKeysManager, DraftsSlice, UiStore as BlockEditorUiStore } from './block-editor/types';
 type UiStoreState = {
     setActivePreviewField: (field: {
+        kind: 'block';
         blockId: EditorBlockId;
         fieldPath: string;
     } | null) => void;
@@ -45,5 +46,5 @@ export declare function BlockForm({ siteId: _siteId, block, manifest, uiStore, h
     widgetOverrides?: Record<string, FieldWidgetComponent>;
     hideThemeV2RawStyleFields?: boolean;
     pageDesignBlock?: PageDesignEditorBlock | null;
-}): import("react/jsx-runtime").JSX.Element | null;
+}): import("react").JSX.Element | null;
 export {};

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

@@ -55,4 +55,4 @@ export type FormProviderProps = {
  * 3. MediaEditorProvider - Media upload and repository
  * 4. RichTextWidgetProvider - Rich text theme and image picker
  */
-export declare function FormProvider({ siteId, theme, mediaConfig, linkConfig, referenceConfig, onPickImage, children, }: FormProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function FormProvider({ siteId, theme, mediaConfig, linkConfig, referenceConfig, onPickImage, children, }: FormProviderProps): import("react").JSX.Element;

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

@@ -1,4 +1,4 @@
 export declare const AddBlockDivider: ({ onOpen, position }: {
     onOpen: (position: number) => void;
     position: number;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => import("react").JSX.Element;

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,11 +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: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export {};

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

@@ -24,4 +24,4 @@ export declare function BlockCardBody({ siteId, block, manifest, uiStore, hasRec
     iconStyleGuideEditHref?: string | null;
     onGenerateIconSet?: (input: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;

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,16 +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: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export {};

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

@@ -21,5 +21,5 @@ type BlockListProviderProps = {
     value: BlockListContextValue;
     children: ReactNode;
 };
-export declare function BlockListProvider({ value, children }: BlockListProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function BlockListProvider({ value, children }: BlockListProviderProps): import("react").JSX.Element;
 export {};

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

@@ -5,4 +5,4 @@ export declare function BlockPickerDialog({ open, onOpenChange, creatingBlockNam
     creatingBlockName: string | null;
     descriptors: BlockDescriptor[];
     onSelect: (descriptor: BlockDescriptor) => void;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;

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

@@ -14,4 +14,4 @@ export type BlockThumbnailProps = {
  * - Text blocks: Show Lucide icon with colored background
  * - Default: Show icon from manifest with category-based gradient
  */
-export declare function BlockThumbnail({ blockKind, manifest, content }: BlockThumbnailProps): import("react/jsx-runtime").JSX.Element;
+export declare function BlockThumbnail({ blockKind, manifest, content }: BlockThumbnailProps): import("react").JSX.Element;

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

@@ -9,9 +9,9 @@ type BlockTileProps = {
  * Visual tile component for displaying a block option.
  * Used in the block picker for both grid and list views.
  */
-export declare function BlockTile({ block, onClick, isLoading, disabled }: BlockTileProps): import("react/jsx-runtime").JSX.Element;
+export declare function BlockTile({ block, onClick, isLoading, disabled }: BlockTileProps): import("react").JSX.Element;
 /**
  * Compact version for recently used section
  */
-export declare function BlockTileCompact({ block, onClick, isLoading, disabled }: BlockTileProps): import("react/jsx-runtime").JSX.Element;
+export declare function BlockTileCompact({ block, onClick, isLoading, disabled }: BlockTileProps): import("react").JSX.Element;
 export {};

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

@@ -1,3 +1,3 @@
 export declare const EmptyState: ({ onAdd }: {
     onAdd: () => void;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => import("react").JSX.Element;

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

@@ -12,5 +12,5 @@ type EnhancedBlockPickerDialogProps = {
 /**
  * Enhanced block picker with search, categories, and recommendations
  */
-export declare function EnhancedBlockPickerDialog({ open, onOpenChange, creatingBlockName, descriptors, siteId, existingBlockNames, enabledContentTypes, onSelect, }: EnhancedBlockPickerDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function EnhancedBlockPickerDialog({ open, onOpenChange, creatingBlockName, descriptors, siteId, existingBlockNames, enabledContentTypes, onSelect, }: EnhancedBlockPickerDialogProps): import("react").JSX.Element;
 export {};

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

@@ -13,5 +13,5 @@ export declare function FeatureCardIconsPanel({ block, uiStore, currentStyleGuid
     iconStyleGuideEditHref?: string | null;
     onGenerateIconSet?: (input: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
-}): import("react/jsx-runtime").JSX.Element | null;
+}): import("react").JSX.Element | null;
 export {};

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

@@ -39,4 +39,4 @@ export declare function GeneratedIconSetDialog({ open, onOpenChange, cards, styl
     styleGuideEditHref?: string | null;
     onGenerate?: (input: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApply?: (preview: GeneratedIconSetPreview) => GeneratedIconSetApplyResult | void | Promise<GeneratedIconSetApplyResult | void>;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;

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

@@ -1,4 +1,4 @@
 import type { ReactNode } from 'react';
 export declare function HeaderActions({ headerLeftSlot, }: {
     headerLeftSlot?: ReactNode;
-}): import("react/jsx-runtime").JSX.Element | null;
+}): import("react").JSX.Element | null;

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

@@ -5,10 +5,10 @@ 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<{
+export declare const SortableBlockItem: import("react").MemoExoticComponent<({ siteId, block, onMove, onDuplicate, onDelete, isFirst, isLast, isMoving, isDraggable, collapsed, onCollapsedChange, highlighted, hasRecoveryConflict, focusSignal, onFocusHandled, onBlockSave, theme, widgetOverrides, uiStore, sdkConfig, customBlocks, hideThemeV2RawStyleFields, pageDesignBlock, reorderControlMode, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, onApplyGeneratedIconSet, }: {
     siteId: string;
     block: BlockItem;
     onMove: (blockId: string, direction: number) => void;
@@ -33,10 +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: GeneratedIconSetGenerateInput) => Promise<GeneratedIconSetGenerateResult>;
     onApplyGeneratedIconSet?: (preview: GeneratedIconSetPreview) => GeneratedIconSetPreview | void | Promise<GeneratedIconSetPreview | void>;
-}>;
+}) => import("react").JSX.Element>;

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/block-editor/types.d.ts

@@ -44,6 +44,7 @@ export type UiSlice = {
     }) => void;
     clearFocus: () => void;
     setActivePreviewField: (field: {
+        kind: 'block';
         blockId: EditorBlockId;
         fieldPath: string;
     } | null) => void;

package/dist/_dts/editor-blocks/src/media/MediaField.d.ts

@@ -7,5 +7,5 @@ import type { VideoPrepIntentResolver } from '../../../media-react/src/index';
 export declare function uploadIntentForFileField(): UploadIntentContract;
 export declare function videoPrepIntentForMediaField(fieldPath: string, mediaKinds: readonly NonNullable<MediaFieldConfig['mediaKinds']>[number][] | undefined): VideoPrepIntentResolver | undefined;
 export declare function videoSelectionIntentForMediaField(fieldPath: string, mediaKinds: readonly NonNullable<MediaFieldConfig['mediaKinds']>[number][] | undefined): VideoPrepIntent | undefined;
-export declare function MediaField({ path, backend, config, }: FieldWidgetProps<MediaValue, MediaFieldConfig>): import("react/jsx-runtime").JSX.Element;
-export declare function FileField({ path, backend, config, }: FieldWidgetProps<MediaValue, FileFieldConfig>): import("react/jsx-runtime").JSX.Element;
+export declare function MediaField({ path, backend, config, }: FieldWidgetProps<MediaValue, MediaFieldConfig>): import("react").JSX.Element;
+export declare function FileField({ path, backend, config, }: FieldWidgetProps<MediaValue, FileFieldConfig>): import("react").JSX.Element;

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

@@ -10,4 +10,4 @@ export interface ButtonValue {
     size?: 'sm' | 'md' | 'lg' | 'xl';
     text: string;
 }
-export declare function ButtonField({ path, backend, config }: FieldWidgetProps<ButtonValue, ButtonFieldConfig>): import("react/jsx-runtime").JSX.Element;
+export declare function ButtonField({ path, backend, config }: FieldWidgetProps<ButtonValue, ButtonFieldConfig>): import("react").JSX.Element;

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

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

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

@@ -20,5 +20,5 @@ export interface ButtonWidgetProviderProps {
     buttonSystem: ButtonSystem | null;
     children: ReactNode;
 }
-export declare function ButtonWidgetProvider({ buttonSystem, children }: ButtonWidgetProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ButtonWidgetProvider({ buttonSystem, children }: ButtonWidgetProviderProps): import("react").JSX.Element;
 export declare function useButtonWidgetContext(): ButtonWidgetContextValue;