@react-email/editor 0.0.0-experimental.2 → 0.0.0-experimental.20

package/dist/index.d.mts

@@ -1,35 +1,100 @@
+import * as react_jsx_runtime9 from "react/jsx-runtime";
 import * as _tiptap_core0 from "@tiptap/core";
-import { Editor, Extension, JSONContent, Mark, Node, NodeConfig as NodeConfig$1, NodeType, ParentConfig } from "@tiptap/core";
+import { Content, Editor, Extension, Extensions, JSONContent, Mark, MarkConfig, MarkType, Node, NodeConfig as NodeConfig$1, NodeType as NodeType$1, ParentConfig, Range } from "@tiptap/core";
+import { UseEditorOptions } from "@tiptap/react";
+import * as React$1 from "react";
+import { ComponentType, ReactNode, Ref } from "react";
+import { StarterKitOptions as StarterKitOptions$1 } from "@tiptap/starter-kit";
+import { BlockquoteOptions } from "@tiptap/extension-blockquote";
+import { BulletListOptions } from "@tiptap/extension-bullet-list";
+import { CodeOptions } from "@tiptap/extension-code";
 import { CodeBlockOptions } from "@tiptap/extension-code-block";
-import * as _tiptap_extension_placeholder0 from "@tiptap/extension-placeholder";
+import { EditorView } from "@tiptap/pm/view";
+import { HorizontalRuleOptions } from "@tiptap/extension-horizontal-rule";
+import { HardBreakOptions } from "@tiptap/extension-hard-break";
+import { HeadingOptions as HeadingOptions$1 } from "@tiptap/extension-heading";
+import { ItalicOptions } from "@tiptap/extension-italic";
+import { LinkOptions as LinkOptions$1 } from "@tiptap/extension-link";
+import { ListItemOptions } from "@tiptap/extension-list-item";
+import { OrderedListOptions } from "@tiptap/extension-ordered-list";
+import { ParagraphOptions } from "@tiptap/extension-paragraph";
+import { PlaceholderOptions as PlaceholderOptions$1 } from "@tiptap/extension-placeholder";
+import { StrikeOptions } from "@tiptap/extension-strike";
 import { Node as Node$1 } from "@tiptap/pm/model";
-import * as React$1 from "react";
-
-//#region src/utils/types.d.ts
 
-type KnownThemeComponents = 'reset' | 'body' | 'container' | 'h1' | 'h2' | 'h3' | 'paragraph' | 'nestedList' | 'list' | 'listItem' | 'listParagraph' | 'blockquote' | 'codeBlock' | 'inlineCode' | 'codeTag' | 'link' | 'footer' | 'hr' | 'image' | 'button' | 'section';
-type CssJs = { [K in KnownThemeComponents]: React$1.CSSProperties & {
-  align?: 'center' | 'left' | 'right';
-} };
+//#region src/core/event-bus.d.ts
+/**
+ * Base event map interface for the editor event bus.
+ *
+ * Components extend this via TypeScript module augmentation:
+ * ```ts
+ * declare module '@react-email/editor' {
+ *   interface EditorEventMap {
+ *     'my-component:custom-event': { data: string };
+ *   }
+ * }
+ * ```
+ */
+interface EditorEventMap {
+  'bubble-menu:add-link': undefined;
+}
+type EditorEventName = keyof EditorEventMap;
+type EditorEventHandler<T extends EditorEventName> = (payload: EditorEventMap[T]) => void | Promise<void>;
+interface EditorEventSubscription {
+  unsubscribe: () => void;
+}
+declare class EditorEventBus {
+  private prefixEventName;
+  dispatch<T extends EditorEventName>(eventName: T, payload: EditorEventMap[T], options?: {
+    target?: EventTarget;
+  }): void;
+  on<T extends EditorEventName>(eventName: T, handler: EditorEventHandler<T>, options?: AddEventListenerOptions & {
+    target?: EventTarget;
+  }): EditorEventSubscription;
+}
+declare const editorEventBus: EditorEventBus;
 //#endregion
-//#region src/core/email-node.d.ts
+//#region src/core/is-document-visually-empty.d.ts
+declare function isDocumentVisuallyEmpty(doc: Node$1): boolean;
+//#endregion
+//#region src/core/serializer/compose-react-email.d.ts
+interface ComposeReactEmailResult {
+  html: string;
+  text: string;
+}
+declare const composeReactEmail: ({
+  editor,
+  preview
+}: {
+  editor: Editor;
+  preview: string | null;
+}) => Promise<ComposeReactEmailResult>;
+//#endregion
+//#region src/core/serializer/email-node.d.ts
 type RendererComponent = (props: {
   node: JSONContent;
-  styles: CssJs;
+  style: React.CSSProperties;
   children?: React.ReactNode;
 }) => React.ReactNode;
 interface EmailNodeConfig<Options, Storage> extends NodeConfig$1<Options, Storage> {
   renderToReactEmail: RendererComponent;
 }
