@portabletext/editor 1.35.0 → 1.35.2

package/lib/index.d.cts

@@ -607,52 +607,12 @@ export declare type EditorEvent =
 
 /**
  * @public
- * Listen for events emitted by the editor. Must be used inside `EditorProvider`. Events available include:
- *  - 'blurred'
- *  - 'done loading'
- *  - 'editable'
- *  - 'error'
- *  - 'focused'
- *  - 'invalid value'
- *  - 'loading'
- *  - 'mutation'
- *  - 'patch'
- *  - 'read only'
- *  - 'ready'
- *  - 'selection'
- *  - 'value changed'
+ * @deprecated
+ * This component has been renamed. Use `EventListenerPlugin` instead.
  *
- * @example
- * Listen and log events.
- * ```tsx
- * import {EditorProvider} from '@portabletext/editor'
- * import {EventListenerPlugin} from '@portabletext/editor/plugins'
- *
- * function MyComponent() {
- *  return (
- *  <EditorProvider>
- *   <EventListenerPlugin
- *    on={(event) => {
- *     console.log(event)
- *    }
- *   } />
- *   { ... }
- * </EditorProvider>
- *  )
- * }
  * ```
- * @example
- * Handle events when there is a mutation.
- * ```tsx
- * <EventListenerPlugin
- *  on={(event) => {
- *    if (event.type === 'mutation') {
- *      console.log('Value changed:', event.snapshot)
- *    }
- *  }}
- * />
+ * import {EventListenerPlugin} from '@portabletext/editor/plugins'
  * ```
- * @group Components
  */
 export declare function EditorEventListener(props: {
   on: (event: EditorEmittedEvent) => void
@@ -1013,6 +973,15 @@ declare const editorMachine: StateMachine<
   | {
       type: 'notify.unset'
       previousValue: Array<PortableTextBlock>
+    }
+  | {
+      type: 'dragstart'
+    }
+  | {
+      type: 'dragend'
+    }
+  | {
+      type: 'drop'
     },
   {},
   never,
@@ -1074,7 +1043,9 @@ declare const editorMachine: StateMachine<
   never,
   {
     'edit mode':
-      | 'editable'
+      | {
+          editable: 'dragging internally' | 'idle'
+        }
       | {
           'read only': 'read only' | 'determine initial edit mode'
         }
@@ -1085,7 +1056,7 @@ declare const editorMachine: StateMachine<
           pristine: 'normalizing' | 'idle'
         }
   },
-  string,
+  'dragging internally',
   {
     behaviors?: Array<Behavior>
     converters?: Array<Converter>
@@ -1759,6 +1730,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           Record<string, AnyActorRef | undefined>,
           StateValue,
@@ -2107,6 +2087,15 @@ declare const editorMachine: StateMachine<
         | {
             type: 'notify.unset'
             previousValue: Array<PortableTextBlock>
+          }
+        | {
+            type: 'dragstart'
+          }
+        | {
+            type: 'dragend'
+          }
+        | {
+            type: 'drop'
           },
         AnyEventObject
       >
@@ -2479,6 +2468,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -3116,6 +3114,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -3756,6 +3763,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -4395,6 +4411,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -5033,6 +5058,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -5672,6 +5706,15 @@ declare const editorMachine: StateMachine<
             | {
                 type: 'notify.unset'
                 previousValue: Array<PortableTextBlock>
+              }
+            | {
+                type: 'dragstart'
+              }
+            | {
+                type: 'dragend'
+              }
+            | {
+                type: 'drop'
               },
             undefined,
             never,
@@ -6036,6 +6079,15 @@ declare const editorMachine: StateMachine<
             | {
                 type: 'notify.unset'
                 previousValue: Array<PortableTextBlock>
+              }
+            | {
+                type: 'dragstart'
+              }
+            | {
+                type: 'dragend'
+              }
+            | {
+                type: 'drop'
               },
             undefined,
             never,
@@ -6675,6 +6727,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -7312,6 +7373,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -7950,6 +8020,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -8591,6 +8670,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -9232,6 +9320,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -9601,6 +9698,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -9967,6 +10073,15 @@ declare const editorMachine: StateMachine<
           | {
               type: 'notify.unset'
               previousValue: Array<PortableTextBlock>
+            }
+          | {
+              type: 'dragstart'
+            }
+          | {
+              type: 'dragend'
+            }
+          | {
+              type: 'drop'
             },
           undefined,
           never,
@@ -10483,6 +10598,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -11129,6 +11253,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -11768,6 +11901,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -12407,6 +12549,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -13059,6 +13210,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -13712,6 +13872,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -14351,6 +14520,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -14993,6 +15171,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -15686,6 +15873,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -16334,6 +16530,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -16983,6 +17188,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -17623,6 +17837,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -18265,6 +18488,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -18913,6 +19145,15 @@ declare const editorMachine: StateMachine<
                   | {
                       type: 'notify.unset'
                       previousValue: Array<PortableTextBlock>
+                    }
+                  | {
+                      type: 'dragstart'
+                    }
+                  | {
+                      type: 'dragend'
+                    }
+                  | {
+                      type: 'drop'
                     },
                   undefined,
                   never,
@@ -19208,6 +19449,27 @@ declare const editorMachine: StateMachine<
                 >
               }
             }
+            readonly initial: 'idle'
+            readonly states: {
+              readonly 'idle': {
+                readonly on: {
+                  readonly dragstart: {
+                    readonly target: 'dragging internally'
+                  }
+                }
+              }
+              readonly 'dragging internally': {
+                readonly tags: readonly ['dragging internally']
+                readonly on: {
+                  readonly dragend: {
+                    readonly target: 'idle'
+                  }
+                  readonly drop: {
+                    readonly target: 'idle'
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -19347,6 +19609,13 @@ export declare type EditorSelector<TSelected> = (
  */
 export declare type EditorSnapshot = {
   context: EditorContext
+  /**
+   * @beta
+   * Do not rely on this externally
+   */
+  beta: {
+    hasTag: HasTag
+  }
 }
 
 /**
@@ -19406,6 +19675,8 @@ export declare type FocusChange = {
   event: FocusEvent_2<HTMLDivElement, Element>
 }
 
+declare type HasTag = ReturnType<EditorActor['getSnapshot']>['hasTag']
+
 /** @internal */
 declare interface History_2 {
   redos: HistoryItem[]
@@ -19771,9 +20042,9 @@ export declare class PortableTextEditor extends Component<
     path: Path,
   ) => [
     (
-      | PortableTextSpan
+      | PortableTextTextBlock<PortableTextObject | PortableTextSpan>
       | PortableTextObject
-      | PortableTextTextBlock<PortableTextSpan | PortableTextObject>
+      | PortableTextSpan
       | undefined
     ),
     Path | undefined,