npm - @portabletext/editor - Versions diffs - 1.1.1 → 1.1.2 - Mend

@portabletext/editor 1.1.1 → 1.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (51) hide show

package/README.md +3 -0
package/lib/index.d.mts +1667 -0
package/lib/index.d.ts +1667 -0
package/lib/index.esm.js +305 -153
package/lib/index.esm.js.map +1 -1
package/lib/index.js +305 -154
package/lib/index.js.map +1 -1
package/lib/index.mjs +305 -153
package/lib/index.mjs.map +1 -1
package/package.json +23 -22
package/src/editor/Editable.tsx +30 -31
package/src/editor/PortableTextEditor.tsx +23 -6
package/src/editor/__tests__/PortableTextEditor.test.tsx +9 -9
package/src/editor/__tests__/PortableTextEditorTester.tsx +2 -5
package/src/editor/__tests__/RangeDecorations.test.tsx +2 -2
package/src/editor/__tests__/handleClick.test.tsx +27 -7
package/src/editor/__tests__/insert-block.test.tsx +4 -4
package/src/editor/__tests__/pteWarningsSelfSolving.test.tsx +7 -7
package/src/editor/__tests__/self-solving.test.tsx +176 -0
package/src/editor/components/Leaf.tsx +28 -23
package/src/editor/components/Synchronizer.tsx +60 -32
package/src/editor/editor-machine.ts +195 -0
package/src/editor/hooks/usePortableTextEditorSelection.tsx +11 -13
package/src/editor/hooks/useSyncValue.test.tsx +9 -9
package/src/editor/hooks/useSyncValue.ts +14 -13
package/src/editor/plugins/__tests__/createWithInsertData.test.tsx +1 -1
package/src/editor/plugins/__tests__/withEditableAPIDelete.test.tsx +28 -28
package/src/editor/plugins/__tests__/withEditableAPIGetFragment.test.tsx +17 -17
package/src/editor/plugins/__tests__/withEditableAPIInsert.test.tsx +8 -8
package/src/editor/plugins/__tests__/withEditableAPISelectionsOverlapping.test.tsx +5 -5
package/src/editor/plugins/__tests__/withPortableTextLists.test.tsx +2 -2
package/src/editor/plugins/__tests__/withPortableTextMarkModel.test.tsx +46 -46
package/src/editor/plugins/__tests__/withPortableTextSelections.test.tsx +22 -11
package/src/editor/plugins/__tests__/withUndoRedo.test.tsx +9 -9
package/src/editor/plugins/createWithInsertData.ts +4 -8
package/src/editor/plugins/createWithObjectKeys.ts +7 -0
package/src/editor/plugins/createWithPatches.ts +5 -6
package/src/editor/plugins/createWithPortableTextBlockStyle.ts +10 -2
package/src/editor/plugins/createWithPortableTextMarkModel.ts +20 -4
package/src/editor/plugins/createWithPortableTextSelections.ts +4 -5
package/src/editor/plugins/createWithSchemaTypes.ts +9 -0
package/src/editor/plugins/index.ts +18 -8
package/src/index.ts +9 -3
package/src/utils/__tests__/dmpToOperations.test.ts +1 -1
package/src/utils/__tests__/operationToPatches.test.ts +61 -61
package/src/utils/__tests__/patchToOperations.test.ts +39 -39
package/src/utils/__tests__/ranges.test.ts +1 -1
package/src/utils/__tests__/valueNormalization.test.tsx +14 -2
package/src/utils/__tests__/values.test.ts +17 -17
package/src/utils/validateValue.ts +0 -22
package/src/editor/__tests__/utils.ts +0 -44

package/lib/index.d.mts CHANGED Viewed

@@ -38,6 +38,17 @@ import type {Observable, Subject} from 'rxjs'
 import type {Descendant, Node as Node_2, Operation} from 'slate'
 import type {ReactEditor} from 'slate-react'
 import type {DOMNode} from 'slate-react/dist/utils/dom'
