chore: Add support for VS Code debugging

* Add NPM scripts to start Karma ready for attaching the debugger
* Add a launcher to attach to Chrome started by Karma
* Add launchers to debug the preprocessor and bundling of tests
* Add directories to be ignored by the tree and search

Author: prantlf

.vscode/launch.json

@@ -0,0 +1,76 @@
+{
+  // Pro informace o možných atributech použijte technologii IntelliSense.
+  // Umístěním ukazatele myši zobrazíte popisy existujících atributů.
+  // Další informace najdete tady: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "build bundles",
+      "type": "node",
+      "request": "launch",
+      "program": "${workspaceFolder}/node_modules/rollup/dist/bin/rollup",
+      "cwd": "${workspaceFolder}/test",
+      "args": [
+        "-c"
+      ],
+      "skipFiles": [
+        "<node_internals>/**"
+      ]
+    },
+    {
+      "name": "run prefixes",
+      "type": "node",
+      "request": "launch",
+      "program": "${workspaceFolder}/node_modules/karma/bin/karma",
+      "cwd": "${workspaceFolder}/test",
+      "args": [
+        "start", "karma.prefixes.js"
+      ],
+      "skipFiles": [
+        "<node_internals>/**"
+      ]
+    },
+    {
+      "name": "run handler",
+      "type": "node",
+      "request": "launch",
+      "program": "${workspaceFolder}/node_modules/karma/bin/karma",
+      "cwd": "${workspaceFolder}/test",
+      "args": [
+        "start", "karma.handler.js"
+      ],
+      "skipFiles": [
+        "<node_internals>/**"
+      ]
+    },
+    {
+      "name": "run source-root",
+      "type": "node",
+      "request": "launch",
+      "program": "${workspaceFolder}/node_modules/karma/bin/karma",
+      "cwd": "${workspaceFolder}/test",
+      "args": [
+        "start", "karma.source-root.js"
+      ],
+      "skipFiles": [
+        "<node_internals>/**"
+      ]
+    },
+    {
+      "name": "attach to browser",
+      "type": "chrome",
+      "request": "attach",
+      // "url": "http://localhost:9876/debug.html",
+      "address": "localhost",
+      "port": 9222,
+      "webRoot": "${workspaceRoot}",
+      "pathMapping": {
+        "/": "${workspaceRoot}/test",
+        "/base/": "${workspaceRoot}/test/"
+      },
+      "sourceMapPathOverrides": {
+        "/test/*": "../src/*"
+      }
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+  "files.exclude": {
+    "**/.git": true,
+    "**/.DS_Store": true,
+    "**/Thumbs.db": true,
+    "**/coverage": true
+  },
+  "search.exclude": {
+    "**/node_modules": true,
+    "**/*.code-search": true,
+    "**/test/out": true
+  }
+}

.vscode/tasks.json

@@ -0,0 +1,40 @@
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+      "label": "debug prefixes",
+      "type": "shell",
+      "command": "karma",
+			"options": {
+				"cwd": "${workspaceRoot}/test"
+			},
+      "args": [
+				"start", "karma.prefixes.js", "--reporters=progress",
+				"--single-run=false", "--auto-watch"
+			],
+      "isBackground": true,
+			"problemMatcher": {
+        "owner": "karma",
+        "fileLocation": "relative",
+        "pattern": [
+					{
+						"regexp": "\\) (\\S.*) FAILED$",
+						"message": 1
+					},
+					{
+						"regexp": "^            at \\S+ \\(([^:]+):(\\d+):(\\d+)\\)$",
+						"file": 1,
+						"line": 2,
+						"column": 3
+					}
+				],
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "\\[karma-server\\]",
+					"endsPattern": "^TOTAL: (?:\\d+ FAILED, )?\\d+ SUCCESS$"
+          // "endsPattern": "LOG MESSAGES FOR"
+        }
+      }
+    }
+	]
+}

package.json

@@ -22,6 +22,9 @@
   },
   "license": "MIT",
   "scripts": {
+    "debug:prefixes": "karma start test/karma.prefixes.js --reporters=progress --single-run=false --auto-watch",
+    "debug:handler": "karma start test/karma.handler.js --reporters=progress --single-run=false --auto-watch",
+    "debug:source-root": "karma start test/karma.source-root.js --reporters=progress --single-run=false --auto-watch",
     "pretest": "cd test && rollup -c",
     "test": "c8 karma start test/karma.prefixes.js && c8 --no-clean karma start test/karma.handler.js && c8 --no-clean karma start test/karma.source-root-value.js && c8 --no-clean karma start test/karma.source-root-function.js && c8 report -r text -r lcov && c8 check-coverage --100"
   },

test/karma.shared.js

@@ -22,7 +22,16 @@ module.exports = function (config, testName) {
 
     reporters: ['brief'],
 
-    browsers: ['ChromeHeadless'],
+    browsers: ['ChromeDebugging'],
+
+    customLaunchers: {
+      ChromeDebugging: {
+        base: 'ChromeHeadless',
+        flags: [
+          '--remote-debugging-port=9222', '--use-mock-keychain'
+        ]
+      }
+    },
 
     briefReporter: { renderOnRunCompleteOnly: !!process.env.CI },