@portabletext/editor 7.9.0 → 7.10.0

package/lib/_chunks-dts/behavior.types.action.d.ts

@@ -1,18 +1,23 @@
-import * as _portabletext_schema6 from "@portabletext/schema";
-import { AnnotationDefinition, AnnotationSchemaType, AnnotationSchemaType as AnnotationSchemaType$1, BaseDefinition, BlockObjectDefinition, BlockObjectSchemaType, BlockObjectSchemaType as BlockObjectSchemaType$1, DecoratorDefinition, DecoratorSchemaType, DecoratorSchemaType as DecoratorSchemaType$1, FieldDefinition, FieldDefinition as FieldDefinition$1, InlineObjectDefinition, InlineObjectSchemaType, InlineObjectSchemaType as InlineObjectSchemaType$1, ListDefinition, ListSchemaType, ListSchemaType as ListSchemaType$1, OfDefinition, PortableTextBlock, PortableTextBlock as PortableTextBlock$1, PortableTextChild, PortableTextChild as PortableTextChild$1, PortableTextObject, PortableTextObject as PortableTextObject$1, PortableTextSpan, PortableTextSpan as PortableTextSpan$1, PortableTextTextBlock, PortableTextTextBlock as PortableTextTextBlock$1, Schema, SchemaDefinition, SchemaDefinition as SchemaDefinition$1, StyleDefinition, StyleSchemaType, StyleSchemaType as StyleSchemaType$1, TypedObject, defineSchema } from "@portabletext/schema";
-import * as xstate31 from "xstate";
+import { AnnotationSchemaType, BlockObjectSchemaType, DecoratorSchemaType, FieldDefinition, InlineObjectSchemaType, ListSchemaType, OfDefinition, PortableTextBlock, PortableTextChild, PortableTextObject, PortableTextSpan, PortableTextTextBlock, Schema, StyleSchemaType, TypedObject } from "@portabletext/schema";
+import { Patch } from "@portabletext/patches";
 import { ActorRefFrom } from "xstate";
-import * as react7 from "react";
-import React$1, { BaseSyntheticEvent, ClipboardEvent as ClipboardEvent$1, FocusEvent, JSX, PropsWithChildren, ReactElement, RefObject, TextareaHTMLAttributes } from "react";
-import { Patch, Patch as Patch$1 } from "@portabletext/patches";
+import { BaseSyntheticEvent, ClipboardEvent as ClipboardEvent$1, FocusEvent, JSX, PropsWithChildren, ReactElement, RefObject, TextareaHTMLAttributes } from "react";
+type EditorPriority = {
+  id: string;
+  name?: string;
+  reference?: {
+    priority: EditorPriority;
+    importance: 'higher' | 'lower';
+  };
+};
 type MIMEType = `${string}/${string}`;
 /**
  * @internal
  */
 type PickFromUnion<TUnion, TTagKey extends keyof TUnion, TPickedTags extends TUnion[TTagKey]> = TUnion extends Record<TTagKey, TPickedTags> ? TUnion : never;