+import {
+  ActionFunction,
+  ActorRefFrom,
+  ActorRefFromLogic,
+  CallbackActorLogic,
+  EventObject,
+  MetaObject,
+  NonReducibleUnknown,
+  StateMachine,
+  Values,
+} from 'xstate'
 /** @beta */
 export declare interface BlockAnnotationRenderProps {
@@ -220,6 +231,11 @@ export declare interface EditableAPIDeleteOptions {
   mode?: 'blocks' | 'children' | 'selected'
 }
+/**
+ * @internal
+ */
+export declare type EditorActor = ActorRefFrom<typeof editorMachine>
 /**
  * When the editor changes, it will emit a change item describing the change
  * @beta */
@@ -244,6 +260,1634 @@ export declare type EditorChange =
  */
 export declare type EditorChanges = Subject<EditorChange>
+/**
+ * @internal
+ */
+export declare const editorMachine: StateMachine<
+  {
+    pendingEvents: Array<PatchEvent | MutationEvent_2>
+  },
+  | PatchEvent
+  | MutationEvent_2
+  | {
+      type: 'normalizing'
+    }
+  | {
+      type: 'done normalizing'
+    }
+  | {
+      type: 'ready'
+    }
+  | {
+      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: 'focus'
+      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
+  },
+  Values<{
+    'emit patch event': {
+      type: 'emit patch event'
+      params: NonReducibleUnknown
+    }
+    'emit mutation event': {
+      type: 'emit mutation event'
+      params: NonReducibleUnknown
+    }
+    'defer event': {
+      type: 'defer event'
+      params: NonReducibleUnknown
+    }
+    'emit pending events': {
+      type: 'emit pending events'
+      params: NonReducibleUnknown
+    }
+    'clear pending events': {
+      type: 'clear pending events'
+      params: NonReducibleUnknown
+    }
+  }>,
+  never,
+  never,
+  | 'dirty'
+  | {
+      pristine: 'normalizing' | 'idle'
+    },
+  string,
+  NonReducibleUnknown,
+  NonReducibleUnknown,
+  | PatchEvent
+  | MutationEvent_2
+  | {
+      type: 'ready'
+    }
+  | {
+      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: 'focus'
+      event: FocusEvent_2<HTMLDivElement, Element>
+    }
+  | {
+      type: 'online'
+    }
+  | {
+      type: 'offline'
+    }
+  | {
+      type: 'loading'
+    }
+  | {
+      type: 'done loading'
+    },
+  MetaObject,
+  {
+    readonly id: 'editor'
+    readonly context: {
+      readonly pendingEvents: []
+    }
+    readonly invoke: {
+      readonly id: 'networkLogic'
+      readonly src: 'networkLogic'
+    }
+    readonly on: {
+      readonly 'ready': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'ready'
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'unset': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'unset'
+            previousValue: Array<PortableTextBlock>
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'value changed': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'value changed'
+            value: Array<PortableTextBlock> | undefined
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'invalid value': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'invalid value'
+            resolution: InvalidValueResolution | null
+            value: Array<PortableTextBlock> | undefined
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'error': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'error'
+            name: string
+            description: string
+            data: unknown
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'selection': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'selection'
+            selection: EditorSelection
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'blur': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'blur'
+            event: FocusEvent_2<HTMLDivElement, Element>
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'focus': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'focus'
+            event: FocusEvent_2<HTMLDivElement, Element>
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'online': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'online'
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'offline': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'offline'
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'loading': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'loading'
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+      readonly 'done loading': {
+        readonly actions: ActionFunction<
+          {
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+          },
+          {
+            type: 'done loading'
+          },
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            },
+          undefined,
+          never,
+          never,
+          never,
+          never,
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'ready'
+            }
+          | {
+              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: 'focus'
+              event: FocusEvent_2<HTMLDivElement, Element>
+            }
+          | {
+              type: 'online'
+            }
+          | {
+              type: 'offline'
+            }
+          | {
+              type: 'loading'
+            }
+          | {
+              type: 'done loading'
+            }
+        >
+      }
+    }
+    readonly initial: 'pristine'
+    readonly states: {
+      readonly pristine: {
+        readonly initial: 'idle'
+        readonly states: {
+          readonly idle: {
+            readonly on: {
+              readonly normalizing: {
+                readonly target: 'normalizing'
+              }
+              readonly patch: {
+                readonly actions: 'defer event'
+                readonly target: '#editor.dirty'
+              }
+              readonly mutation: {
+                readonly actions: 'defer event'
+                readonly target: '#editor.dirty'
+              }
+            }
+          }
+          readonly normalizing: {
+            readonly on: {
+              readonly 'done normalizing': {
+                readonly target: 'idle'
+              }
+              readonly 'patch': {
+                readonly actions: 'defer event'
+              }
+              readonly 'mutation': {
+                readonly actions: 'defer event'
+              }
+            }
+          }
+        }
+      }
+      readonly dirty: {
+        readonly entry: readonly ['emit pending events', 'clear pending events']
+        readonly on: {
+          readonly patch: {
+            readonly actions: 'emit patch event'
+          }
+          readonly mutation: {
+            readonly actions: 'emit mutation event'
+          }
+        }
+      }
+    }
+  }
+>
 /** @internal */
 export declare type EditorNode = Node_2 & {
   _key: string
@@ -361,6 +2005,16 @@ export declare type MutationChange = {
   snapshot: PortableTextBlock[] | undefined
 }
+/**
+ * @internal
+ */
+declare type MutationEvent_2 = {
+  type: 'mutation'
+  patches: Array<Patch>
+  snapshot: Array<PortableTextBlock> | undefined
+}
+export {MutationEvent_2 as MutationEvent}
 /** @beta */
 export declare type OnBeforeInputFn = (event: InputEvent) => void
@@ -410,6 +2064,14 @@ export declare type PatchChange = {
   patch: Patch
 }
+/**
+ * @internal
+ */
+export declare type PatchEvent = {
+  type: 'patch'
+  patch: Patch
+}
 /** @beta */
 export declare type PatchObservable = Observable<{
   patches: Patch[]
@@ -477,6 +2139,11 @@ export declare type PortableTextEditableProps = Omit<
  * @public
  */
 export declare class PortableTextEditor extends Component<PortableTextEditorProps> {
+  /**
+   * @internal
+   * Don't use this API directly. It's subject to change.
+   */
+  editorActor: EditorActor
   /**
    * An observable of all the editor changes.
    */