@portabletext/editor 1.22.0 → 1.24.0

package/lib/index.d.cts

@@ -98,7 +98,11 @@ export declare type BaseDefinition = {
 export declare type Behavior<
   TBehaviorEventType extends BehaviorEvent['type'] = BehaviorEvent['type'],
   TGuardResponse = true,
-  TBehaviorEvent extends BehaviorEvent = BehaviorEvent,
+  TBehaviorEvent extends BehaviorEvent = PickFromUnion<
+    BehaviorEvent,
+    'type',
+    TBehaviorEventType
+  >,
 > = {
   /**
    * The internal editor event that triggers this behavior.
@@ -364,6 +368,43 @@ export declare type ConnectionChange = {
   value: 'online' | 'offline'
 }
 
+declare type Converter<TMIMEType extends MIMEType = MIMEType> = {
+  mimeType: TMIMEType
+  serialize: Serializer<TMIMEType>
+  deserialize: Deserializer<TMIMEType>
+}
+
+declare type ConverterEvent<TMIMEType extends MIMEType = MIMEType> =
+  | {
+      type: 'serialize'
+      originEvent: 'copy' | 'cut' | 'unknown'
+    }
+  | {
+      type: 'serialization.failure'
+      mimeType: TMIMEType
+      reason: string
+    }
+  | {
+      type: 'serialization.success'
+      data: string
+      mimeType: TMIMEType
+      originEvent: 'copy' | 'cut' | 'unknown'
+    }
+  | {
+      type: 'deserialize'
+      data: string
+    }
+  | {
+      type: 'deserialization.failure'
+      mimeType: TMIMEType
+      reason: string
+    }
+  | {
+      type: 'deserialization.success'
+      data: Array<PortableTextBlock>
+      mimeType: TMIMEType
+    }
+
 /**
  * @beta
  */
@@ -402,6 +443,18 @@ export declare function defineSchema<
   const TSchemaDefinition extends SchemaDefinition,
 >(definition: TSchemaDefinition): TSchemaDefinition
 
+declare type Deserializer<TMIMEType extends MIMEType> = ({
+  context,
+  event,
+}: {
+  context: EditorContext
+  event: PickFromUnion<ConverterEvent<TMIMEType>, 'type', 'deserialize'>
+}) => PickFromUnion<
+  ConverterEvent<TMIMEType>,
+  'type',
+  'deserialization.success' | 'deserialization.failure'
+>
+
 /** @beta */
 export declare interface EditableAPI {
   activeAnnotations: () => PortableTextObject[]
@@ -569,6 +622,7 @@ export declare type EditorConfig = {
  */
 export declare type EditorContext = {
   activeDecorators: Array<string>
+  converters: Array<Converter>
   keyGenerator: () => string
   schema: EditorSchema
   selection: EditorSelection
@@ -615,6 +669,7 @@ export declare type EditorEvent =
       | 'style.toggle'
       | 'patches'
       | 'update behaviors'
+      | 'update key generator'
       | 'update readOnly'
       | 'update value'
     >
@@ -678,6 +733,7 @@ export declare function EditorEventListener(props: {
 export declare const editorMachine: StateMachine<
   {
     behaviors: Set<Behavior>
+    converters: Set<Converter>
     keyGenerator: () => string
     pendingEvents: Array<PatchEvent | MutationEvent>
     schema: EditorSchema
@@ -787,6 +843,10 @@ export declare const editorMachine: StateMachine<
       type: 'update behaviors'
       behaviors: Array<Behavior>
     }
+  | {
+      type: 'update key generator'
+      keyGenerator: () => string
+    }
   | {
       type: 'update value'
       value: Array<PortableTextBlock> | undefined
@@ -915,6 +975,7 @@ export declare const editorMachine: StateMachine<
   string,
   {
     behaviors?: Array<Behavior>
+    converters?: Array<Converter>
     keyGenerator: () => string
     maxBlocks?: number
     readOnly?: boolean
@@ -1061,6 +1122,7 @@ export declare const editorMachine: StateMachine<
       }
       input: {
         behaviors?: Array<Behavior>
+        converters?: Array<Converter>
         keyGenerator: () => string
         maxBlocks?: number
         readOnly?: boolean
@@ -1071,6 +1133,7 @@ export declare const editorMachine: StateMachine<
         MachineSnapshot<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -1180,6 +1243,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -1342,6 +1409,10 @@ export declare const editorMachine: StateMachine<
             type: 'update behaviors'
             behaviors: Array<Behavior>
           }
+        | {
+            type: 'update key generator'
+            keyGenerator: () => string
+          }
         | {
             type: 'update value'
             value: Array<PortableTextBlock> | undefined
@@ -1400,6 +1471,7 @@ export declare const editorMachine: StateMachine<
       >
     }) => {
       behaviors: Set<Behavior>
+      converters: Set<Converter>
       keyGenerator: () => string
       pendingEvents: never[]
       schema: PortableTextMemberSchemaTypes_2
@@ -1419,6 +1491,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -1532,6 +1605,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -1706,6 +1783,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -1819,6 +1897,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -1993,6 +2075,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -2107,6 +2190,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -2281,6 +2368,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -2396,6 +2484,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -2571,6 +2663,7 @@ export declare const editorMachine: StateMachine<
           ActionFunction<
             {
               behaviors: Set<Behavior>
+              converters: Set<Converter>
               keyGenerator: () => string
               pendingEvents: Array<PatchEvent | MutationEvent>
               schema: EditorSchema
@@ -2684,6 +2777,10 @@ export declare const editorMachine: StateMachine<
                 type: 'update behaviors'
                 behaviors: Array<Behavior>
               }
+            | {
+                type: 'update key generator'
+                keyGenerator: () => string
+              }
             | {
                 type: 'update value'
                 value: Array<PortableTextBlock> | undefined
@@ -2748,6 +2845,7 @@ export declare const editorMachine: StateMachine<
           ActionFunction<
             {
               behaviors: Set<Behavior>
+              converters: Set<Converter>
               keyGenerator: () => string
               pendingEvents: Array<PatchEvent | MutationEvent>
               schema: EditorSchema
@@ -2861,6 +2959,10 @@ export declare const editorMachine: StateMachine<
                 type: 'update behaviors'
                 behaviors: Array<Behavior>
               }
+            | {
+                type: 'update key generator'
+                keyGenerator: () => string
+              }
             | {
                 type: 'update value'
                 value: Array<PortableTextBlock> | undefined
@@ -3036,6 +3138,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -3149,6 +3252,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -3323,6 +3430,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -3436,6 +3544,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -3610,6 +3722,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -3722,6 +3835,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -3896,6 +4013,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -4006,6 +4124,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -4180,6 +4302,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -4292,6 +4415,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -4465,6 +4592,190 @@ export declare const editorMachine: StateMachine<
       readonly 'update behaviors': {
         readonly actions: 'assign behaviors'
       }
+      readonly 'update key generator': {
+        readonly actions: ActionFunction<
+          {
+            behaviors: Set<Behavior>
+            converters: Set<Converter>
+            keyGenerator: () => string
+            pendingEvents: Array<PatchEvent | MutationEvent>
+            schema: EditorSchema
+            initialReadOnly: boolean
+            maxBlocks: number | undefined
+            selection: EditorSelection
+            value: Array<PortableTextBlock> | undefined
+          },
+          {
+            type: 'update key generator'
+            keyGenerator: () => string
+          },
+          | {
+              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 key generator'
+              keyGenerator: () => string
+            }
+          | {
+              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,
+          never
+        >
+      }
       readonly 'update schema': {
         readonly actions: 'assign schema'
       }
@@ -4472,6 +4783,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -4585,6 +4897,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -4651,6 +4967,7 @@ export declare const editorMachine: StateMachine<
         readonly actions: ActionFunction<
           {
             behaviors: Set<Behavior>
+            converters: Set<Converter>
             keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent>
             schema: EditorSchema
@@ -4764,6 +5081,10 @@ export declare const editorMachine: StateMachine<
               type: 'update behaviors'
               behaviors: Array<Behavior>
             }
+          | {
+              type: 'update key generator'
+              keyGenerator: () => string
+            }
           | {
               type: 'update value'
               value: Array<PortableTextBlock> | undefined
@@ -4845,6 +5166,7 @@ export declare const editorMachine: StateMachine<
                       }: GuardArgs<
                         {
                           behaviors: Set<Behavior>
+                          converters: Set<Converter>
                           keyGenerator: () => string
                           pendingEvents: Array<PatchEvent | MutationEvent>
                           schema: EditorSchema
@@ -4866,12 +5188,42 @@ export declare const editorMachine: StateMachine<
               }
               readonly 'read only': {
                 readonly on: {
+                  readonly 'behavior event': {
+                    readonly actions: 'handle behavior event'
+                    readonly guard: ({
+                      event,
+                    }: GuardArgs<
+                      {
+                        behaviors: Set<Behavior>
+                        converters: Set<Converter>
+                        keyGenerator: () => string
+                        pendingEvents: Array<PatchEvent | MutationEvent>
+                        schema: EditorSchema
+                        initialReadOnly: boolean
+                        maxBlocks: number | undefined
+                        selection: EditorSelection
+                        value: Array<PortableTextBlock> | undefined
+                      },
+                      {
+                        type: 'behavior event'
+                        behaviorEvent:
+                          | SyntheticBehaviorEvent
+                          | NativeBehaviorEvent
+                        editor: PortableTextSlateEditor
+                        defaultActionCallback?: () => void
+                        nativeEvent?: {
+                          preventDefault: () => void
+                        }
+                      }
+                    >) => boolean
+                  }
                   readonly 'update readOnly': {
                     readonly guard: ({
                       event,
                     }: GuardArgs<
                       {
                         behaviors: Set<Behavior>
+                        converters: Set<Converter>
                         keyGenerator: () => string
                         pendingEvents: Array<PatchEvent | MutationEvent>
                         schema: EditorSchema
@@ -4900,6 +5252,7 @@ export declare const editorMachine: StateMachine<
                 }: GuardArgs<
                   {
                     behaviors: Set<Behavior>
+                    converters: Set<Converter>
                     keyGenerator: () => string
                     pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
@@ -4926,6 +5279,7 @@ export declare const editorMachine: StateMachine<
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
+                    converters: Set<Converter>
                     keyGenerator: () => string
                     pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
@@ -5052,6 +5406,10 @@ export declare const editorMachine: StateMachine<
                       type: 'update behaviors'
                       behaviors: Array<Behavior>
                     }
+                  | {
+                      type: 'update key generator'
+                      keyGenerator: () => string
+                    }
                   | {
                       type: 'update value'
                       value: Array<PortableTextBlock> | undefined
@@ -5226,6 +5584,7 @@ export declare const editorMachine: StateMachine<
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
+                    converters: Set<Converter>
                     keyGenerator: () => string
                     pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
@@ -5340,6 +5699,10 @@ export declare const editorMachine: StateMachine<
                       type: 'update behaviors'
                       behaviors: Array<Behavior>
                     }
+                  | {
+                      type: 'update key generator'
+                      keyGenerator: () => string
+                    }
                   | {
                       type: 'update value'
                       value: Array<PortableTextBlock> | undefined
@@ -5514,6 +5877,7 @@ export declare const editorMachine: StateMachine<
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
+                    converters: Set<Converter>
                     keyGenerator: () => string
                     pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
@@ -5630,6 +5994,10 @@ export declare const editorMachine: StateMachine<
                       type: 'update behaviors'
                       behaviors: Array<Behavior>
                     }
+                  | {
+                      type: 'update key generator'
+                      keyGenerator: () => string
+                    }
                   | {
                       type: 'update value'
                       value: Array<PortableTextBlock> | undefined
@@ -5804,6 +6172,7 @@ export declare const editorMachine: StateMachine<
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
+                    converters: Set<Converter>
                     keyGenerator: () => string
                     pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
@@ -5919,6 +6288,10 @@ export declare const editorMachine: StateMachine<
                       type: 'update behaviors'
                       behaviors: Array<Behavior>
                     }
+                  | {
+                      type: 'update key generator'
+                      keyGenerator: () => string
+                    }
                   | {
                       type: 'update value'
                       value: Array<PortableTextBlock> | undefined
@@ -6093,6 +6466,7 @@ export declare const editorMachine: StateMachine<
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
+                    converters: Set<Converter>
                     keyGenerator: () => string
                     pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
@@ -6207,6 +6581,10 @@ export declare const editorMachine: StateMachine<
                       type: 'update behaviors'
                       behaviors: Array<Behavior>
                     }
+                  | {
+                      type: 'update key generator'
+                      keyGenerator: () => string
+                    }
                   | {
                       type: 'update value'
                       value: Array<PortableTextBlock> | undefined
@@ -6381,6 +6759,7 @@ export declare const editorMachine: StateMachine<
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
+                    converters: Set<Converter>
                     keyGenerator: () => string
                     pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
@@ -6511,6 +6890,10 @@ export declare const editorMachine: StateMachine<
                       type: 'update behaviors'
                       behaviors: Array<Behavior>
                     }
+                  | {
+                      type: 'update key generator'
+                      keyGenerator: () => string
+                    }
                   | {
                       type: 'update value'
                       value: Array<PortableTextBlock> | undefined
@@ -6685,6 +7068,7 @@ export declare const editorMachine: StateMachine<
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
+                    converters: Set<Converter>
                     keyGenerator: () => string
                     pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
@@ -6800,6 +7184,10 @@ export declare const editorMachine: StateMachine<
                       type: 'update behaviors'
                       behaviors: Array<Behavior>
                     }
+                  | {
+                      type: 'update key generator'
+                      keyGenerator: () => string
+                    }
                   | {
                       type: 'update value'
                       value: Array<PortableTextBlock> | undefined
@@ -6974,6 +7362,7 @@ export declare const editorMachine: StateMachine<
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
+                    converters: Set<Converter>
                     keyGenerator: () => string
                     pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
@@ -7089,6 +7478,10 @@ export declare const editorMachine: StateMachine<
                       type: 'update behaviors'
                       behaviors: Array<Behavior>
                     }
+                  | {
+                      type: 'update key generator'
+                      keyGenerator: () => string
+                    }
                   | {
                       type: 'update value'
                       value: Array<PortableTextBlock> | undefined
@@ -7263,6 +7656,7 @@ export declare const editorMachine: StateMachine<
                 readonly actions: ActionFunction<
                   {
                     behaviors: Set<Behavior>
+                    converters: Set<Converter>
                     keyGenerator: () => string
                     pendingEvents: Array<PatchEvent | MutationEvent>
                     schema: EditorSchema
@@ -7378,6 +7772,10 @@ export declare const editorMachine: StateMachine<
                       type: 'update behaviors'
                       behaviors: Array<Behavior>
                     }
+                  | {
+                      type: 'update key generator'
+                      keyGenerator: () => string
+                    }
                   | {
                       type: 'update value'
                       value: Array<PortableTextBlock> | undefined
@@ -7859,6 +8257,10 @@ export declare type InternalEditorEvent =
       type: 'update behaviors'
       behaviors: Array<Behavior>
     }
+  | {
+      type: 'update key generator'
+      keyGenerator: () => string
+    }
   | {
       type: 'update value'
       value: Array<PortableTextBlock> | undefined
@@ -7919,6 +8321,8 @@ export declare type LoadingChange = {
   isLoading: boolean
 }
 
+declare type MIMEType = `${string}/${string}`
+
 /**
  * The editor has mutated it's content.
  * @beta */
@@ -7949,6 +8353,10 @@ export declare type NativeBehaviorEvent =
       type: 'copy'
       data: DataTransfer
     }
+  | {
+      type: 'deserialize'
+      dataTransfer: DataTransfer
+    }
   | {
       type: 'key.down'
       keyboardEvent: Pick<
@@ -7967,6 +8375,11 @@ export declare type NativeBehaviorEvent =
       type: 'paste'
       data: DataTransfer
     }
+  | {
+      type: 'serialize'
+      originEvent: 'copy' | 'cut' | 'unknown'
+      dataTransfer: DataTransfer
+    }
 
 /**
  * @alpha
@@ -8494,6 +8907,18 @@ export declare type SelectionChange = {
   selection: EditorSelection
 }
 
+declare type Serializer<TMIMEType extends MIMEType> = ({
+  context,
+  event,
+}: {
+  context: EditorContext
+  event: PickFromUnion<ConverterEvent<TMIMEType>, 'type', 'serialize'>
+}) => PickFromUnion<
+  ConverterEvent<TMIMEType>,
+  'type',
+  'serialization.success' | 'serialization.failure'
+>
+
 /**
  * @internal
  */
@@ -8524,6 +8949,12 @@ export declare type SyntheticBehaviorEvent =
   | {
       type: 'blur'
     }
+  | {
+      type: 'data transfer.set'
+      data: string
+      dataTransfer: DataTransfer
+      mimeType: MIMEType
+    }
   | {
       type: 'decorator.toggle'
       decorator: string
@@ -8539,6 +8970,10 @@ export declare type SyntheticBehaviorEvent =
   | {
       type: 'focus'
     }
+  | {
+      type: 'insert.blocks'
+      blocks: Array<PortableTextBlock>
+    }
   | {
       type: 'insert.block object'
       placement: 'auto' | 'after' | 'before'
@@ -8581,6 +9016,16 @@ export declare type SyntheticBehaviorEvent =
       type: 'style.toggle'
       style: string
     }
+  | (PickFromUnion<
+      ConverterEvent,
+      'type',
+      | 'deserialization.failure'
+      | 'deserialization.success'
+      | 'serialization.failure'
+      | 'serialization.success'
+    > & {
+      dataTransfer: DataTransfer
+    })
 
 /**
  * The editor performed a undo history step