Add pre-commit

.editorconfig

@@ -0,0 +1,38 @@
+# See https://EditorConfig.org
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_size = 2
+indent_style = space
+max_line_length = 80
+trim_trailing_whitespace = true
+
+[*.json]
+indent_style = tab
+
+[*.py]
+indent_style = space
+indent_size = 4
+
+[*.{yml,yaml}]
+# Trailing whitespace breaks yaml files if you use a multiline string
+# with a line that has trailing white space. Many of our recorded
+# tests use strings with trailing white space to represent the final
+# document contents. For example
+# src/test/suite/fixtures/recorded/languages/ruby/changeCondition.yml
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab
+
+[src/vendor/**]
+charset = unset
+end_of_line = unset
+indent_size = unset
+indent_style = unset
+trim_trailing_whitespace = unset
+insert_final_newline = unset
+max_line_length = unset

.eslintrc.json

@@ -1,6 +1,9 @@
 {
     "root": true,
     "parser": "@typescript-eslint/parser",
+    "extends": [
+        "prettier"
+    ],
     "parserOptions": {
         "ecmaVersion": 6,
         "sourceType": "module"
@@ -10,7 +13,6 @@
     ],
     "rules": {
         "@typescript-eslint/naming-convention": "warn",
-        "@typescript-eslint/semi": "warn",
         "@typescript-eslint/no-unused-vars": [
             "warn",
             {

.pre-commit-config.yaml

@@ -0,0 +1,41 @@
+minimum_pre_commit_version: "2.9.0"
+ci:
+  autofix_prs: false
+exclude: ^src/vendor/
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.1.0
+    hooks:
+      - id: check-added-large-files
+      - id: check-case-conflict
+      - id: check-executables-have-shebangs
+      - id: check-merge-conflict
+      - id: check-shebang-scripts-are-executable
+      - id: check-symlinks
+      - id: destroyed-symlinks
+      - id: detect-private-key
+      - id: end-of-file-fixer
+      - id: fix-byte-order-marker
+      - id: mixed-line-ending
+      - id: trailing-whitespace
+        # Trailing whitespace breaks yaml files if you use a multiline string
+        # with a line that has trailing white space. Many of our recorded
+        # tests use strings with trailing white space to represent the final
+        # document contents. For example
+        # src/test/suite/fixtures/recorded/languages/ruby/changeCondition.yml
+        exclude: ^src/test/suite/fixtures/recorded/.*/[^/]*\.yml$
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: "v2.6.2"
+    hooks:
+      - id: prettier
+  - repo: https://github.com/ikamensh/flynt/
+    rev: "0.76"
+    hooks:
+      - id: flynt
+  - repo: https://github.com/Zac-HD/shed
+    rev: 0.9.5
+    hooks:
+      - id: shed
+        # TODO: bump to --py310-plus when Talon moves to Python 3.10.
+        args: [--refactor, --py39-plus]
+        types_or: [python, markdown, rst]

.prettierignore

@@ -0,0 +1,4 @@
+/src/vendor
+
+# We use our own format for our recorded yaml tests to keep them compact
+/src/test/suite/fixtures/recorded/**/*.yml

.vscode/extensions.json

@@ -2,6 +2,7 @@
 	// See http://go.microsoft.com/fwlink/?LinkId=827846
 	// for the documentation about the extensions.json format
 	"recommendations": [
-		"dbaeumer.vscode-eslint"
+		"dbaeumer.vscode-eslint",
+		"esbenp.prettier-vscode"
 	]
 }

.vscode/settings.json

@@ -6,9 +6,8 @@
     "search.exclude": {
         "out": true // set this to false to include "out" folder in search results
     },
-    "[typescript]": {
-        "editor.defaultFormatter": "esbenp.prettier-vscode"
-    },
+    "python.formatting.provider": "black",
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
     // Turn off tsc task auto detection since we have the necessary tasks as npm scripts
     "typescript.tsc.autoDetect": "off",
     "cSpell.words": [
@@ -21,4 +20,4 @@
         "pojo",
         "subword"
     ]
-}
+}

docs/contributing/CONTRIBUTING.md

@@ -18,6 +18,13 @@ locally you need to run the extension in debug mode. To do so you need to run
 the `workbench.action.debug.selectandstart` command and then select either "Run
 Extension" or "Extension Tests".
 
+### Code formatting
+
+We use [`pre-commit`](https://pre-commit.com/) to automate autoformatting.
+Autoformatters will automatically run on PRs in CI, but you can also run them
+locally or install pre-commit hooks as described in the `pre-commit`
+documentation.
+
 ### Running docs site locally
 
 Run the `workbench.action.debug.selectandstart` command and then select

package.json

@@ -513,15 +513,17 @@
 		"@types/semver": "^7.3.9",
 		"@types/sinon": "^10.0.2",
 		"@types/vscode": "^1.61.0",
-		"@typescript-eslint/eslint-plugin": "^5.11.0",
-		"@typescript-eslint/parser": "^5.11.0",
+		"@typescript-eslint/eslint-plugin": "^5.20.0",
+		"@typescript-eslint/parser": "^5.20.0",
 		"esbuild": "^0.11.12",
-		"eslint": "^7.15.0",
+		"eslint": "^8.13.0",
+		"eslint-config-prettier": "^8.5.0",
 		"fast-xml-parser": "^3.20.0",
 		"glob": "^7.1.7",
 		"js-yaml": "^4.1.0",
 		"mocha": "^8.1.3",
 		"npm-license-crawler": "^0.2.1",
+		"prettier": "2.6.2",
 		"semver": "^7.3.5",
 		"sinon": "^11.1.1",
 		"typescript": "^4.5.5",
@@ -532,4 +534,4 @@
 		"immutability-helper": "^3.1.1",
 		"lodash": "^4.17.21"
 	}
