@portabletext/editor 1.19.0 → 1.21.0

package/lib/index.d.cts

@@ -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
  */
@@ -469,6 +476,10 @@ export declare interface EditableAPIDeleteOptions {
  */
 export declare type Editor = {
   getSnapshot: () => EditorSnapshot
+  /**
+   * @beta
+   */
+  registerBehavior: (config: {behavior: Behavior}) => () => void
   send: (event: EditorEvent) => void
   on: ActorRef<Snapshot<unknown>, EventObject, EditorEmittedEvent>['on']
   _internal: {
@@ -568,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
@@ -599,9 +612,9 @@ export declare function EditorEventListener(props: {
  */
 export declare const editorMachine: StateMachine<
   {
-    behaviors: Array<Behavior>
+    behaviors: Set<Behavior>
     keyGenerator: () => string
-    pendingEvents: Array<PatchEvent | MutationEvent_2>
+    pendingEvents: Array<PatchEvent | MutationEvent>
     schema: EditorSchema
     initialReadOnly: boolean
     maxBlocks: number | undefined
@@ -661,7 +674,7 @@ export declare const editorMachine: StateMachine<
       style: string
     }
   | PatchEvent
-  | MutationEvent_2
+  | MutationEvent
   | {
       type: 'normalizing'
     }
@@ -679,6 +692,23 @@ export declare const editorMachine: StateMachine<
         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
@@ -740,10 +770,22 @@ export declare const editorMachine: StateMachine<
     }
   | {
       type: 'done loading'
+    }
+  | {
+      type: 'custom.*'
+      event: CustomBehaviorEvent
     },
   {},
   never,
   Values<{
+    'add behavior to context': {
+      type: 'add behavior to context'
+      params: NonReducibleUnknown
+    }
+    'remove behavior from context': {
+      type: 'remove behavior from context'
+      params: NonReducibleUnknown
+    }
     'assign behaviors': {
       type: 'assign behaviors'
       params: NonReducibleUnknown
@@ -867,7 +909,7 @@ export declare const editorMachine: StateMachine<
       style: string
     }
   | PatchEvent
-  | MutationEvent_2
+  | MutationEvent
   | {
       type: 'ready'
     }
@@ -918,6 +960,10 @@ export declare const editorMachine: StateMachine<
     }
   | {
       type: 'editable'
+    }
+  | {
+      type: 'custom.*'
+      event: CustomBehaviorEvent
     },
   MetaObject,
   {
@@ -958,9 +1004,9 @@ export declare const editorMachine: StateMachine<
       self: ActorRef<
         MachineSnapshot<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -1020,7 +1066,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -1038,6 +1084,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -1099,6 +1162,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           Record<string, AnyActorRef | undefined>,
           StateValue,
@@ -1160,7 +1227,7 @@ export declare const editorMachine: StateMachine<
             style: string
           }
         | PatchEvent
-        | MutationEvent_2
+        | MutationEvent
         | {
             type: 'normalizing'
           }
@@ -1178,6 +1245,23 @@ export declare const editorMachine: StateMachine<
               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
@@ -1239,26 +1323,36 @@ export declare const editorMachine: StateMachine<
           }
         | {
             type: 'done loading'
+          }
+        | {
+            type: 'custom.*'
+            event: CustomBehaviorEvent
           },
         AnyEventObject
       >
     }) => {
-      behaviors: Behavior[]
+      behaviors: Set<Behavior>
       keyGenerator: () => string
       pendingEvents: never[]
-      schema: PortableTextMemberSchemaTypes
+      schema: PortableTextMemberSchemaTypes_2
       selection: null
       initialReadOnly: boolean
       maxBlocks: number | undefined
       value: PortableTextBlock[] | undefined
     }
     readonly on: {
+      readonly 'add behavior': {
+        readonly actions: 'add behavior to context'
+      }
+      readonly 'remove behavior': {
+        readonly actions: 'remove behavior from context'
+      }
       readonly 'unset': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -1322,7 +1416,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -1340,6 +1434,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -1401,6 +1512,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -1460,7 +1575,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -1512,14 +1627,18 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'value changed': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -1583,7 +1702,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -1601,6 +1720,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -1662,6 +1798,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -1721,7 +1861,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -1773,14 +1913,18 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'invalid value': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -1845,7 +1989,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -1863,6 +2007,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -1924,6 +2085,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -1983,7 +2148,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -2035,14 +2200,18 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'error': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -2108,7 +2277,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -2126,6 +2295,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -2187,6 +2373,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -2246,7 +2436,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -2298,15 +2488,19 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'selection': {
         readonly actions: readonly [
           ActionFunction<
             {
-              behaviors: Array<Behavior>
+              behaviors: Set<Behavior>
               keyGenerator: () => string
-              pendingEvents: Array<PatchEvent | MutationEvent_2>
+              pendingEvents: Array<PatchEvent | MutationEvent>
               schema: EditorSchema
               initialReadOnly: boolean
               maxBlocks: number | undefined
@@ -2370,7 +2564,7 @@ export declare const editorMachine: StateMachine<
                 style: string
               }
             | PatchEvent
-            | MutationEvent_2
+            | MutationEvent
             | {
                 type: 'normalizing'
               }
@@ -2388,6 +2582,23 @@ export declare const editorMachine: StateMachine<
                   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
@@ -2449,6 +2660,10 @@ export declare const editorMachine: StateMachine<
               }
             | {
                 type: 'done loading'
+              }
+            | {
+                type: 'custom.*'
+                event: CustomBehaviorEvent
               },
             undefined,
             never,
@@ -2459,9 +2674,9 @@ export declare const editorMachine: StateMachine<
           >,
           ActionFunction<
             {
-              behaviors: Array<Behavior>
+              behaviors: Set<Behavior>
               keyGenerator: () => string
-              pendingEvents: Array<PatchEvent | MutationEvent_2>
+              pendingEvents: Array<PatchEvent | MutationEvent>
               schema: EditorSchema
               initialReadOnly: boolean
               maxBlocks: number | undefined
@@ -2525,7 +2740,7 @@ export declare const editorMachine: StateMachine<
                 style: string
               }
             | PatchEvent
-            | MutationEvent_2
+            | MutationEvent
             | {
                 type: 'normalizing'
               }
@@ -2543,6 +2758,23 @@ export declare const editorMachine: StateMachine<
                   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
@@ -2604,6 +2836,10 @@ export declare const editorMachine: StateMachine<
               }
             | {
                 type: 'done loading'
+              }
+            | {
+                type: 'custom.*'
+                event: CustomBehaviorEvent
               },
             undefined,
             never,
@@ -2663,7 +2899,7 @@ export declare const editorMachine: StateMachine<
                 style: string
               }
             | PatchEvent
-            | MutationEvent_2
+            | MutationEvent
             | {
                 type: 'ready'
               }
@@ -2715,15 +2951,19 @@ export declare const editorMachine: StateMachine<
             | {
                 type: 'editable'
               }
+            | {
+                type: 'custom.*'
+                event: CustomBehaviorEvent
+              }
           >,
         ]
       }
       readonly 'blurred': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -2787,7 +3027,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -2805,6 +3045,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -2866,6 +3123,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -2925,7 +3186,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -2977,14 +3238,18 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'focused': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -3048,7 +3313,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -3066,6 +3331,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -3127,6 +3409,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -3186,7 +3472,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -3238,14 +3524,18 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'loading': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -3308,7 +3598,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -3326,6 +3616,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -3387,6 +3694,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -3446,7 +3757,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -3498,14 +3809,18 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'patches': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -3566,7 +3881,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -3584,6 +3899,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -3645,6 +3977,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -3704,7 +4040,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -3756,14 +4092,18 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'done loading': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -3826,7 +4166,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -3844,6 +4184,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -3905,6 +4262,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -3964,7 +4325,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'ready'
             }
