Add support for if and for statements in Talon-script (#3274)

Author: AndreasArvidsson

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## 2026
 
+- 2026-05-03: Add support for if and for statements in Talon-script. [`#3274`](https://github.com/cursorless-dev/cursorless/pull/3274)
 - 2026-03-12: Added `userColor3` and `userColor4` as additional user-configurable hat colors. They are disabled by default until you enable and name them. ([#3206](https://github.com/cursorless-dev/cursorless/pull/3206))
 - 2026-03-11: Moved scope tests out of VSCode so they can run as regular unit tests with faster local and CI feedback. ([#3210](https://github.com/cursorless-dev/cursorless/pull/3210))
 - 2026-03-11: Git actions can now stage and unstage entire files, not just partial selections. ([#3209](https://github.com/cursorless-dev/cursorless/pull/3209))

packages/app-web-docs/package.json

@@ -23,15 +23,15 @@
     "build": "docusaurus build --out-dir out"
   },
   "dependencies": {
-    "@algolia/client-search": "^5.51.0",
+    "@algolia/client-search": "^5.52.0",
     "@cursorless/lib-common": "workspace:*",
     "@docsearch/react": "^4.6.3",
-    "@docusaurus/core": "^3.10.0",
-    "@docusaurus/faster": "^3.10.0",
-    "@docusaurus/preset-classic": "^3.10.0",
-    "@docusaurus/theme-classic": "^3.10.0",
-    "@docusaurus/theme-common": "^3.10.0",
-    "@docusaurus/theme-search-algolia": "^3.10.0",
+    "@docusaurus/core": "^3.10.1",
+    "@docusaurus/faster": "^3.10.1",
+    "@docusaurus/preset-classic": "^3.10.1",
+    "@docusaurus/theme-classic": "^3.10.1",
+    "@docusaurus/theme-common": "^3.10.1",
+    "@docusaurus/theme-search-algolia": "^3.10.1",
     "@mdx-js/react": "^3.1.1",
     "bootstrap": "^5.3.8",
     "docusaurus-plugin-sass": "^0.2.6",
@@ -43,8 +43,8 @@
   },
   "devDependencies": {
     "@cursorless/lib-node-common": "workspace:*",
-    "@docusaurus/module-type-aliases": "^3.10.0",
-    "@docusaurus/types": "^3.10.0",
+    "@docusaurus/module-type-aliases": "^3.10.1",
+    "@docusaurus/types": "^3.10.1",
     "@types/mdast": "^4.0.4",
     "@types/mocha": "^10.0.10",
     "@types/node": "^24.12.2",

packages/lib-common/src/scopeSupportFacets/talon.ts

@@ -14,24 +14,34 @@ export const talonScopeSupport: LanguageScopeSupportFacetMap = {
 
   "comment.line": supported,
 
+  "condition.if": supported,
+
   "interior.command": supported,
+  "interior.if": supported,
+  "interior.foreach": supported,
 
   "name.assignment": supported,
   "name.command": supported,
   "name.variable.initialized": supported,
+  "name.foreach": supported,
   "name.iteration.block": supported,
   "name.iteration.document": supported,
 
   "statement.command": supported,
   "statement.variable.initialized": supported,
   "statement.assignment": supported,
   "statement.functionCall": supported,
+  "statement.if": supported,
+  "statement.foreach": supported,
   "statement.iteration.block": supported,
   "statement.iteration.document": supported,
 
+  ifStatement: supported,
+
   "value.assignment": supported,
   "value.command": supported,
   "value.variable": supported,
+  "value.foreach": supported,
   "value.iteration.block": supported,
   "value.iteration.document": supported,
 
@@ -231,15 +241,11 @@ export const talonScopeSupport: LanguageScopeSupportFacetMap = {
   "name.argument.catch": notApplicable,
   "type.argument.catch": notApplicable,
 
-  // If statement
-  ifStatement: notApplicable,
-  "statement.if": notApplicable,
+  // If statement branches
   "branch.if": notApplicable,
   "branch.if.elif.else": notApplicable,
   "branch.if.else": notApplicable,
   "branch.if.iteration": notApplicable,
-  "condition.if": notApplicable,
-  "interior.if": notApplicable,
 
   // Switch statement
   "statement.switch": notApplicable,
@@ -251,7 +257,7 @@ export const talonScopeSupport: LanguageScopeSupportFacetMap = {
   "interior.switchCase": notApplicable,
   "value.switch": notApplicable,
 
-  // Loop
+  // Loop branches
   "branch.loop": notApplicable,
   "branch.loop.iteration": notApplicable,
 
@@ -260,13 +266,6 @@ export const talonScopeSupport: LanguageScopeSupportFacetMap = {
   "condition.for": notApplicable,
   "interior.for": notApplicable,
 
-  // For-each loop
-  "statement.foreach": notApplicable,
-  "interior.foreach": notApplicable,
-  "name.foreach": notApplicable,
-  "type.foreach": notApplicable,
-  "value.foreach": notApplicable,
-
   // While loop
   "statement.while": notApplicable,
   "condition.while": notApplicable,
@@ -358,6 +357,7 @@ export const talonScopeSupport: LanguageScopeSupportFacetMap = {
   "type.iteration.document": notApplicable,
   "functionCall.generic": notApplicable,
   "functionCallee.generic": notApplicable,
+  "type.foreach": notApplicable,
 
   // Type alias
   "type.alias": notApplicable,

packages/lib-engine/package.json

@@ -20,15 +20,15 @@
     "@cursorless/lib-common": "workspace:*",
     "@cursorless/lib-node-common": "workspace:*",
     "@cursorless/lib-sentence-parser": "workspace:*",
-    "@cursorless/talon-tools": "^0.10.2",
+    "@cursorless/talon-tools": "^0.11.0",
     "immer": "^11.1.4",
     "immutability-helper": "^3.1.1",
     "itertools": "^2.6.0",
     "lodash-es": "^4.18.1",
     "moo": "^0.5.3",
     "nearley": "^2.20.1",
     "uuid": "^14.0.0",
-    "zod": "^4.3.6"
+    "zod": "^4.4.2"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",

packages/test-runner/package.json

@@ -29,7 +29,7 @@
     "tail": "^2.2.6"
   },
   "devDependencies": {
-    "@cursorless/tree-sitter-wasms": "^0.8.1",
+    "@cursorless/tree-sitter-wasms": "^0.9.0",
     "@types/cross-spawn": "^6.0.6",
     "@types/mocha": "^10.0.10",
     "@types/tail": "^2.2.3",