@portabletext/editor 1.17.0 → 1.18.0

package/lib/index.d.cts

@@ -43,7 +43,6 @@ import type {DOMNode} from 'slate-dom'
 import type {ReactEditor} from 'slate-react'
 import type {TextInsertTextOptions} from 'slate/dist/interfaces/transforms/text'
 import {
-  ActionArgs,
   ActionFunction,
   ActorRef,
   ActorRefFrom,
@@ -82,7 +81,7 @@ export declare type AddedAnnotationPaths = {
 }
 
 /**
- * @alpha
+ * @public
  */
 export declare type BaseDefinition = {
   name: string
@@ -91,7 +90,7 @@ export declare type BaseDefinition = {
 }
 
 /**
- * @alpha
+ * @beta
  */
 export declare type Behavior<
   TBehaviorEventType extends BehaviorEvent['type'] = BehaviorEvent['type'],
@@ -117,7 +116,7 @@ export declare type Behavior<
 }
 
 /**
- * @alpha
+ * @beta
  */
 export declare type BehaviorActionIntend =
   | SyntheticBehaviorEvent
@@ -211,7 +210,7 @@ export declare type BehaviorActionIntend =
     }
 
 /**
- * @alpha
+ * @beta
  */
 export declare type BehaviorActionIntendSet<
   TBehaviorEventType extends BehaviorEvent['type'] = BehaviorEvent['type'],
@@ -228,12 +227,12 @@ export declare type BehaviorActionIntendSet<
 ) => Array<BehaviorActionIntend>
 
 /**
- * @alpha
+ * @beta
  */
 export declare type BehaviorEvent = SyntheticBehaviorEvent | NativeBehaviorEvent
 
 /**
- * @alpha
+ * @beta
  */
 export declare type BehaviorGuard<
   TBehaviorEvent extends BehaviorEvent,
