@portabletext/editor 1.1.4 → 1.1.6

package/lib/index.d.mts

@@ -27,7 +27,6 @@ import type {
 import {
   Component,
   ForwardRefExoticComponent,
-  HTMLProps,
   JSX as JSX_2,
   MutableRefObject,
   PropsWithChildren,
@@ -40,16 +39,87 @@ import type {ReactEditor} from 'slate-react'
 import type {DOMNode} from 'slate-react/dist/utils/dom'
 import {
   ActionFunction,
+  ActorRef,
   ActorRefFrom,
   ActorRefFromLogic,
+  AnyActorLogic,
+  AnyActorRef,
+  AnyEventObject,
   CallbackActorLogic,
+  ConditionalRequired,
   EventObject,
+  GetConcreteByKey,
+  InputFrom,
+  IsNotNever,
+  MachineSnapshot,
   MetaObject,
   NonReducibleUnknown,
+  RequiredActorOptions,
   StateMachine,
+  StateValue,
   Values,
 } from 'xstate'
 
+/**
+ * @alpha
+ */
+export declare type Behavior<
+  TBehaviorEventType extends BehaviorEvent['type'] = BehaviorEvent['type'],
+  TGuardResponse = true,
+> = {
+  on: TBehaviorEventType
+  guard?: BehaviorGuard<
+    PickFromUnion<BehaviorEvent, 'type', TBehaviorEventType>,
+    TGuardResponse
+  >
+  actions: Array<RaiseBehaviorActionIntend<TBehaviorEventType, TGuardResponse>>
+}
+
+/**
+ * @alpha
+ */
+export declare type BehaviorActionIntend =
+  | {
+      type: 'insert text'
+      text: string
+    }
+  | {
+      type: 'insert text block'
+      decorators: Array<string>
+    }
+
+/**
+ * @alpha
+ */
+export declare type BehaviorContext = {
+  schema: PortableTextMemberSchemaTypes
+  value: Array<PortableTextBlock>
+  selection: NonNullable<EditorSelection>
+}
+
+/**
+ * @alpha
+ */
+export declare type BehaviorEvent = {
+  type: 'key down'
+  nativeEvent: KeyboardEvent
+  editor: PortableTextSlateEditor
+}
+
+/**
+ * @alpha
+ */
+export declare type BehaviorGuard<
+  TBehaviorEvent extends BehaviorEvent,
+  TGuardResponse,
+> = ({
+  context,
+  event,
+}: {
+  event: TBehaviorEvent
+  context: BehaviorContext
+}) => TGuardResponse | false
+
 /** @beta */
 export declare interface BlockAnnotationRenderProps {
   block: PortableTextBlock
@@ -153,7 +223,6 @@ export declare type ConnectionChange = {
  * @internal
  */
 export declare type createEditorOptions = {
-  keyGenerator: () => string
   patches$?: PatchObservable
   portableTextEditor: PortableTextEditor
   readOnly: boolean
@@ -265,8 +334,24 @@ export declare type EditorChanges = Subject<EditorChange>
  */
 export declare const editorMachine: StateMachine<
   {
+    behaviors: Array<Behavior>
+    keyGenerator: () => string
     pendingEvents: Array<PatchEvent | MutationEvent_2>
+    schema: PortableTextMemberSchemaTypes
   },
+  | BehaviorEvent
+  | ({
+      type: 'insert text'
+      text: string
+    } & {
+      editor: PortableTextSlateEditor
+    })
+  | ({
+      type: 'insert text block'
+      decorators: Array<string>
+    } & {
+      editor: PortableTextSlateEditor
+    })
   | PatchEvent
   | MutationEvent_2
   | {
@@ -275,6 +360,10 @@ export declare const editorMachine: StateMachine<
   | {
       type: 'done normalizing'
     }
+  | {
+      type: 'update schema'
+      schema: PortableTextMemberSchemaTypes
+    }
   | {
       type: 'ready'
     }
@@ -334,6 +423,18 @@ export declare const editorMachine: StateMachine<
     id: string | undefined
   },
   Values<{
+    'apply:insert text': {
+      type: 'apply:insert text'
+      params: unknown
+    }
+    'apply:insert text block': {
+      type: 'apply:insert text block'
+      params: unknown
+    }
+    'assign schema': {
+      type: 'assign schema'
+      params: NonReducibleUnknown
+    }
     'emit patch event': {
       type: 'emit patch event'
       params: NonReducibleUnknown
@@ -354,6 +455,10 @@ export declare const editorMachine: StateMachine<
       type: 'clear pending events'
       params: NonReducibleUnknown
     }
+    'handle behavior event': {
+      type: 'handle behavior event'
+      params: NonReducibleUnknown
+    }
   }>,
   never,
   never,
@@ -362,7 +467,11 @@ export declare const editorMachine: StateMachine<
       pristine: 'normalizing' | 'idle'
     },
   string,
-  NonReducibleUnknown,
+  {
+    behaviors: Array<Behavior>
+    keyGenerator: () => string
+    schema: PortableTextMemberSchemaTypes
+  },
   NonReducibleUnknown,
   | PatchEvent
   | MutationEvent_2
@@ -415,8 +524,245 @@ export declare const editorMachine: StateMachine<
   MetaObject,
   {
     readonly id: 'editor'
-    readonly context: {
-      readonly pendingEvents: []
+    readonly context: ({
+      input,
+    }: {
+      spawn: {
+        <TSrc extends 'networkLogic'>(
+          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']
+        >
+        <TLogic extends AnyActorLogic>(
+          src: TLogic,
+          options?:
+            | {
+                id?: never
+                systemId?: string
+                input?: InputFrom<TLogic> | undefined
+                syncSnapshot?: boolean
+              }
+            | undefined,
+        ): ActorRefFromLogic<TLogic>
+      }
+      input: {
+        behaviors: Array<Behavior>
+        keyGenerator: () => string
+        schema: PortableTextMemberSchemaTypes
+      }
+      self: ActorRef<
+        MachineSnapshot<
+          {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
+            pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
+          },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | PatchEvent
+          | MutationEvent_2
+          | {
+              type: 'normalizing'
+            }
+          | {
+              type: 'done normalizing'
+            }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
+          | {
+              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'
+            },
+          Record<string, AnyActorRef | undefined>,
+          StateValue,
+          string,
+          unknown,
+          any,
+          any
+        >,
+        | BehaviorEvent
+        | ({
+            type: 'insert text'
+            text: string
+          } & {
+            editor: PortableTextSlateEditor
+          })
+        | ({
+            type: 'insert text block'
+            decorators: Array<string>
+          } & {
+            editor: PortableTextSlateEditor
+          })
+        | PatchEvent
+        | MutationEvent_2
+        | {
+            type: 'normalizing'
+          }
+        | {
+            type: 'done normalizing'
+          }
+        | {
+            type: 'update schema'
+            schema: PortableTextMemberSchemaTypes
+          }
+        | {
+            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'
+          },
+        AnyEventObject
+      >
+    }) => {
+      behaviors: Behavior[]
+      keyGenerator: () => string
+      pendingEvents: never[]
+      schema: PortableTextMemberSchemaTypes
     }
     readonly invoke: {
       readonly id: 'networkLogic'
@@ -426,11 +772,27 @@ export declare const editorMachine: StateMachine<
       readonly 'ready': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'ready'
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -439,6 +801,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -543,12 +909,28 @@ export declare const editorMachine: StateMachine<
       readonly 'unset': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'unset'
             previousValue: Array<PortableTextBlock>
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -557,6 +939,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -661,12 +1047,28 @@ export declare const editorMachine: StateMachine<
       readonly 'value changed': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'value changed'
             value: Array<PortableTextBlock> | undefined
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -675,6 +1077,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -779,13 +1185,29 @@ export declare const editorMachine: StateMachine<
       readonly 'invalid value': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'invalid value'
             resolution: InvalidValueResolution | null
             value: Array<PortableTextBlock> | undefined
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -794,6 +1216,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -898,7 +1324,10 @@ export declare const editorMachine: StateMachine<
       readonly 'error': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'error'
@@ -906,6 +1335,19 @@ export declare const editorMachine: StateMachine<
             description: string
             data: unknown
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -914,6 +1356,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -1018,12 +1464,28 @@ export declare const editorMachine: StateMachine<
       readonly 'selection': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'selection'
             selection: EditorSelection
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -1032,6 +1494,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -1136,12 +1602,28 @@ export declare const editorMachine: StateMachine<
       readonly 'blur': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'blur'
             event: FocusEvent_2<HTMLDivElement, Element>
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -1150,6 +1632,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -1254,12 +1740,28 @@ export declare const editorMachine: StateMachine<
       readonly 'focus': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'focus'
             event: FocusEvent_2<HTMLDivElement, Element>
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -1268,6 +1770,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -1372,11 +1878,27 @@ export declare const editorMachine: StateMachine<
       readonly 'online': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'online'
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -1385,6 +1907,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -1489,11 +2015,27 @@ export declare const editorMachine: StateMachine<
       readonly 'offline': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'offline'
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -1502,6 +2044,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -1606,11 +2152,27 @@ export declare const editorMachine: StateMachine<
       readonly 'loading': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'loading'
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -1619,6 +2181,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -1723,11 +2289,27 @@ export declare const editorMachine: StateMachine<
       readonly 'done loading': {
         readonly actions: ActionFunction<
           {
+            behaviors: Array<Behavior>
+            keyGenerator: () => string
             pendingEvents: Array<PatchEvent | MutationEvent_2>
+            schema: PortableTextMemberSchemaTypes
           },
           {
             type: 'done loading'
           },
+          | BehaviorEvent
+          | ({
+              type: 'insert text'
+              text: string
+            } & {
+              editor: PortableTextSlateEditor
+            })
+          | ({
+              type: 'insert text block'
+              decorators: Array<string>
+            } & {
+              editor: PortableTextSlateEditor
+            })
           | PatchEvent
           | MutationEvent_2
           | {
@@ -1736,6 +2318,10 @@ export declare const editorMachine: StateMachine<
           | {
               type: 'done normalizing'
             }
+          | {
+              type: 'update schema'
+              schema: PortableTextMemberSchemaTypes
+            }
           | {
               type: 'ready'
             }
@@ -1837,6 +2423,18 @@ export declare const editorMachine: StateMachine<
             }
         >
       }
+      readonly 'update schema': {
+        readonly actions: 'assign schema'
+      }
+      readonly 'key down': {
+        readonly actions: readonly ['handle behavior event']
+      }
+      readonly 'insert text': {
+        readonly actions: readonly ['apply:insert text']
+      }
+      readonly 'insert text block': {
+        readonly actions: readonly ['apply:insert text block']
+      }
     }
     readonly initial: 'pristine'
     readonly states: {
@@ -2078,35 +2676,21 @@ export declare type PatchObservable = Observable<{
   snapshot: PortableTextBlock[] | undefined
 }>
 
+/**
+ * @alpha
+ */
+export declare type PickFromUnion<
+  TUnion,
+  TTagKey extends keyof TUnion,
+  TPickedTags extends TUnion[TTagKey],
+> = TUnion extends Record<TTagKey, TPickedTags> ? TUnion : never
+
 /**
  * @public
  */
 export declare const PortableTextEditable: ForwardRefExoticComponent<
-  Omit<
-    Omit<
-      TextareaHTMLAttributes<HTMLDivElement>,
-      'onPaste' | 'onCopy' | 'onBeforeInput'
-    > & {
-      hotkeys?: HotkeyOptions
-      onBeforeInput?: (event: InputEvent) => void
-      onPaste?: OnPasteFn
-      onCopy?: OnCopyFn
-      ref: MutableRefObject<HTMLDivElement | null>
-      rangeDecorations?: RangeDecoration[]
-      renderAnnotation?: RenderAnnotationFunction
-      renderBlock?: RenderBlockFunction
-      renderChild?: RenderChildFunction
-      renderDecorator?: RenderDecoratorFunction
-      renderListItem?: RenderListItemFunction
-      renderPlaceholder?: RenderPlaceholderFunction
-      renderStyle?: RenderStyleFunction
-      scrollSelectionIntoView?: ScrollSelectionIntoViewFunction
-      selection?: EditorSelection
-      spellCheck?: boolean
-    } & Omit<HTMLProps<HTMLDivElement>, 'onPaste' | 'onBeforeInput' | 'as'>,
-    'ref'
-  > &
-    RefAttributes<HTMLDivElement>
+  Omit<PortableTextEditableProps, 'ref'> &
+    RefAttributes<Omit<HTMLDivElement, 'onPaste' | 'onBeforeInput' | 'as'>>
 >
 
 /**
@@ -2447,6 +3031,23 @@ export declare interface PortableTextSlateEditor extends ReactEditor {
   redo: () => void
 }
 
+/**
+ * @alpha
+ */
+export declare type RaiseBehaviorActionIntend<
+  TBehaviorEventType extends BehaviorEvent['type'] = BehaviorEvent['type'],
+  TGuardResponse = true,
+> = (
+  {
+    context,
+    event,
+  }: {
+    context: BehaviorContext
+    event: PickFromUnion<BehaviorEvent, 'type', TBehaviorEventType>
+  },
+  guardResponse: TGuardResponse,
+) => BehaviorActionIntend | void
+
 /**
  * A range decoration is a UI affordance that wraps a given selection range in the editor
  * with a custom component. This can be used to highlight search results,