-type NamespaceEvent<TEvent, TNamespace$1 extends string> = TEvent extends {
+type NamespaceEvent<TEvent, TNamespace extends string> = TEvent extends {
   type: infer TEventType;
-} ? { [K in keyof TEvent]: K extends 'type' ? `${TNamespace$1}.${TEventType & string}` : TEvent[K] } : never;
+} ? { [K in keyof TEvent]: K extends 'type' ? `${TNamespace}.${TEventType & string}` : TEvent[K] } : never;
 type StrictExtract<T, U extends T> = U;
 type Converter<TMIMEType extends MIMEType = MIMEType> = {
   mimeType: TMIMEType;
@@ -109,7 +114,7 @@ type ChildPath = Path;
  * always render portable text objects: `'span'` is always a leaf and
  * `'block'` is always a text block; both are excluded.
  */
-type ContainerNodeForType<TType$1 extends string> = TType$1 extends 'span' | 'block' ? never : PortableTextObject;
+type ContainerNodeForType<TType extends string> = TType extends 'span' | 'block' ? never : PortableTextObject;
 /**
  * @alpha
  *
@@ -413,14 +418,14 @@ type RegistrableNode = Container | TextBlock | Span | BlockObject | InlineObject
  * })
  * ```
  */
-declare function defineContainer<const TType$1 extends string>(config: {
-  type: TType$1 extends 'span' ? "Error: defineContainer({type: 'span'}) is forbidden -- 'span' is always a span, use defineSpan" : TType$1 extends 'block' ? "Error: defineContainer({type: 'block'}) is forbidden -- 'block' is always a text block, use defineTextBlock" : TType$1 extends '*' ? "Error: defineContainer({type: '*'}) is forbidden -- containers cannot be registered by wildcard" : TType$1;
+declare function defineContainer<const TType extends string>(config: {
+  type: TType extends 'span' ? "Error: defineContainer({type: 'span'}) is forbidden -- 'span' is always a span, use defineSpan" : TType extends 'block' ? "Error: defineContainer({type: 'block'}) is forbidden -- 'block' is always a text block, use defineTextBlock" : TType extends '*' ? "Error: defineContainer({type: '*'}) is forbidden -- containers cannot be registered by wildcard" : TType;
   arrayField: string;
   render?: (props: {
     attributes: Record<string, unknown>;
     children: ReactElement;
     focused: boolean;
-    node: ContainerNodeForType<TType$1>;
+    node: ContainerNodeForType<TType>;
     path: Path;
     readOnly: boolean;
     selected: boolean;
@@ -450,8 +455,8 @@ declare function defineContainer<const TType$1 extends string>(config: {
  * })
  * ```
  */
-declare function defineSpan<const TType$1 extends string>(config: {
-  type: TType$1 extends 'block' ? "Error: defineSpan({type: 'block'}) is forbidden -- 'block' is always a text block, use defineTextBlock" : TType$1;
+declare function defineSpan<const TType extends string>(config: {
+  type: TType extends 'block' ? "Error: defineSpan({type: 'block'}) is forbidden -- 'block' is always a text block, use defineTextBlock" : TType;
   render?: SpanRender;
 }): Span;
 /**
@@ -478,8 +483,8 @@ declare function defineSpan<const TType$1 extends string>(config: {
  * })
  * ```
  */
-declare function defineBlockObject<const TType$1 extends string>(config: {
-  type: TType$1 extends 'block' ? "Error: defineBlockObject({type: 'block'}) is forbidden -- 'block' is always a text block, use defineTextBlock" : TType$1 extends 'span' ? "Error: defineBlockObject({type: 'span'}) is forbidden -- 'span' is always a span, use defineSpan" : TType$1;
+declare function defineBlockObject<const TType extends string>(config: {
+  type: TType extends 'block' ? "Error: defineBlockObject({type: 'block'}) is forbidden -- 'block' is always a text block, use defineTextBlock" : TType extends 'span' ? "Error: defineBlockObject({type: 'span'}) is forbidden -- 'span' is always a span, use defineSpan" : TType;
   render?: BlockObjectRender;
 }): BlockObject;
 /**
@@ -506,8 +511,8 @@ declare function defineBlockObject<const TType$1 extends string>(config: {
  * })
  * ```
  */
-declare function defineInlineObject<const TType$1 extends string>(config: {
-  type: TType$1 extends 'block' ? "Error: defineInlineObject({type: 'block'}) is forbidden -- 'block' is always a text block, use defineTextBlock" : TType$1 extends 'span' ? "Error: defineInlineObject({type: 'span'}) is forbidden -- 'span' is always a span, use defineSpan" : TType$1;
+declare function defineInlineObject<const TType extends string>(config: {
+  type: TType extends 'block' ? "Error: defineInlineObject({type: 'block'}) is forbidden -- 'block' is always a text block, use defineTextBlock" : TType extends 'span' ? "Error: defineInlineObject({type: 'span'}) is forbidden -- 'span' is always a span, use defineSpan" : TType;
   render?: InlineObjectRender;
 }): InlineObject;
 /**
@@ -532,8 +537,8 @@ declare function defineInlineObject<const TType$1 extends string>(config: {
  * })
  * ```
  */
-declare function defineTextBlock<const TType$1 extends string>(config: {
-  type: TType$1 extends 'span' ? "Error: defineTextBlock({type: 'span'}) is forbidden -- 'span' is always a span, use defineSpan" : TType$1;
+declare function defineTextBlock<const TType extends string>(config: {
+  type: TType extends 'span' ? "Error: defineTextBlock({type: 'span'}) is forbidden -- 'span' is always a span, use defineSpan" : TType;
   render?: TextBlockRender;
   of?: ReadonlyArray<Span | InlineObject>;
 }): TextBlock;
@@ -839,7 +844,7 @@ declare class PortableTextEditor {
    */
   static delete: (editor: PortableTextEditor, selection: EditorSelection, options?: EditableAPIDeleteOptions) => void;
   static findDOMNode: (editor: PortableTextEditor, element: PortableTextBlock | PortableTextChild) => Node | undefined;
-  static findByPath: (editor: PortableTextEditor, path: Path) => [_portabletext_schema6.PortableTextTextBlock<PortableTextObject | _portabletext_schema6.PortableTextSpan> | PortableTextObject | _portabletext_schema6.PortableTextSpan | undefined, Path | undefined];
+  static findByPath: (editor: PortableTextEditor, path: Path) => [import("@portabletext/schema").PortableTextTextBlock<PortableTextObject | import("@portabletext/schema").PortableTextSpan> | PortableTextObject | import("@portabletext/schema").PortableTextSpan | undefined, Path | undefined];
   /**
    * @deprecated
    * Use `editor.send(...)` instead
@@ -1177,7 +1182,7 @@ type PortableTextEditableProps = Omit<TextareaHTMLAttributes<HTMLDivElement>, 'o
  * ```
  * @group Components
  */
-declare const PortableTextEditable: react7.ForwardRefExoticComponent<Omit<PortableTextEditableProps, "ref"> & react7.RefAttributes<Omit<HTMLDivElement, "as" | "onPaste" | "onBeforeInput">>>;
+declare const PortableTextEditable: import("react").ForwardRefExoticComponent<Omit<PortableTextEditableProps, "ref"> & import("react").RefAttributes<Omit<HTMLDivElement, "as" | "onPaste" | "onBeforeInput">>>;
 /** @beta */
 interface EditableAPIDeleteOptions {
   mode?: 'blocks' | 'children' | 'selected';
@@ -1696,7 +1701,7 @@ interface BaseEditor {
   pointRefs: Set<PointRef>;
   rangeRefs: Set<RangeRef>;
   apply: (operation: EngineOperation) => void;
-  normalizeNode: (entry: [Editor$1 | Node$1, Path], options?: {
+  normalizeNode: (entry: [Editor | Node$1, Path], options?: {
     operation?: EngineOperation;
   }) => void;
   onChange: (options?: {
@@ -1715,7 +1720,7 @@ interface BaseEditor {
   select: (target: Location) => void;
   setSelection: (props: Partial<Range>) => void;
 }
-type Editor$1 = BaseEditor & DOMEditor & PortableTextEditorEngine;
+type Editor = BaseEditor & DOMEditor & PortableTextEditorEngine;
 type StringDiff = {
   start: number;
   end: number;
@@ -1749,11 +1754,11 @@ type Action = {
  * A DOM-specific version of the `Editor` interface.
  */
 interface DOMEditor extends BaseEditor {
-  hasEditableTarget: (editor: Editor$1, target: EventTarget | null) => target is DOMNode;
-  hasRange: (editor: Editor$1, range: Range) => boolean;
-  hasSelectableTarget: (editor: Editor$1, target: EventTarget | null) => boolean;
-  hasTarget: (editor: Editor$1, target: EventTarget | null) => target is DOMNode;
-  isTargetInsideNonReadonlyVoid: (editor: Editor$1, target: EventTarget | null) => boolean;
+  hasEditableTarget: (editor: Editor, target: EventTarget | null) => target is DOMNode;
+  hasRange: (editor: Editor, range: Range) => boolean;
+  hasSelectableTarget: (editor: Editor, target: EventTarget | null) => boolean;
+  hasTarget: (editor: Editor, target: EventTarget | null) => target is DOMNode;
+  isTargetInsideNonReadonlyVoid: (editor: Editor, target: EventTarget | null) => boolean;
   isNodeMapDirty: boolean;
   domWindow: Window | null;
   domElement: HTMLElement | null;
@@ -1774,51 +1779,51 @@ interface DOMEditorInterface {
   /**
    * Blur the editor.
    */
-  blur: (editor: Editor$1) => void;
+  blur: (editor: Editor) => void;
   /**
    * Find the DOM node that implements DocumentOrShadowRoot for the editor.
    */
-  findDocumentOrShadowRoot: (editor: Editor$1) => Document | ShadowRoot;
+  findDocumentOrShadowRoot: (editor: Editor) => Document | ShadowRoot;
   /**
    * Focus the editor.
    */
-  focus: (editor: Editor$1, options?: {
+  focus: (editor: Editor, options?: {
     retries: number;
   }) => void;
   /**
    * Return the host window of the current editor.
    */
-  getWindow: (editor: Editor$1) => Window;
+  getWindow: (editor: Editor) => Window;
   /**
    * Check if a DOM node is within the editor.
    */
-  hasDOMNode: (editor: Editor$1, target: DOMNode, options?: {
+  hasDOMNode: (editor: Editor, target: DOMNode, options?: {
     editable?: boolean;
   }) => boolean;
   /**
    * Check if the target is editable and in the editor.
    */
-  hasEditableTarget: (editor: Editor$1, target: EventTarget | null) => target is DOMNode;
+  hasEditableTarget: (editor: Editor, target: EventTarget | null) => target is DOMNode;
   /**
    *
    */
-  hasRange: (editor: Editor$1, range: Range) => boolean;
+  hasRange: (editor: Editor, range: Range) => boolean;
   /**
    * Check if the target can be selectable
    */
-  hasSelectableTarget: (editor: Editor$1, target: EventTarget | null) => boolean;
+  hasSelectableTarget: (editor: Editor, target: EventTarget | null) => boolean;
   /**
    * Check if the target is in the editor.
    */
-  hasTarget: (editor: Editor$1, target: EventTarget | null) => target is DOMNode;
+  hasTarget: (editor: Editor, target: EventTarget | null) => target is DOMNode;
   /**
    * Check if the target is inside void and in an non-readonly editor.
    */
-  isTargetInsideNonReadonlyVoid: (editor: Editor$1, target: EventTarget | null) => boolean;
+  isTargetInsideNonReadonlyVoid: (editor: Editor, target: EventTarget | null) => boolean;
   /**
    * Find a native DOM selection point from a point.
    */
-  toDOMPoint: (editor: Editor$1, point: Point) => DOMPoint;
+  toDOMPoint: (editor: Editor, point: Point) => DOMPoint;
   /**
    * Find a native DOM range from a `range`.
    *
@@ -1827,11 +1832,11 @@ interface DOMEditorInterface {
    * there is no way to create a reverse DOM Range using Range.setStart/setEnd
    * according to https://dom.spec.whatwg.org/#concept-range-bp-set.
    */
-  toDOMRange: (editor: Editor$1, range: Range) => DOMRange;
+  toDOMRange: (editor: Editor, range: Range) => DOMRange;
   /**
    * Find a point from a DOM selection's `domNode` and `domOffset`.
    */
-  toSelectionPoint: <T extends boolean>(editor: Editor$1, domPoint: DOMPoint, options: {
+  toSelectionPoint: <T extends boolean>(editor: Editor, domPoint: DOMPoint, options: {
     exactMatch: boolean;
     suppressThrow: T;
     /**
@@ -1843,7 +1848,7 @@ interface DOMEditorInterface {
   /**
    * Find a range from a DOM range or selection.
    */
-  toEditorSelection: <T extends boolean>(editor: Editor$1, domRange: DOMRange | DOMStaticRange | DOMSelection, options: {
+  toEditorSelection: <T extends boolean>(editor: Editor, domRange: DOMRange | DOMStaticRange | DOMSelection, options: {
     exactMatch: boolean;
     suppressThrow: T;
   }) => T extends true ? Range | null : Range;
@@ -1884,6 +1889,19 @@ interface PortableTextEditorEngine extends DOMEditor {
    * per render, regardless of how many operations a batch applied.
    */
   listIndexMapDirty: boolean;
+  /**
+   * Per-notify pending flags for the segmented selector channels
+   * (`EngineSelectorChannel`). Set where the corresponding state mutates
+   * (registration map swaps in `register-node-on-engine.ts`, list-index
+   * invalidation in the update-value subscriber) and consumed by the
+   * React layer's `onContextChange` dispatch. Separate from
+   * `listIndexMapDirty`, which any read clears via `getListIndexMap`;
+   * these are cleared only when the notification is delivered.
+   */
+  selectorChannelsPending: {
+    registrations: boolean;
+    listIndex: boolean;
+  };
   /**
    * Serialized paths of sibling groups (a node's keyed child array, or the
    * root value array as `''`) whose children have been verified to carry no
@@ -2003,6 +2021,10 @@ type Behavior<TBehaviorEventType extends '*' | `${BehaviorEventTypeNamespace}.*`
  *
  */
 declare function defineBehavior<TPayload extends Record<string, unknown>, TBehaviorEventType extends '*' | `${BehaviorEventTypeNamespace}.*` | BehaviorEvent['type'] = CustomBehaviorEvent['type'], TGuardResponse = true>(behavior: Behavior<TBehaviorEventType, TGuardResponse, ResolveBehaviorEvent<TBehaviorEventType, TPayload>>): Behavior;
+type BehaviorConfig = {
+  behavior: Behavior;
+  priority: EditorPriority;
+};
 /**
  * The document-changing operations emitted through
  * `editor.on('operation', ...)`. Every change to the editor (local edits,
@@ -2115,207 +2137,6 @@ type PatchEvent = {
   type: 'patch';
   patch: Patch;
 };
-/**
- * @public
- */
-type EditorConfig = {
-  /**
-   * @beta
-   */
-  keyGenerator?: () => string;
-  readOnly?: boolean;
-  initialValue?: Array<PortableTextBlock>;
-  schemaDefinition: SchemaDefinition;
-};
-/**
- * @public
- */
-type EditorEvent = ExternalEditorEvent | ExternalBehaviorEvent | {
-  type: 'update value';
-  value: Array<PortableTextBlock> | undefined;
-};
-/**
- * @public
- */
-type Editor = {
-  dom: EditorDom;
-  getSnapshot: () => EditorSnapshot;
-  /**
-   * @beta
-   */
-  registerBehavior: (config: {
-    behavior: Behavior;
-  }) => () => void;
-  /**
-   * Register a node renderer. The `node` argument is the result of one
-   * of the `defineX` factories (`defineContainer`, `defineTextBlock`,
-   * `defineSpan`, `defineBlockObject`, `defineInlineObject`). Returns
-   * a function that unregisters the node when called.
-   *
-   * @alpha
-   */
-  registerNode: (config: {
-    node: RegistrableNode;
-  }) => () => void;
-  send: (event: EditorEvent) => void;
-  /**
-   * Register an event listener.
-   *
-   * With `{batch: true}` the listener is called once per burst with
-   * `Array<Event>`, every matching event emitted before control returns to the
-   * event loop (one synchronous `editor.send` worth, normalization included),
-   * in delivery order, on the trailing microtask. That is the same boundary at
-   * which the editor settles its own state, so each call is one fully-applied,
-   * normalized change. Without it (the default), the listener runs
-   * synchronously for every event and receives a single event.
-   */
-  on: {
-    <TType$1 extends EditorEmittedEvent['type'] | '*'>(type: TType$1, listener: (events: Array<EditorEmittedEvent & (TType$1 extends '*' ? unknown : {
-      type: TType$1;
-    })>) => void, options: {
-      batch: true;
-    }): {
-      unsubscribe: () => void;
-    };
-    <TType$1 extends EditorEmittedEvent['type'] | '*'>(type: TType$1, listener: (event: EditorEmittedEvent & (TType$1 extends '*' ? unknown : {
-      type: TType$1;
-    })) => void, options?: {
-      batch?: false;
-    }): {
-      unsubscribe: () => void;
-    };
-  };
-  /**
-   * Subscribe to editor state changes. The observer's `next` callback fires
-   * with the current `EditorSnapshot` on relevant transitions (selection
-   * updates, content mutations, behavior dispatch, configuration changes).
-   *
-   * Notifications are coalesced: a synchronous burst of transitions (e.g. the
-   * many operations one action applies, like undoing a large delete) delivers
-   * a single `next` with the settled snapshot on the next microtask, rather
-   * than one `next` per transition. The snapshot is cumulative, so only
-   * intermediate per-transition states are skipped. To observe every
-   * operation, use `editor.on('operation', ...)`.
-   *
-   * The editor has no terminal state and no error path, so `error` and
-   * `complete` are part of the observable contract but never fire. They are
-   * kept for structural compatibility with `useSyncExternalStore`,
-   * `@xstate/react`'s `useSelector`, and other observer-shaped consumers.
-   */
-  subscribe(observer: {
-    next?: (snapshot: EditorSnapshot) => void;
-    error?: (err: unknown) => void;
-    complete?: () => void;
-  }): {
-    unsubscribe: () => void;
-  };
-};
-/**
- * @public
- */
-type EditorProviderProps = {
-  initialConfig: EditorConfig;
-  children?: React$1.ReactNode;
-};
-/**
- * @public
- * The EditorProvider component is used to set up the editor context and configure the Portable Text Editor.
- * @example
- * ```tsx
- * import {EditorProvider} from '@portabletext/editor'
- *
- * function App() {
- *  return (
- *    <EditorProvider initialConfig={{ ... }} >
- *      ...
- *    </EditorProvider>
- *  )
- * }
- *
- * ```
- * @group Components
- */
-declare function EditorProvider(props: EditorProviderProps): React$1.JSX.Element;
-/**
- * @public
- */
-type EditorSelector<TSelected> = (snapshot: EditorSnapshot) => TSelected;
-/**
- * @public
- * Hook to select a value from the editor state.
- * @example
- * Pass a selector as the second argument
- * ```tsx
- * import { useEditorSelector } from '@portabletext/editor'
- *
- * function MyComponent(editor) {
- *  const value = useEditorSelector(editor, selector)
- * }
- * ```
- * @example
- * Pass an inline selector as the second argument.
- * In this case, use the editor context to obtain the schema.
- * ```tsx
- * import { useEditorSelector } from '@portabletext/editor'
- *
- * function MyComponent(editor) {
- *  const schema = useEditorSelector(editor, (snapshot) => snapshot.context.schema)
- * }
- * ```
- * @group Hooks
- */
-declare function useEditorSelector<TSelected>(editor: Editor, selector: EditorSelector<TSelected>, compare?: (a: TSelected, b: TSelected) => boolean): TSelected;
-/**
- * @deprecated Use `useEditor` to get the current editor instance.
- * @public
- * Get the current editor object from the React context.
- */
-declare const usePortableTextEditor: () => PortableTextEditor;
-/**
- * @deprecated Use `useEditorSelector` to get the current editor selection.
- * @public
- * Get the current editor selection from the React context.
- */
-declare const usePortableTextEditorSelection: () => EditorSelection;
-/**
- * @public
- */
-declare const defaultKeyGenerator: () => string;
-/**
- * @public
- * Get the current editor context from the `EditorProvider`.
- * Must be used inside the `EditorProvider` component.
- * @returns The current editor object.
- * @example
- * ```tsx
- * import { useEditor } from '@portabletext/editor'
- *
- * function MyComponent() {
- *  const editor = useEditor()
- * }
- * ```
- * @group Hooks
- */
-declare function useEditor(): Editor;
-/**
- * @beta
- */
-type BlockOffset = {
-  path: BlockPath;
-  offset: number;
-};
-type EditorPriority = {
-  id: string;
-  name?: string;
-  reference?: {
-    priority: EditorPriority;
-    importance: 'higher' | 'lower';
-  };
-};
-type BehaviorConfig = {
-  behavior: Behavior;
-  priority: EditorPriority;
-};
 /**
  * @public
  */
@@ -2342,7 +2163,7 @@ type EditorActor = ActorRefFrom<typeof editorMachine>;
 /**
  * @internal
  */
-declare const editorMachine: xstate31.StateMachine<{
+declare const editorMachine: import("xstate").StateMachine<{
   behaviors: Set<BehaviorConfig>;
   behaviorsSorted: boolean;
   initialConverters: Array<Converter>;
@@ -2415,55 +2236,55 @@ declare const editorMachine: xstate31.StateMachine<{
   params: unknown;
 } | {
   type: "add behavior to context";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "remove behavior from context";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "add editor engine to context";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "attach maps to editor engine";
   params: unknown;
 } | {
   type: "emit patch event";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "emit mutation event";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "emit read only";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "emit editable";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "defer event";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "emit pending events";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "emit ready";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "clear pending events";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "discard conflicting pending patches";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "discard all pending events";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "defer incoming patches";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "emit pending incoming patches";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "clear pending incoming patches";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 } | {
   type: "handle blur";
   params: unknown;
@@ -2475,7 +2296,7 @@ declare const editorMachine: xstate31.StateMachine<{
   params: unknown;
 } | {
   type: "sort behaviors";
-  params: xstate31.NonReducibleUnknown;
+  params: import("xstate").NonReducibleUnknown;
 }, {
   type: "engine is busy";
   params: unknown;
@@ -2504,9 +2325,9 @@ declare const editorMachine: xstate31.StateMachine<{
   readOnly?: boolean;
   schema: EditorSchema;
   initialValue?: Array<PortableTextBlock>;
-}, xstate31.NonReducibleUnknown, InternalPatchEvent | MutationEvent | PatchesEvent | {
+}, import("xstate").NonReducibleUnknown, InternalPatchEvent | MutationEvent | PatchesEvent | {
   type: "blurred";
-  event: react7.FocusEvent<HTMLDivElement, Element>;
+  event: import("react").FocusEvent<HTMLDivElement, Element>;
 } | {
   type: "done loading";
 } | {
@@ -2518,16 +2339,16 @@ declare const editorMachine: xstate31.StateMachine<{
   data: unknown;
 } | {
   type: "focused";
-  event: react7.FocusEvent<HTMLDivElement, Element>;
+  event: import("react").FocusEvent<HTMLDivElement, Element>;
 } | {
   type: "invalid value";
-  resolution: InvalidValueResolution | null;
+  resolution: import("..").InvalidValueResolution | null;
   value: Array<PortableTextBlock> | undefined;
 } | {
   type: "loading";
 } | {
   type: "operation";
-  operation: Operation;
+  operation: import("..").Operation;
 } | {
   type: "read only";
 } | {
@@ -2538,7 +2359,7 @@ declare const editorMachine: xstate31.StateMachine<{
 } | {
   type: "value changed";
   value: Array<PortableTextBlock> | undefined;
-}, xstate31.MetaObject, {
+}, import("xstate").MetaObject, {
   id: "editor";
   states: {
     readonly 'edit mode': {
@@ -2621,12 +2442,12 @@ type ChildWithOptionalKey = SpanWithOptionalKey | ObjectBlockWithOptionalKey;
  */
 type BehaviorEvent = SyntheticBehaviorEvent | NativeBehaviorEvent | CustomBehaviorEvent;
 type BehaviorEventTypeNamespace = SyntheticBehaviorEventNamespace | NativeBehaviorEventNamespace | CustomBehaviorEventNamespace;
-type NamespacedBehaviorEventType<TNamespace$1 extends BehaviorEventTypeNamespace | ''> = TNamespace$1 extends '' ? BehaviorEvent['type'] : Extract<BehaviorEvent['type'], TNamespace$1 | `${TNamespace$1}.${string}`>;
+type NamespacedBehaviorEventType<TNamespace extends BehaviorEventTypeNamespace | ''> = TNamespace extends '' ? BehaviorEvent['type'] : Extract<BehaviorEvent['type'], TNamespace | `${TNamespace}.${string}`>;
 /**************************************
  * External events
  **************************************/
 type ExternalBehaviorEventNamespace = 'blur' | 'focus' | 'insert';
-type ExternalBehaviorEventType<TNamespace$1 extends ExternalBehaviorEventNamespace, TType$1 extends string = ''> = TType$1 extends '' ? `${TNamespace$1}` : `${TNamespace$1}.${TType$1}`;
+type ExternalBehaviorEventType<TNamespace extends ExternalBehaviorEventNamespace, TType extends string = ''> = TType extends '' ? `${TNamespace}` : `${TNamespace}.${TType}`;
 type ExternalBehaviorEvent = {
   type: ExternalBehaviorEventType<'blur'>;
 } | {
@@ -3106,23 +2927,38 @@ type MouseBehaviorEvent = {
  * Custom events
  **************************************/
 type CustomBehaviorEventNamespace = 'custom';
-type CustomBehaviorEventType<TNamespace$1 extends CustomBehaviorEventNamespace, TType$1 extends string = ''> = TType$1 extends '' ? `${TNamespace$1}` : `${TNamespace$1}.${TType$1}`;
+type CustomBehaviorEventType<TNamespace extends CustomBehaviorEventNamespace, TType extends string = ''> = TType extends '' ? `${TNamespace}` : `${TNamespace}.${TType}`;
 /**
  * @beta
  */
-type CustomBehaviorEvent<TPayload extends Record<string, unknown> = Record<string, unknown>, TType$1 extends string = string, TInternalType extends CustomBehaviorEventType<'custom', TType$1> = CustomBehaviorEventType<'custom', TType$1>> = {
+type CustomBehaviorEvent<TPayload extends Record<string, unknown> = Record<string, unknown>, TType extends string = string, TInternalType extends CustomBehaviorEventType<'custom', TType> = CustomBehaviorEventType<'custom', TType>> = {
   type: TInternalType;
 } & TPayload;
 /**************************************
  * Resolve behavior event
  **************************************/
 type ResolveBehaviorEvent<TBehaviorEventType extends '*' | `${BehaviorEventTypeNamespace}.*` | BehaviorEvent['type'], TPayload extends Record<string, unknown> = Record<string, unknown>> = TBehaviorEventType extends '*' ? BehaviorEvent : TBehaviorEventType extends `${infer TNamespace}.*` ? TNamespace extends BehaviorEventTypeNamespace ? PickFromUnion<BehaviorEvent, 'type', NamespacedBehaviorEventType<TNamespace>> : never : TBehaviorEventType extends `custom.${infer TType}` ? CustomBehaviorEvent<TPayload, TType> : TBehaviorEventType extends BehaviorEvent['type'] ? PickFromUnion<BehaviorEvent, 'type', TBehaviorEventType> : never;
-type ExtractNamespace<TType$1 extends string> = TType$1 extends `${infer Namespace}.${string}` ? Namespace : TType$1;
+type ExtractNamespace<TType extends string> = TType extends `${infer Namespace}.${string}` ? Namespace : TType;
 type EditorDom = {
   getBlockNodes: (snapshot: EditorSnapshot) => Array<Node>;
   getChildNodes: (snapshot: EditorSnapshot) => Array<Node>;
   getEditorElement: () => Element | undefined;
+  /**
+   * The bounding rect of the snapshot's selection. A collapsed selection gives
+   * a caret rect.
+   */
   getSelectionRect: (snapshot: EditorSnapshot) => DOMRect | null;
+  /**
+   * Resolves viewport (client) coordinates to the editor point where a click
+   * at those coordinates would place the caret. The browser snaps to the
+   * nearest position within the element at the coordinates. Returns `null`
+   * when the coordinates don't resolve to a position inside the editor's
+   * content.
+   */
+  getPointAtCoordinates: (coordinates: {
+    x: number;
+    y: number;
+  }) => EditorSelectionPoint | null;
   getStartBlockElement: (snapshot: EditorSnapshot) => Element | null;
   getEndBlockElement: (snapshot: EditorSnapshot) => Element | null;
   /**
@@ -3322,5 +3158,5 @@ type BehaviorActionSet<TBehaviorEvent, TGuardResponse> = (payload: {
   event: TBehaviorEvent;
   dom: EditorDom;
 }, guardResponse: TGuardResponse) => Array<BehaviorAction>;
-export { EditorContext as $, SpanRender as $t, PortableTextTextBlock$1 as A, HotkeyOptions as At, EditorSelector as B, RegisteredPositional as Bt, ListDefinition as C, RenderEditableFunction as Ct, PortableTextChild$1 as D, ScrollSelectionIntoViewFunction as Dt, PortableTextBlock$1 as E, RenderStyleFunction as Et, BlockOffset as F, EditorSchema as Ft, EditorConfig as G, Container as Gt, EditorProvider as H, BlockObject as Ht, useEditor as I, Containers as It, MutationEvent as J, InlineObject as Jt, EditorEvent as K, ContainerRender as Kt, defaultKeyGenerator as L, RegisteredBlockObject as Lt, StyleDefinition as M, resolveContainerAt as Mt, StyleSchemaType$1 as N, TraversalSnapshot as Nt, PortableTextObject$1 as O, PortableTextEditable as Ot, defineSchema as P, Node$1 as Pt, BehaviorGuard as Q, Span as Qt, usePortableTextEditorSelection as R, RegisteredContainer as Rt, InlineObjectSchemaType$1 as S, RenderDecoratorFunction as St, Patch$1 as T, RenderPlaceholderFunction as Tt, EditorProviderProps as U, BlockObjectRender as Ut, useEditorSelector as V, RegisteredSpan as Vt, Editor as W, BlockObjectRenderProps as Wt, Behavior as X, InlineObjectRenderProps as Xt, Operation as Y, InlineObjectRender as Yt, defineBehavior as Z, RegistrableNode as Zt, BlockObjectSchemaType$1 as _, RangeDecoration as _t, forward as a, defineContainer as an, BlockListItemRenderProps as at, FieldDefinition$1 as b, RenderBlockFunction as bt, CustomBehaviorEvent as c, defineTextBlock as cn, EditableAPIDeleteOptions as ct, SyntheticBehaviorEvent as d, ChildPath as dn, InvalidValueResolution as dt, SpanRenderProps as en, EditorSnapshot as et, PatchesEvent as f, KeyedSegment as fn, OnCopyFn as ft, BlockObjectDefinition as g, PasteData as gt, BaseDefinition as h, OnPasteResultOrPromise as ht, execute as i, defineBlockObject as in, BlockDecoratorRenderProps as it, SchemaDefinition$1 as j, PortableTextEditor as jt, PortableTextSpan$1 as k, PortableTextEditableProps as kt, InsertPlacement as l, AnnotationPath as ln, EditorSelection as lt, AnnotationSchemaType$1 as m, OnPasteResult as mt, BehaviorActionSet as n, TextBlockRender as nn, BlockAnnotationRenderProps as nt, raise as o, defineInlineObject as on, BlockRenderProps as ot, AnnotationDefinition as p, Path as pn, OnPasteFn as pt, EditorEmittedEvent as q, ContainerRenderProps as qt, effect as r, TextBlockRenderProps as rn, BlockChildRenderProps as rt, BehaviorEvent as s, defineSpan as sn, BlockStyleRenderProps as st, BehaviorAction as t, TextBlock as tn, AddedAnnotationPaths as tt, NativeBehaviorEvent as u, BlockPath as un, EditorSelectionPoint as ut, DecoratorDefinition as v, RangeDecorationOnMovedDetails as vt, ListSchemaType$1 as w, RenderListItemFunction as wt, InlineObjectDefinition as x, RenderChildFunction as xt, DecoratorSchemaType$1 as y, RenderAnnotationFunction as yt, usePortableTextEditor as z, RegisteredInlineObject as zt };
+export { HotkeyOptions as $, BlockStyleRenderProps as A, defineSpan as At, RangeDecoration as B, EditorSnapshot as C, SpanRenderProps as Ct, BlockDecoratorRenderProps as D, defineBlockObject as Dt, BlockChildRenderProps as E, TextBlockRenderProps as Et, OnCopyFn as F, KeyedSegment as Ft, RenderDecoratorFunction as G, RenderAnnotationFunction as H, OnPasteFn as I, Path as It, RenderPlaceholderFunction as J, RenderEditableFunction as K, OnPasteResult as L, EditorSelection as M, AnnotationPath as Mt, EditorSelectionPoint as N, BlockPath as Nt, BlockListItemRenderProps as O, defineContainer as Ot, InvalidValueResolution as P, ChildPath as Pt, PortableTextEditableProps as Q, OnPasteResultOrPromise as R, EditorContext as S, SpanRender as St, BlockAnnotationRenderProps as T, TextBlockRender as Tt, RenderBlockFunction as U, RangeDecorationOnMovedDetails as V, RenderChildFunction as W, ScrollSelectionIntoViewFunction as X, RenderStyleFunction as Y, PortableTextEditable as Z, MutationEvent as _, InlineObject as _t, forward as a, Containers as at, defineBehavior as b, RegistrableNode as bt, BehaviorEvent as c, RegisteredInlineObject as ct, InsertPlacement as d, BlockObject as dt, PortableTextEditor as et, NativeBehaviorEvent as f, BlockObjectRender as ft, EditorEmittedEvent as g, ContainerRenderProps as gt, PatchesEvent as h, ContainerRender as ht, execute as i, EditorSchema as it, EditableAPIDeleteOptions as j, defineTextBlock as jt, BlockRenderProps as k, defineInlineObject as kt, CustomBehaviorEvent as l, RegisteredPositional as lt, ExternalEditorEvent as m, Container as mt, BehaviorActionSet as n, TraversalSnapshot as nt, raise as o, RegisteredBlockObject as ot, SyntheticBehaviorEvent as p, BlockObjectRenderProps as pt, RenderListItemFunction as q, effect as r, Node$1 as rt, EditorDom as s, RegisteredContainer as st, BehaviorAction as t, resolveContainerAt as tt, ExternalBehaviorEvent as u, RegisteredSpan as ut, Operation as v, InlineObjectRender as vt, AddedAnnotationPaths as w, TextBlock as wt, BehaviorGuard as x, Span as xt, Behavior as y, InlineObjectRenderProps as yt, PasteData as z };
 //# sourceMappingURL=behavior.types.action.d.ts.map