@@ -4016,6 +4377,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'editable'
             }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
+            }
         >
       }
       readonly 'update behaviors': {
@@ -4027,9 +4392,9 @@ export declare const editorMachine: StateMachine<
       readonly 'update value': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -4093,7 +4458,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -4111,6 +4476,23 @@ export declare const editorMachine: StateMachine<
                 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
@@ -4172,6 +4554,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -4184,9 +4570,9 @@ export declare const editorMachine: StateMachine<
       readonly 'update maxBlocks': {
         readonly actions: ActionFunction<
           {
-            behaviors: Array<Behavior>
+            behaviors: Set<Behavior>
             keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
             initialReadOnly: boolean
             maxBlocks: number | undefined
@@ -4250,7 +4636,7 @@ export declare const editorMachine: StateMachine<
               style: string
             }
           | PatchEvent
-          | MutationEvent_2
+          | MutationEvent
           | {
               type: 'normalizing'
             }
@@ -4269,12 +4655,29 @@ export declare const editorMachine: StateMachine<
               }
             }
           | {
-              type: 'update readOnly'
-              readOnly: boolean
+              type: 'custom behavior event'
+              behaviorEvent: CustomBehaviorEvent
+              editor: PortableTextSlateEditor
+              nativeEvent?: {
+                preventDefault: () => void
+              }
             }