-}
+}

src/core/updateSelections/updateSelections.ts

@@ -66,7 +66,7 @@ export function getSelectionInfo(
  */
 export function selectionsToSelectionInfos(
   document: TextDocument,
-  selectionMatrix: Selection[][],
+  selectionMatrix: (readonly Selection[])[],
   rangeBehavior: DecorationRangeBehavior = DecorationRangeBehavior.ClosedClosed
 ): FullSelectionInfo[][] {
   return selectionMatrix.map((selections) =>
@@ -118,7 +118,7 @@ export async function callFunctionAndUpdateSelections(
   rangeUpdater: RangeUpdater,
   func: () => Thenable<unknown>,
   document: TextDocument,
-  selectionMatrix: Selection[][]
+  selectionMatrix: (readonly Selection[])[]
 ): Promise<Selection[][]> {
   const selectionInfoMatrix = selectionsToSelectionInfos(
     document,
@@ -173,7 +173,7 @@ export async function performEditsAndUpdateSelections(
   rangeUpdater: RangeUpdater,
   editor: TextEditor,
   edits: Edit[],
-  originalSelections: Selection[][]
+  originalSelections: (readonly Selection[])[]
 ) {
   const document = editor.document;
   const selectionInfoMatrix = selectionsToSelectionInfos(

src/util/addDecorationsToEditor.ts

@@ -20,15 +20,17 @@ export function addDecorationsToEditors(
 ) {
   hatTokenMap.clear();
 
-  var editors: vscode.TextEditor[];
+  var editors: readonly vscode.TextEditor[];
 
   if (vscode.window.activeTextEditor == null) {
     editors = vscode.window.visibleTextEditors;
   } else {
-    editors = vscode.window.visibleTextEditors.filter(
-      (editor) => editor !== vscode.window.activeTextEditor
-    );
-    editors.unshift(vscode.window.activeTextEditor);
+    editors = [
+      vscode.window.activeTextEditor,
+      ...vscode.window.visibleTextEditors.filter(
+        (editor) => editor !== vscode.window.activeTextEditor
+      ),
+    ];
   }
 
   const tokens = concat(

third-party-licenses.csv

@@ -1,12 +1,12 @@
 "module name","licenses","repository","licenseUrl","parents"
-"@docusaurus/core@2.0.0-beta.15","MIT","https://github.com/facebook/docusaurus","https://github.com/facebook/docusaurus/raw/master/LICENSE","website"
-"@docusaurus/preset-classic@2.0.0-beta.15","MIT","https://github.com/facebook/docusaurus","https://github.com/facebook/docusaurus/raw/master/LICENSE","website"
+"@docusaurus/core@2.0.0-beta.17","MIT","https://github.com/facebook/docusaurus","https://github.com/facebook/docusaurus/raw/master/LICENSE","website"
+"@docusaurus/preset-classic@2.0.0-beta.17","MIT","https://github.com/facebook/docusaurus","https://github.com/facebook/docusaurus/raw/master/LICENSE","website"
 "@mdx-js/react@1.6.22","MIT","https://github.com/mdx-js/mdx","https://github.com/mdx-js/mdx/raw/master/license","website"
-"@types/lodash@4.14.168","MIT","https://github.com/DefinitelyTyped/DefinitelyTyped","https://github.com/DefinitelyTyped/DefinitelyTyped/raw/master/LICENSE","cursorless"
+"@types/lodash@4.14.181","MIT","https://github.com/DefinitelyTyped/DefinitelyTyped","https://github.com/DefinitelyTyped/DefinitelyTyped/raw/master/LICENSE","cursorless"
 "clsx@1.1.1","MIT","https://github.com/lukeed/clsx","https://github.com/lukeed/clsx/raw/master/license","website"
 "immutability-helper@3.1.1","MIT","https://github.com/kolodny/immutability-helper","https://github.com/kolodny/immutability-helper/raw/master/LICENSE","cursorless"
 "mdast-util-find-and-replace@2.1.0","MIT","https://github.com/syntax-tree/mdast-util-find-and-replace","https://github.com/syntax-tree/mdast-util-find-and-replace/raw/master/license","website"
-"prism-react-renderer@1.2.1","MIT","https://github.com/FormidableLabs/prism-react-renderer","https://github.com/FormidableLabs/prism-react-renderer/raw/master/LICENSE","website"
+"prism-react-renderer@1.3.1","MIT","https://github.com/FormidableLabs/prism-react-renderer","https://github.com/FormidableLabs/prism-react-renderer/raw/master/LICENSE","website"
 "react-dom@17.0.2","MIT","https://github.com/facebook/react","https://github.com/facebook/react/raw/master/LICENSE","website"
 "react@17.0.2","MIT","https://github.com/facebook/react","https://github.com/facebook/react/raw/master/LICENSE","website"
 "unist-util-visit@4.1.0","MIT","https://github.com/syntax-tree/unist-util-visit","https://github.com/syntax-tree/unist-util-visit/raw/master/license","website"