modernize the infra and updated the syntax to the latest Q# 1.x

Author: filipw

.gitignore

@@ -103,3 +103,6 @@ dist
 # TernJS port file
 .tern-port
 out/
+
+# macOS
+.DS_Store

.mocharc.json

@@ -0,0 +1,5 @@
+{
+  "require": "ts-node/register",
+  "spec": "test/**/*.tests.ts",
+  "timeout": 10000
+}

README.md

@@ -4,15 +4,32 @@ This repository contains the TextMate grammar for Q#. The grammar provides token
 
 [![CoC](https://img.shields.io/badge/code%20of%20conduct-contributor%20covenant-yellow)](CODE_OF_CONDUCT.md)
 
+## Language coverage
+
+The grammar tracks modern Q# (QDK 1.x) and covers, among other things:
+
+* File-scoped namespaces, `import` / `export` directives (with `*` wildcards and `as` aliases), and the legacy `namespace { }` / `open` forms
+* `struct` declarations, `new` struct instantiation, copy-and-update (`...spread`) and member access (`point.X`)
+* Attributes (`@EntryPoint()`, `@Test()`, `@Config(...)`, ...)
+* Operation/function declarations with type parameters and class constraints (`<'T : Eq + Add>`, `Exp['T]`), plus the functors `is Adj + Ctl`
+* Lambdas (`->`, `=>`), partial application, ternary (`cond ? a | b`), and the full operator set (arithmetic, comparison, logical, bitwise `&&& ||| ^^^ ~~~ <<< >>>`, ranges `..`/`...`, copy-update `w/ ... <-`)
+* Numeric literals in decimal, hex (`0xFF`), binary (`0b1010`), octal (`0o52`), `BigInt` (`42L`), exponent (`1.0e-3`) and digit-separator (`1_000`) forms
+* Interpolated strings (`$"...{expr}..."`) with tokenized expression holes
+* Intrinsic quantum operations highlighted as quantum operations while still tokenizing their arguments
+
+The behaviour is pinned by an extensive unit-test suite; the tests can additionally be run against a checkout of the official [`microsoft/qdk`](https://github.com/microsoft/qdk) samples by pointing the `QDK_SAMPLES` environment variable at its `samples/` directory.
+
 ## Build and Development
 
 To contribute, clone the repo and run (requires Node.js and `npm` to be installed on the dev machine)
 
 * `npm install` to install all dependencies
-* Run `npm run compile` to build and run tests
-* Run `npm run test` to run only tests
+* Run `npm run build` to regenerate the grammar outputs from the YAML source
+* Run `npm test` to build the grammar and run the unit tests
 
 The source grammar is located at `src/qsharp.tmLanguage.yml` and is the core file to be maintained.
+The build (`build.js`) converts it into the two output files below; the tests tokenize
+Q# snippets with `vscode-textmate` and assert on the resulting scopes.
 
 ## Output
 

build.js

@@ -0,0 +1,36 @@
+// Builds the Q# TextMate grammar outputs from the YAML source.
+//
+//   src/qsharp.tmLanguage.yml  ->  grammars/qsharp.tmLanguage       (plist)
+//                              ->  grammars/qsharp.tmLanguage.json  (JSON)
+//
+// The YAML file is the single source of truth and the only file that should be
+// edited by hand. Run with `npm run build`.
+
+const fs = require("fs");
+const path = require("path");
+const jsYaml = require("js-yaml");
+const plist = require("plist");
+
+const srcFile = path.join(__dirname, "src", "qsharp.tmLanguage.yml");
+const grammarsDir = path.join(__dirname, "grammars");
+
+function build() {
+    const text = fs.readFileSync(srcFile, "utf8");
+    const grammar = jsYaml.load(text);
+
+    fs.mkdirSync(grammarsDir, { recursive: true });
+
+    fs.writeFileSync(
+        path.join(grammarsDir, "qsharp.tmLanguage.json"),
+        JSON.stringify(grammar, null, "\t") + "\n"
+    );
+
+    fs.writeFileSync(
+        path.join(grammarsDir, "qsharp.tmLanguage"),
+        plist.build(grammar)
+    );
+
+    console.log("Built grammars/qsharp.tmLanguage and grammars/qsharp.tmLanguage.json");
+}
+
+build();