-type ConfigParameter<Options, Storage> = Partial<Omit<EmailNodeConfig<Options, Storage>, 'renderToReactEmail'>> & Pick<EmailNodeConfig<Options, Storage>, 'renderToReactEmail'>;
+type ConfigParameter$1<Options, Storage> = Partial<Omit<EmailNodeConfig<Options, Storage>, 'renderToReactEmail'>> & Pick<EmailNodeConfig<Options, Storage>, 'renderToReactEmail'> & ThisType<{
+  name: string;
+  options: Options;
+  storage: Storage;
+  editor: Editor;
+  type: NodeType$1;
+  parent: (...args: any[]) => any;
+}>;
 declare class EmailNode<Options = Record<string, never>, Storage = Record<string, never>> extends Node<Options, Storage> {
   config: EmailNodeConfig<Options, Storage>;
-  constructor(config: ConfigParameter<Options, Storage>);
+  constructor(config: ConfigParameter$1<Options, Storage>);
   /**
    * Create a new Node instance
    * @param config - Node configuration object or a function that returns a configuration object
    */
-  static create<O = Record<string, never>, S = Record<string, never>>(config: ConfigParameter<O, S> | (() => ConfigParameter<O, S>)): EmailNode<O, S>;
+  static create<O = Record<string, never>, S = Record<string, never>>(config: ConfigParameter$1<O, S> | (() => ConfigParameter$1<O, S>)): EmailNode<O, S>;
   static from<O, S>(node: Node<O, S>, renderToReactEmail: RendererComponent): EmailNode<O, S>;
   configure(options?: Partial<Options>): EmailNode<Options, Storage>;
   extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig extends NodeConfig$1<ExtendedOptions, ExtendedStorage> = EmailNodeConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: (() => Partial<ExtendedConfig>) | (Partial<ExtendedConfig> & ThisType<{
@@ -37,10 +102,48 @@ declare class EmailNode<Options = Record<string, never>, Storage = Record<string
     options: ExtendedOptions;
     storage: ExtendedStorage;
     editor: Editor;
-    type: NodeType;
+    type: NodeType$1;
   }>)): EmailNode<ExtendedOptions, ExtendedStorage>;
 }
 //#endregion
+//#region src/core/create-paste-handler.d.ts
+type PasteHandler = (payload: string | File, view: EditorView) => boolean;
+type UploadImageHandler = (file: File, view: EditorView, pos: number, preserveAttributes?: {
+  width?: string;
+  height?: string;
+  alignment?: string;
+  href?: string;
+}) => void | Promise<void>;
+//#endregion
+//#region src/core/use-editor.d.ts
+type Merge<A, B> = A & Omit<B, keyof A>;
+declare function useEditor({
+  content,
+  extensions,
+  onUpdate,
+  onPaste,
+  onUploadImage,
+  onReady,
+  editable,
+  ...rest
+}: Merge<{
+  content: Content;
+  extensions?: Extensions;
+  onUpdate?: (editor: Editor, transaction: {
+    getMeta: (key: string) => unknown;
+  }) => void;
+  onPaste?: PasteHandler;
+  onUploadImage?: UploadImageHandler;
+  onReady?: (editor: Editor | null) => void;
+  editable?: boolean;
+}, UseEditorOptions>): {
+  editor: Editor;
+  isEditorEmpty: boolean;
+  extensions: Extensions;
+  contentError: Error | null;
+  isCollaborative: boolean;
+};
+//#endregion
 //#region src/extensions/alignment-attribute.d.ts
 interface AlignmentOptions {
   types: string[];
@@ -64,6 +167,44 @@ interface BodyOptions {
 }
 declare const Body: EmailNode<BodyOptions, Record<string, never>>;
 //#endregion
+//#region src/core/serializer/email-mark.d.ts
+type SerializedMark = NonNullable<JSONContent['marks']>[number];
+type RendererComponent$1 = (props: {
+  mark: SerializedMark;
+  node: JSONContent;
+  style: React.CSSProperties;
+  children?: React.ReactNode;
+}) => React.ReactNode;
+interface EmailMarkConfig<Options, Storage> extends MarkConfig<Options, Storage> {
+  renderToReactEmail: RendererComponent$1;
+}
+type ConfigParameter<Options, Storage> = Partial<Omit<EmailMarkConfig<Options, Storage>, 'renderToReactEmail'>> & Pick<EmailMarkConfig<Options, Storage>, 'renderToReactEmail'> & ThisType<{
+  name: string;
+  options: Options;
+  storage: Storage;
+  editor: Editor;
+  type: MarkType;
+  parent: (...args: any[]) => any;
+}>;
+declare class EmailMark<Options = Record<string, never>, Storage = Record<string, never>> extends Mark<Options, Storage> {
+  config: EmailMarkConfig<Options, Storage>;
+  constructor(config: ConfigParameter<Options, Storage>);
+  /**
+   * Create a new Mark instance
+   * @param config - Mark configuration object or a function that returns a configuration object
+   */
+  static create<O = Record<string, never>, S = Record<string, never>>(config: ConfigParameter<O, S> | (() => ConfigParameter<O, S>)): EmailMark<O, S>;
+  static from<O, S>(mark: Mark<O, S>, renderToReactEmail: RendererComponent$1): EmailMark<O, S>;
+  configure(options?: Partial<Options>): EmailMark<Options, Storage>;
+  extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig extends MarkConfig<ExtendedOptions, ExtendedStorage> = EmailMarkConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: (() => Partial<ExtendedConfig>) | (Partial<ExtendedConfig> & ThisType<{
+    name: string;
+    options: ExtendedOptions;
+    storage: ExtendedStorage;
+    editor: Editor;
+    type: MarkType;
+  }>)): EmailMark<ExtendedOptions, ExtendedStorage>;
+}
+//#endregion
 //#region src/extensions/bold.d.ts
 interface BoldOptions {
   /**
@@ -95,7 +236,7 @@ declare module '@tiptap/core' {
  * This extension allows you to mark text as bold.
  * @see https://tiptap.dev/api/marks/bold
  */
-declare const Bold: Mark<BoldOptions, any>;
+declare const Bold: EmailMark<BoldOptions, Record<string, never>>;
 //#endregion
 //#region src/extensions/button.d.ts
 interface EditorButtonOptions {
@@ -146,6 +287,34 @@ interface DivOptions {
 }
 declare const Div: EmailNode<DivOptions, Record<string, never>>;
 //#endregion
+//#region src/extensions/divider.d.ts
+type DividerOptions = HorizontalRuleOptions;
+declare const Divider: EmailNode<HorizontalRuleOptions, any>;
+//#endregion
+//#region src/extensions/global-content.d.ts
+interface GlobalContentOptions {
+  key: string;
+  data: Record<string, unknown>;
+}
+declare module '@tiptap/core' {
+  interface GlobalContent<ReturnType> {
+    setGlobalContent: (key: string, value: unknown) => ReturnType;
+  }
+  interface Commands<ReturnType> {
+    globalContent: GlobalContent<ReturnType>;
+  }
+}
+declare function getGlobalContent(key: string, editor: Editor): unknown | null;
+declare const GlobalContent: Node<GlobalContentOptions, any>;
+//#endregion
+//#region src/extensions/heading.d.ts
+type HeadingOptions = HeadingOptions$1;
+declare const Heading: EmailNode<HeadingOptions$1, any>;
+//#endregion
+//#region src/extensions/link.d.ts
+type LinkOptions = LinkOptions$1;
+declare const Link: EmailMark<LinkOptions$1, any>;
+//#endregion
 //#region src/extensions/max-nesting.d.ts
 interface MaxNestingOptions {
   maxDepth: number;
@@ -160,17 +329,13 @@ interface PlaceholderOptions {
   }) => string);
   includeChildren?: boolean;
 }
