@wordpress/core-data 7.38.0 → 7.38.1-next.v.0

package/build-module/utils/crdt-user-selections.mjs

@@ -0,0 +1,144 @@
+// packages/core-data/src/utils/crdt-user-selections.ts
+import { Y, CRDT_RECORD_MAP_KEY } from "@wordpress/sync";
+import { getRootMap } from "./crdt-utils.mjs";
+var SelectionType = /* @__PURE__ */ ((SelectionType2) => {
+  SelectionType2["None"] = "none";
+  SelectionType2["Cursor"] = "cursor";
+  SelectionType2["SelectionInOneBlock"] = "selection-in-one-block";
+  SelectionType2["SelectionInMultipleBlocks"] = "selection-in-multiple-blocks";
+  SelectionType2["WholeBlock"] = "whole-block";
+  return SelectionType2;
+})(SelectionType || {});
+function getSelectionState(selectionStart, selectionEnd, yDoc) {
+  const ymap = getRootMap(yDoc, CRDT_RECORD_MAP_KEY);
+  const yBlocks = ymap.get("blocks") ?? new Y.Array();
+  const isSelectionEmpty = Object.keys(selectionStart).length === 0;
+  const noSelection = {
+    type: "none" /* None */
+  };
+  if (isSelectionEmpty) {
+    return noSelection;
+  }
+  const isSelectionInOneBlock = selectionStart.clientId === selectionEnd.clientId;
+  const isCursorOnly = isSelectionInOneBlock && selectionStart.offset === selectionEnd.offset;
+  const isSelectionAWholeBlock = isSelectionInOneBlock && selectionStart.offset === void 0 && selectionEnd.offset === void 0;
+  if (isSelectionAWholeBlock) {
+    return {
+      type: "whole-block" /* WholeBlock */,
+      blockId: selectionStart.clientId
+    };
+  } else if (isCursorOnly) {
+    const cursorPosition = getCursorPosition(selectionStart, yBlocks);
+    if (!cursorPosition) {
+      return noSelection;
+    }
+    return {
+      type: "cursor" /* Cursor */,
+      blockId: selectionStart.clientId,
+      cursorPosition
+    };
+  } else if (isSelectionInOneBlock) {
+    const cursorStartPosition2 = getCursorPosition(
+      selectionStart,
+      yBlocks
+    );
+    const cursorEndPosition2 = getCursorPosition(selectionEnd, yBlocks);
+    if (!cursorStartPosition2 || !cursorEndPosition2) {
+      return noSelection;
+    }
+    return {
+      type: "selection-in-one-block" /* SelectionInOneBlock */,
+      blockId: selectionStart.clientId,
+      cursorStartPosition: cursorStartPosition2,
+      cursorEndPosition: cursorEndPosition2
+    };
+  }
+  const cursorStartPosition = getCursorPosition(selectionStart, yBlocks);
+  const cursorEndPosition = getCursorPosition(selectionEnd, yBlocks);
+  if (!cursorStartPosition || !cursorEndPosition) {
+    return noSelection;
+  }
+  return {
+    type: "selection-in-multiple-blocks" /* SelectionInMultipleBlocks */,
+    blockStartId: selectionStart.clientId,
+    blockEndId: selectionEnd.clientId,
+    cursorStartPosition,
+    cursorEndPosition
+  };
+}
+function getCursorPosition(selection, blocks) {
+  const block = findBlockByClientId(selection.clientId, blocks);
+  if (!block) {
+    return null;
+  }
+  const attributes = block.get("attributes");
+  const currentYText = attributes.get(selection.attributeKey);
+  const relativePosition = Y.createRelativePositionFromTypeIndex(
+    currentYText,
+    selection.offset
+  );
+  return {
+    relativePosition,
+    absoluteOffset: selection.offset
+  };
+}
+function findBlockByClientId(blockId, blocks) {
+  for (const block of blocks) {
+    if (block.get("clientId") === blockId) {
+      return block;
+    }
+    const innerBlocks = block.get("innerBlocks");
+    if (innerBlocks && innerBlocks.length > 0) {
+      const innerBlock = findBlockByClientId(blockId, innerBlocks);
+      if (innerBlock) {
+        return innerBlock;
+      }
+    }
+  }
+  return null;
+}
+function areSelectionsStatesEqual(selection1, selection2) {
+  if (selection1.type !== selection2.type) {
+    return false;
+  }
+  switch (selection1.type) {
+    case "none" /* None */:
+      return true;
+    case "cursor" /* Cursor */:
+      return selection1.blockId === selection2.blockId && areCursorPositionsEqual(
+        selection1.cursorPosition,
+        selection2.cursorPosition
+      );
+    case "selection-in-one-block" /* SelectionInOneBlock */:
+      return selection1.blockId === selection2.blockId && areCursorPositionsEqual(
+        selection1.cursorStartPosition,
+        selection2.cursorStartPosition
+      ) && areCursorPositionsEqual(
+        selection1.cursorEndPosition,
+        selection2.cursorEndPosition
+      );
+    case "selection-in-multiple-blocks" /* SelectionInMultipleBlocks */:
+      return selection1.blockStartId === selection2.blockStartId && selection1.blockEndId === selection2.blockEndId && areCursorPositionsEqual(
+        selection1.cursorStartPosition,
+        selection2.cursorStartPosition
+      ) && areCursorPositionsEqual(
+        selection1.cursorEndPosition,
+        selection2.cursorEndPosition
+      );
+    case "whole-block" /* WholeBlock */:
+      return selection1.blockId === selection2.blockId;
+    default:
+      return false;
+  }
+}
+function areCursorPositionsEqual(cursorPosition1, cursorPosition2) {
+  const isRelativePositionEqual = JSON.stringify(cursorPosition1.relativePosition) === JSON.stringify(cursorPosition2.relativePosition);
+  const isAbsoluteOffsetEqual = cursorPosition1.absoluteOffset === cursorPosition2.absoluteOffset;
+  return isRelativePositionEqual && isAbsoluteOffsetEqual;
+}
+export {
+  SelectionType,
+  areSelectionsStatesEqual,
+  getSelectionState
+};
+//# sourceMappingURL=crdt-user-selections.mjs.map

