Tighten and fix Talon actions type hints (#1849)

This fixes an incorrect type hint, removes a few implicit `Any`s, and
tightens up how `cursorless_get_text_action` can be used.

## Checklist

- [ ] ~I have added
[tests](https://www.cursorless.org/docs/contributing/test-case-recorder/)~
- [ ] ~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)~
- [x] I have not broken the cheatsheet

Co-authored-by: Pokey Rule <[email protected]>

Author: auscompgeek

src/actions/actions.py

@@ -1,4 +1,4 @@
-from typing import Union
+from typing import Callable, Union
 
 from talon import Module, actions
 
@@ -15,7 +15,6 @@
 
 mod = Module()
 
-
 mod.list(
     "cursorless_simple_action",
     desc="Cursorless internal: simple actions",
@@ -48,7 +47,7 @@
     "experimental_action",
 ]
 
-callback_actions = {
+callback_actions: dict[str, Callable[[CursorlessTarget], None]] = {
     "callAsFunction": cursorless_call_action,
     "findInDocument": actions.user.private_cursorless_find,
     "nextHomophone": cursorless_homophones_action,
@@ -74,7 +73,7 @@
         "{user.cursorless_custom_action}"
     )
 )
-def cursorless_action_or_ide_command(m) -> dict:
+def cursorless_action_or_ide_command(m) -> dict[str, str]:
     try:
         value = m.cursorless_custom_action
         type = "ide_command"
@@ -127,7 +126,7 @@ def cursorless_insert(
         cursorless_replace_action(destination, text)
 
     def private_cursorless_action_or_ide_command(
-        instruction: dict, target: CursorlessTarget
+        instruction: dict[str, str], target: CursorlessTarget
     ):
         """Perform cursorless action or ide command on target (internal use only)"""
         type = instruction["type"]

src/actions/get_text.py

@@ -7,11 +7,12 @@
 
 def cursorless_get_text_action(
     target: CursorlessTarget,
+    *,
     show_decorations: Optional[bool] = None,
     ensure_single_target: Optional[bool] = None,
 ) -> list[str]:
     """Get target texts"""
-    options = {}
+    options: dict[str, bool] = {}
 
     if show_decorations is not None:
         options["showDecorations"] = show_decorations

src/actions/homophones.py

@@ -1,11 +1,13 @@
+from typing import Optional
+
 from talon import actions, app
 
-from ..targets.target_types import PrimitiveDestination
+from ..targets.target_types import CursorlessTarget, PrimitiveDestination
 from .get_text import cursorless_get_text_action
 from .replace import cursorless_replace_action
 
 
-def cursorless_homophones_action(target: dict):
+def cursorless_homophones_action(target: CursorlessTarget):
     """Replaced target with next homophone"""
     texts = cursorless_get_text_action(target, show_decorations=False)
     try:
@@ -17,16 +19,16 @@ def cursorless_homophones_action(target: dict):
     cursorless_replace_action(destination, updated_texts)
 
 
-def get_next_homophone(word: str):
-    homophones = actions.user.homophones_get(word)
+def get_next_homophone(word: str) -> str:
+    homophones: Optional[list[str]] = actions.user.homophones_get(word)
     if not homophones:
         raise LookupError(f"Found no homophones for '{word}'")
     index = (homophones.index(word.lower()) + 1) % len(homophones)
     homophone = homophones[index]
     return format_homophone(word, homophone)
 
 
-def format_homophone(word: str, homophone: str):
+def format_homophone(word: str, homophone: str) -> str:
     if word.isupper():
         return homophone.upper()
     if word == word.capitalize():