Merge pull request #1 from SSlinky/reprise

Project Restart

Author: SSlinky

.gitignore

@@ -3,4 +3,5 @@ out
 node_modules
 client/server
 .vscode-test
-test*/**
+sample*/**
+*.vsix

.vscode/launch.json

@@ -7,7 +7,10 @@
 			"request": "launch",
 			"name": "Launch Client",
 			"runtimeExecutable": "${execPath}",
-			"args": ["--extensionDevelopmentPath=${workspaceRoot}"],
+			"args": [
+				"--extensionDevelopmentPath=${workspaceRoot}",
+				"${workspaceFolder}/sample"
+			],
 			"outFiles": ["${workspaceRoot}/client/out/**/*.js"],
 			"preLaunchTask": {
 				"type": "npm",

.vscode/settings.json

@@ -5,5 +5,9 @@
 	"editor.codeActionsOnSave": {
 		"source.fixAll.eslint": "explicit"
 	},
-	"vbaLanguageServer.trace.server": "verbose"
+	"vbaLanguageServer.trace.server": "verbose",
+	"files.watcherExclude": {
+		"**/.git/objects/**": true,
+		"**/node_modules/**": true
+	} 
 }

.vscodeignore

@@ -1,15 +1,36 @@
-.vscode/**
-**/*.ts
-**/*.map
+# Project
 .gitignore
+.eslintignore
+.vscode/**
+.travis.yml
 **/tsconfig.json
 **/tsconfig.base.json
 contributing.md
-.travis.yml
+
+# Development
+**/src
+
+# # Typescript
+**/*.ts
+**/*.map
+
+# Generated
+.antlr
+*.java
+*.interp
+*.tokens
+*.vsix
+
+# Samples and testing
+sample*/**
+**/test/**
+**/testFixture/**
+
+# Client node modules
 client/node_modules/**
 !client/node_modules/vscode-jsonrpc/**
 !client/node_modules/vscode-languageclient/**
 !client/node_modules/vscode-languageserver-protocol/**
 !client/node_modules/vscode-languageserver-types/**
 !client/node_modules/{minimatch,brace-expansion,concat-map,balanced-match}/**
-!client/node_modules/{semver,lru-cache,yallist}/**
+!client/node_modules/{semver,lru-cache,yallist}/**

README.md

@@ -2,16 +2,26 @@
 
 Adds VBA language support to VSCode via LSP compliant Language Server.
 
+![VBA LSP](images/vba-lsp.png)
+
 ## Features
+
 * Syntax highlighting (resolved on client)
 * Semantic highlighting
 * Folding ranges
 * Document symbols
-* Diagnostics
 
+## Coming Soon
+
+* Hovers
+* Diagnostics (info, warnings, and errors)
 
 ## Installation
 
+* Through the VBA Marketplace,
+* VSCode command palette `ext install sslinky.vba-lsp`, or;
+* Download the [visx](/releases/latest).
+
 ## Contributing
 
-Contributors welcome! Please see [contributing.md](tbc).
+Contributors welcome! Please see [contributing.md](/contributing.md).

client/package-lock.json

@@ -7,7 +7,7 @@
 	"publisher": "SSlinky",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/SSlinky/tbc"
+		"url": "https://github.com/SSlinky/VB-LanguageServer"
 	},
 	"engines": {
 		"vscode": "^1.63.0"

client/package.json

@@ -19,10 +19,10 @@ repository:
       - include: "#mthdSig"
       - include: "#variableDeclarations"
       - include: "#block"
-      - include: "#testing"    
+      - include: "#testing"
     repository:
       moduleLines:
-        match: "(.*):"
+        match: '([^\n:]*)?:(?=([^"]*"[^"]*")*[^"]*$)'
         captures:
           1:
             patterns:
@@ -52,8 +52,7 @@ repository:
     repository:
       string:
         name: string.quoted.double.vba
-        begin: "\""
-        end: "\""
+        match: '"[^\r\n]*"'
       boolean:
         name: constant.language.boolean.vba
         match: "(?i)(true|false)"

client/src/syntaxes/vba.tmLanguage.yaml

@@ -0,0 +1,35 @@
+# Contributing
+
+## Setup
+
+1. Clone repo
+2. Install Java >= 11
+3. Install NPM
+4. `npm install` to install dependencies.
+5. `npm run textMate` first time and every time grammar is changed.
+6. `npm run antlr4ts` first time and every time grammar is changed.
+7. (Optional) Install [ANTLR4 grammar syntax support](https://marketplace.visualstudio.com/items?itemName=mike-lischke.vscode-antlr4) VSCode extension.
+
+## Debugging Language Server
+
+* Use the Client + Server launch configuration.
+
+## Debugging Antlr Grammar
+
+Requires the  ANTLR4 grammar syntax support extension installed. Each time you open the workspace, you'll need to open a grammar file to activate the extension.
+
+Note the grammar file for this project can be found at /server/src/antlr/vba.g4
+
+### Show Parse Tree
+
+* Open the VBA file you want to debug.
+* Run `Debug ANTLR4 grammar` from launch configurations.
+
+### Debug Rule
+
+* Open the grammar file.
+* Right click a rule and choose an option from the context menu.
+  * Show Railroad Diagram for Rule
+  * Show ATN Graph for Rule
+
+The grammar call graph is interesting, but not particularly useful. Generating "valid" input generates garbage.