Added text insertion action to Cursorless public api (#1875)

Fixes #1754

## Checklist

- [x] I have added
[tests](https://www.cursorless.org/docs/contributing/test-case-recorder/)
- [x] I have updated the
[docs](https://github.com/cursorless-dev/cursorless/tree/main/docs) and
[cheatsheet](https://github.com/cursorless-dev/cursorless/tree/main/cursorless-talon/src/cheatsheet)
- [/] I have not broken the cheatsheet

---------

Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com>

Author: AndreasArvidsson

src/actions/actions.py

@@ -1,10 +1,17 @@
+from typing import Union
+
 from talon import Module, actions
 
-from ..targets.target_types import CursorlessTarget, ImplicitDestination
+from ..targets.target_types import (
+    CursorlessDestination,
+    CursorlessTarget,
+    ImplicitDestination,
+)
 from .bring_move import BringMoveTargets
 from .call import cursorless_call_action
 from .execute_command import cursorless_execute_command_action
 from .homophones import cursorless_homophones_action
+from .replace import cursorless_replace_action
 
 mod = Module()
 
@@ -111,6 +118,14 @@ def cursorless_ide_command(command_id: str, target: CursorlessTarget):
         """Perform ide command on cursorless target"""
         return cursorless_execute_command_action(command_id, target)
 
+    def cursorless_insert(
+        destination: CursorlessDestination, text: Union[str, list[str]]
+    ):
+        """Perform text insertion on Cursorless destination"""
+        if isinstance(text, str):
+            text = [text]
+        cursorless_replace_action(destination, text)
+
     def private_cursorless_action_or_ide_command(
         instruction: dict, target: CursorlessTarget
     ):

src/actions/homophones.py

@@ -1,5 +1,6 @@
 from talon import actions, app
 
+from ..targets.target_types import PrimitiveDestination
 from .get_text import cursorless_get_text_action
 from .replace import cursorless_replace_action
 
@@ -12,7 +13,8 @@ def cursorless_homophones_action(target: dict):
     except LookupError as e:
         app.notify(str(e))
         return
-    cursorless_replace_action(target, updated_texts)
+    destination = PrimitiveDestination("to", target)
+    cursorless_replace_action(destination, updated_texts)
 
 
 def get_next_homophone(word: str):

src/actions/reformat.py

@@ -1,6 +1,6 @@
 from talon import Module, actions
 
-from ..targets.target_types import CursorlessTarget
+from ..targets.target_types import CursorlessTarget, PrimitiveDestination
 from .get_text import cursorless_get_text_action
 from .replace import cursorless_replace_action
 
@@ -15,4 +15,5 @@ def private_cursorless_reformat(target: CursorlessTarget, formatters: str):
         """Execute Cursorless reformat action. Reformat target with formatter"""
         texts = cursorless_get_text_action(target, show_decorations=False)
         updated_texts = [actions.user.reformat_text(text, formatters) for text in texts]
-        cursorless_replace_action(target, updated_texts)
+        destination = PrimitiveDestination("to", target)
+        cursorless_replace_action(destination, updated_texts)

src/actions/replace.py

@@ -1,14 +1,16 @@
 from talon import actions
 
-from ..targets.target_types import CursorlessTarget, PrimitiveDestination
+from ..targets.target_types import CursorlessDestination
 
 
-def cursorless_replace_action(target: CursorlessTarget, replace_with: list[str]):
+def cursorless_replace_action(
+    destination: CursorlessDestination, replace_with: list[str]
+):
     """Execute Cursorless replace action. Replace targets with texts"""
     actions.user.private_cursorless_command_and_wait(
         {
             "name": "replace",
             "replaceWith": replace_with,
-            "destination": PrimitiveDestination("to", target),
+            "destination": destination,
         }
     )