Add menu choosing helper from pokey_talon (talonhub#1393)

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

BREAKING_CHANGES.txt

@@ -6,7 +6,12 @@ applied given the delay between changes being submitted and the time they were r
 and merged.
 
 ---
-* 2023-06-06 Deprecate `go marks` command for VSCode. Use 'bar marks' instead.
+* 2024-05-30 Deprecate 'drop down <user.number_small>' in favor of overridable 'choose' helper
+* 2024-01-27 Deprecate '<user.number_string>' command without a spoken prefix like `numb`.
+See `numbers.talon` and `numbers_unprefixed.talon.` If in the future you want to still use
+unprefixed numbers, you will need to comment out the
+`tag(): user.prefixed_numbers` line in your `settings.talon` file.
+* 2023-06-06 Deprecate `go ` command for VSCode. Use 'bar marks' instead.
 * 2023-02-04 Deprecate `murder` command for i3wm. Use 'win kill' instead.
 * 2022-12-11 Deprecate user.insert_with_history. Just use `user.add_phrase_to_history(text);
 insert(text)` instead. See #939.

core/homophones/homophones.py

@@ -227,3 +227,18 @@ def homophones_get(word: str) -> [str] or None:
         if word in all_homophones:
             return all_homophones[word]
         return None
+
+
+ctx_homophones_open = Context()
+ctx_homophones_open.matches = """
+tag: user.homophones_open
+"""
+
+
+@ctx_homophones_open.action_class("user")
+class UserActions:
+    def choose(number_small: int):
+        """Choose the nth homophone"""
+        result = actions.user.homophones_select(number_small)
+        actions.insert(result)
+        actions.user.homophones_hide()

core/homophones/homophones_open.talon

@@ -1,9 +1,6 @@
 tag: user.homophones_open
 -
-choose <number_small>:
-    result = user.homophones_select(number_small)
-    insert(result)
-    user.homophones_hide()
+
 choose <user.formatters> <number_small>:
     result = user.homophones_select(number_small)
     insert(user.formatted_text(result, formatters))

core/menu_choose/menu_choose.py

@@ -0,0 +1,14 @@
+from talon import Context, Module, actions
+
+mod = Module()
+
+
+@mod.action_class
+class Actions:
+    def choose(number_small: int):
+        """Choose the nth item"""
+        actions.key(f"down:{number_small-1} enter")
+
+    def choose_up(number_small: int):
+        """Choose the nth item up"""
+        actions.key(f"up:{number_small} enter")

core/menu_choose/menu_choose.talon

@@ -0,0 +1,3 @@
+# pick item from a dropdown
+selector <number_small>: user.choose(number_small)
+selector up <number_small>: user.choose_up(number_small)