@portabletext/editor 1.20.0 → 1.21.1

package/lib/index.d.ts

@@ -64,6 +64,7 @@ import {
   Values,
 } from 'xstate'
 import {GuardArgs} from 'xstate/guards'
+import {PortableTextMemberSchemaTypes as PortableTextMemberSchemaTypes_2} from '..'
 
 /**
  * @public
@@ -97,6 +98,7 @@ export declare type BaseDefinition = {
 export declare type Behavior<
   TBehaviorEventType extends BehaviorEvent['type'] = BehaviorEvent['type'],
   TGuardResponse = true,
+  TBehaviorEvent extends BehaviorEvent = BehaviorEvent,
 > = {
   /**
    * The internal editor event that triggers this behavior.
@@ -107,14 +109,11 @@ export declare type Behavior<
    * Returning a non-nullable value from the guard will pass the value to the
    * actions and execute them.
    */
-  guard?: BehaviorGuard<
-    PickFromUnion<BehaviorEvent, 'type', TBehaviorEventType>,
-    TGuardResponse
-  >
+  guard?: BehaviorGuard<TBehaviorEvent, TGuardResponse>
   /**
    * Array of behavior action sets.
    */
-  actions: Array<BehaviorActionIntendSet<TBehaviorEventType, TGuardResponse>>
+  actions: Array<BehaviorActionIntendSet<TBehaviorEvent, TGuardResponse>>
 }
 
 /**
@@ -124,7 +123,7 @@ export declare type BehaviorActionIntend =
   | SyntheticBehaviorEvent
   | {
       type: 'raise'
-      event: SyntheticBehaviorEvent
+      event: SyntheticBehaviorEvent | CustomBehaviorEvent
     }
   | {
       type: 'annotation.toggle'
@@ -228,16 +227,13 @@ export declare type BehaviorActionIntend =
 /**
  * @beta
  */
