@portabletext/editor 1.14.0 → 1.14.2

package/lib/index.d.ts

@@ -94,20 +94,20 @@ export declare type BaseDefinition = {
  * @alpha
  */
 export declare type Behavior<
-  TBehaviorEventType extends BehaviorEvent['type'] = BehaviorEvent['type'],
+  TAnyBehaviorEventType extends BehaviorEvent['type'] = BehaviorEvent['type'],
   TGuardResponse = true,
 > = {
   /**
    * The internal editor event that triggers this behavior.
    */
-  on: TBehaviorEventType
+  on: TAnyBehaviorEventType
   /**
    * Predicate function that determines if the behavior should be executed.
    * Returning a non-nullable value from the guard will pass the value to the
    * actions and execute them.
    */
   guard?: BehaviorGuard<
-    PickFromUnion<BehaviorEvent, 'type', TBehaviorEventType>,
+    PickFromUnion<BehaviorEvent, 'type', TAnyBehaviorEventType>,
     TGuardResponse
   >
   /**
@@ -120,7 +120,7 @@ export declare type Behavior<
  * @alpha
  */
 export declare type BehaviorActionIntend =
-  | BehaviorEvent
+  | SyntheticBehaviorEvent
   | {
       type: 'insert.span'
       text: string
@@ -215,141 +215,25 @@ export declare type BehaviorActionIntend =
  */
 export declare type BehaviorActionIntendSet<TGuardResponse = true> = (
   guardResponse: TGuardResponse,
-) => Array<
-  OmitFromUnion<
-    BehaviorActionIntend,
-    'type',
-    'copy' | 'key.down' | 'key.up' | 'paste'
-  >
->
+) => Array<BehaviorActionIntend>
 
 /**
  * @alpha
  */
-export declare type BehaviorEvent =
-  | {
-      type: 'annotation.add'
-      annotation: {
-        name: string
-        value: {
-          [prop: string]: unknown
-        }
-      }
-    }
-  | {
-      type: 'annotation.remove'
-      annotation: {
-        name: string
-      }
-    }
-  | {
-      type: 'annotation.toggle'
-      annotation: {
-        name: string
-        value: {
-          [prop: string]: unknown
-        }
-      }
-    }
-  | {
-      type: 'blur'
-    }
-  | {
-      type: 'copy'
-      data: DataTransfer
-    }
-  | {
-      type: 'decorator.add'
-      decorator: string
-    }
-  | {
-      type: 'decorator.remove'
-      decorator: string
-    }
-  | {
-      type: 'decorator.toggle'
-      decorator: string
-    }
-  | {
-      type: 'delete.backward'
-      unit: TextUnit
-    }
-  | {
-      type: 'delete.forward'
-      unit: TextUnit
-    }
-  | {
-      type: 'focus'
-    }
-  | {
-      type: 'insert.block object'
-      placement: 'auto' | 'after' | 'before'
-      blockObject: {
-        name: string
-        value?: {
-          [prop: string]: unknown
-        }
-      }
-    }
-  | {
-      type: 'insert.inline object'
-      inlineObject: {
-        name: string
-        value?: {
-          [prop: string]: unknown
-        }
-      }
-    }
-  | {
-      type: 'insert.soft break'
-    }
-  | {
-      type: 'insert.break'
-    }
-  | {
-      type: 'insert.text'
-      text: string
-      options?: TextInsertTextOptions
-    }
-  | {
-      type: 'paste'
-      data: DataTransfer
-    }
-  | {
-      type: 'key.down'
-      keyboardEvent: Pick<
-        KeyboardEvent,
-        'key' | 'code' | 'altKey' | 'ctrlKey' | 'metaKey' | 'shiftKey'
-      >
-    }
-  | {
-      type: 'key.up'
-      keyboardEvent: Pick<
-        KeyboardEvent,
-        'key' | 'code' | 'altKey' | 'ctrlKey' | 'metaKey' | 'shiftKey'
-      >
-    }
-  | {
-      type: 'list item.toggle'
-      listItem: string
-    }
-  | {
-      type: 'style.toggle'
-      style: string
-    }
+export declare type BehaviorEvent = SyntheticBehaviorEvent | NativeBehaviorEvent
 
 /**
  * @alpha
  */
 export declare type BehaviorGuard<
-  TBehaviorEvent extends BehaviorEvent,
+  TAnyBehaviorEvent extends BehaviorEvent,
   TGuardResponse,
 > = ({
   context,
   event,
 }: {
   context: EditorContext
-  event: TBehaviorEvent
+  event: TAnyBehaviorEvent
 }) => TGuardResponse | false
 
 /** @beta */
@@ -478,7 +362,6 @@ export declare const coreBehavior: {
     | 'annotation.remove'
     | 'annotation.toggle'
     | 'blur'
-    | 'copy'
     | 'decorator.add'
     | 'decorator.remove'
     | 'decorator.toggle'
@@ -489,10 +372,11 @@ export declare const coreBehavior: {
     | 'insert.soft break'
     | 'insert.break'
     | 'insert.text'
-    | 'paste'
+    | 'style.toggle'
+    | 'copy'
     | 'key.down'
     | 'key.up'
-    | 'style.toggle',
+    | 'paste',
     true
   >
   decorators: {
@@ -503,7 +387,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -514,10 +397,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
     decoratorRemove: Behavior<
@@ -527,7 +411,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -538,10 +421,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
     decoratorToggle: Behavior<
@@ -551,7 +435,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -562,10 +445,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
   }
@@ -577,7 +461,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -588,10 +471,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
     arrowUpOnLonelyBlockObject: Behavior<
@@ -601,7 +485,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -612,10 +495,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
     breakingBlockObject: Behavior<
@@ -625,7 +509,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -636,10 +519,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
     deletingEmptyTextBlockAfterBlockObject: Behavior<
@@ -649,7 +533,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -660,10 +543,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
     deletingEmptyTextBlockBeforeBlockObject: Behavior<
@@ -673,7 +557,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -684,10 +567,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
   }
@@ -699,7 +583,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -710,10 +593,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
     unindentListOnBackspace: Behavior<
@@ -723,7 +607,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -734,10 +617,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
     clearListOnEnter: Behavior<
@@ -747,7 +631,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -758,10 +641,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
     indentListOnTab: Behavior<
@@ -771,7 +655,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -782,10 +665,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
     unindentListOnShiftTab: Behavior<
@@ -795,7 +679,6 @@ export declare const coreBehavior: {
       | 'annotation.remove'
       | 'annotation.toggle'
       | 'blur'
-      | 'copy'
       | 'decorator.add'
       | 'decorator.remove'
       | 'decorator.toggle'
@@ -806,10 +689,11 @@ export declare const coreBehavior: {
       | 'insert.soft break'
       | 'insert.break'
       | 'insert.text'
-      | 'paste'
+      | 'style.toggle'
+      | 'copy'
       | 'key.down'
       | 'key.up'
-      | 'style.toggle',
+      | 'paste',
       true
     >
   }
@@ -825,7 +709,6 @@ export declare const coreBehaviors: Behavior<
   | 'annotation.remove'
   | 'annotation.toggle'
   | 'blur'
-  | 'copy'
   | 'decorator.add'
   | 'decorator.remove'
   | 'decorator.toggle'
@@ -836,10 +719,11 @@ export declare const coreBehaviors: Behavior<
   | 'insert.soft break'
   | 'insert.break'
   | 'insert.text'
-  | 'paste'
+  | 'style.toggle'
+  | 'copy'
   | 'key.down'
   | 'key.up'
-  | 'style.toggle',
+  | 'paste',
   true
 >[]
 
@@ -855,7 +739,6 @@ export declare function createCodeEditorBehaviors(
   | 'annotation.remove'
   | 'annotation.toggle'
   | 'blur'
-  | 'copy'
   | 'decorator.add'
   | 'decorator.remove'
   | 'decorator.toggle'
@@ -866,10 +749,11 @@ export declare function createCodeEditorBehaviors(
   | 'insert.soft break'
   | 'insert.break'
   | 'insert.text'
-  | 'paste'
+  | 'style.toggle'
+  | 'copy'
   | 'key.down'
   | 'key.up'
-  | 'style.toggle',
+  | 'paste',
   true
 >[]
 
@@ -885,7 +769,6 @@ export declare function createLinkBehaviors(
   | 'annotation.remove'
   | 'annotation.toggle'
   | 'blur'
-  | 'copy'
   | 'decorator.add'
   | 'decorator.remove'
   | 'decorator.toggle'
@@ -896,10 +779,11 @@ export declare function createLinkBehaviors(
   | 'insert.soft break'
   | 'insert.break'
   | 'insert.text'
-  | 'paste'
+  | 'style.toggle'
+  | 'copy'
   | 'key.down'
   | 'key.up'
-  | 'style.toggle',
+  | 'paste',
   true
 >[]
 
@@ -915,7 +799,6 @@ export declare function createMarkdownBehaviors(
   | 'annotation.remove'
   | 'annotation.toggle'
   | 'blur'
-  | 'copy'
   | 'decorator.add'
   | 'decorator.remove'
   | 'decorator.toggle'
@@ -926,10 +809,11 @@ export declare function createMarkdownBehaviors(
   | 'insert.soft break'
   | 'insert.break'
   | 'insert.text'
-  | 'paste'
+  | 'style.toggle'
+  | 'copy'
   | 'key.down'
   | 'key.up'
-  | 'style.toggle',
+  | 'paste',
   true
 >[]
 
@@ -937,9 +821,9 @@ export declare function createMarkdownBehaviors(
  * @alpha
  */
 export declare function defineBehavior<
-  TBehaviorEventType extends BehaviorEvent['type'],
+  TAnyBehaviorEventType extends BehaviorEvent['type'],
   TGuardResponse = true,
->(behavior: Behavior<TBehaviorEventType, TGuardResponse>): Behavior
+>(behavior: Behavior<TAnyBehaviorEventType, TGuardResponse>): Behavior
 
 /**
  * @alpha
@@ -1115,10 +999,10 @@ export declare type EditorContext = {
 export declare type EditorEmittedEvent = PickFromUnion<
   InternalEditorEmittedEvent,
   'type',
-  | 'blur'
+  | 'blurred'
   | 'done loading'
   | 'error'
-  | 'focus'
+  | 'focused'
   | 'invalid value'
   | 'loading'
   | 'mutation'
@@ -1251,7 +1135,7 @@ export declare const editorMachine: StateMachine<
     }
   | {
       type: 'behavior event'
-      behaviorEvent: BehaviorEvent
+      behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
       editor: PortableTextSlateEditor
       nativeEvent?: {
         preventDefault: () => void
@@ -1612,7 +1496,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -1769,7 +1653,7 @@ export declare const editorMachine: StateMachine<
           }
         | {
             type: 'behavior event'
-            behaviorEvent: BehaviorEvent
+            behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
             editor: PortableTextSlateEditor
             nativeEvent?: {
               preventDefault: () => void
@@ -1953,7 +1837,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -2267,7 +2151,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -2581,7 +2465,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -2892,7 +2776,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -3206,7 +3090,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -3520,7 +3404,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -3841,7 +3725,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -4163,7 +4047,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -4470,7 +4354,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -4776,7 +4660,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -5065,7 +4949,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -5354,7 +5238,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -5644,7 +5528,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -5935,7 +5819,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -6225,7 +6109,7 @@ export declare const editorMachine: StateMachine<
               }
             | {
                 type: 'behavior event'
-                behaviorEvent: BehaviorEvent
+                behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
                 editor: PortableTextSlateEditor
                 nativeEvent?: {
                   preventDefault: () => void
@@ -6397,7 +6281,7 @@ export declare const editorMachine: StateMachine<
               }
             | {
                 type: 'behavior event'
-                behaviorEvent: BehaviorEvent
+                behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
                 editor: PortableTextSlateEditor
                 nativeEvent?: {
                   preventDefault: () => void
@@ -6687,7 +6571,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -6976,7 +6860,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -7264,7 +7148,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -7550,7 +7434,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -7838,7 +7722,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -8133,7 +8017,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -8307,7 +8191,7 @@ export declare const editorMachine: StateMachine<
               }
             | {
                 type: 'behavior event'
-                behaviorEvent: BehaviorEvent
+                behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
                 editor: PortableTextSlateEditor
                 nativeEvent?: {
                   preventDefault: () => void
@@ -8478,7 +8362,7 @@ export declare const editorMachine: StateMachine<
               }
             | {
                 type: 'behavior event'
-                behaviorEvent: BehaviorEvent
+                behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
                 editor: PortableTextSlateEditor
                 nativeEvent?: {
                   preventDefault: () => void
@@ -8768,7 +8652,7 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'behavior event'
-              behaviorEvent: BehaviorEvent
+              behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
@@ -8864,7 +8748,7 @@ export declare const editorMachine: StateMachine<
           },
           {
             type: 'behavior event'
-            behaviorEvent: BehaviorEvent
+            behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
             editor: PortableTextSlateEditor
             nativeEvent?: {
               preventDefault: () => void
@@ -8972,7 +8856,7 @@ export declare const editorMachine: StateMachine<
               }
             | {
                 type: 'behavior event'
-                behaviorEvent: BehaviorEvent
+                behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
                 editor: PortableTextSlateEditor
                 nativeEvent?: {
                   preventDefault: () => void
@@ -9139,7 +9023,7 @@ export declare const editorMachine: StateMachine<
               }
             | {
                 type: 'behavior event'
-                behaviorEvent: BehaviorEvent
+                behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
                 editor: PortableTextSlateEditor
                 nativeEvent?: {
                   preventDefault: () => void
@@ -9570,7 +9454,7 @@ export declare type InternalEditorEmittedEvent =
       readOnly: boolean
     }
   | PickFromUnion<
-      BehaviorEvent,
+      SyntheticBehaviorEvent,
       'type',
       | 'annotation.add'
       | 'annotation.remove'
@@ -9598,7 +9482,7 @@ export declare type InternalEditorEvent =
     }
   | {
       type: 'behavior event'
-      behaviorEvent: BehaviorEvent
+      behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
       editor: PortableTextSlateEditor
       nativeEvent?: {
         preventDefault: () => void
@@ -9742,6 +9626,33 @@ declare type MutationEvent_2 = {
 }
 export {MutationEvent_2 as MutationEvent}
 
+/**
+ * @alpha
+ */
+export declare type NativeBehaviorEvent =
+  | {
+      type: 'copy'
+      data: DataTransfer
+    }
+  | {
+      type: 'key.down'
+      keyboardEvent: Pick<
+        KeyboardEvent,
+        'key' | 'code' | 'altKey' | 'ctrlKey' | 'metaKey' | 'shiftKey'
+      >
+    }
+  | {
+      type: 'key.up'
+      keyboardEvent: Pick<
+        KeyboardEvent,
+        'key' | 'code' | 'altKey' | 'ctrlKey' | 'metaKey' | 'shiftKey'
+      >
+    }
+  | {
+      type: 'paste'
+      data: DataTransfer
+    }
+
 /**
  * @alpha
  */
@@ -10255,6 +10166,99 @@ export declare type SlateEditor = {
   initialValue: Array<Descendant>
 }
 
+/**
+ * @alpha
+ */
+export declare type SyntheticBehaviorEvent =
+  | {
+      type: 'annotation.add'
+      annotation: {
+        name: string
+        value: {
+          [prop: string]: unknown
+        }
+      }
+    }
+  | {
+      type: 'annotation.remove'
+      annotation: {
+        name: string
+      }
+    }
+  | {
+      type: 'annotation.toggle'
+      annotation: {
+        name: string
+        value: {
+          [prop: string]: unknown
+        }
+      }
+    }
+  | {
+      type: 'blur'
+    }
+  | {
+      type: 'decorator.add'
+      decorator: string
+    }
+  | {
+      type: 'decorator.remove'
+      decorator: string
+    }
+  | {
+      type: 'decorator.toggle'
+      decorator: string
+    }
+  | {
+      type: 'delete.backward'
+      unit: TextUnit
+    }
+  | {
+      type: 'delete.forward'
+      unit: TextUnit
+    }
+  | {
+      type: 'focus'
+    }
+  | {
+      type: 'insert.block object'
+      placement: 'auto' | 'after' | 'before'
+      blockObject: {
+        name: string
+        value?: {
+          [prop: string]: unknown
+        }
+      }
+    }
+  | {
+      type: 'insert.inline object'
+      inlineObject: {
+        name: string
+        value?: {
+          [prop: string]: unknown
+        }
+      }
+    }
+  | {
+      type: 'insert.soft break'
+    }
+  | {
+      type: 'insert.break'
+    }
+  | {
+      type: 'insert.text'
+      text: string
+      options?: TextInsertTextOptions
+    }
+  | {
+      type: 'list item.toggle'
+      listItem: string
+    }
+  | {
+      type: 'style.toggle'
+      style: string
+    }
+
 /**
  * The editor performed a undo history step
  * @beta */