@portabletext/editor 1.0.19 → 1.1.0

package/lib/index.d.mts

@@ -1,41 +1,42 @@
-import {ArrayDefinition} from '@sanity/types'
-import {ArraySchemaType} from '@sanity/types'
-import {BaseSyntheticEvent} from 'react'
-import {BlockDecoratorDefinition} from '@sanity/types'
-import {BlockListDefinition} from '@sanity/types'
-import {BlockSchemaType} from '@sanity/types'
-import {BlockStyleDefinition} from '@sanity/types'
-import {ClipboardEvent as ClipboardEvent_2} from 'react'
-import {Component} from 'react'
-import {Descendant} from 'slate'
-import {DOMNode} from 'slate-react/dist/utils/dom'
-import {FocusEvent as FocusEvent_2} from 'react'
-import {ForwardRefExoticComponent} from 'react'
-import {HTMLProps} from 'react'
-import {JSX as JSX_2} from 'react'
-import {KeyboardEvent as KeyboardEvent_2} from 'react'
-import {MutableRefObject} from 'react'
-import {Node as Node_2} from 'slate'
-import {ObjectSchemaType} from '@sanity/types'
-import {Observable} from 'rxjs'
-import {Operation} from 'slate'
 import {Patch} from '@portabletext/patches'
-import {Path} from '@sanity/types'
-import {PortableTextBlock} from '@sanity/types'
-import {PortableTextChild} from '@sanity/types'
-import {PortableTextListBlock} from '@sanity/types'
-import {PortableTextObject} from '@sanity/types'
-import {PortableTextSpan} from '@sanity/types'
-import {PortableTextTextBlock} from '@sanity/types'
-import {PropsWithChildren} from 'react'
+import {
+  ArrayDefinition,
+  ArraySchemaType,
+  BlockDecoratorDefinition,
+  BlockListDefinition,
+  BlockSchemaType,
+  BlockStyleDefinition,
+  ObjectSchemaType,
+  Path,
+  PortableTextBlock,
+  PortableTextChild,
+  PortableTextListBlock,
+  PortableTextObject,
+  PortableTextSpan,
+  PortableTextTextBlock,
+  SpanSchemaType,
+  TypedObject,
+} from '@sanity/types'
+import {
+  BaseSyntheticEvent,
+  ClipboardEvent as ClipboardEvent_2,
+  Component,
+  FocusEvent as FocusEvent_2,
+  ForwardRefExoticComponent,
+  HTMLProps,
+  JSX as JSX_2,
+  KeyboardEvent as KeyboardEvent_2,
+  MutableRefObject,
+  PropsWithChildren,
+  ReactElement,
+  RefAttributes,
+  RefObject,
+  TextareaHTMLAttributes,
+} from 'react'
+import {Observable, Subject} from 'rxjs'
+import {Descendant, Node as Node_2, Operation} from 'slate'
 import {ReactEditor} from 'slate-react'
-import {ReactElement} from 'react'
-import {RefAttributes} from 'react'
-import {RefObject} from 'react'
-import {SpanSchemaType} from '@sanity/types'
-import {Subject} from 'rxjs'
-import {TextareaHTMLAttributes} from 'react'
-import {TypedObject} from '@sanity/types'
+import {DOMNode} from 'slate-react/dist/utils/dom'
 
 /** @beta */
 export declare interface BlockAnnotationRenderProps {
@@ -158,14 +159,22 @@ export declare interface EditableAPI {
     },
   ) =>
     | {
-        spanPath: Path
         markDefPath: Path
+        markDefPaths: Array<Path>
+        spanPath: Path
       }
     | undefined
   blur: () => void
-  delete: (selection: EditorSelection, options?: EditableAPIDeleteOptions) => void
-  findByPath: (path: Path) => [PortableTextBlock | PortableTextChild | undefined, Path | undefined]
-  findDOMNode: (element: PortableTextBlock | PortableTextChild) => DOMNode | undefined
+  delete: (
+    selection: EditorSelection,
+    options?: EditableAPIDeleteOptions,
+  ) => void
+  findByPath: (
+    path: Path,
+  ) => [PortableTextBlock | PortableTextChild | undefined, Path | undefined]
+  findDOMNode: (
+    element: PortableTextBlock | PortableTextChild,
+  ) => DOMNode | undefined
   focus: () => void
   focusBlock: () => PortableTextBlock | undefined
   focusChild: () => PortableTextChild | undefined