-export declare type BehaviorActionIntendSet<
-  TBehaviorEventType extends BehaviorEvent['type'] = BehaviorEvent['type'],
-  TGuardResponse = true,
-> = (
+export declare type BehaviorActionIntendSet<TBehaviorEvent, TGuardResponse> = (
   {
     context,
     event,
   }: {
     context: EditorContext
-    event: PickFromUnion<BehaviorEvent, 'type', TBehaviorEventType>
+    event: TBehaviorEvent
   },
   guardResponse: TGuardResponse,
 ) => Array<BehaviorActionIntend>
@@ -245,15 +241,15 @@ export declare type BehaviorActionIntendSet<
 /**
  * @beta
  */
-export declare type BehaviorEvent = SyntheticBehaviorEvent | NativeBehaviorEvent
+export declare type BehaviorEvent =
+  | SyntheticBehaviorEvent
+  | NativeBehaviorEvent
+  | CustomBehaviorEvent
 
 /**
  * @beta
  */
-export declare type BehaviorGuard<
-  TBehaviorEvent extends BehaviorEvent,
-  TGuardResponse,
-> = ({
+export declare type BehaviorGuard<TBehaviorEvent, TGuardResponse> = ({
   context,
   event,
 }: {
@@ -368,6 +364,17 @@ export declare type ConnectionChange = {
   value: 'online' | 'offline'
 }
 
+/**
+ * @beta
+ */
+declare type CustomBehaviorEvent<
+  TPayload extends Record<string, unknown> = Record<string, unknown>,
+  TType extends string = string,
+  TInternalType extends `custom.${TType}` = `custom.${TType}`,
+> = {
+  type: TInternalType
+} & TPayload
+
 /**
  * @public
  */
@@ -572,24 +579,26 @@ export declare type EditorEmittedEvent = PickFromUnion<
 /**
  * @public
  */
-export declare type EditorEvent = PickFromUnion<
-  InternalEditorEvent,
-  'type',
-  | 'annotation.add'
-  | 'annotation.remove'
-  | 'blur'
-  | 'decorator.toggle'
-  | 'focus'
-  | 'insert.block object'
-  | 'insert.inline object'
-  | 'list item.toggle'
-  | 'select'
-  | 'style.toggle'
-  | 'patches'
-  | 'update behaviors'
-  | 'update readOnly'
-  | 'update value'
->
+export declare type EditorEvent =
+  | PickFromUnion<
+      InternalEditorEvent,
+      'type',
+      | 'annotation.add'
+      | 'annotation.remove'
+      | 'blur'
+      | 'decorator.toggle'
+      | 'focus'
+      | 'insert.block object'
+      | 'insert.inline object'
+      | 'list item.toggle'
+      | 'select'
+      | 'style.toggle'
+      | 'patches'
+      | 'update behaviors'
+      | 'update readOnly'
+      | 'update value'
+    >
+  | CustomBehaviorEvent
 
 /**
  * @public
@@ -605,7 +614,7 @@ export declare const editorMachine: StateMachine<
   {
     behaviors: Set<Behavior>
     keyGenerator: () => string
-    pendingEvents: Array<PatchEvent | MutationEvent_2>
+    pendingEvents: Array<PatchEvent | MutationEvent>
     schema: EditorSchema
     initialReadOnly: boolean
     maxBlocks: number | undefined
@@ -665,7 +674,7 @@ export declare const editorMachine: StateMachine<
       style: string
     }
   | PatchEvent
-  | MutationEvent_2
+  | MutationEvent
   | {
       type: 'normalizing'
     }
@@ -679,10 +688,20 @@ export declare const editorMachine: StateMachine<
       type: 'behavior event'
       behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
       editor: PortableTextSlateEditor
+      defaultActionCallback?: () => void
+      nativeEvent?: {
+        preventDefault: () => void
+      }
+    }
+  | {
+      type: 'custom behavior event'
+      behaviorEvent: CustomBehaviorEvent
+      editor: PortableTextSlateEditor
       nativeEvent?: {
         preventDefault: () => void
       }
     }
+  | CustomBehaviorEvent
   | {
       type: 'add behavior'
       behavior: Behavior
@@ -752,6 +771,10 @@ export declare const editorMachine: StateMachine<
     }
   | {
       type: 'done loading'
+    }
+  | {
+      type: 'custom.*'
+      event: CustomBehaviorEvent
     },
   {},
   never,
@@ -887,7 +910,7 @@ export declare const editorMachine: StateMachine<
       style: string
     }
   | PatchEvent
-  | MutationEvent_2
+  | MutationEvent
   | {
       type: 'ready'
     }
@@ -938,6 +961,10 @@ export declare const editorMachine: StateMachine<
     }
   | {
       type: 'editable'
+    }
+  | {
+      type: 'custom.*'
+      event: CustomBehaviorEvent
     },
   MetaObject,
   {
@@ -980,7 +1007,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -1040,7 +1067,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -1054,10 +1081,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -1127,6 +1164,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           Record<string, AnyActorRef | undefined>,
           StateValue,
@@ -1188,7 +1229,7 @@ export declare const editorMachine: StateMachine<
             style: string
           }
         | PatchEvent
-        | MutationEvent_2
+        | MutationEvent
         | {
             type: 'normalizing'
           }
@@ -1202,10 +1243,20 @@ export declare const editorMachine: StateMachine<
             type: 'behavior event'
             behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
             editor: PortableTextSlateEditor
+            defaultActionCallback?: () => void
+            nativeEvent?: {
+              preventDefault: () => void
+            }
+          }
+        | {
+            type: 'custom behavior event'
+            behaviorEvent: CustomBehaviorEvent
+            editor: PortableTextSlateEditor
             nativeEvent?: {
               preventDefault: () => void
             }
           }
+        | CustomBehaviorEvent
         | {
             type: 'add behavior'
             behavior: Behavior
@@ -1275,6 +1326,10 @@ export declare const editorMachine: StateMachine<
           }
         | {
             type: 'done loading'
+          }
+        | {
+            type: 'custom.*'
+            event: CustomBehaviorEvent
           },
         AnyEventObject
       >
@@ -1282,7 +1337,7 @@ export declare const editorMachine: StateMachine<
       behaviors: Set<Behavior>
       keyGenerator: () => string
       pendingEvents: never[]
-      schema: PortableTextMemberSchemaTypes
+      schema: PortableTextMemberSchemaTypes_2
       selection: null
       initialReadOnly: boolean
       maxBlocks: number | undefined
@@ -1300,7 +1355,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -1364,7 +1419,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -1378,10 +1433,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -1451,6 +1516,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -1510,7 +1579,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -1562,6 +1631,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'value changed': {
@@ -1569,7 +1642,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -1633,7 +1706,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -1647,10 +1720,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -1720,6 +1803,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -1779,7 +1866,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -1831,6 +1918,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'invalid value': {
@@ -1838,7 +1929,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -1903,7 +1994,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -1917,10 +2008,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -1990,6 +2091,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -2049,7 +2154,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -2101,6 +2206,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'error': {
@@ -2108,7 +2217,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -2174,7 +2283,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -2188,10 +2297,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -2261,6 +2380,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -2320,7 +2443,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -2372,6 +2495,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'selection': {
@@ -2380,7 +2507,7 @@ export declare const editorMachine: StateMachine<
             {
               behaviors: Set<Behavior>
               keyGenerator: () => string
-              pendingEvents: Array<PatchEvent | MutationEvent_2>
+              pendingEvents: Array<PatchEvent | MutationEvent>
               schema: EditorSchema
               initialReadOnly: boolean
               maxBlocks: number | undefined
@@ -2444,7 +2571,7 @@ export declare const editorMachine: StateMachine<
                 style: string
               }
             | PatchEvent
-            | MutationEvent_2
+            | MutationEvent
             | {
                 type: 'normalizing'
               }
@@ -2458,10 +2585,20 @@ export declare const editorMachine: StateMachine<
                 type: 'behavior event'
                 behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
                 editor: PortableTextSlateEditor
+                defaultActionCallback?: () => void
+                nativeEvent?: {
+                  preventDefault: () => void
+                }
+              }
+            | {
+                type: 'custom behavior event'
+                behaviorEvent: CustomBehaviorEvent
+                editor: PortableTextSlateEditor
                 nativeEvent?: {
                   preventDefault: () => void
                 }
               }
+            | CustomBehaviorEvent
             | {
                 type: 'add behavior'
                 behavior: Behavior
@@ -2531,6 +2668,10 @@ export declare const editorMachine: StateMachine<
               }
             | {
                 type: 'done loading'
+              }
+            | {
+                type: 'custom.*'
+                event: CustomBehaviorEvent
               },
             undefined,
             never,
@@ -2543,7 +2684,7 @@ export declare const editorMachine: StateMachine<
             {
               behaviors: Set<Behavior>
               keyGenerator: () => string
-              pendingEvents: Array<PatchEvent | MutationEvent_2>
+              pendingEvents: Array<PatchEvent | MutationEvent>
               schema: EditorSchema
               initialReadOnly: boolean
               maxBlocks: number | undefined
@@ -2607,7 +2748,7 @@ export declare const editorMachine: StateMachine<
                 style: string
               }
             | PatchEvent
-            | MutationEvent_2
+            | MutationEvent
             | {
                 type: 'normalizing'
               }
@@ -2621,10 +2762,20 @@ export declare const editorMachine: StateMachine<
                 type: 'behavior event'
                 behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
                 editor: PortableTextSlateEditor
+                defaultActionCallback?: () => void
+                nativeEvent?: {
+                  preventDefault: () => void
+                }
+              }
+            | {
+                type: 'custom behavior event'
+                behaviorEvent: CustomBehaviorEvent
+                editor: PortableTextSlateEditor
                 nativeEvent?: {
                   preventDefault: () => void
                 }
               }
+            | CustomBehaviorEvent
             | {
                 type: 'add behavior'
                 behavior: Behavior
@@ -2694,6 +2845,10 @@ export declare const editorMachine: StateMachine<
               }
             | {
                 type: 'done loading'
+              }
+            | {
+                type: 'custom.*'
+                event: CustomBehaviorEvent
               },
             undefined,
             never,
@@ -2753,7 +2908,7 @@ export declare const editorMachine: StateMachine<
                 style: string
               }
             | PatchEvent
-            | MutationEvent_2
+            | MutationEvent
             | {
                 type: 'ready'
               }
@@ -2805,6 +2960,10 @@ export declare const editorMachine: StateMachine<
             | {
                 type: 'editable'
               }
+            | {
+                type: 'custom.*'
+                event: CustomBehaviorEvent
+              }
           >,
         ]
       }
@@ -2813,7 +2972,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -2877,7 +3036,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -2891,10 +3050,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -2964,6 +3133,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -3023,7 +3196,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -3075,6 +3248,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'focused': {
@@ -3082,7 +3259,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -3146,7 +3323,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -3160,10 +3337,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -3233,6 +3420,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -3292,7 +3483,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -3344,6 +3535,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'loading': {
@@ -3351,7 +3546,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -3414,7 +3609,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -3428,10 +3623,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -3501,6 +3706,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -3560,7 +3769,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -3612,6 +3821,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'patches': {
@@ -3619,7 +3832,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -3680,7 +3893,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -3694,10 +3907,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -3767,6 +3990,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -3826,7 +4053,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -3878,6 +4105,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'done loading': {
@@ -3885,7 +4116,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -3948,7 +4179,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -3962,10 +4193,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -4035,6 +4276,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -4094,7 +4339,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -4146,6 +4391,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'update behaviors': {
@@ -4159,7 +4408,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -4223,7 +4472,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -4237,10 +4486,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -4310,6 +4569,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -4324,7 +4587,7 @@ export declare const editorMachine: StateMachine<
           {
             behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -4388,7 +4651,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -4402,10 +4665,20 @@ export declare const editorMachine: StateMachine<
               type: 'behavior event'
               behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
               editor: PortableTextSlateEditor
+              defaultActionCallback?: () => void
+              nativeEvent?: {
+                preventDefault: () => void
+              }
+            }
+          | {
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
               nativeEvent?: {
                 preventDefault: () => void
               }
             }
+          | CustomBehaviorEvent
           | {
               type: 'add behavior'
               behavior: Behavior
@@ -4475,6 +4748,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -4504,7 +4781,7 @@ export declare const editorMachine: StateMachine<
                         {
                           behaviors: Set<Behavior>
                           keyGenerator: () => string
-                          pendingEvents: Array<PatchEvent | MutationEvent_2>
+                          pendingEvents: Array<PatchEvent | MutationEvent>
                           schema: EditorSchema
                           initialReadOnly: boolean
                           maxBlocks: number | undefined
@@ -4531,7 +4808,7 @@ export declare const editorMachine: StateMachine<
                       {
                         behaviors: Set<Behavior>
                         keyGenerator: () => string
-                        pendingEvents: Array<PatchEvent | MutationEvent_2>
+                        pendingEvents: Array<PatchEvent | MutationEvent>
                         schema: EditorSchema
                         initialReadOnly: boolean
                         maxBlocks: number | undefined
@@ -4559,7 +4836,7 @@ export declare const editorMachine: StateMachine<
                   {
                     behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -4577,12 +4854,15 @@ export declare const editorMachine: StateMachine<
               readonly 'behavior event': {
                 readonly actions: 'handle behavior event'
               }
+              readonly 'custom behavior event': {
+                readonly actions: 'handle behavior event'
+              }
               readonly 'annotation.*': {
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -4657,7 +4937,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -4673,10 +4953,20 @@ export declare const editorMachine: StateMachine<
                         | SyntheticBehaviorEvent
                         | NativeBehaviorEvent
                       editor: PortableTextSlateEditor
+                      defaultActionCallback?: () => void
+                      nativeEvent?: {
+                        preventDefault: () => void
+                      }
+                    }
+                  | {
+                      type: 'custom behavior event'
+                      behaviorEvent: CustomBehaviorEvent
+                      editor: PortableTextSlateEditor
                       nativeEvent?: {
                         preventDefault: () => void
                       }
                     }
+                  | CustomBehaviorEvent
                   | {
                       type: 'add behavior'
                       behavior: Behavior
@@ -4746,6 +5036,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -4805,7 +5099,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -4857,6 +5151,10 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
               readonly 'blur': {
@@ -4864,7 +5162,7 @@ export declare const editorMachine: StateMachine<
                   {
                     behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -4927,7 +5225,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -4943,10 +5241,20 @@ export declare const editorMachine: StateMachine<
                         | SyntheticBehaviorEvent
                         | NativeBehaviorEvent
                       editor: PortableTextSlateEditor
+                      defaultActionCallback?: () => void
+                      nativeEvent?: {
+                        preventDefault: () => void
+                      }
+                    }
+                  | {
+                      type: 'custom behavior event'
+                      behaviorEvent: CustomBehaviorEvent
+                      editor: PortableTextSlateEditor
                       nativeEvent?: {
                         preventDefault: () => void
                       }
                     }
+                  | CustomBehaviorEvent
                   | {
                       type: 'add behavior'
                       behavior: Behavior
@@ -5016,6 +5324,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -5075,7 +5387,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -5127,24 +5439,29 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
-              readonly 'decorator.*': {
+              readonly 'custom.*': {
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
                     selection: EditorSelection
                     value: Array<PortableTextBlock> | undefined
                   },
-                  {
-                    type: 'decorator.toggle'
-                    decorator: string
-                  },
+                  | CustomBehaviorEvent
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    },
                   | {
                       type: 'annotation.add'
                       annotation: {
@@ -5198,7 +5515,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -5214,10 +5531,20 @@ export declare const editorMachine: StateMachine<
                         | SyntheticBehaviorEvent
                         | NativeBehaviorEvent
                       editor: PortableTextSlateEditor
+                      defaultActionCallback?: () => void
+                      nativeEvent?: {
+                        preventDefault: () => void
+                      }
+                    }
+                  | {
+                      type: 'custom behavior event'
+                      behaviorEvent: CustomBehaviorEvent
+                      editor: PortableTextSlateEditor
                       nativeEvent?: {
                         preventDefault: () => void
                       }
                     }
+                  | CustomBehaviorEvent
                   | {
                       type: 'add behavior'
                       behavior: Behavior
@@ -5287,6 +5614,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -5346,7 +5677,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -5398,14 +5729,18 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
-              readonly 'focus': {
+              readonly 'decorator.*': {
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -5413,7 +5748,8 @@ export declare const editorMachine: StateMachine<
                     value: Array<PortableTextBlock> | undefined
                   },
                   {
-                    type: 'focus'
+                    type: 'decorator.toggle'
+                    decorator: string
                   },
                   | {
                       type: 'annotation.add'
@@ -5468,7 +5804,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -5484,10 +5820,20 @@ export declare const editorMachine: StateMachine<
                         | SyntheticBehaviorEvent
                         | NativeBehaviorEvent
                       editor: PortableTextSlateEditor
+                      defaultActionCallback?: () => void
+                      nativeEvent?: {
+                        preventDefault: () => void
+                      }
+                    }
+                  | {
+                      type: 'custom behavior event'
+                      behaviorEvent: CustomBehaviorEvent
+                      editor: PortableTextSlateEditor
                       nativeEvent?: {
                         preventDefault: () => void
                       }
                     }
+                  | CustomBehaviorEvent
                   | {
                       type: 'add behavior'
                       behavior: Behavior
@@ -5557,6 +5903,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -5616,7 +5966,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -5668,39 +6018,27 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
-              readonly 'insert.*': {
+              readonly 'focus': {
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
                     selection: EditorSelection
                     value: Array<PortableTextBlock> | undefined
                   },
-                  | {
-                      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: 'focus'
+                  },
                   | {
                       type: 'annotation.add'
                       annotation: {
@@ -5754,7 +6092,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -5770,16 +6108,26 @@ export declare const editorMachine: StateMachine<
                         | SyntheticBehaviorEvent
                         | NativeBehaviorEvent
                       editor: PortableTextSlateEditor
+                      defaultActionCallback?: () => void
                       nativeEvent?: {
                         preventDefault: () => void
                       }
                     }
                   | {
-                      type: 'add behavior'
-                      behavior: Behavior
-                    }
-                  | {
-                      type: 'remove behavior'
+                      type: 'custom behavior event'
+                      behaviorEvent: CustomBehaviorEvent
+                      editor: PortableTextSlateEditor
+                      nativeEvent?: {
+                        preventDefault: () => void
+                      }
+                    }
+                  | CustomBehaviorEvent
+                  | {
+                      type: 'add behavior'
+                      behavior: Behavior
+                    }
+                  | {
+                      type: 'remove behavior'
                       behavior: Behavior
                     }
                   | {
@@ -5843,6 +6191,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -5902,7 +6254,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -5954,6 +6306,314 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
+                >
+              }
+              readonly 'insert.*': {
+                readonly actions: ActionFunction<
+                  {
+                    behaviors: Set<Behavior>
+                    keyGenerator: () => string
+                    pendingEvents: Array<PatchEvent | MutationEvent>
+                    schema: EditorSchema
+                    initialReadOnly: boolean
+                    maxBlocks: number | undefined
+                    selection: EditorSelection
+                    value: Array<PortableTextBlock> | undefined
+                  },
+                  | {
+                      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: 'annotation.add'
+                      annotation: {
+                        name: string
+                        value: {
+                          [prop: string]: unknown
+                        }
+                      }
+                    }
+                  | {
+                      type: 'annotation.remove'
+                      annotation: {
+                        name: string
+                      }
+                    }
+                  | {
+                      type: 'blur'
+                    }
+                  | {
+                      type: 'decorator.toggle'
+                      decorator: string
+                    }
+                  | {
+                      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: 'list item.toggle'
+                      listItem: string
+                    }
+                  | {
+                      type: 'style.toggle'
+                      style: string
+                    }
+                  | PatchEvent
+                  | MutationEvent
+                  | {
+                      type: 'normalizing'
+                    }
+                  | {
+                      type: 'done normalizing'
+                    }
+                  | {
+                      type: 'done syncing initial value'
+                    }
+                  | {
+                      type: 'behavior event'
+                      behaviorEvent:
+                        | SyntheticBehaviorEvent
+                        | NativeBehaviorEvent
+                      editor: PortableTextSlateEditor
+                      defaultActionCallback?: () => void
+                      nativeEvent?: {
+                        preventDefault: () => void
+                      }
+                    }
+                  | {
+                      type: 'custom behavior event'
+                      behaviorEvent: CustomBehaviorEvent
+                      editor: PortableTextSlateEditor
+                      nativeEvent?: {
+                        preventDefault: () => void
+                      }
+                    }
+                  | CustomBehaviorEvent
+                  | {
+                      type: 'add behavior'
+                      behavior: Behavior
+                    }
+                  | {
+                      type: 'remove behavior'
+                      behavior: Behavior
+                    }
+                  | {
+                      type: 'update readOnly'
+                      readOnly: boolean
+                    }
+                  | {
+                      type: 'update schema'
+                      schema: EditorSchema
+                    }
+                  | {
+                      type: 'update behaviors'
+                      behaviors: Array<Behavior>
+                    }
+                  | {
+                      type: 'update value'
+                      value: Array<PortableTextBlock> | undefined
+                    }
+                  | {
+                      type: 'update maxBlocks'
+                      maxBlocks: number | undefined
+                    }
+                  | PatchesEvent
+                  | {
+                      type: 'unset'
+                      previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'value changed'
+                      value: Array<PortableTextBlock> | undefined
+                    }
+                  | {
+                      type: 'invalid value'
+                      resolution: InvalidValueResolution | null
+                      value: Array<PortableTextBlock> | undefined
+                    }
+                  | {
+                      type: 'error'
+                      name: string
+                      description: string
+                      data: unknown
+                    }
+                  | {
+                      type: 'select'
+                      selection: EditorSelection
+                    }
+                  | {
+                      type: 'selection'
+                      selection: EditorSelection
+                    }
+                  | {
+                      type: 'blurred'
+                      event: FocusEvent_2<HTMLDivElement, Element>
+                    }
+                  | {
+                      type: 'focused'
+                      event: FocusEvent_2<HTMLDivElement, Element>
+                    }
+                  | {
+                      type: 'loading'
+                    }
+                  | {
+                      type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    },
+                  undefined,
+                  never,
+                  never,
+                  never,
+                  never,
+                  | {
+                      type: 'annotation.add'
+                      annotation: {
+                        name: string
+                        value: {
+                          [prop: string]: unknown
+                        }
+                      }
+                    }
+                  | {
+                      type: 'annotation.remove'
+                      annotation: {
+                        name: string
+                      }
+                    }
+                  | {
+                      type: 'blur'
+                    }
+                  | {
+                      type: 'decorator.toggle'
+                      decorator: string
+                    }
+                  | {
+                      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: 'list item.toggle'
+                      listItem: string
+                    }
+                  | {
+                      type: 'style.toggle'
+                      style: string
+                    }
+                  | PatchEvent
+                  | MutationEvent
+                  | {
+                      type: 'ready'
+                    }
+                  | PatchesEvent
+                  | {
+                      type: 'unset'
+                      previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'value changed'
+                      value: Array<PortableTextBlock> | undefined
+                    }
+                  | {
+                      type: 'invalid value'
+                      resolution: InvalidValueResolution | null
+                      value: Array<PortableTextBlock> | undefined
+                    }
+                  | {
+                      type: 'error'
+                      name: string
+                      description: string
+                      data: unknown
+                    }
+                  | {
+                      type: 'select'
+                      selection: EditorSelection
+                    }
+                  | {
+                      type: 'selection'
+                      selection: EditorSelection
+                    }
+                  | {
+                      type: 'blurred'
+                      event: FocusEvent_2<HTMLDivElement, Element>
+                    }
+                  | {
+                      type: 'focused'
+                      event: FocusEvent_2<HTMLDivElement, Element>
+                    }
+                  | {
+                      type: 'loading'
+                    }
+                  | {
+                      type: 'done loading'
+                    }
+                  | {
+                      type: 'read only'
+                    }
+                  | {
+                      type: 'editable'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
               readonly 'list item.*': {
@@ -5961,7 +6621,7 @@ export declare const editorMachine: StateMachine<
                   {
                     behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -6025,7 +6685,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -6041,10 +6701,20 @@ export declare const editorMachine: StateMachine<
                         | SyntheticBehaviorEvent
                         | NativeBehaviorEvent
                       editor: PortableTextSlateEditor
+                      defaultActionCallback?: () => void
                       nativeEvent?: {
                         preventDefault: () => void
                       }
                     }
+                  | {
+                      type: 'custom behavior event'
+                      behaviorEvent: CustomBehaviorEvent
+                      editor: PortableTextSlateEditor
+                      nativeEvent?: {
+                        preventDefault: () => void
+                      }
+                    }
+                  | CustomBehaviorEvent
                   | {
                       type: 'add behavior'
                       behavior: Behavior
@@ -6114,6 +6784,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -6173,7 +6847,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -6225,6 +6899,10 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
               readonly 'select': {
@@ -6232,7 +6910,7 @@ export declare const editorMachine: StateMachine<
                   {
                     behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -6296,7 +6974,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -6312,10 +6990,20 @@ export declare const editorMachine: StateMachine<
                         | SyntheticBehaviorEvent
                         | NativeBehaviorEvent
                       editor: PortableTextSlateEditor
+                      defaultActionCallback?: () => void
                       nativeEvent?: {
                         preventDefault: () => void
                       }
                     }
+                  | {
+                      type: 'custom behavior event'
+                      behaviorEvent: CustomBehaviorEvent
+                      editor: PortableTextSlateEditor
+                      nativeEvent?: {
+                        preventDefault: () => void
+                      }
+                    }
+                  | CustomBehaviorEvent
                   | {
                       type: 'add behavior'
                       behavior: Behavior
@@ -6385,6 +7073,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -6444,7 +7136,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -6496,6 +7188,10 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
               readonly 'style.*': {
@@ -6503,7 +7199,7 @@ export declare const editorMachine: StateMachine<
                   {
                     behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -6567,7 +7263,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -6583,10 +7279,20 @@ export declare const editorMachine: StateMachine<
                         | SyntheticBehaviorEvent
                         | NativeBehaviorEvent
                       editor: PortableTextSlateEditor
+                      defaultActionCallback?: () => void
                       nativeEvent?: {
                         preventDefault: () => void
                       }
                     }
+                  | {
+                      type: 'custom behavior event'
+                      behaviorEvent: CustomBehaviorEvent
+                      editor: PortableTextSlateEditor
+                      nativeEvent?: {
+                        preventDefault: () => void
+                      }
+                    }
+                  | CustomBehaviorEvent
                   | {
                       type: 'add behavior'
                       behavior: Behavior
@@ -6656,6 +7362,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -6715,7 +7425,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -6767,6 +7477,10 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
             }
@@ -6948,7 +7662,7 @@ export declare type InternalEditorEmittedEvent =
     }
   | PatchEvent
   | PatchesEvent
-  | MutationEvent_2
+  | MutationEvent
   | {
       type: 'unset'
       previousValue: Array<PortableTextBlock>
@@ -7009,6 +7723,10 @@ export declare type InternalEditorEmittedEvent =
       | 'focus'
       | 'style.toggle'
     >
+  | {
+      type: 'custom.*'
+      event: CustomBehaviorEvent
+    }
 
 /**
  * @internal
@@ -7027,10 +7745,20 @@ export declare type InternalEditorEvent =
       type: 'behavior event'
       behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
       editor: PortableTextSlateEditor
+      defaultActionCallback?: () => void
+      nativeEvent?: {
+        preventDefault: () => void
+      }
+    }
+  | {
+      type: 'custom behavior event'
+      behaviorEvent: CustomBehaviorEvent
+      editor: PortableTextSlateEditor
       nativeEvent?: {
         preventDefault: () => void
       }
     }
+  | CustomBehaviorEvent
   | {
       type: 'add behavior'
       behavior: Behavior
@@ -7123,7 +7851,7 @@ export declare type MutationChange = {
 /**
  * @internal
  */
-declare type MutationEvent_2 = {
+export declare type MutationEvent = {
   type: 'mutation'
   patches: Array<Patch>
   /**
@@ -7132,7 +7860,6 @@ declare type MutationEvent_2 = {
   snapshot: Array<PortableTextBlock> | undefined
   value: Array<PortableTextBlock> | undefined
 }
-export {MutationEvent_2 as MutationEvent}
 
 /**
  * @beta
@@ -7345,9 +8072,9 @@ export declare class PortableTextEditor extends Component<
     path: Path,
   ) => [
     (
-      | PortableTextTextBlock<PortableTextObject | PortableTextSpan>
-      | PortableTextObject
       | PortableTextSpan
+      | PortableTextObject
+      | PortableTextTextBlock<PortableTextSpan | PortableTextObject>
       | undefined
     ),
     Path | undefined,
@@ -7543,6 +8270,8 @@ export declare interface PortableTextSlateEditor extends ReactEditor {
   redo: () => void
 }
 
+export {PortableTextSpan}
+
 /**
  * A range decoration is a UI affordance that wraps a given selection range in the editor
  * with a custom component. This can be used to highlight search results,