Migrate snippets support to community snippets, support multiple snippets (#2804)

cursorless-dev/cursorless#2353

The Cursorless side of talonhub/community#1718

Will allow Cursorless to fetch multiple snippets from community and
decide which one to use.

## Release notes
Cursorless can now get multiple snippets from community. One for each
language. Cursorless can then pick the correct snippet for the document
language regardless of which document is focused at the moment.

---------

Co-authored-by: Phillip Cohen <phillip@phillip.io>

Author: 2 people

src/actions/generate_snippet.py

@@ -1,17 +1,12 @@
 import glob
 from pathlib import Path
 
-from talon import Context, Module, actions, registry, settings
+from talon import Module, actions, registry, settings
 
 from ..targets.target_types import CursorlessExplicitTarget
 
 mod = Module()
 
-ctx = Context()
-ctx.matches = r"""
-tag: user.cursorless_use_community_snippets
-"""
-
 
 @mod.action_class
 class Actions:
@@ -33,17 +28,6 @@ def private_cursorless_migrate_snippets():
 
     def private_cursorless_generate_snippet_action(target: CursorlessExplicitTarget):  # pyright: ignore [reportGeneralTypeIssues]
         """Generate a snippet from the given target"""
-        actions.user.private_cursorless_command_no_wait(
-            {
-                "name": "generateSnippet",
-                "target": target,
-            }
-        )
-
-
-@ctx.action_class("user")
-class UserActions:
-    def private_cursorless_generate_snippet_action(target: CursorlessExplicitTarget):  # pyright: ignore [reportGeneralTypeIssues]
         actions.user.private_cursorless_command_no_wait(
             {
                 "name": "generateSnippet",

src/check_community_repo.py

@@ -9,6 +9,7 @@
 
 required_actions = [
     "user.homophones_get",
+    "user.insert_snippet_by_name",
     "user.reformat_text",
 ]
 

src/snippet_cursorless.talon

@@ -0,0 +1,77 @@
+from dataclasses import dataclass
+
+from .targets.target_types import CursorlessDestination, CursorlessTarget
+
+
+@dataclass
+class ScopeType:
+    type: str
+
+
+# Insertion snippets
+
+
+@dataclass
+class CustomInsertionSnippet:
+    type = "custom"
+    body: str
+    scopeTypes: list[ScopeType] | None
+    languages: list[str] | None
+    substitutions: dict[str, str] | None
+
+
+@dataclass
+class ListInsertionSnippet:
+    type = "list"
+    substitutions: dict[str, str] | None
+    snippets: list[CustomInsertionSnippet]
+
+
+@dataclass
+class InsertSnippetAction:
+    name = "insertSnippet"
+    snippetDescription: CustomInsertionSnippet | ListInsertionSnippet
+    destination: CursorlessDestination
+
+
+# Wrapper snippets
+
+
+@dataclass
+class CustomWrapperSnippet:
+    type = "custom"
+    body: str
+    variableName: str | None
+    scopeType: ScopeType | None
+    languages: list[str] | None
+
+
+@dataclass
+class ListWrapperSnippet:
+    type = "list"
+    snippets: list[CustomWrapperSnippet]
+
+
+@dataclass
+class WrapperSnippetAction:
+    name = "wrapWithSnippet"
+    snippetDescription: CustomWrapperSnippet | ListWrapperSnippet
+    target: CursorlessTarget
+
+
+# Community types
+
+
+@dataclass
+class CommunityInsertionSnippet:
+    body: str
+    languages: list[str] | None = None
+    scopes: list[str] | None = None
+
+
+@dataclass
+class CommunityWrapperSnippet:
+    body: str
+    variable_name: str
+    languages: list[str] | None
+    scope: str | None