@@ -301,7 +300,7 @@ export declare interface BlockListItemRenderProps {
 }
 
 /**
- * @alpha
+ * @beta
  */
 export declare type BlockOffset = {
   path: [KeyedSegment]
@@ -354,7 +353,7 @@ export declare type ConnectionChange = {
 }
 
 /**
- * @alpha
+ * @public
  */
 export declare function defineSchema<
   const TSchemaDefinition extends SchemaDefinition,
@@ -450,9 +449,10 @@ export declare interface EditableAPIDeleteOptions {
 }
 
 /**
- * @alpha
+ * @public
  */
 export declare type Editor = {
+  getSnapshot: () => EditorSnapshot
   send: (event: EditorEvent) => void
   on: ActorRef<Snapshot<unknown>, EventObject, EditorEmittedEvent>['on']
   _internal: {
@@ -492,9 +492,12 @@ export declare type EditorChange =
 export declare type EditorChanges = Subject<EditorChange>
 
 /**
- * @alpha
+ * @public
  */
 export declare type EditorConfig = {
+  /**
+   * @beta
+   */
   behaviors?: Array<Behavior>
   keyGenerator?: () => string
   /**
@@ -515,7 +518,7 @@ export declare type EditorConfig = {
 )
 
 /**
- * @alpha
+ * @public
  */
 export declare type EditorContext = {
   activeDecorators: Array<string>
@@ -526,7 +529,7 @@ export declare type EditorContext = {
 }
 
 /**
- * @alpha
+ * @public
  */
 export declare type EditorEmittedEvent = PickFromUnion<
   InternalEditorEmittedEvent,
@@ -547,7 +550,7 @@ export declare type EditorEmittedEvent = PickFromUnion<
 >
 
 /**
- * @alpha
+ * @public
  */
 export declare type EditorEvent = PickFromUnion<
   InternalEditorEvent,
@@ -571,7 +574,7 @@ export declare type EditorEvent = PickFromUnion<
 >
 
 /**
- * @alpha
+ * @public
  */
 export declare function EditorEventListener(props: {
   on: (event: EditorEmittedEvent) => void
@@ -679,11 +682,6 @@ export declare const editorMachine: StateMachine<
         preventDefault: () => void
       }
     }
-  | {
-      type: 'behavior action intends'
-      editor: PortableTextSlateEditor
-      actionIntends: Array<BehaviorActionIntend>
-    }
   | {
       type: 'update readOnly'
       readOnly: boolean
@@ -1064,11 +1062,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -1222,11 +1215,6 @@ export declare const editorMachine: StateMachine<
               preventDefault: () => void
             }
           }
-        | {
-            type: 'behavior action intends'
-            editor: PortableTextSlateEditor
-            actionIntends: Array<BehaviorActionIntend>
-          }
         | {
             type: 'update readOnly'
             readOnly: boolean
@@ -1402,11 +1390,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -1694,11 +1677,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -1987,11 +1965,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -2281,11 +2254,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -2574,11 +2542,6 @@ export declare const editorMachine: StateMachine<
                   preventDefault: () => void
                 }
               }
-            | {
-                type: 'behavior action intends'
-                editor: PortableTextSlateEditor
-                actionIntends: Array<BehaviorActionIntend>
-              }
             | {
                 type: 'update readOnly'
                 readOnly: boolean
@@ -2747,11 +2710,6 @@ export declare const editorMachine: StateMachine<
                   preventDefault: () => void
                 }
               }
-            | {
-                type: 'behavior action intends'
-                editor: PortableTextSlateEditor
-                actionIntends: Array<BehaviorActionIntend>
-              }
             | {
                 type: 'update readOnly'
                 readOnly: boolean
@@ -3040,11 +2998,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -3332,11 +3285,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -3623,11 +3571,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -3912,11 +3855,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -4203,11 +4141,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -4501,11 +4434,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -4676,11 +4604,6 @@ export declare const editorMachine: StateMachine<
                 preventDefault: () => void
               }
             }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
           | {
               type: 'update readOnly'
               readOnly: boolean
@@ -4747,609 +4670,98 @@ export declare const editorMachine: StateMachine<
           never
         >
       }
-      readonly 'behavior action intends': {
-        readonly actions: readonly [
-          ({
-            context,
-            event,
-          }: ActionArgs<
-            {
-              behaviors: Array<Behavior>
-              keyGenerator: () => string
-              pendingEvents: Array<PatchEvent | MutationEvent_2>
-              schema: EditorSchema
-              initialReadOnly: boolean
-              maxBlocks: number | undefined
-              selection: EditorSelection
-              value: Array<PortableTextBlock> | undefined
-            },
-            {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            },
-            | {
-                type: 'annotation.add'
-                annotation: {
-                  name: string
-                  value: {
-                    [prop: string]: unknown
-                  }
-                }
-              }
-            | {
-                type: 'annotation.remove'
-                annotation: {
-                  name: string
-                }
-              }
-            | {
-                type: 'annotation.toggle'
-                annotation: {
-                  name: string
-                  value: {
-                    [prop: string]: unknown
-                  }
+    }
+    readonly type: 'parallel'
+    readonly states: {
+      readonly 'edit mode': {
+        readonly initial: 'read only'
+        readonly states: {
+          readonly 'read only': {
+            readonly initial: 'determine initial edit mode'
+            readonly states: {
+              readonly 'determine initial edit mode': {
+                readonly on: {
+                  readonly 'done syncing initial value': readonly [
+                    {
+                      readonly target: '#editor.edit mode.read only.read only'
+                      readonly guard: ({
+                        context,
+                      }: GuardArgs<
+                        {
+                          behaviors: Array<Behavior>
+                          keyGenerator: () => string
+                          pendingEvents: Array<PatchEvent | MutationEvent_2>
+                          schema: EditorSchema
+                          initialReadOnly: boolean
+                          maxBlocks: number | undefined
+                          selection: EditorSelection
+                          value: Array<PortableTextBlock> | undefined
+                        },
+                        {
+                          type: 'done syncing initial value'
+                        }
+                      >) => boolean
+                    },
+                    {
+                      readonly target: '#editor.edit mode.editable'
+                    },
+                  ]
                 }
               }
-            | {
-                type: 'blur'
-              }
-            | {
-                type: 'decorator.add'
-                decorator: string
-              }
-            | {
-                type: 'decorator.remove'
-                decorator: string
-              }
-            | {
-                type: 'decorator.toggle'
-                decorator: string
-              }
-            | {
-                type: 'focus'
-              }
-            | {
-                type: 'insert.block object'
-                placement: 'auto' | 'after' | 'before'
-                blockObject: {
-                  name: string
-                  value?: {
-                    [prop: string]: unknown
+              readonly 'read only': {
+                readonly on: {
+                  readonly 'update readOnly': {
+                    readonly guard: ({
+                      event,
+                    }: GuardArgs<
+                      {
+                        behaviors: Array<Behavior>
+                        keyGenerator: () => string
+                        pendingEvents: Array<PatchEvent | MutationEvent_2>
+                        schema: EditorSchema
+                        initialReadOnly: boolean
+                        maxBlocks: number | undefined
+                        selection: EditorSelection
+                        value: Array<PortableTextBlock> | undefined
+                      },
+                      {
+                        type: 'update readOnly'
+                        readOnly: boolean
+                      }
+                    >) => boolean
+                    readonly target: '#editor.edit mode.editable'
+                    readonly actions: readonly ['emit editable']
                   }
                 }
               }
-            | {
-                type: 'insert.inline object'
-                inlineObject: {
-                  name: string
-                  value?: {
-                    [prop: string]: unknown
+            }
+          }
+          readonly 'editable': {
+            readonly on: {
+              readonly 'update readOnly': {
+                readonly guard: ({
+                  event,
+                }: GuardArgs<
+                  {
+                    behaviors: Array<Behavior>
+                    keyGenerator: () => string
+                    pendingEvents: Array<PatchEvent | MutationEvent_2>
+                    schema: EditorSchema
+                    initialReadOnly: boolean
+                    maxBlocks: number | undefined
+                    selection: EditorSelection
+                    value: Array<PortableTextBlock> | undefined
+                  },
+                  {
+                    type: 'update readOnly'
+                    readOnly: boolean
                   }
-                }
-              }
-            | {
-                type: 'list item.toggle'
-                listItem: string
-              }
-            | {
-                type: 'style.toggle'
-                style: string
-              }
-            | PatchEvent
-            | MutationEvent_2
-            | {
-                type: 'normalizing'
-              }
-            | {
-                type: 'done normalizing'
+                >) => boolean
+                readonly target: '#editor.edit mode.read only.read only'
+                readonly actions: readonly ['emit read only']
               }
-            | {
-                type: 'done syncing initial value'
-              }
-            | {
-                type: 'behavior event'
-                behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
-                editor: PortableTextSlateEditor
-                nativeEvent?: {
-                  preventDefault: () => void
-                }
-              }
-            | {
-                type: 'behavior action intends'
-                editor: PortableTextSlateEditor
-                actionIntends: Array<BehaviorActionIntend>
-              }
-            | {
-                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: 'selection'
-                selection: EditorSelection
-              }
-            | {
-                type: 'blurred'
-                event: FocusEvent_2<HTMLDivElement, Element>
-              }
-            | {
-                type: 'focused'
-                event: FocusEvent_2<HTMLDivElement, Element>
-              }
-            | {
-                type: 'loading'
-              }
-            | {
-                type: 'done loading'
-              }
-          >) => void,
-          ActionFunction<
-            {
-              behaviors: Array<Behavior>
-              keyGenerator: () => string
-              pendingEvents: Array<PatchEvent | MutationEvent_2>
-              schema: EditorSchema
-              initialReadOnly: boolean
-              maxBlocks: number | undefined
-              selection: EditorSelection
-              value: Array<PortableTextBlock> | undefined
-            },
-            {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            },
-            | {
-                type: 'annotation.add'
-                annotation: {
-                  name: string
-                  value: {
-                    [prop: string]: unknown
-                  }
-                }
-              }
-            | {
-                type: 'annotation.remove'
-                annotation: {
-                  name: string
-                }
-              }
-            | {
-                type: 'annotation.toggle'
-                annotation: {
-                  name: string
-                  value: {
-                    [prop: string]: unknown
-                  }
-                }
-              }
-            | {
-                type: 'blur'
-              }
-            | {
-                type: 'decorator.add'
-                decorator: string
-              }
-            | {
-                type: 'decorator.remove'
-                decorator: string
-              }
-            | {
-                type: 'decorator.toggle'
-                decorator: string
-              }
-            | {
-                type: '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_2
-            | {
-                type: 'normalizing'
-              }
-            | {
-                type: 'done normalizing'
-              }
-            | {
-                type: 'done syncing initial value'
-              }
-            | {
-                type: 'behavior event'
-                behaviorEvent: SyntheticBehaviorEvent | NativeBehaviorEvent
-                editor: PortableTextSlateEditor
-                nativeEvent?: {
-                  preventDefault: () => void
-                }
-              }
-            | {
-                type: 'behavior action intends'
-                editor: PortableTextSlateEditor
-                actionIntends: Array<BehaviorActionIntend>
-              }
-            | {
-                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: 'selection'
-                selection: EditorSelection
-              }
-            | {
-                type: 'blurred'
-                event: FocusEvent_2<HTMLDivElement, Element>
-              }
-            | {
-                type: 'focused'
-                event: FocusEvent_2<HTMLDivElement, Element>
-              }
-            | {
-                type: 'loading'
-              }
-            | {
-                type: 'done loading'
-              },
-            undefined,
-            never,
-            Values<{
-              'assign behaviors': {
-                type: 'assign behaviors'
-                params: NonReducibleUnknown
-              }
-              'assign schema': {
-                type: 'assign schema'
-                params: NonReducibleUnknown
-              }
-              'emit patch event': {
-                type: 'emit patch event'
-                params: NonReducibleUnknown
-              }
-              'emit mutation event': {
-                type: 'emit mutation event'
-                params: NonReducibleUnknown
-              }
-              'emit read only': {
-                type: 'emit read only'
-                params: NonReducibleUnknown
-              }
-              'emit editable': {
-                type: 'emit editable'
-                params: NonReducibleUnknown
-              }
-              'defer event': {
-                type: 'defer event'
-                params: NonReducibleUnknown
-              }
-              'emit pending events': {
-                type: 'emit pending events'
-                params: NonReducibleUnknown
-              }
-              'emit ready': {
-                type: 'emit ready'
-                params: NonReducibleUnknown
-              }
-              'clear pending events': {
-                type: 'clear pending events'
-                params: NonReducibleUnknown
-              }
-              'handle behavior event': {
-                type: 'handle behavior event'
-                params: NonReducibleUnknown
-              }
-            }>,
-            never,
-            never,
-            | {
-                type: 'annotation.add'
-                annotation: {
-                  name: string
-                  value: {
-                    [prop: string]: unknown
-                  }
-                }
-              }
-            | {
-                type: 'annotation.remove'
-                annotation: {
-                  name: string
-                }
-              }
-            | {
-                type: 'annotation.toggle'
-                annotation: {
-                  name: string
-                  value: {
-                    [prop: string]: unknown
-                  }
-                }
-              }
-            | {
-                type: 'blur'
-              }
-            | {
-                type: 'decorator.add'
-                decorator: string
-              }
-            | {
-                type: 'decorator.remove'
-                decorator: string
-              }
-            | {
-                type: 'decorator.toggle'
-                decorator: string
-              }
-            | {
-                type: '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_2
-            | {
-                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: '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'
-              }
-          >,
-        ]
-      }
-    }
-    readonly type: 'parallel'
-    readonly states: {
-      readonly 'edit mode': {
-        readonly initial: 'read only'
-        readonly states: {
-          readonly 'read only': {
-            readonly initial: 'determine initial edit mode'
-            readonly states: {
-              readonly 'determine initial edit mode': {
-                readonly on: {
-                  readonly 'done syncing initial value': readonly [
-                    {
-                      readonly target: '#editor.edit mode.read only.read only'
-                      readonly guard: ({
-                        context,
-                      }: GuardArgs<
-                        {
-                          behaviors: Array<Behavior>
-                          keyGenerator: () => string
-                          pendingEvents: Array<PatchEvent | MutationEvent_2>
-                          schema: EditorSchema
-                          initialReadOnly: boolean
-                          maxBlocks: number | undefined
-                          selection: EditorSelection
-                          value: Array<PortableTextBlock> | undefined
-                        },
-                        {
-                          type: 'done syncing initial value'
-                        }
-                      >) => boolean
-                    },
-                    {
-                      readonly target: '#editor.edit mode.editable'
-                    },
-                  ]
-                }
-              }
-              readonly 'read only': {
-                readonly on: {
-                  readonly 'update readOnly': {
-                    readonly guard: ({
-                      event,
-                    }: GuardArgs<
-                      {
-                        behaviors: Array<Behavior>
-                        keyGenerator: () => string
-                        pendingEvents: Array<PatchEvent | MutationEvent_2>
-                        schema: EditorSchema
-                        initialReadOnly: boolean
-                        maxBlocks: number | undefined
-                        selection: EditorSelection
-                        value: Array<PortableTextBlock> | undefined
-                      },
-                      {
-                        type: 'update readOnly'
-                        readOnly: boolean
-                      }
-                    >) => boolean
-                    readonly target: '#editor.edit mode.editable'
-                    readonly actions: readonly ['emit editable']
-                  }
-                }
-              }
-            }
-          }
-          readonly 'editable': {
-            readonly on: {
-              readonly 'update readOnly': {
-                readonly guard: ({
-                  event,
-                }: GuardArgs<
-                  {
-                    behaviors: Array<Behavior>
-                    keyGenerator: () => string
-                    pendingEvents: Array<PatchEvent | MutationEvent_2>
-                    schema: EditorSchema
-                    initialReadOnly: boolean
-                    maxBlocks: number | undefined
-                    selection: EditorSelection
-                    value: Array<PortableTextBlock> | undefined
-                  },
-                  {
-                    type: 'update readOnly'
-                    readOnly: boolean
-                  }
-                >) => boolean
-                readonly target: '#editor.edit mode.read only.read only'
-                readonly actions: readonly ['emit read only']
-              }
-              readonly 'behavior event': {
-                readonly actions: 'handle behavior event'
+              readonly 'behavior event': {
+                readonly actions: 'handle behavior event'
               }
               readonly 'annotation.add': {
                 readonly actions: ActionFunction<
@@ -5462,11 +4874,6 @@ export declare const editorMachine: StateMachine<
                         preventDefault: () => void
                       }
                     }
-                  | {
-                      type: 'behavior action intends'
-                      editor: PortableTextSlateEditor
-                      actionIntends: Array<BehaviorActionIntend>
-                    }
                   | {
                       type: 'update readOnly'
                       readOnly: boolean
@@ -5758,11 +5165,6 @@ export declare const editorMachine: StateMachine<
                         preventDefault: () => void
                       }
                     }
-                  | {
-                      type: 'behavior action intends'
-                      editor: PortableTextSlateEditor
-                      actionIntends: Array<BehaviorActionIntend>
-                    }
                   | {
                       type: 'update readOnly'
                       readOnly: boolean
@@ -6057,11 +5459,6 @@ export declare const editorMachine: StateMachine<
                         preventDefault: () => void
                       }
                     }
-                  | {
-                      type: 'behavior action intends'
-                      editor: PortableTextSlateEditor
-                      actionIntends: Array<BehaviorActionIntend>
-                    }
                   | {
                       type: 'update readOnly'
                       readOnly: boolean
@@ -6350,11 +5747,6 @@ export declare const editorMachine: StateMachine<
                         preventDefault: () => void
                       }
                     }
-                  | {
-                      type: 'behavior action intends'
-                      editor: PortableTextSlateEditor
-                      actionIntends: Array<BehaviorActionIntend>
-                    }
                   | {
                       type: 'update readOnly'
                       readOnly: boolean
@@ -6652,11 +6044,6 @@ export declare const editorMachine: StateMachine<
                         preventDefault: () => void
                       }
                     }
-                  | {
-                      type: 'behavior action intends'
-                      editor: PortableTextSlateEditor
-                      actionIntends: Array<BehaviorActionIntend>
-                    }
                   | {
                       type: 'update readOnly'
                       readOnly: boolean
@@ -6945,11 +6332,6 @@ export declare const editorMachine: StateMachine<
                         preventDefault: () => void
                       }
                     }
-                  | {
-                      type: 'behavior action intends'
-                      editor: PortableTextSlateEditor
-                      actionIntends: Array<BehaviorActionIntend>
-                    }
                   | {
                       type: 'update readOnly'
                       readOnly: boolean
@@ -7254,11 +6636,6 @@ export declare const editorMachine: StateMachine<
                         preventDefault: () => void
                       }
                     }
-                  | {
-                      type: 'behavior action intends'
-                      editor: PortableTextSlateEditor
-                      actionIntends: Array<BehaviorActionIntend>
-                    }
                   | {
                       type: 'update readOnly'
                       readOnly: boolean
@@ -7548,11 +6925,6 @@ export declare const editorMachine: StateMachine<
                         preventDefault: () => void
                       }
                     }
-                  | {
-                      type: 'behavior action intends'
-                      editor: PortableTextSlateEditor
-                      actionIntends: Array<BehaviorActionIntend>
-                    }
                   | {
                       type: 'update readOnly'
                       readOnly: boolean
@@ -7842,11 +7214,6 @@ export declare const editorMachine: StateMachine<
                         preventDefault: () => void
                       }
                     }
-                  | {
-                      type: 'behavior action intends'
-                      editor: PortableTextSlateEditor
-                      actionIntends: Array<BehaviorActionIntend>
-                    }
                   | {
                       type: 'update readOnly'
                       readOnly: boolean
@@ -8111,14 +7478,14 @@ export declare type EditorNode = Node_2 & {
 }
 
 /**
- * @alpha
+ * @public
  */
 export declare function EditorProvider(
   props: EditorProviderProps,
 ): React_2.JSX.Element
 
 /**
- * @alpha
+ * @public
  */
 export declare type EditorProviderProps = {
   initialConfig: EditorConfig
@@ -8126,32 +7493,32 @@ export declare type EditorProviderProps = {
 }
 
 /**
- * @alpha
+ * @public
  */
 export declare type EditorSchema = PortableTextMemberSchemaTypes
 
-/** @beta */
+/** @public */
 export declare type EditorSelection = {
   anchor: EditorSelectionPoint
   focus: EditorSelectionPoint
   backward?: boolean
 } | null
 
-/** @beta */
+/** @public */
 export declare type EditorSelectionPoint = {
   path: Path
   offset: number
 }
 
 /**
- * @alpha
+ * @public
  */
 export declare type EditorSelector<TSelected> = (
   snapshot: EditorSnapshot,
 ) => TSelected
 
 /**
- * @alpha
+ * @public
  */
 export declare type EditorSnapshot = {
   context: EditorContext
@@ -8291,11 +7658,6 @@ export declare type InternalEditorEvent =
         preventDefault: () => void
       }
     }
-  | {
-      type: 'behavior action intends'
-      editor: PortableTextSlateEditor
-      actionIntends: Array<BehaviorActionIntend>
-    }
   | {
       type: 'update readOnly'
       readOnly: boolean
@@ -8383,12 +7745,16 @@ export declare type MutationChange = {
 declare type MutationEvent_2 = {
   type: 'mutation'
   patches: Array<Patch>
+  /**
+   * @deprecated Use `value` instead
+   */
   snapshot: Array<PortableTextBlock> | undefined
+  value: Array<PortableTextBlock> | undefined
 }
 export {MutationEvent_2 as MutationEvent}
 
 /**
- * @alpha
+ * @beta
  */
 export declare type NativeBehaviorEvent =
   | {
@@ -8544,6 +7910,7 @@ export declare type PortableTextEditableProps = Omit<
 /**
  * The main Portable Text Editor component.
  * @public
+ * @deprecated Use `EditorProvider` instead
  */
 export declare class PortableTextEditor extends Component<
   PortableTextEditorProps<Editor | undefined>
@@ -8689,6 +8056,7 @@ export declare class PortableTextEditor extends Component<
  * Props for the PortableTextEditor component
  *
  * @public
+ * @deprecated Use `EditorProvider` instead
  */
 export declare type PortableTextEditorProps<
   TEditor extends Editor | undefined = undefined,
@@ -8892,7 +8260,7 @@ export declare type RenderStyleFunction = (
 ) => JSX.Element
 
 /**
- * @alpha
+ * @public
  */
 export declare type SchemaDefinition<
   TBaseDefinition extends BaseDefinition = BaseDefinition,
@@ -8928,7 +8296,7 @@ export declare type SlateEditor = {
 }
 
 /**
- * @alpha
+ * @beta
  */
 export declare type SyntheticBehaviorEvent =
   | {
@@ -9036,12 +8404,12 @@ export declare type UnsetChange = {
 }
 
 /**
- * @alpha
+ * @public
  */
 export declare function useEditor(): Editor
 
 /**
- * @alpha
+ * @public
  */
 export declare function useEditorSelector<TSelected>(
   editor: Editor,
@@ -9050,12 +8418,14 @@ export declare function useEditorSelector<TSelected>(
 ): TSelected
 
 /**
+ * @deprecated Use `useEditor` to get the current editor instance.
  * @public
  * Get the current editor object from the React context.
  */
 export declare const usePortableTextEditor: () => PortableTextEditor
 
 /**
+ * @deprecated Use `useEditorSelector` to get the current editor selection.
  * @public
  * Get the current editor selection from the React context.
  */