Add support for select() imperative method (#576)

Author: inf1nite-lo0p

lerna.json

@@ -1,4 +1,4 @@
 {
     "$schema": "node_modules/lerna/schemas/lerna-schema.json",
-    "version": "0.116.0"
+    "version": "0.116.1-alpha-select.0"
 }

packages/slate-editor/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@prezly/slate-editor",
-    "version": "0.116.0",
+    "version": "0.116.1-alpha-select.0",
     "description": "The Prezly Slate Editor",
     "license": "MIT",
     "type": "module",

packages/slate-editor/src/modules/editor/Editor.tsx

@@ -323,6 +323,9 @@ export const Editor = forwardRef<EditorRef, EditorProps>((props, forwardedRef) =
                 EditorCommands.resetNodes(editor, value, editor.selection);
                 setInitialValue(value);
             },
+            select: (target) => {
+                Transforms.select(editor, target);
+            },
         }),
     );
 

packages/slate-editor/src/modules/editor/types.ts

@@ -2,7 +2,7 @@ import type { Events } from '@prezly/events';
 import type { Decorate, EditorCommands } from '@prezly/slate-commons';
 import type { Alignment } from '@prezly/slate-types';
 import type { CSSProperties, KeyboardEvent, ReactNode } from 'react';
-import type { Editor, Element, Node } from 'slate';
+import type { Editor, Element, Node, Location } from 'slate';
 import type { Transforms } from 'slate';
 
 import type { AllowedBlocksExtensionConfiguration } from '#extensions/allowed-blocks';
@@ -72,6 +72,12 @@ export interface EditorRef {
     isModified(): boolean;
 
     resetValue(value: Value): void;
+
+    /**
+     * Programmatically set the selection in the editor.
+     * @param target - The target location for the selection.
+     */
+    select(target: Location): void;
 }
 
 export type Value = Element[];