package/build-module/utils/crdt-user-selections.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/crdt-user-selections.ts"],
+  "sourcesContent": ["/**\n * External dependencies\n */\nimport { Y, CRDT_RECORD_MAP_KEY } from '@wordpress/sync';\n\n/**\n * Internal dependencies\n */\nimport type { YPostRecord } from './crdt';\nimport type { YBlock, YBlocks } from './crdt-blocks';\nimport { getRootMap } from './crdt-utils';\nimport type { WPBlockSelection } from '../types';\n\n/**\n * The type of selection.\n */\nexport enum SelectionType {\n\tNone = 'none',\n\tCursor = 'cursor',\n\tSelectionInOneBlock = 'selection-in-one-block',\n\tSelectionInMultipleBlocks = 'selection-in-multiple-blocks',\n\tWholeBlock = 'whole-block',\n}\n\n/**\n * The position of the cursor.\n */\nexport type CursorPosition = {\n\trelativePosition: Y.RelativePosition;\n\n\t// Also store the absolute offset index of the cursor from the perspective\n\t// of the user who is updating the selection.\n\t//\n\t// Do not use this value directly, instead use `createAbsolutePositionFromRelativePosition()`\n\t// on relativePosition for the most up-to-date positioning.\n\t//\n\t// This is used because local Y.Text changes (e.g. adding or deleting a character)\n\t// can result in the same relative position if it is pinned to an unchanged\n\t// character. With both of these values as editor state, a change in perceived\n\t// position will always result in a redraw.\n\tabsoluteOffset: number;\n};\n\nexport type SelectionNone = {\n\t// The user has not made a selection.\n\ttype: SelectionType.None;\n};\n\nexport type SelectionCursor = {\n\t// The user has a cursor position in a block with no text highlighted.\n\ttype: SelectionType.Cursor;\n\tblockId: string;\n\tcursorPosition: CursorPosition;\n};\n\nexport type SelectionInOneBlock = {\n\t// The user has highlighted text in a single block.\n\ttype: SelectionType.SelectionInOneBlock;\n\tblockId: string;\n\tcursorStartPosition: CursorPosition;\n\tcursorEndPosition: CursorPosition;\n};\n\nexport type SelectionInMultipleBlocks = {\n\t// The user has highlighted text over multiple blocks.\n\ttype: SelectionType.SelectionInMultipleBlocks;\n\tblockStartId: string;\n\tblockEndId: string;\n\tcursorStartPosition: CursorPosition;\n\tcursorEndPosition: CursorPosition;\n};\n\nexport type SelectionWholeBlock = {\n\t// The user has a non-text block selected, like an image block.\n\ttype: SelectionType.WholeBlock;\n\tblockId: string;\n};\n\nexport type SelectionState =\n\t| SelectionNone\n\t| SelectionCursor\n\t| SelectionInOneBlock\n\t| SelectionInMultipleBlocks\n\t| SelectionWholeBlock;\n\n/**\n * Converts WordPress block editor selection to a SelectionState.\n *\n * @param selectionStart - The start position of the selection\n * @param selectionEnd   - The end position of the selection\n * @param yDoc           - The Yjs document\n * @return The SelectionState\n */\nexport function getSelectionState(\n\tselectionStart: WPBlockSelection,\n\tselectionEnd: WPBlockSelection,\n\tyDoc: Y.Doc\n): SelectionState {\n\tconst ymap = getRootMap< YPostRecord >( yDoc, CRDT_RECORD_MAP_KEY );\n\tconst yBlocks = ymap.get( 'blocks' ) ?? new Y.Array< YBlock >();\n\n\tconst isSelectionEmpty = Object.keys( selectionStart ).length === 0;\n\tconst noSelection: SelectionNone = {\n\t\ttype: SelectionType.None,\n\t};\n\n\tif ( isSelectionEmpty ) {\n\t\t// Case 1: No selection\n\t\treturn noSelection;\n\t}\n\n\t// When the page initially loads, selectionStart can contain an empty object `{}`.\n\tconst isSelectionInOneBlock =\n\t\tselectionStart.clientId === selectionEnd.clientId;\n\tconst isCursorOnly =\n\t\tisSelectionInOneBlock && selectionStart.offset === selectionEnd.offset;\n\tconst isSelectionAWholeBlock =\n\t\tisSelectionInOneBlock &&\n\t\tselectionStart.offset === undefined &&\n\t\tselectionEnd.offset === undefined;\n\n\tif ( isSelectionAWholeBlock ) {\n\t\t// Case 2: A whole block is selected.\n\t\treturn {\n\t\t\ttype: SelectionType.WholeBlock,\n\t\t\tblockId: selectionStart.clientId,\n\t\t};\n\t} else if ( isCursorOnly ) {\n\t\t// Case 3: Cursor only, no text selected\n\t\tconst cursorPosition = getCursorPosition( selectionStart, yBlocks );\n\n\t\tif ( ! cursorPosition ) {\n\t\t\t// If we can't find the cursor position in block text, treat it as a non-selection.\n\t\t\treturn noSelection;\n\t\t}\n\n\t\treturn {\n\t\t\ttype: SelectionType.Cursor,\n\t\t\tblockId: selectionStart.clientId,\n\t\t\tcursorPosition,\n\t\t};\n\t} else if ( isSelectionInOneBlock ) {\n\t\t// Case 4: Selection in a single block\n\t\tconst cursorStartPosition = getCursorPosition(\n\t\t\tselectionStart,\n\t\t\tyBlocks\n\t\t);\n\t\tconst cursorEndPosition = getCursorPosition( selectionEnd, yBlocks );\n\n\t\tif ( ! cursorStartPosition || ! cursorEndPosition ) {\n\t\t\t// If we can't find the cursor positions in block text, treat it as a non-selection.\n\t\t\treturn noSelection;\n\t\t}\n\n\t\treturn {\n\t\t\ttype: SelectionType.SelectionInOneBlock,\n\t\t\tblockId: selectionStart.clientId,\n\t\t\tcursorStartPosition,\n\t\t\tcursorEndPosition,\n\t\t};\n\t}\n\n\t// Caes 5: Selection in multiple blocks\n\tconst cursorStartPosition = getCursorPosition( selectionStart, yBlocks );\n\tconst cursorEndPosition = getCursorPosition( selectionEnd, yBlocks );\n\tif ( ! cursorStartPosition || ! cursorEndPosition ) {\n\t\t// If we can't find the cursor positions in block text, treat it as a non-selection.\n\t\treturn noSelection;\n\t}\n\n\treturn {\n\t\ttype: SelectionType.SelectionInMultipleBlocks,\n\t\tblockStartId: selectionStart.clientId,\n\t\tblockEndId: selectionEnd.clientId,\n\t\tcursorStartPosition,\n\t\tcursorEndPosition,\n\t};\n}\n\n/**\n * Get the cursor position from a selection.\n *\n * @param selection - The selection.\n * @param blocks    - The blocks to search through.\n * @return The cursor position, or null if not found.\n */\nfunction getCursorPosition(\n\tselection: WPBlockSelection,\n\tblocks: YBlocks\n): CursorPosition | null {\n\tconst block = findBlockByClientId( selection.clientId, blocks );\n\tif ( ! block ) {\n\t\treturn null;\n\t}\n\n\tconst attributes = block.get( 'attributes' ) as Y.Map< Y.Text >;\n\tconst currentYText = attributes.get( selection.attributeKey ) as Y.Text;\n\n\tconst relativePosition = Y.createRelativePositionFromTypeIndex(\n\t\tcurrentYText,\n\t\tselection.offset\n\t);\n\n\treturn {\n\t\trelativePosition,\n\t\tabsoluteOffset: selection.offset,\n\t};\n}\n\n/**\n * Find a block by its client ID.\n *\n * @param blockId - The client ID of the block.\n * @param blocks  - The blocks to search through.\n * @return The block if found, null otherwise.\n */\nfunction findBlockByClientId(\n\tblockId: string,\n\tblocks: YBlocks\n): YBlock | null {\n\tfor ( const block of blocks ) {\n\t\tif ( block.get( 'clientId' ) === blockId ) {\n\t\t\treturn block;\n\t\t}\n\n\t\tconst innerBlocks = block.get( 'innerBlocks' );\n\n\t\tif ( innerBlocks && innerBlocks.length > 0 ) {\n\t\t\tconst innerBlock = findBlockByClientId( blockId, innerBlocks );\n\n\t\t\tif ( innerBlock ) {\n\t\t\t\treturn innerBlock;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn null;\n}\n\n/**\n * Check if two selection states are equal.\n *\n * @param selection1 - The first selection state.\n * @param selection2 - The second selection state.\n * @return True if the selection states are equal, false otherwise.\n */\nexport function areSelectionsStatesEqual(\n\tselection1: SelectionState,\n\tselection2: SelectionState\n): boolean {\n\tif ( selection1.type !== selection2.type ) {\n\t\treturn false;\n\t}\n\n\tswitch ( selection1.type ) {\n\t\tcase SelectionType.None:\n\t\t\treturn true;\n\n\t\tcase SelectionType.Cursor:\n\t\t\treturn (\n\t\t\t\tselection1.blockId ===\n\t\t\t\t\t( selection2 as SelectionCursor ).blockId &&\n\t\t\t\tareCursorPositionsEqual(\n\t\t\t\t\tselection1.cursorPosition,\n\t\t\t\t\t( selection2 as SelectionCursor ).cursorPosition\n\t\t\t\t)\n\t\t\t);\n\n\t\tcase SelectionType.SelectionInOneBlock:\n\t\t\treturn (\n\t\t\t\tselection1.blockId ===\n\t\t\t\t\t( selection2 as SelectionInOneBlock ).blockId &&\n\t\t\t\tareCursorPositionsEqual(\n\t\t\t\t\tselection1.cursorStartPosition,\n\t\t\t\t\t( selection2 as SelectionInOneBlock ).cursorStartPosition\n\t\t\t\t) &&\n\t\t\t\tareCursorPositionsEqual(\n\t\t\t\t\tselection1.cursorEndPosition,\n\t\t\t\t\t( selection2 as SelectionInOneBlock ).cursorEndPosition\n\t\t\t\t)\n\t\t\t);\n\n\t\tcase SelectionType.SelectionInMultipleBlocks:\n\t\t\treturn (\n\t\t\t\tselection1.blockStartId ===\n\t\t\t\t\t( selection2 as SelectionInMultipleBlocks ).blockStartId &&\n\t\t\t\tselection1.blockEndId ===\n\t\t\t\t\t( selection2 as SelectionInMultipleBlocks ).blockEndId &&\n\t\t\t\tareCursorPositionsEqual(\n\t\t\t\t\tselection1.cursorStartPosition,\n\t\t\t\t\t( selection2 as SelectionInMultipleBlocks )\n\t\t\t\t\t\t.cursorStartPosition\n\t\t\t\t) &&\n\t\t\t\tareCursorPositionsEqual(\n\t\t\t\t\tselection1.cursorEndPosition,\n\t\t\t\t\t( selection2 as SelectionInMultipleBlocks )\n\t\t\t\t\t\t.cursorEndPosition\n\t\t\t\t)\n\t\t\t);\n\t\tcase SelectionType.WholeBlock:\n\t\t\treturn (\n\t\t\t\tselection1.blockId ===\n\t\t\t\t( selection2 as SelectionWholeBlock ).blockId\n\t\t\t);\n\n\t\tdefault:\n\t\t\treturn false;\n\t}\n}\n\n/**\n * Check if two cursor positions are equal.\n *\n * @param cursorPosition1 - The first cursor position.\n * @param cursorPosition2 - The second cursor position.\n * @return True if the cursor positions are equal, false otherwise.\n */\nfunction areCursorPositionsEqual(\n\tcursorPosition1: CursorPosition,\n\tcursorPosition2: CursorPosition\n): boolean {\n\tconst isRelativePositionEqual =\n\t\tJSON.stringify( cursorPosition1.relativePosition ) ===\n\t\tJSON.stringify( cursorPosition2.relativePosition );\n\n\t// Ensure a change in calculated absolute offset results in a treating the cursor as modified.\n\t// This is necessary because Y.Text relative positions can remain the same after text changes.\n\tconst isAbsoluteOffsetEqual =\n\t\tcursorPosition1.absoluteOffset === cursorPosition2.absoluteOffset;\n\n\treturn isRelativePositionEqual && isAbsoluteOffsetEqual;\n}\n"],
+  "mappings": "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",
+  "names": ["SelectionType", "cursorStartPosition", "cursorEndPosition"]
+}