+          | CustomBehaviorEvent
           | {
-              type: 'update schema'
-              schema: EditorSchema
+              type: 'add behavior'
+              behavior: Behavior
+            }
+          | {
+              type: 'remove behavior'
+              behavior: Behavior
+            }
+          | {
+              type: 'update readOnly'
+              readOnly: boolean
+            }
+          | {
+              type: 'update schema'
+              schema: EditorSchema
             }
           | {
               type: 'update behaviors'
@@ -4329,6 +4732,10 @@ export declare const editorMachine: StateMachine<
             }
           | {
               type: 'done loading'
+            }
+          | {
+              type: 'custom.*'
+              event: CustomBehaviorEvent
             },
           undefined,
           never,
@@ -4356,9 +4763,9 @@ export declare const editorMachine: StateMachine<
                         context,
                       }: GuardArgs<
                         {
-                          behaviors: Array<Behavior>
+                          behaviors: Set<Behavior>
                           keyGenerator: () => string
-                          pendingEvents: Array<PatchEvent | MutationEvent_2>
+                          pendingEvents: Array<PatchEvent | MutationEvent>
                           schema: EditorSchema
                           initialReadOnly: boolean
                           maxBlocks: number | undefined
@@ -4383,9 +4790,9 @@ export declare const editorMachine: StateMachine<
                       event,
                     }: GuardArgs<
                       {
-                        behaviors: Array<Behavior>
+                        behaviors: Set<Behavior>
                         keyGenerator: () => string
-                        pendingEvents: Array<PatchEvent | MutationEvent_2>
+                        pendingEvents: Array<PatchEvent | MutationEvent>
                         schema: EditorSchema
                         initialReadOnly: boolean
                         maxBlocks: number | undefined
@@ -4411,9 +4818,9 @@ export declare const editorMachine: StateMachine<
                   event,
                 }: GuardArgs<
                   {
-                    behaviors: Array<Behavior>
+                    behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -4431,12 +4838,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: Array<Behavior>
+                    behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -4511,7 +4921,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -4531,6 +4941,23 @@ export declare const editorMachine: StateMachine<
                         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
@@ -4592,6 +5019,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -4651,7 +5082,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -4703,14 +5134,18 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
               readonly 'blur': {
                 readonly actions: ActionFunction<
                   {
-                    behaviors: Array<Behavior>
+                    behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -4773,7 +5208,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -4793,6 +5228,23 @@ export declare const editorMachine: StateMachine<
                         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
@@ -4854,6 +5306,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -4913,7 +5369,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -4965,14 +5421,307 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
+                >
+              }
+              readonly 'custom.*': {
+                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
+                  },
+                  | CustomBehaviorEvent
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    },
+                  | {
+                      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
+                      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 'decorator.*': {
                 readonly actions: ActionFunction<
                   {
-                    behaviors: Array<Behavior>
+                    behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -5036,7 +5785,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -5056,6 +5805,23 @@ export declare const editorMachine: StateMachine<
                         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
@@ -5117,6 +5883,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -5176,7 +5946,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -5228,14 +5998,18 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
               readonly 'focus': {
                 readonly actions: ActionFunction<
                   {
-                    behaviors: Array<Behavior>
+                    behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -5298,7 +6072,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -5318,6 +6092,23 @@ export declare const editorMachine: StateMachine<
                         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
@@ -5379,6 +6170,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -5438,7 +6233,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -5490,14 +6285,18 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
               readonly 'insert.*': {
                 readonly actions: ActionFunction<
                   {
-                    behaviors: Array<Behavior>
+                    behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -5576,7 +6375,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -5596,6 +6395,23 @@ export declare const editorMachine: StateMachine<
                         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
@@ -5657,6 +6473,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -5716,7 +6536,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -5768,14 +6588,18 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
               readonly 'list item.*': {
                 readonly actions: ActionFunction<
                   {
-                    behaviors: Array<Behavior>
+                    behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -5839,7 +6663,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -5859,6 +6683,23 @@ export declare const editorMachine: StateMachine<
                         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
@@ -5920,6 +6761,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -5979,7 +6824,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -6031,14 +6876,18 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
               readonly 'select': {
                 readonly actions: ActionFunction<
                   {
-                    behaviors: Array<Behavior>
+                    behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -6102,7 +6951,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -6122,6 +6971,23 @@ export declare const editorMachine: StateMachine<
                         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
@@ -6183,6 +7049,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -6242,7 +7112,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -6294,14 +7164,18 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
               readonly 'style.*': {
                 readonly actions: ActionFunction<
                   {
-                    behaviors: Array<Behavior>
+                    behaviors: Set<Behavior>
                     keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
                     initialReadOnly: boolean
                     maxBlocks: number | undefined
@@ -6365,7 +7239,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'normalizing'
                     }
@@ -6385,6 +7259,23 @@ export declare const editorMachine: StateMachine<
                         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
@@ -6446,6 +7337,10 @@ export declare const editorMachine: StateMachine<
                     }
                   | {
                       type: 'done loading'
+                    }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
                     },
                   undefined,
                   never,
@@ -6505,7 +7400,7 @@ export declare const editorMachine: StateMachine<
                       style: string
                     }
                   | PatchEvent
-                  | MutationEvent_2
+                  | MutationEvent
                   | {
                       type: 'ready'
                     }
@@ -6557,6 +7452,10 @@ export declare const editorMachine: StateMachine<
                   | {
                       type: 'editable'
                     }
+                  | {
+                      type: 'custom.*'
+                      event: CustomBehaviorEvent
+                    }
                 >
               }
             }
@@ -6738,7 +7637,7 @@ export declare type InternalEditorEmittedEvent =
     }
   | PatchEvent
   | PatchesEvent
-  | MutationEvent_2
+  | MutationEvent
   | {
       type: 'unset'
       previousValue: Array<PortableTextBlock>
@@ -6799,6 +7698,10 @@ export declare type InternalEditorEmittedEvent =
       | 'focus'
       | 'style.toggle'
     >
+  | {
+      type: 'custom.*'
+      event: CustomBehaviorEvent
+    }
 
 /**
  * @internal
@@ -6821,6 +7724,23 @@ export declare type InternalEditorEvent =
         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
@@ -6905,7 +7825,7 @@ export declare type MutationChange = {
 /**
  * @internal
  */
-declare type MutationEvent_2 = {
+export declare type MutationEvent = {
   type: 'mutation'
   patches: Array<Patch>
   /**
@@ -6914,7 +7834,6 @@ declare type MutationEvent_2 = {
   snapshot: Array<PortableTextBlock> | undefined
   value: Array<PortableTextBlock> | undefined
 }
-export {MutationEvent_2 as MutationEvent}
 
 /**
  * @beta
@@ -7127,9 +8046,9 @@ export declare class PortableTextEditor extends Component<
     path: Path,
   ) => [
     (
-      | PortableTextTextBlock<PortableTextObject | PortableTextSpan>
-      | PortableTextObject
       | PortableTextSpan
+      | PortableTextObject
+      | PortableTextTextBlock<PortableTextSpan | PortableTextObject>
       | undefined
     ),
     Path | undefined,
@@ -7325,6 +8244,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,