@@ -190,7 +199,10 @@ export declare interface EditableAPI {
   isCollapsedSelection: () => boolean
   isExpandedSelection: () => boolean
   isMarkActive: (mark: string) => boolean
-  isSelectionsOverlapping: (selectionA: EditorSelection, selectionB: EditorSelection) => boolean
+  isSelectionsOverlapping: (
+    selectionA: EditorSelection,
+    selectionB: EditorSelection,
+  ) => boolean
   isVoid: (element: PortableTextBlock | PortableTextChild) => boolean
   marks: () => string[]
   redo: () => void
@@ -287,7 +299,10 @@ export declare type HistoryItem = {
  */
 export declare type HotkeyOptions = {
   marks?: Record<string, string>
-  custom?: Record<string, (event: BaseSyntheticEvent, editor: PortableTextEditor) => void>
+  custom?: Record<
+    string,
+    (event: BaseSyntheticEvent, editor: PortableTextEditor) => void
+  >
 }
 
 /**
@@ -372,7 +387,9 @@ export declare type OnPasteResult =
 /**
  * @beta
  */
-export declare type OnPasteResultOrPromise = OnPasteResult | Promise<OnPasteResult>
+export declare type OnPasteResultOrPromise =
+  | OnPasteResult
+  | Promise<OnPasteResult>
 
 /** @beta */
 export declare interface PasteData {
@@ -403,7 +420,10 @@ export declare type PatchObservable = Observable<{
  */
 export declare const PortableTextEditable: ForwardRefExoticComponent<
   Omit<
-    Omit<TextareaHTMLAttributes<HTMLDivElement>, 'onPaste' | 'onCopy' | 'onBeforeInput'> & {
+    Omit<
+      TextareaHTMLAttributes<HTMLDivElement>,
+      'onPaste' | 'onCopy' | 'onBeforeInput'
+    > & {
       hotkeys?: HotkeyOptions
       onBeforeInput?: (event: InputEvent) => void
       onPaste?: OnPasteFn
@@ -486,8 +506,18 @@ export declare class PortableTextEditor extends Component<PortableTextEditorProp
     },
   ) =>
     | {
-        spanPath: Path
+        /**
+         * @deprecated An annotation may be applied to multiple blocks, resulting
+         * in multiple `markDef`'s being created. Use `markDefPaths` instead.
+         */
         markDefPath: Path
+        markDefPaths: Array<Path>
+        /**
+         * @deprecated Does not return anything meaningful since an annotation
+         * can span multiple blocks and spans. If references the span closest
+         * to the focus point of the selection.
+         */
+        spanPath: Path
       }
     | undefined
   static blur: (editor: PortableTextEditor) => void
@@ -515,15 +545,34 @@ export declare class PortableTextEditor extends Component<PortableTextEditorProp
         Path | undefined,
       ]
   static focus: (editor: PortableTextEditor) => void
-  static focusBlock: (editor: PortableTextEditor) => PortableTextBlock | undefined
-  static focusChild: (editor: PortableTextEditor) => PortableTextChild | undefined
+  static focusBlock: (
+    editor: PortableTextEditor,
+  ) => PortableTextBlock | undefined
+  static focusChild: (
+    editor: PortableTextEditor,
+  ) => PortableTextChild | undefined
   static getSelection: (editor: PortableTextEditor) => EditorSelection
-  static getValue: (editor: PortableTextEditor) => PortableTextBlock[] | undefined
-  static hasBlockStyle: (editor: PortableTextEditor, blockStyle: string) => boolean | undefined
-  static hasListStyle: (editor: PortableTextEditor, listStyle: string) => boolean | undefined
-  static isCollapsedSelection: (editor: PortableTextEditor) => boolean | undefined
-  static isExpandedSelection: (editor: PortableTextEditor) => boolean | undefined
-  static isMarkActive: (editor: PortableTextEditor, mark: string) => boolean | undefined
+  static getValue: (
+    editor: PortableTextEditor,
+  ) => PortableTextBlock[] | undefined
+  static hasBlockStyle: (
+    editor: PortableTextEditor,
+    blockStyle: string,
+  ) => boolean | undefined
+  static hasListStyle: (
+    editor: PortableTextEditor,
+    listStyle: string,
+  ) => boolean | undefined
+  static isCollapsedSelection: (
+    editor: PortableTextEditor,
+  ) => boolean | undefined
+  static isExpandedSelection: (
+    editor: PortableTextEditor,
+  ) => boolean | undefined
+  static isMarkActive: (
+    editor: PortableTextEditor,
+    mark: string,
+  ) => boolean | undefined
   static insertChild: (
     editor: PortableTextEditor,
     type: SpanSchemaType | ObjectSchemaType,
@@ -545,12 +594,23 @@ export declare class PortableTextEditor extends Component<PortableTextEditorProp
   ) => boolean | undefined
   static isObjectPath: (editor: PortableTextEditor, path: Path) => boolean
   static marks: (editor: PortableTextEditor) => string[] | undefined
-  static select: (editor: PortableTextEditor, selection: EditorSelection | null) => void
-  static removeAnnotation: (editor: PortableTextEditor, type: ObjectSchemaType) => void | undefined
-  static toggleBlockStyle: (editor: PortableTextEditor, blockStyle: string) => void | undefined
+  static select: (
+    editor: PortableTextEditor,
+    selection: EditorSelection | null,
+  ) => void
+  static removeAnnotation: (
+    editor: PortableTextEditor,
+    type: ObjectSchemaType,
+  ) => void | undefined
+  static toggleBlockStyle: (
+    editor: PortableTextEditor,
+    blockStyle: string,
+  ) => void | undefined
   static toggleList: (editor: PortableTextEditor, listStyle: string) => void
   static toggleMark: (editor: PortableTextEditor, mark: string) => void
-  static getFragment: (editor: PortableTextEditor) => PortableTextBlock[] | undefined
+  static getFragment: (
+    editor: PortableTextEditor,
+  ) => PortableTextBlock[] | undefined
   static undo: (editor: PortableTextEditor) => void
   static redo: (editor: PortableTextEditor) => void
   static isSelectionsOverlapping: (
@@ -706,9 +766,9 @@ export declare interface PortableTextSlateEditor extends ReactEditor {
    */
   pteWithHotKeys: (event: KeyboardEvent_2<HTMLDivElement>) => void
   /**
-   * Helper function that creates an empty text block
+   * Helper function that creates a text block
    */
-  pteCreateEmptyBlock: () => Descendant
+  pteCreateTextBlock: (options: {decorators: Array<string>}) => Descendant
   /**
    * Undo
    */
@@ -779,28 +839,42 @@ export declare type RedoChange = {
 }
 
 /** @beta */
-export declare type RenderAnnotationFunction = (props: BlockAnnotationRenderProps) => JSX.Element
+export declare type RenderAnnotationFunction = (
+  props: BlockAnnotationRenderProps,
+) => JSX.Element
 
 /** @beta */
-export declare type RenderBlockFunction = (props: BlockRenderProps) => JSX.Element
+export declare type RenderBlockFunction = (
+  props: BlockRenderProps,
+) => JSX.Element
 
 /** @beta */
-export declare type RenderChildFunction = (props: BlockChildRenderProps) => JSX.Element
+export declare type RenderChildFunction = (
+  props: BlockChildRenderProps,
+) => JSX.Element
 
 /** @beta */
-export declare type RenderDecoratorFunction = (props: BlockDecoratorRenderProps) => JSX.Element
+export declare type RenderDecoratorFunction = (
+  props: BlockDecoratorRenderProps,
+) => JSX.Element
 
 /** @beta */
-export declare type RenderEditableFunction = (props: PortableTextEditableProps) => JSX.Element
+export declare type RenderEditableFunction = (
+  props: PortableTextEditableProps,
+) => JSX.Element
 
 /** @beta */
-export declare type RenderListItemFunction = (props: BlockListItemRenderProps) => JSX.Element
+export declare type RenderListItemFunction = (
+  props: BlockListItemRenderProps,
+) => JSX.Element
 
 /** @beta */
 export declare type RenderPlaceholderFunction = () => React.ReactNode
 
 /** @beta */
-export declare type RenderStyleFunction = (props: BlockStyleRenderProps) => JSX.Element
+export declare type RenderStyleFunction = (
+  props: BlockStyleRenderProps,
+) => JSX.Element
 
 /** @beta */
 export declare type ScrollSelectionIntoViewFunction = (

package/lib/index.d.ts

@@ -1,41 +1,42 @@
-import {ArrayDefinition} from '@sanity/types'
-import {ArraySchemaType} from '@sanity/types'
-import {BaseSyntheticEvent} from 'react'
-import {BlockDecoratorDefinition} from '@sanity/types'
-import {BlockListDefinition} from '@sanity/types'
-import {BlockSchemaType} from '@sanity/types'
-import {BlockStyleDefinition} from '@sanity/types'
-import {ClipboardEvent as ClipboardEvent_2} from 'react'
-import {Component} from 'react'
-import {Descendant} from 'slate'
-import {DOMNode} from 'slate-react/dist/utils/dom'
-import {FocusEvent as FocusEvent_2} from 'react'
-import {ForwardRefExoticComponent} from 'react'
-import {HTMLProps} from 'react'
-import {JSX as JSX_2} from 'react'
-import {KeyboardEvent as KeyboardEvent_2} from 'react'
-import {MutableRefObject} from 'react'
-import {Node as Node_2} from 'slate'
-import {ObjectSchemaType} from '@sanity/types'
-import {Observable} from 'rxjs'
-import {Operation} from 'slate'
 import {Patch} from '@portabletext/patches'
-import {Path} from '@sanity/types'
-import {PortableTextBlock} from '@sanity/types'
-import {PortableTextChild} from '@sanity/types'
-import {PortableTextListBlock} from '@sanity/types'
-import {PortableTextObject} from '@sanity/types'
-import {PortableTextSpan} from '@sanity/types'
-import {PortableTextTextBlock} from '@sanity/types'
-import {PropsWithChildren} from 'react'
+import {
+  ArrayDefinition,
+  ArraySchemaType,
+  BlockDecoratorDefinition,
+  BlockListDefinition,
+  BlockSchemaType,
+  BlockStyleDefinition,
+  ObjectSchemaType,
+  Path,
+  PortableTextBlock,
+  PortableTextChild,
+  PortableTextListBlock,
+  PortableTextObject,
+  PortableTextSpan,
+  PortableTextTextBlock,
+  SpanSchemaType,
+  TypedObject,
+} from '@sanity/types'
+import {
+  BaseSyntheticEvent,
+  ClipboardEvent as ClipboardEvent_2,
+  Component,
+  FocusEvent as FocusEvent_2,
+  ForwardRefExoticComponent,
+  HTMLProps,
+  JSX as JSX_2,
+  KeyboardEvent as KeyboardEvent_2,
+  MutableRefObject,
+  PropsWithChildren,
+  ReactElement,
+  RefAttributes,
+  RefObject,
+  TextareaHTMLAttributes,
+} from 'react'
+import {Observable, Subject} from 'rxjs'
+import {Descendant, Node as Node_2, Operation} from 'slate'
 import {ReactEditor} from 'slate-react'
-import {ReactElement} from 'react'
-import {RefAttributes} from 'react'
-import {RefObject} from 'react'
-import {SpanSchemaType} from '@sanity/types'
-import {Subject} from 'rxjs'
-import {TextareaHTMLAttributes} from 'react'
-import {TypedObject} from '@sanity/types'
+import {DOMNode} from 'slate-react/dist/utils/dom'
 
 /** @beta */
 export declare interface BlockAnnotationRenderProps {
@@ -158,14 +159,22 @@ export declare interface EditableAPI {
     },
   ) =>
     | {
-        spanPath: Path
         markDefPath: Path
+        markDefPaths: Array<Path>
+        spanPath: Path
       }
     | undefined
   blur: () => void
-  delete: (selection: EditorSelection, options?: EditableAPIDeleteOptions) => void
-  findByPath: (path: Path) => [PortableTextBlock | PortableTextChild | undefined, Path | undefined]
-  findDOMNode: (element: PortableTextBlock | PortableTextChild) => DOMNode | undefined
+  delete: (
+    selection: EditorSelection,
+    options?: EditableAPIDeleteOptions,
+  ) => void
+  findByPath: (
+    path: Path,
+  ) => [PortableTextBlock | PortableTextChild | undefined, Path | undefined]
+  findDOMNode: (
+    element: PortableTextBlock | PortableTextChild,
+  ) => DOMNode | undefined
   focus: () => void
   focusBlock: () => PortableTextBlock | undefined
   focusChild: () => PortableTextChild | undefined
@@ -190,7 +199,10 @@ export declare interface EditableAPI {
   isCollapsedSelection: () => boolean
   isExpandedSelection: () => boolean
   isMarkActive: (mark: string) => boolean
-  isSelectionsOverlapping: (selectionA: EditorSelection, selectionB: EditorSelection) => boolean
+  isSelectionsOverlapping: (
+    selectionA: EditorSelection,
+    selectionB: EditorSelection,
+  ) => boolean
   isVoid: (element: PortableTextBlock | PortableTextChild) => boolean
   marks: () => string[]
   redo: () => void
@@ -287,7 +299,10 @@ export declare type HistoryItem = {
  */
 export declare type HotkeyOptions = {
   marks?: Record<string, string>
-  custom?: Record<string, (event: BaseSyntheticEvent, editor: PortableTextEditor) => void>
+  custom?: Record<
+    string,
+    (event: BaseSyntheticEvent, editor: PortableTextEditor) => void
+  >
 }
 
 /**
@@ -372,7 +387,9 @@ export declare type OnPasteResult =
 /**
  * @beta
  */
-export declare type OnPasteResultOrPromise = OnPasteResult | Promise<OnPasteResult>
+export declare type OnPasteResultOrPromise =
+  | OnPasteResult
+  | Promise<OnPasteResult>
 
 /** @beta */
 export declare interface PasteData {
@@ -403,7 +420,10 @@ export declare type PatchObservable = Observable<{
  */
 export declare const PortableTextEditable: ForwardRefExoticComponent<
   Omit<
-    Omit<TextareaHTMLAttributes<HTMLDivElement>, 'onPaste' | 'onCopy' | 'onBeforeInput'> & {
+    Omit<
+      TextareaHTMLAttributes<HTMLDivElement>,
+      'onPaste' | 'onCopy' | 'onBeforeInput'
+    > & {
       hotkeys?: HotkeyOptions
       onBeforeInput?: (event: InputEvent) => void
       onPaste?: OnPasteFn
@@ -486,8 +506,18 @@ export declare class PortableTextEditor extends Component<PortableTextEditorProp
     },
   ) =>
     | {
-        spanPath: Path
+        /**
+         * @deprecated An annotation may be applied to multiple blocks, resulting
+         * in multiple `markDef`'s being created. Use `markDefPaths` instead.
+         */
         markDefPath: Path
+        markDefPaths: Array<Path>
+        /**
+         * @deprecated Does not return anything meaningful since an annotation
+         * can span multiple blocks and spans. If references the span closest
+         * to the focus point of the selection.
+         */
+        spanPath: Path
       }
     | undefined
   static blur: (editor: PortableTextEditor) => void
@@ -515,15 +545,34 @@ export declare class PortableTextEditor extends Component<PortableTextEditorProp
         Path | undefined,
       ]
   static focus: (editor: PortableTextEditor) => void
-  static focusBlock: (editor: PortableTextEditor) => PortableTextBlock | undefined
-  static focusChild: (editor: PortableTextEditor) => PortableTextChild | undefined
+  static focusBlock: (
+    editor: PortableTextEditor,
+  ) => PortableTextBlock | undefined
+  static focusChild: (
+    editor: PortableTextEditor,
+  ) => PortableTextChild | undefined
   static getSelection: (editor: PortableTextEditor) => EditorSelection
-  static getValue: (editor: PortableTextEditor) => PortableTextBlock[] | undefined
-  static hasBlockStyle: (editor: PortableTextEditor, blockStyle: string) => boolean | undefined
-  static hasListStyle: (editor: PortableTextEditor, listStyle: string) => boolean | undefined
-  static isCollapsedSelection: (editor: PortableTextEditor) => boolean | undefined
-  static isExpandedSelection: (editor: PortableTextEditor) => boolean | undefined
-  static isMarkActive: (editor: PortableTextEditor, mark: string) => boolean | undefined
+  static getValue: (
+    editor: PortableTextEditor,
+  ) => PortableTextBlock[] | undefined
+  static hasBlockStyle: (
+    editor: PortableTextEditor,
+    blockStyle: string,
+  ) => boolean | undefined
+  static hasListStyle: (
+    editor: PortableTextEditor,
+    listStyle: string,
+  ) => boolean | undefined
+  static isCollapsedSelection: (
+    editor: PortableTextEditor,
+  ) => boolean | undefined
+  static isExpandedSelection: (
+    editor: PortableTextEditor,
+  ) => boolean | undefined
+  static isMarkActive: (
+    editor: PortableTextEditor,
+    mark: string,
+  ) => boolean | undefined
   static insertChild: (
     editor: PortableTextEditor,
     type: SpanSchemaType | ObjectSchemaType,
@@ -545,12 +594,23 @@ export declare class PortableTextEditor extends Component<PortableTextEditorProp
   ) => boolean | undefined
   static isObjectPath: (editor: PortableTextEditor, path: Path) => boolean
   static marks: (editor: PortableTextEditor) => string[] | undefined
-  static select: (editor: PortableTextEditor, selection: EditorSelection | null) => void
-  static removeAnnotation: (editor: PortableTextEditor, type: ObjectSchemaType) => void | undefined
-  static toggleBlockStyle: (editor: PortableTextEditor, blockStyle: string) => void | undefined
+  static select: (
+    editor: PortableTextEditor,
+    selection: EditorSelection | null,
+  ) => void
+  static removeAnnotation: (
+    editor: PortableTextEditor,
+    type: ObjectSchemaType,
+  ) => void | undefined
+  static toggleBlockStyle: (
+    editor: PortableTextEditor,
+    blockStyle: string,
+  ) => void | undefined
   static toggleList: (editor: PortableTextEditor, listStyle: string) => void
   static toggleMark: (editor: PortableTextEditor, mark: string) => void
-  static getFragment: (editor: PortableTextEditor) => PortableTextBlock[] | undefined
+  static getFragment: (
+    editor: PortableTextEditor,
+  ) => PortableTextBlock[] | undefined
   static undo: (editor: PortableTextEditor) => void
   static redo: (editor: PortableTextEditor) => void
   static isSelectionsOverlapping: (
@@ -706,9 +766,9 @@ export declare interface PortableTextSlateEditor extends ReactEditor {
    */
   pteWithHotKeys: (event: KeyboardEvent_2<HTMLDivElement>) => void
   /**
-   * Helper function that creates an empty text block
+   * Helper function that creates a text block
    */
-  pteCreateEmptyBlock: () => Descendant
+  pteCreateTextBlock: (options: {decorators: Array<string>}) => Descendant
   /**
    * Undo
    */
@@ -779,28 +839,42 @@ export declare type RedoChange = {
 }
 
 /** @beta */
-export declare type RenderAnnotationFunction = (props: BlockAnnotationRenderProps) => JSX.Element
+export declare type RenderAnnotationFunction = (
+  props: BlockAnnotationRenderProps,
+) => JSX.Element
 
 /** @beta */
-export declare type RenderBlockFunction = (props: BlockRenderProps) => JSX.Element
+export declare type RenderBlockFunction = (
+  props: BlockRenderProps,
+) => JSX.Element
 
 /** @beta */
-export declare type RenderChildFunction = (props: BlockChildRenderProps) => JSX.Element
+export declare type RenderChildFunction = (
+  props: BlockChildRenderProps,
+) => JSX.Element
 
 /** @beta */
-export declare type RenderDecoratorFunction = (props: BlockDecoratorRenderProps) => JSX.Element
+export declare type RenderDecoratorFunction = (
+  props: BlockDecoratorRenderProps,
+) => JSX.Element
 
 /** @beta */
-export declare type RenderEditableFunction = (props: PortableTextEditableProps) => JSX.Element
+export declare type RenderEditableFunction = (
+  props: PortableTextEditableProps,
+) => JSX.Element
 
 /** @beta */
-export declare type RenderListItemFunction = (props: BlockListItemRenderProps) => JSX.Element
+export declare type RenderListItemFunction = (
+  props: BlockListItemRenderProps,
+) => JSX.Element
 
 /** @beta */
 export declare type RenderPlaceholderFunction = () => React.ReactNode
 
 /** @beta */
-export declare type RenderStyleFunction = (props: BlockStyleRenderProps) => JSX.Element
+export declare type RenderStyleFunction = (
+  props: BlockStyleRenderProps,
+) => JSX.Element
 
 /** @beta */
 export declare type ScrollSelectionIntoViewFunction = (