package/build-types/awareness/config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Delay in milliseconds before throttling the cursor position updates.
+ */
+export declare const AWARENESS_CURSOR_UPDATE_THROTTLE_IN_MS = 100;
+/**
+ * Delay in milliseconds before updating the cursor position.
+ */
+export declare const LOCAL_CURSOR_UPDATE_DEBOUNCE_IN_MS = 5;
+//# sourceMappingURL=config.d.ts.map

package/build-types/awareness/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/awareness/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,kCAAkC,IAAI,CAAC"}

package/build-types/awareness/post-editor-awareness.d.ts

@@ -0,0 +1,39 @@
+import { AwarenessState, type Y } from '@wordpress/sync';
+import { areUserInfosEqual } from './utils';
+import type { EditorState, PostEditorState } from './types';
+export declare class PostEditorAwareness extends AwarenessState<PostEditorState> {
+    private kind;
+    private name;
+    private postId;
+    protected equalityFieldChecks: {
+        editorState: (state1?: EditorState, state2?: EditorState) => boolean;
+        userInfo: typeof areUserInfosEqual;
+    };
+    constructor(doc: Y.Doc, kind: string, name: string, postId: number);
+    setUp(): void;
+    /**
+     * Set the current user info in the local state.
+     */
+    private setCurrentUserInfo;
+    /**
+     * Subscribe to user selection changes and update the selection state.
+     */
+    private subscribeToUserSelectionChanges;
+    /**
+     * Update the entity record with the current user's selection.
+     *
+     * @param selectionStart  - The start position of the selection.
+     * @param selectionEnd    - The end position of the selection.
+     * @param initialPosition - The initial position of the selection.
+     */
+    private updateSelectionInEntityRecord;
+    /**
+     * Check if two editor states are equal.
+     *
+     * @param state1 - The first editor state.
+     * @param state2 - The second editor state.
+     * @return True if the editor states are equal, false otherwise.
+     */
+    private areEditorStatesEqual;
+}
+//# sourceMappingURL=post-editor-awareness.d.ts.map

