@portabletext/editor 1.10.1 → 1.11.0

package/lib/index.d.mts

@@ -32,6 +32,7 @@ import {
   JSX as JSX_2,
   MutableRefObject,
   PropsWithChildren,
+  default as React_2,
   RefAttributes,
   TextareaHTMLAttributes,
 } from 'react'
@@ -50,16 +51,12 @@ import {
   AnyActorLogic,
   AnyActorRef,
   AnyEventObject,
-  CallbackActorLogic,
-  ConditionalRequired,
   EventObject,
-  GetConcreteByKey,
   InputFrom,
-  IsNotNever,
   MachineSnapshot,
   MetaObject,
   NonReducibleUnknown,
-  RequiredActorOptions,
+  Snapshot,
   StateMachine,
   StateValue,
   Values,
@@ -709,8 +706,8 @@ export declare interface EditableAPIDeleteOptions {
  */
 export declare type Editor = {
   send: (event: EditorEvent) => void
-  on: EditorActor['on']
-  readOnly: boolean
+  on: ActorRef<Snapshot<unknown>, EventObject, EditorEmittedEvent>['on']
+  editable: EditableAPI
   _internal: {
     editorActor: EditorActor
     slateEditor: SlateEditor
@@ -752,6 +749,8 @@ export declare type EditorChanges = Subject<EditorChange>
 export declare type EditorConfig = {
   behaviors?: Array<Behavior>
   keyGenerator?: () => string
+  maxBlocks?: number
+  readOnly?: boolean
   initialValue?: Array<PortableTextBlock>
 } & (
   | {
@@ -764,6 +763,26 @@ export declare type EditorConfig = {
     }
 )
 
+/**
+ * @alpha
+ */
+export declare type EditorEmittedEvent = PickFromUnion<
+  InternalEditorEmittedEvent,
+  'type',
+  | 'blur'
+  | 'done loading'
+  | 'error'
+  | 'focus'
+  | 'invalid value'
+  | 'loading'
+  | 'mutation'
+  | 'patch'
+  | 'readOnly toggled'
+  | 'ready'
+  | 'selection'
+  | 'value changed'
+>
+
 /**
  * @alpha
  */
@@ -778,6 +797,13 @@ export declare type EditorEvent = PickFromUnion<
   | 'update value'
 >
 
+/**
+ * @alpha
+ */
+export declare function EditorEventListener(props: {
+  on: (event: EditorEmittedEvent) => void
+}): null
+
 /**
  * @internal
  */
@@ -890,30 +916,14 @@ export declare const editorMachine: StateMachine<
       type: 'focused'
       event: FocusEvent_2<HTMLDivElement, Element>
     }
-  | {
-      type: 'online'
-    }
-  | {
-      type: 'offline'
-    }
   | {
       type: 'loading'
     }
   | {
       type: 'done loading'
     },
-  {
-    [x: string]:
-      | ActorRefFromLogic<
-          CallbackActorLogic<EventObject, NonReducibleUnknown, EventObject>
-        >
-      | undefined
-  },
-  {
-    src: 'networkLogic'
-    logic: CallbackActorLogic<EventObject, NonReducibleUnknown, EventObject>
-    id: string | undefined
-  },
+  {},
+  never,
   Values<{
     'assign behaviors': {
       type: 'assign behaviors'
@@ -958,6 +968,8 @@ export declare const editorMachine: StateMachine<
   {
     behaviors?: Array<Behavior>
     keyGenerator: () => string
+    maxBlocks?: number
+    readOnly?: boolean
     schema: PortableTextMemberSchemaTypes
     value?: Array<PortableTextBlock>
   },
@@ -1026,17 +1038,15 @@ export declare const editorMachine: StateMachine<
       type: 'focused'
       event: FocusEvent_2<HTMLDivElement, Element>
     }
-  | {
-      type: 'online'
-    }
-  | {
-      type: 'offline'
-    }
   | {
       type: 'loading'
     }
   | {
       type: 'done loading'
+    }
+  | {
+      type: 'readOnly toggled'
+      readOnly: boolean
     },
   MetaObject,
   {
@@ -1045,60 +1055,10 @@ export declare const editorMachine: StateMachine<
       input,
     }: {
       spawn: {
-        <TSrc extends 'networkLogic'>(
+        <TSrc extends never>(
           logic: TSrc,
-          ...[options]: {
-            src: 'networkLogic'
-            logic: CallbackActorLogic<
-              EventObject,
-              NonReducibleUnknown,
-              EventObject
-            >
-            id: string | undefined
-          } extends infer T
-            ? T extends {
-                src: 'networkLogic'
-                logic: CallbackActorLogic<
-                  EventObject,
-                  NonReducibleUnknown,
-                  EventObject
-                >
-                id: string | undefined
-              }
-              ? T extends {
-                  src: TSrc
-                }
-                ? ConditionalRequired<
-                    [
-                      options?:
-                        | ({
-                            id?: T['id'] | undefined
-                            systemId?: string
-                            input?: InputFrom<T['logic']> | undefined
-                            syncSnapshot?: boolean
-                          } & {[K in RequiredActorOptions<T>]: unknown})
-                        | undefined,
-                    ],
-                    IsNotNever<RequiredActorOptions<T>>
-                  >
-                : never
-              : never
-            : never
-        ): ActorRefFromLogic<
-          GetConcreteByKey<
-            {
-              src: 'networkLogic'
-              logic: CallbackActorLogic<
-                EventObject,
-                NonReducibleUnknown,
-                EventObject
-              >
-              id: string | undefined
-            },
-            'src',
-            TSrc
-          >['logic']
-        >
+          ...[options]: never
+        ): ActorRefFromLogic<never>
         <TLogic extends AnyActorLogic>(
           src: TLogic,
           options?:
@@ -1114,6 +1074,8 @@ export declare const editorMachine: StateMachine<
       input: {
         behaviors?: Array<Behavior>
         keyGenerator: () => string
+        maxBlocks?: number
+        readOnly?: boolean
         schema: PortableTextMemberSchemaTypes
         value?: Array<PortableTextBlock>
       }
@@ -1227,12 +1189,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -1345,12 +1301,6 @@ export declare const editorMachine: StateMachine<
             type: 'focused'
             event: FocusEvent_2<HTMLDivElement, Element>
           }
-        | {
-            type: 'online'
-          }
-        | {
-            type: 'offline'
-          }
         | {
             type: 'loading'
           }
@@ -1364,14 +1314,10 @@ export declare const editorMachine: StateMachine<
       keyGenerator: () => string
       pendingEvents: never[]
       schema: PortableTextMemberSchemaTypes
-      readOnly: false
-      maxBlocks: undefined
+      readOnly: boolean
+      maxBlocks: number | undefined
       value: PortableTextBlock[] | undefined
     }
-    readonly invoke: {
-      readonly id: 'networkLogic'
-      readonly src: 'networkLogic'
-    }
     readonly on: {
       readonly 'annotation.add': {
         readonly actions: ActionFunction<
@@ -1492,12 +1438,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -1573,18 +1513,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
         readonly guard: ({
           context,
@@ -1725,12 +1663,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -1806,18 +1738,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
         readonly guard: ({
           context,
@@ -1958,12 +1888,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -2039,18 +1963,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
         readonly guard: ({
           context,
@@ -2188,12 +2110,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -2269,18 +2185,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
         readonly guard: ({
           context,
@@ -2412,12 +2326,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -2493,18 +2401,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
       readonly 'unset': {
@@ -2621,12 +2527,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -2702,18 +2602,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
       readonly 'value changed': {
@@ -2830,12 +2728,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -2911,18 +2803,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
       readonly 'invalid value': {
@@ -3040,12 +2930,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -3121,18 +3005,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
       readonly 'error': {
@@ -3251,12 +3133,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -3332,18 +3208,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
       readonly 'selection': {
@@ -3460,12 +3334,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -3541,18 +3409,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
       readonly 'blur': {
@@ -3669,12 +3535,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -3750,18 +3610,16 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
       readonly 'focused': {
@@ -3878,12 +3736,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -3959,21 +3811,19 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
-      readonly 'online': {
+      readonly 'loading': {
         readonly actions: ActionFunction<
           {
             behaviors: Array<Behavior>
@@ -3985,7 +3835,7 @@ export declare const editorMachine: StateMachine<
             value: Array<PortableTextBlock> | undefined
           },
           {
-            type: 'online'
+            type: 'loading'
           },
           | {
               type: 'annotation.add'
@@ -4086,12 +3936,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -4167,21 +4011,19 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
-      readonly 'offline': {
+      readonly 'patches': {
         readonly actions: ActionFunction<
           {
             behaviors: Array<Behavior>
@@ -4192,9 +4034,7 @@ export declare const editorMachine: StateMachine<
             maxBlocks: number | undefined
             value: Array<PortableTextBlock> | undefined
           },
-          {
-            type: 'offline'
-          },
+          PatchesEvent,
           | {
               type: 'annotation.add'
               annotation: {
@@ -4294,12 +4134,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -4375,21 +4209,19 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
-      readonly 'loading': {
+      readonly 'done loading': {
         readonly actions: ActionFunction<
           {
             behaviors: Array<Behavior>
@@ -4401,7 +4233,7 @@ export declare const editorMachine: StateMachine<
             value: Array<PortableTextBlock> | undefined
           },
           {
-            type: 'loading'
+            type: 'done loading'
           },
           | {
               type: 'annotation.add'
@@ -4502,12 +4334,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -4583,21 +4409,25 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
           | {
               type: 'done loading'
             }
+          | {
+              type: 'readOnly toggled'
+              readOnly: boolean
+            }
         >
       }
-      readonly 'patches': {
+      readonly 'update behaviors': {
+        readonly actions: 'assign behaviors'
+      }
+      readonly 'update schema': {
+        readonly actions: 'assign schema'
+      }
+      readonly 'update value': {
         readonly actions: ActionFunction<
           {
             behaviors: Array<Behavior>
@@ -4608,7 +4438,10 @@ export declare const editorMachine: StateMachine<
             maxBlocks: number | undefined
             value: Array<PortableTextBlock> | undefined
           },
-          PatchesEvent,
+          {
+            type: 'update value'
+            value: Array<PortableTextBlock> | undefined
+          },
           | {
               type: 'annotation.add'
               annotation: {
@@ -4708,12 +4541,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -4725,580 +4552,335 @@ export declare const editorMachine: StateMachine<
           never,
           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: 'focus'
-            }
-          | 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: 'blur'
-              event: FocusEvent_2<HTMLDivElement, Element>
-            }
-          | {
-              type: 'focused'
-              event: FocusEvent_2<HTMLDivElement, Element>
-            }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
-          | {
-              type: 'loading'
-            }
-          | {
-              type: 'done loading'
-            }
+          never
         >
       }
-      readonly 'done loading': {
-        readonly actions: ActionFunction<
-          {
-            behaviors: Array<Behavior>
-            keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
-            schema: PortableTextMemberSchemaTypes
-            readOnly: boolean
-            maxBlocks: number | undefined
-            value: Array<PortableTextBlock> | undefined
-          },
-          {
-            type: 'done loading'
-          },
-          | {
-              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: 'focus'
-            }
-          | PatchEvent
-          | MutationEvent_2
-          | {
-              type: 'normalizing'
-            }
-          | {
-              type: 'done normalizing'
-            }
-          | {
-              type: 'behavior event'
-              behaviorEvent: BehaviorEvent
-              editor: PortableTextSlateEditor
-            }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
-          | {
-              type: 'update schema'
-              schema: PortableTextMemberSchemaTypes
-            }
-          | {
-              type: 'update behaviors'
+      readonly 'toggle readOnly': {
+        readonly actions: readonly [
+          ActionFunction<
+            {
               behaviors: Array<Behavior>
-            }
-          | {
-              type: 'update value'
-              value: Array<PortableTextBlock> | undefined
-            }
-          | {
-              type: 'toggle readOnly'
-            }
-          | {
-              type: 'update maxBlocks'
+              keyGenerator: () => string
+              pendingEvents: Array<PatchEvent | MutationEvent_2>
+              schema: PortableTextMemberSchemaTypes
+              readOnly: boolean
               maxBlocks: number | undefined
-            }
-          | {
-              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: 'blur'
-              event: FocusEvent_2<HTMLDivElement, Element>
-            }
-          | {
-              type: 'focused'
-              event: FocusEvent_2<HTMLDivElement, Element>
-            }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
-          | {
-              type: 'loading'
-            }
-          | {
-              type: 'done loading'
             },
-          undefined,
-          never,
-          never,
-          never,
-          never,
-          | {
-              type: 'annotation.add'
-              annotation: {
-                name: string
-                value: {
-                  [prop: string]: unknown
+            {
+              type: 'toggle readOnly'
+            },
+            | {
+                type: 'annotation.add'
+                annotation: {
+                  name: string
+                  value: {
+                    [prop: string]: unknown
+                  }
                 }
               }
-            }
-          | {
-              type: 'annotation.remove'
-              annotation: {
-                name: string
+            | {
+                type: 'annotation.remove'
+                annotation: {
+                  name: string
+                }
               }
-            }
-          | {
-              type: 'annotation.toggle'
-              annotation: {
-                name: string
-                value: {
-                  [prop: string]: unknown
+            | {
+                type: 'annotation.toggle'
+                annotation: {
+                  name: string
+                  value: {
+                    [prop: string]: unknown
+                  }
                 }
               }
-            }
-          | {
-              type: 'focus'
-            }
-          | 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: 'blur'
-              event: FocusEvent_2<HTMLDivElement, Element>
-            }
-          | {
-              type: 'focused'
-              event: FocusEvent_2<HTMLDivElement, Element>
-            }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
-          | {
-              type: 'loading'
-            }
-          | {
-              type: 'done loading'
-            }
-        >
-      }
-      readonly 'update behaviors': {
-        readonly actions: 'assign behaviors'
-      }
-      readonly 'update schema': {
-        readonly actions: 'assign schema'
-      }
-      readonly 'update value': {
-        readonly actions: ActionFunction<
-          {
-            behaviors: Array<Behavior>
-            keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
-            schema: PortableTextMemberSchemaTypes
-            readOnly: boolean
-            maxBlocks: number | undefined
-            value: Array<PortableTextBlock> | undefined
-          },
-          {
-            type: 'update value'
-            value: Array<PortableTextBlock> | undefined
-          },
-          | {
-              type: 'annotation.add'
-              annotation: {
-                name: string
-                value: {
-                  [prop: string]: unknown
-                }
+            | {
+                type: 'focus'
               }
-            }
-          | {
-              type: 'annotation.remove'
-              annotation: {
-                name: string
+            | PatchEvent
+            | MutationEvent_2
+            | {
+                type: 'normalizing'
               }
-            }
-          | {
-              type: 'annotation.toggle'
-              annotation: {
+            | {
+                type: 'done normalizing'
+              }
+            | {
+                type: 'behavior event'
+                behaviorEvent: BehaviorEvent
+                editor: PortableTextSlateEditor
+              }
+            | {
+                type: 'behavior action intends'
+                editor: PortableTextSlateEditor
+                actionIntends: Array<BehaviorActionIntend>
+              }
+            | {
+                type: 'update schema'
+                schema: PortableTextMemberSchemaTypes
+              }
+            | {
+                type: 'update behaviors'
+                behaviors: Array<Behavior>
+              }
+            | {
+                type: 'update value'
+                value: Array<PortableTextBlock> | undefined
+              }
+            | {
+                type: 'toggle readOnly'
+              }
+            | {
+                type: 'update maxBlocks'
+                maxBlocks: number | undefined
+              }
+            | {
+                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
-                value: {
-                  [prop: string]: unknown
-                }
+                description: string
+                data: unknown
               }
-            }
-          | {
-              type: 'focus'
-            }
-          | PatchEvent
-          | MutationEvent_2
-          | {
-              type: 'normalizing'
-            }
-          | {
-              type: 'done normalizing'
-            }
-          | {
-              type: 'behavior event'
-              behaviorEvent: BehaviorEvent
-              editor: PortableTextSlateEditor
-            }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
-          | {
-              type: 'update schema'
-              schema: PortableTextMemberSchemaTypes
-            }
-          | {
-              type: 'update behaviors'
+            | {
+                type: 'selection'
+                selection: EditorSelection
+              }
+            | {
+                type: 'blur'
+                event: FocusEvent_2<HTMLDivElement, Element>
+              }
+            | {
+                type: 'focused'
+                event: FocusEvent_2<HTMLDivElement, Element>
+              }
+            | {
+                type: 'loading'
+              }
+            | {
+                type: 'done loading'
+              },
+            undefined,
+            never,
+            never,
+            never,
+            never,
+            never
+          >,
+          ActionFunction<
+            {
               behaviors: Array<Behavior>
-            }
-          | {
-              type: 'update value'
-              value: Array<PortableTextBlock> | undefined
-            }
-          | {
-              type: 'toggle readOnly'
-            }
-          | {
-              type: 'update maxBlocks'
+              keyGenerator: () => string
+              pendingEvents: Array<PatchEvent | MutationEvent_2>
+              schema: PortableTextMemberSchemaTypes
+              readOnly: boolean
               maxBlocks: number | undefined
-            }
-          | {
-              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: 'blur'
-              event: FocusEvent_2<HTMLDivElement, Element>
-            }
-          | {
-              type: 'focused'
-              event: FocusEvent_2<HTMLDivElement, Element>
-            }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
-          | {
-              type: 'loading'
-            }
-          | {
-              type: 'done loading'
             },
-          undefined,
-          {
-            src: 'networkLogic'
-            logic: CallbackActorLogic<
-              EventObject,
-              NonReducibleUnknown,
-              EventObject
-            >
-            id: string | undefined
-          },
-          never,
-          never,
-          never,
-          never
-        >
-      }
-      readonly 'toggle readOnly': {
-        readonly actions: ActionFunction<
-          {
-            behaviors: Array<Behavior>
-            keyGenerator: () => string
-            pendingEvents: Array<PatchEvent | MutationEvent_2>
-            schema: PortableTextMemberSchemaTypes
-            readOnly: boolean
-            maxBlocks: number | undefined
-            value: Array<PortableTextBlock> | undefined
-          },
-          {
-            type: 'toggle readOnly'
-          },
-          | {
-              type: 'annotation.add'
-              annotation: {
+            {
+              type: 'toggle readOnly'
+            },
+            | {
+                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: 'focus'
+              }
+            | PatchEvent
+            | MutationEvent_2
+            | {
+                type: 'normalizing'
+              }
+            | {
+                type: 'done normalizing'
+              }
+            | {
+                type: 'behavior event'
+                behaviorEvent: BehaviorEvent
+                editor: PortableTextSlateEditor
+              }
+            | {
+                type: 'behavior action intends'
+                editor: PortableTextSlateEditor
+                actionIntends: Array<BehaviorActionIntend>
+              }
+            | {
+                type: 'update schema'
+                schema: PortableTextMemberSchemaTypes
+              }
+            | {
+                type: 'update behaviors'
+                behaviors: Array<Behavior>
+              }
+            | {
+                type: 'update value'
+                value: Array<PortableTextBlock> | undefined
+              }
+            | {
+                type: 'toggle readOnly'
+              }
+            | {
+                type: 'update maxBlocks'
+                maxBlocks: number | undefined
+              }
+            | {
+                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
-                value: {
-                  [prop: string]: unknown
+                description: string
+                data: unknown
+              }
+            | {
+                type: 'selection'
+                selection: EditorSelection
+              }
+            | {
+                type: 'blur'
+                event: FocusEvent_2<HTMLDivElement, Element>
+              }
+            | {
+                type: 'focused'
+                event: FocusEvent_2<HTMLDivElement, Element>
+              }
+            | {
+                type: 'loading'
+              }
+            | {
+                type: 'done loading'
+              },
+            undefined,
+            never,
+            never,
+            never,
+            never,
+            | {
+                type: 'annotation.add'
+                annotation: {
+                  name: string
+                  value: {
+                    [prop: string]: unknown
+                  }
                 }
               }
-            }
-          | {
-              type: 'annotation.remove'
-              annotation: {
-                name: string
+            | {
+                type: 'annotation.remove'
+                annotation: {
+                  name: string
+                }
               }
-            }
-          | {
-              type: 'annotation.toggle'
-              annotation: {
-                name: string
-                value: {
-                  [prop: string]: unknown
+            | {
+                type: 'annotation.toggle'
+                annotation: {
+                  name: string
+                  value: {
+                    [prop: string]: unknown
+                  }
                 }
               }
-            }
-          | {
-              type: 'focus'
-            }
-          | PatchEvent
-          | MutationEvent_2
-          | {
-              type: 'normalizing'
-            }
-          | {
-              type: 'done normalizing'
-            }
-          | {
-              type: 'behavior event'
-              behaviorEvent: BehaviorEvent
-              editor: PortableTextSlateEditor
-            }
-          | {
-              type: 'behavior action intends'
-              editor: PortableTextSlateEditor
-              actionIntends: Array<BehaviorActionIntend>
-            }
-          | {
-              type: 'update schema'
-              schema: PortableTextMemberSchemaTypes
-            }
-          | {
-              type: 'update behaviors'
-              behaviors: Array<Behavior>
-            }
-          | {
-              type: 'update value'
-              value: Array<PortableTextBlock> | undefined
-            }
-          | {
-              type: 'toggle readOnly'
-            }
-          | {
-              type: 'update maxBlocks'
-              maxBlocks: number | undefined
-            }
-          | {
-              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: 'blur'
-              event: FocusEvent_2<HTMLDivElement, Element>
-            }
-          | {
-              type: 'focused'
-              event: FocusEvent_2<HTMLDivElement, Element>
-            }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
-          | {
-              type: 'loading'
-            }
-          | {
-              type: 'done loading'
-            },
-          undefined,
-          {
-            src: 'networkLogic'
-            logic: CallbackActorLogic<
-              EventObject,
-              NonReducibleUnknown,
-              EventObject
-            >
-            id: string | undefined
-          },
-          never,
-          never,
-          never,
-          never
-        >
+            | {
+                type: 'focus'
+              }
+            | 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: 'blur'
+                event: FocusEvent_2<HTMLDivElement, Element>
+              }
+            | {
+                type: 'focused'
+                event: FocusEvent_2<HTMLDivElement, Element>
+              }
+            | {
+                type: 'loading'
+              }
+            | {
+                type: 'done loading'
+              }
+            | {
+                type: 'readOnly toggled'
+                readOnly: boolean
+              }
+          >,
+        ]
       }
       readonly 'update maxBlocks': {
         readonly actions: ActionFunction<
@@ -5414,12 +4996,6 @@ export declare const editorMachine: StateMachine<
               type: 'focused'
               event: FocusEvent_2<HTMLDivElement, Element>
             }
-          | {
-              type: 'online'
-            }
-          | {
-              type: 'offline'
-            }
           | {
               type: 'loading'
             }
@@ -5427,15 +5003,7 @@ export declare const editorMachine: StateMachine<
               type: 'done loading'
             },
           undefined,
-          {
-            src: 'networkLogic'
-            logic: CallbackActorLogic<
-              EventObject,
-              NonReducibleUnknown,
-              EventObject
-            >
-            id: string | undefined
-          },
+          never,
           never,
           never,
           never,
@@ -5582,12 +5150,6 @@ export declare const editorMachine: StateMachine<
                 type: 'focused'
                 event: FocusEvent_2<HTMLDivElement, Element>
               }
-            | {
-                type: 'online'
-              }
-            | {
-                type: 'offline'
-              }
             | {
                 type: 'loading'
               }
@@ -5709,12 +5271,6 @@ export declare const editorMachine: StateMachine<
                 type: 'focused'
                 event: FocusEvent_2<HTMLDivElement, Element>
               }
-            | {
-                type: 'online'
-              }
-            | {
-                type: 'offline'
-              }
             | {
                 type: 'loading'
               }
@@ -5722,15 +5278,7 @@ export declare const editorMachine: StateMachine<
                 type: 'done loading'
               },
             undefined,
-            {
-              src: 'networkLogic'
-              logic: CallbackActorLogic<
-                EventObject,
-                NonReducibleUnknown,
-                EventObject
-              >
-              id: string | undefined
-            },
+            never,
             Values<{
               'assign behaviors': {
                 type: 'assign behaviors'
@@ -5831,18 +5379,16 @@ export declare const editorMachine: StateMachine<
                 type: 'focused'
                 event: FocusEvent_2<HTMLDivElement, Element>
               }
-            | {
-                type: 'online'
-              }
-            | {
-                type: 'offline'
-              }
             | {
                 type: 'loading'
               }
             | {
                 type: 'done loading'
               }
+            | {
+                type: 'readOnly toggled'
+                readOnly: boolean
+              }
           >,
         ]
       }
@@ -5903,6 +5449,21 @@ export declare type EditorNode = Node_2 & {
   _type: string
 }
 
+/**
+ * @alpha
+ */
+export declare function EditorProvider(
+  props: EditorProviderProps,
+): React_2.JSX.Element
+
+/**
+ * @alpha
+ */
+export declare type EditorProviderProps = {
+  config: EditorConfig
+  children?: React_2.ReactNode
+}
+
 /** @beta */
 export declare type EditorSelection = {
   anchor: EditorSelectionPoint
@@ -6000,18 +5561,16 @@ export declare type InternalEditorEmittedEvent =
       type: 'focused'
       event: FocusEvent_2<HTMLDivElement, Element>
     }
-  | {
-      type: 'online'
-    }
-  | {
-      type: 'offline'
-    }
   | {
       type: 'loading'
     }
   | {
       type: 'done loading'
     }
+  | {
+      type: 'readOnly toggled'
+      readOnly: boolean
+    }
   | PickFromUnion<
       BehaviorEvent,
       'type',
@@ -6057,7 +5616,7 @@ export declare type InternalEditorEvent =
       type: 'update maxBlocks'
       maxBlocks: number | undefined
     }
-  | InternalEditorEmittedEvent
+  | OmitFromUnion<InternalEditorEmittedEvent, 'type', 'readOnly toggled'>
 
 /**
  * The editor has an invalid value
@@ -6171,6 +5730,15 @@ declare type MutationEvent_2 = {
 }
 export {MutationEvent_2 as MutationEvent}
 
+/**
+ * @alpha
+ */
+export declare type OmitFromUnion<
+  TUnion,
+  TTagKey extends keyof TUnion,
+  TOmittedTags extends TUnion[TTagKey],
+> = TUnion extends Record<TTagKey, TOmittedTags> ? never : TUnion
+
 /** @beta */
 export declare type OnBeforeInputFn = (event: InputEvent) => void
 
@@ -6306,15 +5874,13 @@ export declare class PortableTextEditor extends Component<
    */
   schemaTypes: PortableTextMemberSchemaTypes
   /**
-   * The editor API (currently implemented with Slate).
+   * The editor instance
    */
-  private editable?
-  private editorActor
-  private slateEditor
+  private editor
+  private editable
   constructor(props: PortableTextEditorProps)
   componentDidUpdate(prevProps: PortableTextEditorProps): void
   setEditable: (editable: EditableAPI) => void
-  private getValue
   render(): JSX_2.Element
   static activeAnnotations: (editor: PortableTextEditor) => PortableTextObject[]
   static isAnnotationActive: (
@@ -6337,7 +5903,7 @@ export declare class PortableTextEditor extends Component<
     editor: PortableTextEditor,
     selection: EditorSelection,
     options?: EditableAPIDeleteOptions,
-  ) => void | undefined
+  ) => void
   static findDOMNode: (
     editor: PortableTextEditor,
     element: PortableTextBlock | PortableTextChild,
@@ -6345,17 +5911,15 @@ export declare class PortableTextEditor extends Component<
   static findByPath: (
     editor: PortableTextEditor,
     path: Path,
-  ) =>
-    | []
-    | [
-        (
-          | PortableTextTextBlock<PortableTextObject | PortableTextSpan>
-          | PortableTextObject
-          | PortableTextSpan
-          | undefined
-        ),
-        Path | undefined,
-      ]
+  ) => [
+    (
+      | PortableTextTextBlock<PortableTextObject | PortableTextSpan>
+      | PortableTextObject
+      | PortableTextSpan
+      | undefined
+    ),
+    Path | undefined,
+  ]
   static focus: (editor: PortableTextEditor) => void
   static focusBlock: (
     editor: PortableTextEditor,
@@ -6370,21 +5934,14 @@ export declare class PortableTextEditor extends Component<
   static hasBlockStyle: (
     editor: PortableTextEditor,
     blockStyle: string,
-  ) => boolean | undefined
+  ) => boolean
   static hasListStyle: (
     editor: PortableTextEditor,
     listStyle: string,
-  ) => boolean | undefined
-  static isCollapsedSelection: (
-    editor: PortableTextEditor,
-  ) => boolean | undefined
-  static isExpandedSelection: (
-    editor: PortableTextEditor,
-  ) => boolean | undefined
-  static isMarkActive: (
-    editor: PortableTextEditor,
-    mark: string,
-  ) => boolean | undefined
+  ) => boolean
+  static isCollapsedSelection: (editor: PortableTextEditor) => boolean
+  static isExpandedSelection: (editor: PortableTextEditor) => boolean
+  static isMarkActive: (editor: PortableTextEditor, mark: string) => boolean
   static insertChild: <
     TSchemaType extends {
       name: string
@@ -6411,9 +5968,9 @@ export declare class PortableTextEditor extends Component<
   static isVoid: (
     editor: PortableTextEditor,
     element: PortableTextBlock | PortableTextChild,
-  ) => boolean | undefined
+  ) => boolean
   static isObjectPath: (_editor: PortableTextEditor, path: Path) => boolean
-  static marks: (editor: PortableTextEditor) => string[] | undefined
+  static marks: (editor: PortableTextEditor) => string[]
   static select: (
     editor: PortableTextEditor,
     selection: EditorSelection | null,
@@ -6425,11 +5982,11 @@ export declare class PortableTextEditor extends Component<
   >(
     editor: PortableTextEditor,
     type: TSchemaType,
-  ) => void | undefined
+  ) => void
   static toggleBlockStyle: (
     editor: PortableTextEditor,
     blockStyle: string,
-  ) => void | undefined
+  ) => void
   static toggleList: (editor: PortableTextEditor, listStyle: string) => void
   static toggleMark: (editor: PortableTextEditor, mark: string) => void
   static getFragment: (
@@ -6441,7 +5998,7 @@ export declare class PortableTextEditor extends Component<
     editor: PortableTextEditor,
     selectionA: EditorSelection,
     selectionB: EditorSelection,
-  ) => boolean | undefined
+  ) => boolean
 }
 
 /**
@@ -6452,7 +6009,7 @@ export declare class PortableTextEditor extends Component<
 export declare type PortableTextEditorProps<
   TEditor extends Editor | undefined = undefined,
 > = PropsWithChildren<
-  (TEditor extends Editor
+  TEditor extends Editor
     ? {
         /**
          * @alpha
@@ -6497,7 +6054,7 @@ export declare type PortableTextEditorProps<
          * A ref to the editor instance
          */
         editorRef?: MutableRefObject<PortableTextEditor | null>
-      }) & {}
+      }
 >
 
 /** @internal */
@@ -6519,7 +6076,6 @@ export declare type PortableTextMemberSchemaTypes = {
 export declare interface PortableTextSlateEditor extends ReactEditor {
   _key: 'editor'
   _type: 'editor'
-  destroy: () => void
   createPlaceholderBlock: () => Descendant
   editable: EditableAPI
   history: History_2
@@ -6759,6 +6315,11 @@ export declare type UnsetChange = {
  */
 export declare function useEditor(config: EditorConfig): Editor
 
+/**
+ * @alpha
+ */
+export declare function useEditorContext(): Editor
+
 /**
  * @public
  * Get the current editor object from the React context.