-declare const createPlaceholderExtension: (options?: Partial<PlaceholderOptions>) => _tiptap_core0.Extension<_tiptap_extension_placeholder0.PlaceholderOptions, any>;
-declare const placeholder: _tiptap_core0.Extension<_tiptap_extension_placeholder0.PlaceholderOptions, any>;
+declare const Placeholder: Extension<PlaceholderOptions$1, any>;
 //#endregion
-//#region src/extensions/preserved-style.d.ts
-declare const PreservedStyle: Mark<any, any>;
-/**
- * Processes styles when unlinking:
- * - Has background (button-like): preserve all styles
- * - No background: strip link-indicator styles (color, text-decoration), keep the rest
- */
-declare function processStylesForUnlink(styleString: string | null | undefined): string | null;
+//#region src/extensions/preview-text.d.ts
+interface PreviewTextOptions {
+  HTMLAttributes: Record<string, unknown>;
+}
+declare const PreviewText: Node<PreviewTextOptions, any>;
 //#endregion
 //#region src/extensions/section.d.ts
 interface SectionOptions {
@@ -238,7 +403,7 @@ declare module '@tiptap/core' {
  * This extension allows you to mark text as superscript.
  * @see https://tiptap.dev/api/marks/superscript
  */
-declare const Sup: Mark<SupOptions, any>;
+declare const Sup: EmailMark<SupOptions, Record<string, never>>;
 //#endregion
 //#region src/extensions/table.d.ts
 declare module '@tiptap/core' {
@@ -270,5 +435,762 @@ interface TableCellOptions extends Record<string, unknown> {
 declare const TableCell: EmailNode<TableCellOptions, Record<string, never>>;
 declare const TableHeader: Node<any, any>;
 //#endregion
-export { AlignmentAttribute, Body, BodyOptions, Bold, BoldOptions, Button, ClassAttribute, CodeBlockPrism, CodeBlockPrismOptions, Div, DivOptions, EmailNode, EmailNodeConfig, MaxNesting, PlaceholderOptions, PreservedStyle, RendererComponent, Section, StyleAttribute, Sup, SupOptions, Table, TableCell, TableHeader, TableOptions, TableRow, createPlaceholderExtension, placeholder, processStylesForUnlink };
+//#region src/extensions/uppercase.d.ts
+interface UppercaseOptions {
+  HTMLAttributes: Record<string, unknown>;
+}
+declare module '@tiptap/core' {
+  interface Commands<ReturnType> {
+    uppercase: {
+      setUppercase: () => ReturnType;
+      toggleUppercase: () => ReturnType;
+      unsetUppercase: () => ReturnType;
+    };
+  }
+}
+declare const Uppercase: EmailMark<UppercaseOptions, Record<string, never>>;
+//#endregion
+//#region src/extensions/blockquote.d.ts
+declare const Blockquote: EmailNode<BlockquoteOptions, any>;
+//#endregion
+//#region src/extensions/bullet-list.d.ts
+declare const BulletList: EmailNode<BulletListOptions, any>;
+//#endregion
+//#region src/extensions/code.d.ts
+declare const Code: EmailMark<CodeOptions, any>;
+//#endregion
+//#region src/extensions/columns.d.ts
+declare module '@tiptap/core' {
+  interface Commands<ReturnType> {
+    columns: {
+      insertColumns: (count: 2 | 3 | 4) => ReturnType;
+    };
+  }
+}
+declare const COLUMN_PARENT_TYPES: readonly ["twoColumns", "threeColumns", "fourColumns"];
+declare const MAX_COLUMNS_DEPTH = 3;
+declare function getColumnsDepth(doc: Node$1, from: number): number;
+declare const TwoColumns: EmailNode<Record<string, never>, Record<string, never>>;
+declare const ThreeColumns: EmailNode<Record<string, never>, Record<string, never>>;
+declare const FourColumns: EmailNode<Record<string, never>, Record<string, never>>;
+declare const ColumnsColumn: EmailNode<Record<string, never>, Record<string, never>>;
+//#endregion
+//#region src/extensions/hard-break.d.ts
+declare const HardBreak: EmailNode<HardBreakOptions, any>;
+//#endregion
+//#region src/extensions/italic.d.ts
+declare const Italic: EmailMark<ItalicOptions, any>;
+//#endregion
+//#region src/extensions/list-item.d.ts
+declare const ListItem: EmailNode<ListItemOptions, any>;
+//#endregion
+//#region src/extensions/ordered-list.d.ts
+declare const OrderedList: EmailNode<OrderedListOptions, any>;
+//#endregion
+//#region src/extensions/paragraph.d.ts
+declare const Paragraph: EmailNode<ParagraphOptions, any>;
+//#endregion
+//#region src/extensions/preserved-style.d.ts
+declare const PreservedStyle: EmailMark<Record<string, never>, Record<string, never>>;
+/**
+ * Processes styles when unlinking:
+ * - Has background (button-like): preserve all styles
+ * - No background: strip link-indicator styles (color, text-decoration), keep the rest
+ */
+declare function processStylesForUnlink(styleString: string | null | undefined): string | null;
+//#endregion
+//#region src/extensions/strike.d.ts
+declare const Strike: EmailMark<StrikeOptions, any>;
+//#endregion
+//#region src/extensions/index.d.ts
+type StarterKitOptions = {
+  CodeBlockPrism: Partial<CodeBlockPrismOptions> | false;
+  Code: Partial<CodeOptions> | false;
+  Paragraph: Partial<ParagraphOptions> | false;
+  BulletList: Partial<BulletListOptions> | false;
+  OrderedList: Partial<OrderedListOptions> | false;
+  Blockquote: Partial<BlockquoteOptions> | false;
+  ListItem: Partial<ListItemOptions> | false;
+  HardBreak: Partial<HardBreakOptions> | false;
+  Italic: Partial<ItalicOptions> | false;
+  Placeholder: Partial<PlaceholderOptions> | false;
+  PreviewText: Partial<PreviewTextOptions> | false;
+  Bold: Partial<BoldOptions> | false;
+  Strike: Partial<StrikeOptions> | false;
+  Heading: Partial<HeadingOptions> | false;
+  Divider: Partial<DividerOptions> | false;
+  Link: Partial<LinkOptions> | false;
+  Sup: Partial<SupOptions> | false;
+  Uppercase: Partial<UppercaseOptions> | false;
+  PreservedStyle: Partial<Record<string, never>> | false;
+  Table: Partial<TableOptions> | false;
+  TableRow: Partial<TableRowOptions> | false;
+  TableCell: Partial<TableCellOptions> | false;
+  TableHeader: Partial<Record<string, any>> | false;
+  Body: Partial<BodyOptions> | false;
+  Div: Partial<DivOptions> | false;
+  Button: Partial<EditorButtonOptions> | false;
+  Section: Partial<SectionOptions> | false;
+  GlobalContent: Partial<GlobalContentOptions> | false;
+  AlignmentAttribute: Partial<AlignmentOptions> | false;
+  StyleAttribute: Partial<StyleAttributeOptions> | false;
+  ClassAttribute: Partial<ClassAttributeOptions> | false;
+  MaxNesting: Partial<MaxNestingOptions> | false;
+  TiptapStarterKit: Partial<StarterKitOptions$1> | false;
+};
+declare const StarterKit: Extension<StarterKitOptions, any>;
+//#endregion
+//#region src/ui/bubble-menu/create-mark-bubble-item.d.ts
+interface PreWiredItemProps {
+  className?: string;
+  /** Override the default icon */
+  children?: React$1.ReactNode;
+}
+//#endregion
+//#region src/ui/bubble-menu/align-center.d.ts
+declare function BubbleMenuAlignCenter({
+  className,
+  children
+}: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/bubble-menu/align-left.d.ts
+declare function BubbleMenuAlignLeft({
+  className,
+  children
+}: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/bubble-menu/align-right.d.ts
+declare function BubbleMenuAlignRight({
+  className,
+  children
+}: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/bubble-menu/default.d.ts
+type ExcludableItem$3 = 'bold' | 'italic' | 'underline' | 'strike' | 'code' | 'uppercase' | 'align-left' | 'align-center' | 'align-right' | 'node-selector' | 'link-selector';
+interface BubbleMenuDefaultProps {
+  /** Items to exclude from the default layout */
+  excludeItems?: ExcludableItem$3[];
+  /** Node types that should NOT trigger the bubble menu (forwarded to Root) */
+  excludeNodes?: string[];
+  /** Placement relative to selection (forwarded to Root, default: 'bottom') */
+  placement?: 'top' | 'bottom';
+  /** Offset from selection in px (forwarded to Root, default: 8) */
+  offset?: number;
+  /** Called when the bubble menu hides (forwarded to Root) */
+  onHide?: () => void;
+  /** className applied to the Root wrapper */
+  className?: string;
+}
+declare function BubbleMenuDefault({
+  excludeItems,
+  excludeNodes,
+  placement,
+  offset,
+  onHide,
+  className
+}: BubbleMenuDefaultProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/bubble-menu/group.d.ts
+interface BubbleMenuItemGroupProps {
+  className?: string;
+  children: React$1.ReactNode;
+}
+declare function BubbleMenuItemGroup({
+  className,
+  children
+}: BubbleMenuItemGroupProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/bubble-menu/item.d.ts
+interface BubbleMenuItemProps extends React$1.ComponentProps<'button'> {
+  /** Used for aria-label and data-item attribute */
+  name: string;
+  /** Whether this item is currently active */
+  isActive: boolean;
+  /** Called when clicked */
+  onCommand: () => void;
+}
+declare function BubbleMenuItem({
+  name,
+  isActive,
+  onCommand,
+  className,
+  children,
+  ...rest
+}: BubbleMenuItemProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/bubble-menu/link-selector.d.ts
+interface BubbleMenuLinkSelectorProps {
+  className?: string;
+  /** Whether to show the link icon toggle button (default: true) */
+  showToggle?: boolean;
+  /** Custom URL validator. Return the valid URL string or null. */
+  validateUrl?: (value: string) => string | null;
+  /** Called after link is applied */
+  onLinkApply?: (href: string) => void;
+  /** Called after link is removed */
+  onLinkRemove?: () => void;
+  /** Plugin slot: extra actions rendered inside the link input form */
+  children?: React$1.ReactNode;
+  /** Controlled open state */
+  open?: boolean;
+  /** Called when open state changes */
+  onOpenChange?: (open: boolean) => void;
+}
+declare function BubbleMenuLinkSelector({
+  className,
+  showToggle,
+  validateUrl,
+  onLinkApply,
+  onLinkRemove,
+  children,
+  open: controlledOpen,
+  onOpenChange
+}: BubbleMenuLinkSelectorProps): react_jsx_runtime9.JSX.Element | null;
+//#endregion
+//#region src/ui/bubble-menu/node-selector.d.ts
+type NodeType = 'Text' | 'Title' | 'Subtitle' | 'Heading' | 'Bullet List' | 'Numbered List' | 'Quote' | 'Code';
+interface NodeSelectorItem {
+  name: NodeType;
+  icon: React$1.ComponentType<React$1.SVGAttributes<SVGSVGElement>>;
+  command: () => void;
+  isActive: boolean;
+}
+interface NodeSelectorRootProps {
+  /** Block types to exclude */
+  omit?: string[];
+  /** Controlled open state */
+  open?: boolean;
+  /** Called when open state changes */
+  onOpenChange?: (open: boolean) => void;
+  className?: string;
+  children: React$1.ReactNode;
+}
+declare function NodeSelectorRoot({
+  omit,
+  open: controlledOpen,
+  onOpenChange,
+  className,
+  children
+}: NodeSelectorRootProps): react_jsx_runtime9.JSX.Element | null;
+interface NodeSelectorTriggerProps {
+  className?: string;
+  children?: React$1.ReactNode;
+}
+declare function NodeSelectorTrigger({
+  className,
+  children
+}: NodeSelectorTriggerProps): react_jsx_runtime9.JSX.Element;
+interface NodeSelectorContentProps {
+  className?: string;
+  /** Popover alignment (default: "start") */
+  align?: 'start' | 'center' | 'end';
+  /** Render-prop for full control over item rendering.
+   *  Receives the filtered items and a `close` function to dismiss the popover. */
+  children?: (items: NodeSelectorItem[], close: () => void) => React$1.ReactNode;
+}
+declare function NodeSelectorContent({
+  className,
+  align,
+  children
+}: NodeSelectorContentProps): react_jsx_runtime9.JSX.Element;
+interface BubbleMenuNodeSelectorProps {
+  /** Block types to exclude */
+  omit?: string[];
+  className?: string;
+  /** Override the trigger content (default: active item name + chevron icon) */
+  triggerContent?: React$1.ReactNode;
+  /** Controlled open state */
+  open?: boolean;
+  /** Called when open state changes */
+  onOpenChange?: (open: boolean) => void;
+}
+declare function BubbleMenuNodeSelector({
+  omit,
+  className,
+  triggerContent,
+  open,
+  onOpenChange
+}: BubbleMenuNodeSelectorProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/bubble-menu/root.d.ts
+interface BubbleMenuRootProps {
+  /** Node types that should NOT trigger the bubble menu */
+  excludeNodes?: string[];
+  /** Placement relative to selection */
+  placement?: 'top' | 'bottom';
+  /** Offset from selection in px */
+  offset?: number;
+  /** Called when the bubble menu is hidden (e.g., click outside, selection cleared) */
+  onHide?: () => void;
+  /** Additional className on the outer wrapper */
+  className?: string;
+  children: React$1.ReactNode;
+}
+declare function BubbleMenuRoot({
+  excludeNodes,
+  placement,
+  offset,
+  onHide,
+  className,
+  children
+}: BubbleMenuRootProps): react_jsx_runtime9.JSX.Element | null;
+//#endregion
+//#region src/ui/bubble-menu/separator.d.ts
+interface BubbleMenuSeparatorProps {
+  className?: string;
+}
+declare function BubbleMenuSeparator({
+  className
+}: BubbleMenuSeparatorProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/bubble-menu/bold.d.ts
+declare const BubbleMenuBold: {
+  ({
+    className,
+    children
+  }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/ui/bubble-menu/code.d.ts
+declare const BubbleMenuCode: {
+  ({
+    className,
+    children
+  }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/ui/bubble-menu/italic.d.ts
+declare const BubbleMenuItalic: {
+  ({
+    className,
+    children
+  }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/ui/bubble-menu/strike.d.ts
+declare const BubbleMenuStrike: {
+  ({
+    className,
+    children
+  }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/ui/bubble-menu/underline.d.ts
+declare const BubbleMenuUnderline: {
+  ({
+    className,
+    children
+  }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/ui/bubble-menu/uppercase.d.ts
+declare const BubbleMenuUppercase: {
+  ({
+    className,
+    children
+  }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/ui/bubble-menu/index.d.ts
+declare const BubbleMenu: {
+  readonly Root: typeof BubbleMenuRoot;
+  readonly ItemGroup: typeof BubbleMenuItemGroup;
+  readonly Separator: typeof BubbleMenuSeparator;
+  readonly Item: typeof BubbleMenuItem;
+  readonly Bold: {
+    ({
+      className,
+      children
+    }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+    displayName: string;
+  };
+  readonly Italic: {
+    ({
+      className,
+      children
+    }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+    displayName: string;
+  };
+  readonly Underline: {
+    ({
+      className,
+      children
+    }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+    displayName: string;
+  };
+  readonly Strike: {
+    ({
+      className,
+      children
+    }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+    displayName: string;
+  };
+  readonly Code: {
+    ({
+      className,
+      children
+    }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+    displayName: string;
+  };
+  readonly Uppercase: {
+    ({
+      className,
+      children
+    }: PreWiredItemProps): react_jsx_runtime9.JSX.Element;
+    displayName: string;
+  };
+  readonly AlignLeft: typeof BubbleMenuAlignLeft;
+  readonly AlignCenter: typeof BubbleMenuAlignCenter;
+  readonly AlignRight: typeof BubbleMenuAlignRight;
+  readonly NodeSelector: typeof BubbleMenuNodeSelector & {
+    Root: typeof NodeSelectorRoot;
+    Trigger: typeof NodeSelectorTrigger;
+    Content: typeof NodeSelectorContent;
+  };
+  readonly LinkSelector: typeof BubbleMenuLinkSelector;
+  readonly Default: typeof BubbleMenuDefault;
+};
+//#endregion
+//#region src/ui/button-bubble-menu/default.d.ts
+type ExcludableItem$2 = 'edit-link';
+interface ButtonBubbleMenuDefaultProps {
+  excludeItems?: ExcludableItem$2[];
+  placement?: 'top' | 'bottom';
+  offset?: number;
+  onHide?: () => void;
+  className?: string;
+}
+declare function ButtonBubbleMenuDefault({
+  excludeItems,
+  placement,
+  offset,
+  onHide,
+  className
+}: ButtonBubbleMenuDefaultProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/button-bubble-menu/edit-link.d.ts
+interface ButtonBubbleMenuEditLinkProps extends Omit<React$1.ComponentProps<'button'>, 'type'> {}
+declare function ButtonBubbleMenuEditLink({
+  className,
+  children,
+  onClick,
+  onMouseDown,
+  ...rest
+}: ButtonBubbleMenuEditLinkProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/button-bubble-menu/root.d.ts
+interface ButtonBubbleMenuRootProps {
+  /** Called when the bubble menu hides */
+  onHide?: () => void;
+  /** Placement relative to cursor (default: 'top') */
+  placement?: 'top' | 'bottom';
+  /** Offset from cursor in px (default: 8) */
+  offset?: number;
+  /** className on the outer wrapper */
+  className?: string;
+  children: React$1.ReactNode;
+}
+declare function ButtonBubbleMenuRoot({
+  onHide,
+  placement,
+  offset,
+  className,
+  children
+}: ButtonBubbleMenuRootProps): react_jsx_runtime9.JSX.Element | null;
+//#endregion
+//#region src/ui/button-bubble-menu/toolbar.d.ts
+interface ButtonBubbleMenuToolbarProps extends React$1.ComponentProps<'div'> {}
+declare function ButtonBubbleMenuToolbar({
+  children,
+  ...rest
+}: ButtonBubbleMenuToolbarProps): react_jsx_runtime9.JSX.Element | null;
+//#endregion
+//#region src/ui/button-bubble-menu/context.d.ts
+interface ButtonBubbleMenuContextValue {
+  editor: Editor;
+  isEditing: boolean;
+  setIsEditing: (value: boolean) => void;
+}
+declare function useButtonBubbleMenuContext(): ButtonBubbleMenuContextValue;
+//#endregion
+//#region src/ui/button-bubble-menu/index.d.ts
+declare const ButtonBubbleMenu: {
+  readonly Root: typeof ButtonBubbleMenuRoot;
+  readonly Toolbar: typeof ButtonBubbleMenuToolbar;
+  readonly EditLink: typeof ButtonBubbleMenuEditLink;
+  readonly Default: typeof ButtonBubbleMenuDefault;
+};
+//#endregion
+//#region src/ui/image-bubble-menu/default.d.ts
+type ExcludableItem$1 = 'edit-link';
+interface ImageBubbleMenuDefaultProps {
+  excludeItems?: ExcludableItem$1[];
+  placement?: 'top' | 'bottom';
+  offset?: number;
+  onHide?: () => void;
+  className?: string;
+}
+declare function ImageBubbleMenuDefault({
+  excludeItems,
+  placement,
+  offset,
+  onHide,
+  className
+}: ImageBubbleMenuDefaultProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/image-bubble-menu/edit-link.d.ts
+interface ImageBubbleMenuEditLinkProps extends Omit<React$1.ComponentProps<'button'>, 'type'> {}
+declare function ImageBubbleMenuEditLink({
+  className,
+  children,
+  onClick,
+  onMouseDown,
+  ...rest
+}: ImageBubbleMenuEditLinkProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/image-bubble-menu/root.d.ts
+interface ImageBubbleMenuRootProps {
+  /** Called when the bubble menu hides */
+  onHide?: () => void;
+  /** Placement relative to cursor (default: 'top') */
+  placement?: 'top' | 'bottom';
+  /** Offset from cursor in px (default: 8) */
+  offset?: number;
+  /** className on the outer wrapper */
+  className?: string;
+  children: React$1.ReactNode;
+}
+declare function ImageBubbleMenuRoot({
+  onHide,
+  placement,
+  offset,
+  className,
+  children
+}: ImageBubbleMenuRootProps): react_jsx_runtime9.JSX.Element | null;
+//#endregion
+//#region src/ui/image-bubble-menu/toolbar.d.ts
+interface ImageBubbleMenuToolbarProps extends React$1.ComponentProps<'div'> {}
+declare function ImageBubbleMenuToolbar({
+  children,
+  ...rest
+}: ImageBubbleMenuToolbarProps): react_jsx_runtime9.JSX.Element | null;
+//#endregion
+//#region src/ui/image-bubble-menu/context.d.ts
+interface ImageBubbleMenuContextValue {
+  editor: Editor;
+  isEditing: boolean;
+  setIsEditing: (value: boolean) => void;
+}
+declare function useImageBubbleMenuContext(): ImageBubbleMenuContextValue;
+//#endregion
+//#region src/ui/image-bubble-menu/index.d.ts
+declare const ImageBubbleMenu: {
+  readonly Root: typeof ImageBubbleMenuRoot;
+  readonly Toolbar: typeof ImageBubbleMenuToolbar;
+  readonly EditLink: typeof ImageBubbleMenuEditLink;
+  readonly Default: typeof ImageBubbleMenuDefault;
+};
+//#endregion
+//#region src/ui/link-bubble-menu/default.d.ts
+type ExcludableItem = 'edit-link' | 'open-link' | 'unlink';
+interface LinkBubbleMenuDefaultProps {
+  excludeItems?: ExcludableItem[];
+  placement?: 'top' | 'bottom';
+  offset?: number;
+  onHide?: () => void;
+  className?: string;
+  validateUrl?: (value: string) => string | null;
+  onLinkApply?: (href: string) => void;
+  onLinkRemove?: () => void;
+}
+declare function LinkBubbleMenuDefault({
+  excludeItems,
+  placement,
+  offset,
+  onHide,
+  className,
+  validateUrl,
+  onLinkApply,
+  onLinkRemove
+}: LinkBubbleMenuDefaultProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/link-bubble-menu/edit-link.d.ts
+interface LinkBubbleMenuEditLinkProps extends Omit<React$1.ComponentProps<'button'>, 'type'> {}
+declare function LinkBubbleMenuEditLink({
+  className,
+  children,
+  onClick,
+  onMouseDown,
+  ...rest
+}: LinkBubbleMenuEditLinkProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/link-bubble-menu/form.d.ts
+interface LinkBubbleMenuFormProps {
+  className?: string;
+  /** Custom URL validator (default: getUrlFromString) */
+  validateUrl?: (value: string) => string | null;
+  /** Called after link is applied */
+  onLinkApply?: (href: string) => void;
+  /** Called after link is removed */
+  onLinkRemove?: () => void;
+  /** Extra content inside the form (e.g. a variables dropdown slot) */
+  children?: React$1.ReactNode;
+}
+declare function LinkBubbleMenuForm({
+  className,
+  validateUrl,
+  onLinkApply,
+  onLinkRemove,
+  children
+}: LinkBubbleMenuFormProps): react_jsx_runtime9.JSX.Element | null;
+//#endregion
+//#region src/ui/link-bubble-menu/open-link.d.ts
+interface LinkBubbleMenuOpenLinkProps extends Omit<React$1.ComponentProps<'a'>, 'href' | 'target' | 'rel'> {}
+declare function LinkBubbleMenuOpenLink({
+  className,
+  children,
+  ...rest
+}: LinkBubbleMenuOpenLinkProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/link-bubble-menu/root.d.ts
+interface LinkBubbleMenuRootProps {
+  /** Called when the bubble menu hides */
+  onHide?: () => void;
+  /** Placement relative to cursor (default: 'top') */
+  placement?: 'top' | 'bottom';
+  /** Offset from cursor in px (default: 8) */
+  offset?: number;
+  /** className on the outer wrapper */
+  className?: string;
+  children: React$1.ReactNode;
+}
+declare function LinkBubbleMenuRoot({
+  onHide,
+  placement,
+  offset,
+  className,
+  children
+}: LinkBubbleMenuRootProps): react_jsx_runtime9.JSX.Element | null;
+//#endregion
+//#region src/ui/link-bubble-menu/toolbar.d.ts
+interface LinkBubbleMenuToolbarProps extends React$1.ComponentProps<'div'> {}
+declare function LinkBubbleMenuToolbar({
+  children,
+  ...rest
+}: LinkBubbleMenuToolbarProps): react_jsx_runtime9.JSX.Element | null;
+//#endregion
+//#region src/ui/link-bubble-menu/unlink.d.ts
+interface LinkBubbleMenuUnlinkProps extends Omit<React$1.ComponentProps<'button'>, 'type'> {}
+declare function LinkBubbleMenuUnlink({
+  className,
+  children,
+  onClick,
+  onMouseDown,
+  ...rest
+}: LinkBubbleMenuUnlinkProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/link-bubble-menu/context.d.ts
+interface LinkBubbleMenuContextValue {
+  editor: Editor;
+  linkHref: string;
+  isEditing: boolean;
+  setIsEditing: (value: boolean) => void;
+}
+declare function useLinkBubbleMenuContext(): LinkBubbleMenuContextValue;
+//#endregion
+//#region src/ui/link-bubble-menu/index.d.ts
+declare const LinkBubbleMenu: {
+  readonly Root: typeof LinkBubbleMenuRoot;
+  readonly Toolbar: typeof LinkBubbleMenuToolbar;
+  readonly Form: typeof LinkBubbleMenuForm;
+  readonly EditLink: typeof LinkBubbleMenuEditLink;
+  readonly Unlink: typeof LinkBubbleMenuUnlink;
+  readonly OpenLink: typeof LinkBubbleMenuOpenLink;
+  readonly Default: typeof LinkBubbleMenuDefault;
+};
+//#endregion
+//#region src/ui/slash-command/types.d.ts
+type SlashCommandCategory = string;
+interface SearchableItem {
+  title: string;
+  description: string;
+  searchTerms?: string[];
+}
+interface SlashCommandItem extends SearchableItem {
+  icon: ReactNode;
+  category: SlashCommandCategory;
+  command: (props: SlashCommandProps) => void;
+}
+interface SlashCommandProps {
+  editor: Editor;
+  range: Range;
+}
+interface CommandListRef {
+  onKeyDown: (props: {
+    event: KeyboardEvent;
+  }) => boolean;
+}
+interface CommandListProps {
+  items: SlashCommandItem[];
+  command: (item: SlashCommandItem) => void;
+  editor: SlashCommandProps['editor'];
+  range: SlashCommandProps['range'];
+  query: string;
+  ref: Ref<CommandListRef>;
+}
+type CommandListComponent = ComponentType<CommandListProps>;
+//#endregion
+//#region src/ui/slash-command/command-list.d.ts
+declare function CommandList({
+  items,
+  command,
+  query,
+  ref
+}: CommandListProps): react_jsx_runtime9.JSX.Element;
+//#endregion
+//#region src/ui/slash-command/commands.d.ts
+declare const TEXT: SlashCommandItem;
+declare const H1: SlashCommandItem;
+declare const H2: SlashCommandItem;
+declare const H3: SlashCommandItem;
+declare const BULLET_LIST: SlashCommandItem;
+declare const NUMBERED_LIST: SlashCommandItem;
+declare const QUOTE: SlashCommandItem;
+declare const CODE: SlashCommandItem;
+declare const BUTTON: SlashCommandItem;
+declare const DIVIDER: SlashCommandItem;
+declare const SECTION: SlashCommandItem;
+declare const TWO_COLUMNS: SlashCommandItem;
+declare const THREE_COLUMNS: SlashCommandItem;
+declare const FOUR_COLUMNS: SlashCommandItem;
+declare const defaultSlashCommands: SlashCommandItem[];
+//#endregion
+//#region src/ui/slash-command/create-slash-command.d.ts
+declare function createSlashCommand(options?: {
+  items?: SlashCommandItem[];
+  filterItems?: (items: SlashCommandItem[], query: string, editor: Editor) => SlashCommandItem[];
+  component?: CommandListComponent;
+}): _tiptap_core0.Extension<any, any>;
+//#endregion
+//#region src/ui/slash-command/search.d.ts
+declare function scoreItem(item: SearchableItem, query: string): number;
+declare function filterAndRankItems<T extends SearchableItem>(items: T[], query: string): T[];
+//#endregion
+//#region src/ui/slash-command/utils.d.ts
+declare function isInsideNode(editor: Editor, type: string): boolean;
+declare function isAtMaxColumnsDepth(editor: Editor): boolean;
+//#endregion
+//#region src/ui/slash-command/index.d.ts
+declare const SlashCommand: _tiptap_core0.Extension<any, any>;
+//#endregion
+//#region src/utils/set-text-alignment.d.ts
+declare function setTextAlignment(editor: Editor, alignment: string): void;
+//#endregion
+export { AlignmentAttribute, AlignmentOptions, BULLET_LIST, BUTTON, Blockquote, Body, BodyOptions, Bold, BoldOptions, BubbleMenu, BubbleMenuAlignCenter, BubbleMenuAlignLeft, BubbleMenuAlignRight, BubbleMenuBold, BubbleMenuCode, BubbleMenuDefault, type BubbleMenuDefaultProps, BubbleMenuItalic, BubbleMenuItem, BubbleMenuItemGroup, type BubbleMenuItemGroupProps, type BubbleMenuItemProps, BubbleMenuLinkSelector, type BubbleMenuLinkSelectorProps, BubbleMenuNodeSelector, type BubbleMenuNodeSelectorProps, BubbleMenuRoot, type BubbleMenuRootProps, BubbleMenuSeparator, type BubbleMenuSeparatorProps, BubbleMenuStrike, BubbleMenuUnderline, BubbleMenuUppercase, BulletList, Button, ButtonBubbleMenu, ButtonBubbleMenuDefault, type ButtonBubbleMenuDefaultProps, ButtonBubbleMenuEditLink, type ButtonBubbleMenuEditLinkProps, ButtonBubbleMenuRoot, type ButtonBubbleMenuRootProps, ButtonBubbleMenuToolbar, type ButtonBubbleMenuToolbarProps, CODE, COLUMN_PARENT_TYPES, ClassAttribute, ClassAttributeOptions, Code, CodeBlockPrism, CodeBlockPrismOptions, ColumnsColumn, CommandList, type CommandListComponent, type CommandListProps, type CommandListRef, DIVIDER, Div, DivOptions, Divider, DividerOptions, EditorButtonOptions, EditorEventHandler, EditorEventMap, EditorEventName, EditorEventSubscription, EmailNode, EmailNodeConfig, FOUR_COLUMNS, FourColumns, GlobalContent, GlobalContentOptions, H1, H2, H3, HardBreak, Heading, HeadingOptions, ImageBubbleMenu, ImageBubbleMenuDefault, type ImageBubbleMenuDefaultProps, ImageBubbleMenuEditLink, type ImageBubbleMenuEditLinkProps, ImageBubbleMenuRoot, type ImageBubbleMenuRootProps, ImageBubbleMenuToolbar, type ImageBubbleMenuToolbarProps, Italic, Link, LinkBubbleMenu, LinkBubbleMenuDefault, type LinkBubbleMenuDefaultProps, LinkBubbleMenuEditLink, type LinkBubbleMenuEditLinkProps, LinkBubbleMenuForm, type LinkBubbleMenuFormProps, LinkBubbleMenuOpenLink, type LinkBubbleMenuOpenLinkProps, LinkBubbleMenuRoot, type LinkBubbleMenuRootProps, LinkBubbleMenuToolbar, type LinkBubbleMenuToolbarProps, LinkBubbleMenuUnlink, type LinkBubbleMenuUnlinkProps, LinkOptions, ListItem, MAX_COLUMNS_DEPTH, MaxNesting, MaxNestingOptions, NUMBERED_LIST, NodeSelectorContent, type NodeSelectorContentProps, type NodeSelectorItem, NodeSelectorRoot, type NodeSelectorRootProps, NodeSelectorTrigger, type NodeSelectorTriggerProps, type NodeType, OrderedList, Paragraph, Placeholder, PlaceholderOptions, type PreWiredItemProps, PreservedStyle, PreviewText, PreviewTextOptions, QUOTE, RendererComponent, SECTION, type SearchableItem, Section, SectionOptions, SlashCommand, type SlashCommandItem, type SlashCommandProps, StarterKit, StarterKitOptions, Strike, StyleAttribute, StyleAttributeOptions, Sup, SupOptions, TEXT, THREE_COLUMNS, TWO_COLUMNS, Table, TableCell, TableCellOptions, TableHeader, TableOptions, TableRow, TableRowOptions, ThreeColumns, TwoColumns, Uppercase, UppercaseOptions, composeReactEmail, createSlashCommand, defaultSlashCommands, editorEventBus, filterAndRankItems, getColumnsDepth, getGlobalContent, isAtMaxColumnsDepth, isDocumentVisuallyEmpty, isInsideNode, processStylesForUnlink, scoreItem, setTextAlignment, useButtonBubbleMenuContext, useEditor, useImageBubbleMenuContext, useLinkBubbleMenuContext };
 //# sourceMappingURL=index.d.mts.map