package/build-types/awareness/post-editor-awareness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-editor-awareness.d.ts","sourceRoot":"","sources":["../../src/awareness/post-editor-awareness.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAYzD,OAAO,EAAoB,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAO9D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE5D,qBAAa,mBAAoB,SAAQ,cAAc,CAAE,eAAe,CAAE;IAQxE,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IATf,SAAS,CAAC,mBAAmB;+BAuJnB,WAAW,WACX,WAAW,KAClB,OAAO;;MAtJR;gBAGD,GAAG,EAAE,CAAC,CAAC,GAAG,EACF,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;IAKhB,KAAK,IAAI,IAAI;IAOpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IA8DvC;;;;;;OAMG;YACW,6BAA6B;IA+B3C;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;CAU5B"}

package/build-types/awareness/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Internal dependencies
+ */
+import type { SelectionState } from '../utils/crdt-user-selections';
+import type { User } from '../entity-types';
+export type UserInfo = Pick<User<'view'>, 'id' | 'name' | 'slug' | 'avatar_urls'> & {
+    browserType: string;
+    color: string;
+    enteredAt: number;
+};
+/**
+ * This base state represents the presence of the user. We expect it to be
+ * extended to include additional state describing the user's current activity.
+ * This state must be serializable and compact.
+ */
+export interface BaseState {
+    userInfo: UserInfo;
+}
+/**
+ * The editor state includes information about the user's current selection.
+ */
+export interface EditorState {
+    selection: SelectionState;
+}
+/**
+ * The post editor state extends the base state with information used to render
+ * presence indicators in the post editor.
+ */
+export interface PostEditorState extends BaseState {
+    editorState?: EditorState;
+}
+//# sourceMappingURL=types.d.ts.map

