From 2bac01fb7b4e43a2f7e707b7848d1b925d598cda Mon Sep 17 00:00:00 2001 From: Kartik Agaram Date: Mon, 8 Nov 2021 18:49:15 -0800 Subject: [PATCH] syntax highlighting for Visual Studio Code --- editor/VSCode/.vscode/launch.json | 17 ++++ editor/VSCode/.vscodeignore | 4 + editor/VSCode/CHANGELOG.md | 9 +++ editor/VSCode/README.md | 65 +++++++++++++++ editor/VSCode/language-configuration.json | 30 +++++++ editor/VSCode/package.json | 25 ++++++ editor/VSCode/syntaxes/Mu.tmLanguage | 96 +++++++++++++++++++++++ editor/VSCode/vsc-extension-quickstart.md | 29 +++++++ 8 files changed, 275 insertions(+) create mode 100644 editor/VSCode/.vscode/launch.json create mode 100644 editor/VSCode/.vscodeignore create mode 100644 editor/VSCode/CHANGELOG.md create mode 100644 editor/VSCode/README.md create mode 100644 editor/VSCode/language-configuration.json create mode 100644 editor/VSCode/package.json create mode 100644 editor/VSCode/syntaxes/Mu.tmLanguage create mode 100644 editor/VSCode/vsc-extension-quickstart.md diff --git a/editor/VSCode/.vscode/launch.json b/editor/VSCode/.vscode/launch.json new file mode 100644 index 00000000..0e191b59 --- /dev/null +++ b/editor/VSCode/.vscode/launch.json @@ -0,0 +1,17 @@ +// A launch configuration that launches the extension inside a new window +// Use IntelliSense to learn about possible attributes. +// Hover to view descriptions of existing attributes. +// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387 +{ + "version": "0.2.0", + "configurations": [ + { + "name": "Extension", + "type": "extensionHost", + "request": "launch", + "args": [ + "--extensionDevelopmentPath=${workspaceFolder}" + ] + } + ] +} \ No newline at end of file diff --git a/editor/VSCode/.vscodeignore b/editor/VSCode/.vscodeignore new file mode 100644 index 00000000..f369b5e5 --- /dev/null +++ b/editor/VSCode/.vscodeignore @@ -0,0 +1,4 @@ +.vscode/** +.vscode-test/** +.gitignore +vsc-extension-quickstart.md diff --git a/editor/VSCode/CHANGELOG.md b/editor/VSCode/CHANGELOG.md new file mode 100644 index 00000000..5b37189b --- /dev/null +++ b/editor/VSCode/CHANGELOG.md @@ -0,0 +1,9 @@ +# Change Log + +All notable changes to the "mu" extension will be documented in this file. + +Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how to structure this file. + +## [Unreleased] + +- Initial release \ No newline at end of file diff --git a/editor/VSCode/README.md b/editor/VSCode/README.md new file mode 100644 index 00000000..3230356e --- /dev/null +++ b/editor/VSCode/README.md @@ -0,0 +1,65 @@ +# mu README + +This is the README for your extension "mu". After writing up a brief description, we recommend including the following sections. + +## Features + +Describe specific features of your extension including screenshots of your extension in action. Image paths are relative to this README file. + +For example if there is an image subfolder under your extension project workspace: + +\!\[feature X\]\(images/feature-x.png\) + +> Tip: Many popular extensions utilize animations. This is an excellent way to show off your extension! We recommend short, focused animations that are easy to follow. + +## Requirements + +If you have any requirements or dependencies, add a section describing those and how to install and configure them. + +## Extension Settings + +Include if your extension adds any VS Code settings through the `contributes.configuration` extension point. + +For example: + +This extension contributes the following settings: + +* `myExtension.enable`: enable/disable this extension +* `myExtension.thing`: set to `blah` to do something + +## Known Issues + +Calling out known issues can help limit users opening duplicate issues against your extension. + +## Release Notes + +Users appreciate release notes as you update your extension. + +### 1.0.0 + +Initial release of ... + +### 1.0.1 + +Fixed issue #. + +### 1.1.0 + +Added features X, Y, and Z. + +----------------------------------------------------------------------------------------------------------- + +## Working with Markdown + +**Note:** You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts: + +* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux) +* Toggle preview (`Shift+CMD+V` on macOS or `Shift+Ctrl+V` on Windows and Linux) +* Press `Ctrl+Space` (Windows, Linux) or `Cmd+Space` (macOS) to see a list of Markdown snippets + +### For more information + +* [Visual Studio Code's Markdown Support](http://code.visualstudio.com/docs/languages/markdown) +* [Markdown Syntax Reference](https://help.github.com/articles/markdown-basics/) + +**Enjoy!** diff --git a/editor/VSCode/language-configuration.json b/editor/VSCode/language-configuration.json new file mode 100644 index 00000000..8f162a0c --- /dev/null +++ b/editor/VSCode/language-configuration.json @@ -0,0 +1,30 @@ +{ + "comments": { + // symbol used for single line comment. Remove this entry if your language does not support line comments + "lineComment": "//", + // symbols used for start and end a block comment. Remove this entry if your language does not support block comments + "blockComment": [ "/*", "*/" ] + }, + // symbols used as brackets + "brackets": [ + ["{", "}"], + ["[", "]"], + ["(", ")"] + ], + // symbols that are auto closed when typing + "autoClosingPairs": [ + ["{", "}"], + ["[", "]"], + ["(", ")"], + ["\"", "\""], + ["'", "'"] + ], + // symbols that can be used to surround a selection + "surroundingPairs": [ + ["{", "}"], + ["[", "]"], + ["(", ")"], + ["\"", "\""], + ["'", "'"] + ] +} \ No newline at end of file diff --git a/editor/VSCode/package.json b/editor/VSCode/package.json new file mode 100644 index 00000000..6619f4ea --- /dev/null +++ b/editor/VSCode/package.json @@ -0,0 +1,25 @@ +{ + "name": "mu", + "displayName": "Mu", + "description": "Syntax Highlighting for the Mu language", + "version": "0.0.1", + "engines": { + "vscode": "^1.62.0" + }, + "categories": [ + "Programming Languages" + ], + "contributes": { + "languages": [{ + "id": "mu", + "aliases": ["Mu", "mu"], + "extensions": [".mu"], + "configuration": "./language-configuration.json" + }], + "grammars": [{ + "language": "mu", + "scopeName": "source.mu", + "path": "./syntaxes/Mu.tmLanguage" + }] + } +} \ No newline at end of file diff --git a/editor/VSCode/syntaxes/Mu.tmLanguage b/editor/VSCode/syntaxes/Mu.tmLanguage new file mode 100644 index 00000000..64f71320 --- /dev/null +++ b/editor/VSCode/syntaxes/Mu.tmLanguage @@ -0,0 +1,96 @@ + + + + + fileTypes + + mu + + name + Mu + patterns + + + match + #.* + name + comment.line.mu + + + match + <- + name + meta.operator.mu + + + match + \b(return|break[^ ]*|loop[^ ]*) + name + keyword.control.mu + + + match + \b[^ ]*:\b + name + constant.other.label.mu + + + match + ^fn|->\b + name + meta.function.mu + + + match + \bvar\b + name + storage.type.var.mu + + + match + \b(addr|array|boolean|byte|code-point|grapheme|handle|int|float|stream|type)\b + name + storage.type.mu + + + begin + " + end + " + name + string.quoted.double.mu + patterns + + + match + \. + name + constant.character.escape + + + + + match + \b(0x\h+|[0-9])\b + name + constant.numeric.integer.mu + + + match + \b([0-9][0-9a-f]+)\b + name + invalid.illegal.constant.numeric + + + match + \b([0-9a-zA-Z][0-9a-zA-Z])\b + name + invalid.illegal.constant.numeric + + + scopeName + source.mu + uuid + 766C3FEA-ED70-4B61-B17B-79E6ECE54036 + + diff --git a/editor/VSCode/vsc-extension-quickstart.md b/editor/VSCode/vsc-extension-quickstart.md new file mode 100644 index 00000000..856221dc --- /dev/null +++ b/editor/VSCode/vsc-extension-quickstart.md @@ -0,0 +1,29 @@ +# Welcome to your VS Code Extension + +## What's in the folder + +* This folder contains all of the files necessary for your extension. +* `package.json` - this is the manifest file in which you declare your language support and define the location of the grammar file that has been copied into your extension. +* `syntaxes/Mu.tmLanguage` - this is the Text mate grammar file that is used for tokenization. +* `language-configuration.json` - this is the language configuration, defining the tokens that are used for comments and brackets. + +## Get up and running straight away + +* Make sure the language configuration settings in `language-configuration.json` are accurate. +* Press `F5` to open a new window with your extension loaded. +* Create a new file with a file name suffix matching your language. +* Verify that syntax highlighting works and that the language configuration settings are working. + +## Make changes + +* You can relaunch the extension from the debug toolbar after making changes to the files listed above. +* You can also reload (`Ctrl+R` or `Cmd+R` on Mac) the VS Code window with your extension to load your changes. + +## Add more language features + +* To add features such as intellisense, hovers and validators check out the VS Code extenders documentation at https://code.visualstudio.com/docs + +## Install your extension + +* To start using your extension with Visual Studio Code copy it into the `/.vscode/extensions` folder and restart Code. +* To share your extension with the world, read on https://code.visualstudio.com/docs about publishing an extension.