package/build-types/awareness/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/awareness/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAAG,IAAI,CAC1B,IAAI,CAAE,MAAM,CAAE,EACd,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CACtC,GAAG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,QAAQ,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,cAAc,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IACjD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B"}

package/build-types/awareness/utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Internal dependencies
+ */
+import type { User } from '../entity-types';
+import type { UserInfo } from './types';
+/**
+ * Check if two user infos are equal.
+ *
+ * @param userInfo1 - The first user info.
+ * @param userInfo2 - The second user info.
+ * @return True if the user infos are equal, false otherwise.
+ */
+export declare function areUserInfosEqual(userInfo1?: UserInfo, userInfo2?: UserInfo): boolean;
+/**
+ * Generate a user info object from a current user and a list of existing colors.
+ *
+ * @param currentUser    - The current user.
+ * @param existingColors - The existing colors.
+ * @return The user info object.
+ */
+export declare function generateUserInfo(currentUser: User<'view'>, existingColors: string[]): UserInfo;
+//# sourceMappingURL=utils.d.ts.map

package/build-types/awareness/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/awareness/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAgHxC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,SAAS,CAAC,EAAE,QAAQ,EACpB,SAAS,CAAC,EAAE,QAAQ,GAClB,OAAO,CAaT;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,WAAW,EAAE,IAAI,CAAE,MAAM,CAAE,EAC3B,cAAc,EAAE,MAAM,EAAE,GACtB,QAAQ,CAOV"}

package/build-types/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../src/entities.js"],"names":[],"mappings":"AAqBA,iCAAkC,IAAI,CAAC;AAYvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2LE;;;;;;;;;;;;AAcF;;;;;;;;;;KASE;AAWK,2EAJI,MAAM,cACN,OAAO,OA0CjB;AA2KM,oCANI,MAAM,QACN,MAAM,WACN,MAAM,GAEL,MAAM,CAMjB;AA7KD;;;;GAIG;AACH,sDAwFC;AAyBD;;;;GAIG;AACH,gDA0BC"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../src/entities.js"],"names":[],"mappings":"AAsBA,iCAAkC,IAAI,CAAC;AAYvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2LE;;;;;;;;;;;;AAcF;;;;;;;;;;KASE;AAWK,2EAJI,MAAM,cACN,OAAO,OA0CjB;AAwLM,oCANI,MAAM,QACN,MAAM,WACN,MAAM,GAEL,MAAM,CAMjB;AA1LD;;;;GAIG;AACH,sDAqGC;AAyBD;;;;GAIG;AACH,gDA0BC"}

package/build-types/resolvers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../src/resolvers.js"],"names":[],"mappings":"AAmCO,kCAHI,MAAO,SAAS,IAKlB;;CAAY,mBAOnB;AAKK,mCAEE;;CAAY,mBAGnB;AAYK,sCAPI,MAAM,QACN,MAAM,OACN,MAAM,GAAC,MAAM,qBACb,MAAO,SAAS,IAMlB;;;;;CAA6C,mBAmLpD;;IAIF,kEAcC;;AAED;;GAEG;AACH,0CAAuE;AAEvE;;GAEG;AACH,6CAA0E;AAUnE,uCALI,MAAM,QACN,MAAM,UACN,UAAO,IAKT;;;;CAAqC,mBA+N5C;;IAEF,kEAOC;;AAED;;GAEG;AACH,kDAAgF;AAEhF;;GAEG;AACH,kDAAgF;AAKzE,oCAEE;;;CAA2B,mBAQlC;AAEF;;GAEG;AACH,wCAAqE;AAO9D,qCAFI,MAAM,IAIR;;CAAY,mBAUnB;AAYK,yCANI,MAAM,YAEN,MAAM,MAAO,MAEZ,MAAM,OAAA,IAIT;;;;CAAqC,mBAiF5C;AAUK,8CAJI,MAAM,QACN,MAAM,YACN,MAAM,GAAC,MAAM,IAIf;;CAAY,mBAEnB;AAQK,uCAHI,MAAM,UACN,MAAM,IAIR;;;CAA2B,mBAiBlC;AAWK,sCAHI,MAAM,UACN,MAAM,IAIR;;CAAiB,mBAExB;AAEK,2DAEE;;;CAA2B,mBAqBlC;AAEK,kEAEE;;;CAA2B,mBAUlC;AAEK,wEAEE;;;CAA2B,mBAUlC;AAKK,yDAEE;;;CAA2B,mBA6BlC;;IAEF,gDAOC;;AAEM,qCAEE;;CAAY,mBAGnB;AAEK,8CAEE;;CAAY,mBAKnB;AAEK,6CAEE;;;CAA2B,mBAsBlC;AAEK,4CAEE;;;;CAA8B,mBAwCrC;AAEK,mDAEE;;;;CAAqC,mBA6B5C;;IAEF,gDAMC;;AAYM,mCAPI,MAAM,QACN,MAAM,aACN,MAAM,GAAC,MAAM,UACb,MAAO,SAAS,IAMlB;;;;CAAqC,mBAkG5C;;IAGF,sFAK8B;;AAavB,kCARI,MAAM,QACN,MAAM,aACN,MAAM,GAAC,MAAM,eACb,MAAM,GAAC,MAAM,SACb,MAAO,SAAS,IAMlB;;;CAA2B,mBAyClC;AAOK,gDAFI,MAAM,IAIR;;;CAA2B,mBAsBlC;AAOK,wCAFI,MAAM,IAIR;;CAAY,mBAmBnB;AAKK,sCAEE;;CAAY,mBAKnB;AAKK,oCAEE;;CAAY,mBAKnB"}
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../src/resolvers.js"],"names":[],"mappings":"AAmCO,kCAHI,MAAO,SAAS,IAKlB;;CAAY,mBAOnB;AAKK,mCAEE;;CAAY,mBAGnB;AAYK,sCAPI,MAAM,QACN,MAAM,OACN,MAAM,GAAC,MAAM,qBACb,MAAO,SAAS,IAMlB;;;;;CAA6C,mBAoLpD;;IAIF,kEAcC;;AAED;;GAEG;AACH,0CAAuE;AAEvE;;GAEG;AACH,6CAA0E;AAUnE,uCALI,MAAM,QACN,MAAM,UACN,UAAO,IAKT;;;;CAAqC,mBA+N5C;;IAEF,kEAOC;;AAED;;GAEG;AACH,kDAAgF;AAEhF;;GAEG;AACH,kDAAgF;AAKzE,oCAEE;;;CAA2B,mBAQlC;AAEF;;GAEG;AACH,wCAAqE;AAO9D,qCAFI,MAAM,IAIR;;CAAY,mBAUnB;AAYK,yCANI,MAAM,YAEN,MAAM,MAAO,MAEZ,MAAM,OAAA,IAIT;;;;CAAqC,mBAiF5C;AAUK,8CAJI,MAAM,QACN,MAAM,YACN,MAAM,GAAC,MAAM,IAIf;;CAAY,mBAEnB;AAQK,uCAHI,MAAM,UACN,MAAM,IAIR;;;CAA2B,mBAiBlC;AAWK,sCAHI,MAAM,UACN,MAAM,IAIR;;CAAiB,mBAExB;AAEK,2DAEE;;;CAA2B,mBAqBlC;AAEK,kEAEE;;;CAA2B,mBAUlC;AAEK,wEAEE;;;CAA2B,mBAUlC;AAKK,yDAEE;;;CAA2B,mBA6BlC;;IAEF,gDAOC;;AAEM,qCAEE;;CAAY,mBAGnB;AAEK,8CAEE;;CAAY,mBAKnB;AAEK,6CAEE;;;CAA2B,mBAsBlC;AAEK,4CAEE;;;;CAA8B,mBAwCrC;AAEK,mDAEE;;;;CAAqC,mBA6B5C;;IAEF,gDAMC;;AAYM,mCAPI,MAAM,QACN,MAAM,aACN,MAAM,GAAC,MAAM,UACb,MAAO,SAAS,IAMlB;;;;CAAqC,mBAkG5C;;IAGF,sFAK8B;;AAavB,kCARI,MAAM,QACN,MAAM,aACN,MAAM,GAAC,MAAM,eACb,MAAM,GAAC,MAAM,SACb,MAAO,SAAS,IAMlB;;;CAA2B,mBAyClC;AAOK,gDAFI,MAAM,IAIR;;;CAA2B,mBAsBlC;AAOK,wCAFI,MAAM,IAIR;;CAAY,mBAmBnB;AAKK,sCAEE;;CAAY,mBAKnB;AAKK,oCAEE;;CAAY,mBAKnB"}

package/build-types/utils/crdt-user-selections.d.ts

@@ -0,0 +1,66 @@
+/**
+ * External dependencies
+ */
+import { Y } from '@wordpress/sync';
+import type { WPBlockSelection } from '../types';
+/**
+ * The type of selection.
+ */
+export declare enum SelectionType {
+    None = "none",
+    Cursor = "cursor",
+    SelectionInOneBlock = "selection-in-one-block",
+    SelectionInMultipleBlocks = "selection-in-multiple-blocks",
+    WholeBlock = "whole-block"
+}
+/**
+ * The position of the cursor.
+ */
+export type CursorPosition = {
+    relativePosition: Y.RelativePosition;
+    absoluteOffset: number;
+};
+export type SelectionNone = {
+    type: SelectionType.None;
+};
+export type SelectionCursor = {
+    type: SelectionType.Cursor;
+    blockId: string;
+    cursorPosition: CursorPosition;
+};
+export type SelectionInOneBlock = {
+    type: SelectionType.SelectionInOneBlock;
+    blockId: string;
+    cursorStartPosition: CursorPosition;
+    cursorEndPosition: CursorPosition;
+};
+export type SelectionInMultipleBlocks = {
+    type: SelectionType.SelectionInMultipleBlocks;
+    blockStartId: string;
+    blockEndId: string;
+    cursorStartPosition: CursorPosition;
+    cursorEndPosition: CursorPosition;
+};
+export type SelectionWholeBlock = {
+    type: SelectionType.WholeBlock;
+    blockId: string;
+};
+export type SelectionState = SelectionNone | SelectionCursor | SelectionInOneBlock | SelectionInMultipleBlocks | SelectionWholeBlock;
+/**
+ * Converts WordPress block editor selection to a SelectionState.
+ *
+ * @param selectionStart - The start position of the selection
+ * @param selectionEnd   - The end position of the selection
+ * @param yDoc           - The Yjs document
+ * @return The SelectionState
+ */
+export declare function getSelectionState(selectionStart: WPBlockSelection, selectionEnd: WPBlockSelection, yDoc: Y.Doc): SelectionState;
+/**
+ * Check if two selection states are equal.
+ *
+ * @param selection1 - The first selection state.
+ * @param selection2 - The second selection state.
+ * @return True if the selection states are equal, false otherwise.
+ */
+export declare function areSelectionsStatesEqual(selection1: SelectionState, selection2: SelectionState): boolean;
+//# sourceMappingURL=crdt-user-selections.d.ts.map

package/build-types/utils/crdt-user-selections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crdt-user-selections.d.ts","sourceRoot":"","sources":["../../src/utils/crdt-user-selections.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAuB,MAAM,iBAAiB,CAAC;AAQzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;GAEG;AACH,oBAAY,aAAa;IACxB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,mBAAmB,2BAA2B;IAC9C,yBAAyB,iCAAiC;IAC1D,UAAU,gBAAgB;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,CAAC;IAYrC,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAE3B,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAE7B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,cAAc,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAEjC,IAAI,EAAE,aAAa,CAAC,mBAAmB,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,cAAc,CAAC;IACpC,iBAAiB,EAAE,cAAc,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IAEvC,IAAI,EAAE,aAAa,CAAC,yBAAyB,CAAC;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,cAAc,CAAC;IACpC,iBAAiB,EAAE,cAAc,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAEjC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GACvB,aAAa,GACb,eAAe,GACf,mBAAmB,GACnB,yBAAyB,GACzB,mBAAmB,CAAC;AAEvB;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,cAAc,EAAE,gBAAgB,EAChC,YAAY,EAAE,gBAAgB,EAC9B,IAAI,EAAE,CAAC,CAAC,GAAG,GACT,cAAc,CAgFhB;AA8DD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACvC,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,cAAc,GACxB,OAAO,CA2DT"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/core-data",
-	"version": "7.38.0",
+	"version": "7.38.1-next.v.0+b8934fcf9",
 	"description": "Access to and manipulation of core WordPress entities.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -49,22 +49,22 @@
 		"build-module/index.mjs"
 	],
 	"dependencies": {
-		"@wordpress/api-fetch": "^7.38.0",
-		"@wordpress/block-editor": "^15.11.0",
-		"@wordpress/blocks": "^15.11.0",
-		"@wordpress/compose": "^7.38.0",
-		"@wordpress/data": "^10.38.0",
-		"@wordpress/deprecated": "^4.38.0",
-		"@wordpress/element": "^6.38.0",
-		"@wordpress/html-entities": "^4.38.0",
-		"@wordpress/i18n": "^6.11.0",
-		"@wordpress/is-shallow-equal": "^5.38.0",
-		"@wordpress/private-apis": "^1.38.0",
-		"@wordpress/rich-text": "^7.38.0",
-		"@wordpress/sync": "^1.38.0",
-		"@wordpress/undo-manager": "^1.38.0",
-		"@wordpress/url": "^4.38.0",
-		"@wordpress/warning": "^3.38.0",
+		"@wordpress/api-fetch": "^7.38.1-next.v.0+b8934fcf9",
+		"@wordpress/block-editor": "^15.11.1-next.v.0+b8934fcf9",
+		"@wordpress/blocks": "^15.11.1-next.v.0+b8934fcf9",
+		"@wordpress/compose": "^7.38.1-next.v.0+b8934fcf9",
+		"@wordpress/data": "^10.38.1-next.v.0+b8934fcf9",
+		"@wordpress/deprecated": "^4.38.1-next.v.0+b8934fcf9",
+		"@wordpress/element": "^6.38.1-next.v.0+b8934fcf9",
+		"@wordpress/html-entities": "^4.38.1-next.v.0+b8934fcf9",
+		"@wordpress/i18n": "^6.11.1-next.v.0+b8934fcf9",
+		"@wordpress/is-shallow-equal": "^5.38.1-next.v.0+b8934fcf9",
+		"@wordpress/private-apis": "^1.38.1-next.v.0+b8934fcf9",
+		"@wordpress/rich-text": "^7.38.1-next.v.0+b8934fcf9",
+		"@wordpress/sync": "^1.38.1-next.v.0+b8934fcf9",
+		"@wordpress/undo-manager": "^1.38.1-next.v.0+b8934fcf9",
+		"@wordpress/url": "^4.38.1-next.v.0+b8934fcf9",
+		"@wordpress/warning": "^3.38.1-next.v.0+b8934fcf9",
 		"change-case": "^4.1.2",
 		"equivalent-key-map": "^0.2.2",
 		"fast-deep-equal": "^3.1.3",
@@ -72,6 +72,7 @@
 		"uuid": "^9.0.1"
 	},
 	"devDependencies": {
+		"@types/node": "^20.17.10",
 		"deep-freeze": "0.0.1"
 	},
 	"peerDependencies": {
@@ -81,5 +82,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "50c4c0f51e4797c217946ce42adfaa5eb026f33f"
+	"gitHead": "17529010285784fd2e735348a28391c79de87c88"
 }

package/src/awareness/config.ts

@@ -0,0 +1,9 @@
+/**
+ * Delay in milliseconds before throttling the cursor position updates.
+ */
+export const AWARENESS_CURSOR_UPDATE_THROTTLE_IN_MS = 100;
+
+/**
+ * Delay in milliseconds before updating the cursor position.
+ */
+export const LOCAL_CURSOR_UPDATE_DEBOUNCE_IN_MS = 5;

package/src/awareness/post-editor-awareness.ts

@@ -0,0 +1,187 @@
+/**
+ * WordPress dependencies
+ */
+import { dispatch, select, subscribe } from '@wordpress/data';
+import { AwarenessState, type Y } from '@wordpress/sync';
+// @ts-ignore No exported types for block editor store selectors.
+import { store as blockEditorStore } from '@wordpress/block-editor';
+
+/**
+ * Internal dependencies
+ */
+import {
+	AWARENESS_CURSOR_UPDATE_THROTTLE_IN_MS,
+	LOCAL_CURSOR_UPDATE_DEBOUNCE_IN_MS,
+} from './config';
+import { STORE_NAME as coreStore } from '../name';
+import { generateUserInfo, areUserInfosEqual } from './utils';
+import {
+	areSelectionsStatesEqual,
+	getSelectionState,
+} from '../utils/crdt-user-selections';
+
+import type { WPBlockSelection } from '../types';
+import type { EditorState, PostEditorState } from './types';
+
+export class PostEditorAwareness extends AwarenessState< PostEditorState > {
+	protected equalityFieldChecks = {
+		editorState: this.areEditorStatesEqual,
+		userInfo: areUserInfosEqual,
+	};
+
+	public constructor(
+		doc: Y.Doc,
+		private kind: string,
+		private name: string,
+		private postId: number
+	) {
+		super( doc );
+	}
+
+	public setUp(): void {
+		super.setUp();
+
+		this.setCurrentUserInfo();
+		this.subscribeToUserSelectionChanges();
+	}
+
+	/**
+	 * Set the current user info in the local state.
+	 */
+	private setCurrentUserInfo(): void {
+		const states = this.getStates();
+		const otherUserColors = Array.from( states.entries() )
+			.filter(
+				( [ clientId, state ] ) =>
+					state.userInfo && clientId !== this.clientID
+			)
+			.map( ( [ , state ] ) => state.userInfo.color )
+			.filter( Boolean );
+
+		// Get current user info and set it in local state.
+		const currentUser = select( coreStore ).getCurrentUser();
+		const userInfo = generateUserInfo( currentUser, otherUserColors );
+		this.setLocalStateField( 'userInfo', userInfo );
+	}
+
+	/**
+	 * Subscribe to user selection changes and update the selection state.
+	 */
+	private subscribeToUserSelectionChanges(): void {
+		const {
+			getSelectionStart,
+			getSelectionEnd,
+			getSelectedBlocksInitialCaretPosition,
+		} = select( blockEditorStore );
+
+		// Keep track of the current selection in the outer scope so we can compare
+		// in the subscription.
+		let selectionStart = getSelectionStart();
+		let selectionEnd = getSelectionEnd();
+		let localCursorTimeout: NodeJS.Timeout | null = null;
+
+		subscribe( () => {
+			const newSelectionStart = getSelectionStart();
+			const newSelectionEnd = getSelectionEnd();
+
+			if (
+				newSelectionStart === selectionStart &&
+				newSelectionEnd === selectionEnd
+			) {
+				return;
+			}
+
+			selectionStart = newSelectionStart;
+			selectionEnd = newSelectionEnd;
+
+			// Typically selection position is only persisted after typing in a block, which
+			// can cause selection position to be reset by other users making block updates.
+			// Ensure we update the controlled selection right away, persisting our cursor position locally.
+			const initialPosition = getSelectedBlocksInitialCaretPosition();
+			void this.updateSelectionInEntityRecord(
+				selectionStart,
+				selectionEnd,
+				initialPosition
+			);
+
+			// We receive two selection changes in quick succession
+			// from local selection events:
+			//   { clientId: "123...", attributeKey: "content", offset: undefined }
+			//   { clientId: "123...", attributeKey: "content", offset: 554 }
+			// Add a short debounce to avoid sending the first selection change.
+			if ( localCursorTimeout ) {
+				clearTimeout( localCursorTimeout );
+			}
+
+			localCursorTimeout = setTimeout( () => {
+				const selectionState = getSelectionState(
+					selectionStart,
+					selectionEnd,
+					this.doc
+				);
+
+				this.setThrottledLocalStateField(
+					'editorState',
+					{ selection: selectionState },
+					AWARENESS_CURSOR_UPDATE_THROTTLE_IN_MS
+				);
+			}, LOCAL_CURSOR_UPDATE_DEBOUNCE_IN_MS );
+		} );
+	}
+
+	/**
+	 * Update the entity record with the current user's selection.
+	 *
+	 * @param selectionStart  - The start position of the selection.
+	 * @param selectionEnd    - The end position of the selection.
+	 * @param initialPosition - The initial position of the selection.
+	 */
+	private async updateSelectionInEntityRecord(
+		selectionStart: WPBlockSelection,
+		selectionEnd: WPBlockSelection,
+		initialPosition: number | null
+	): Promise< void > {
+		// Send an entityRecord `selection` update if we have a selection.
+		//
+		// Normally WordPress updates the `selection` property of the post when changes are made to blocks.
+		// In a multi-user setup, block changes can occur from other users. When an entity is updated from another
+		// user's changes, useBlockSync() in Gutenberg will reset the user's selection to the last saved selection.
+		//
+		// Manually adding an edit for each movement ensures that other user's changes to the document will
+		// not cause the local user's selection to reset to the last local change location.
+		const edits = {
+			selection: { selectionStart, selectionEnd, initialPosition },
+		};
+
+		const options = {
+			undoIgnore: true,
+		};
+
+		// @ts-ignore Types are not provided when using store name instead of store instance.
+		dispatch( coreStore ).editEntityRecord(
+			this.kind,
+			this.name,
+			this.postId,
+			edits,
+			options
+		);
+	}
+
+	/**
+	 * Check if two editor states are equal.
+	 *
+	 * @param state1 - The first editor state.
+	 * @param state2 - The second editor state.
+	 * @return True if the editor states are equal, false otherwise.
+	 */
+	private areEditorStatesEqual(
+		state1?: EditorState,
+		state2?: EditorState
+	): boolean {
+		if ( ! state1 || ! state2 ) {
+			return state1 === state2;
+		}
+
+		return areSelectionsStatesEqual( state1.selection, state2.selection );
+	}
+}