feat: Add Nevermore-VSCode extension (#625)

Author: Quenty

.github/workflows/extension-release.yml

@@ -0,0 +1,18 @@
+name: Extension Release
+
+on:
+  workflow_dispatch:
+
+jobs:
+  extension-release:
+    name: Release Extension
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - run: npm ci
+        working-directory: tools/nevrmoree-vscode
+
+      - name: Publish VSCode Extension
+        working-directory: tools/nevermore-vscode
+        run: npx vsce publish --pat ${{ secrets.MARKETPLACE_TOKEN }}

.gitignore

@@ -11,6 +11,7 @@ dist
 *.tsbuildinfo
 .DS_Store
 globalTypes.d.lua
+*.vsix
 
 # Normally it's a good idea to commit this. However, in this mono-repo scenario with linking
 # it adds a ton of noise and no real gain. Also we have seen no gains from reproducing

.vscode/extensions.json

@@ -1,5 +1,6 @@
 {
     "recommendations": [
+      "quenty.nevermore-vscode",
       "kampfkarren.selene-vscode",
       "johnnymorganz.luau-lsp",
       "johnnymorganz.stylua"

LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2014-2025 James Onnen (Quenty)
+Copyright (c) 2014-2026 James Onnen (Quenty)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

docs/ides/vscode.md

@@ -0,0 +1,55 @@
+# Getting started with VSCode
+
+VSCode works with Nevermore relatively easily. We have default extensions.json setup. Follow the general setup tips. This types should generally work for Cursor and other VS-Code based IDEs.
+
+## Extensions
+
+Nevermore uses standard community extensions, including the following:
+
+* quenty.nevermore-vscode
+* kampfkarren.selene-vscode
+* johnnymorganz.luau-lsp
+* johnnymorganz.stylua
+
+These will provide snippets, styling, and linking.
+
+## Configuration of Luau-LSP
+
+You currently must use the forked version of luau-lsp. You can use the default extension.
+
+in `settings.json` configure the luau-lsp server to point towards a custom exe path. This should be your Luau-lsp exe path installed via aftman.toml.
+
+```json
+  "luau-lsp.server.path": "C:/Users/James Onnen/.aftman/tool-storage/quenty/luau-lsp/1.58.0-quenty.1/luau-lsp.exe",
+```
+
+## Other helpful settings for consumption
+
+In your user-settings the following settings can be helpful:
+
+```json
+  "[lua]": {
+    "editor.defaultFormatter": "JohnnyMorganz.stylua",
+    "editor.formatOnSave": true,
+    "editor.formatOnSaveMode": "file"
+  },
+  "[luau]": {
+    "editor.defaultFormatter": "JohnnyMorganz.stylua",
+    "editor.formatOnSave": true,
+    "editor.formatOnSaveMode": "file"
+  },
+
+  // Explorer
+  "explorer.confirmDragAndDrop": false,
+  "explorer.compactFolders": false,
+
+  // Make init files not horrible
+  "explorer.fileNesting.enabled": true,
+  "explorer.fileNesting.patterns": {
+    "init.lua": "*.lua",
+    "*": "${basename}.*.${extname}"
+  },
+  "workbench.editor.customLabels.patterns": {
+    "**/init.lua": "${dirname}.lua"
+  },
+```

tools/nevermore-cli/templates/game-template/.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+    "recommendations": [
+      "quenty.nevermore-vscode",
+      "kampfkarren.selene-vscode",
+      "johnnymorganz.luau-lsp",
+      "johnnymorganz.stylua"
+    ]
+}

tools/nevermore-cli/templates/game-template/.vscode/settings.json

@@ -0,0 +1,19 @@
+{
+  "files.exclude": {
+    "*.sublime-workspace": true,
+    "**/node_modules/**": true,
+    "roblox.toml": true
+  },
+  "luau-lsp.sourcemap.rojoProjectFile": "default.project.json",
+  "luau-lsp.ignoreGlobs": ["**/node_modules/**"],
+  "[lua]": {
+    "editor.defaultFormatter": "JohnnyMorganz.stylua",
+    "editor.formatOnSave": true,
+    "editor.formatOnSaveMode": "file"
+  },
+  "[luau]": {
+    "editor.defaultFormatter": "JohnnyMorganz.stylua",
+    "editor.formatOnSave": true,
+    "editor.formatOnSaveMode": "file"
+  }
+}

tools/nevermore-vscode/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2014-2026 James Onnen (Quenty)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tools/nevermore-vscode/README.md

@@ -0,0 +1,20 @@
+# Nevermore-VSCode
+
+This provides snippets for Nevermore for VSCode that help with boiler-plate. For example, you can do type `class` in Lua document, and it will generate a Lua class.
+
+Note that sometimes this can lead to built-in patterns emerging that are maybe more verbose than intended. Please consider updating the snippets as Nevermore develops to reduce boilerplate.
+
+## Building locally
+Basic approach:
+
+```bash
+npm run build:install
+```
+
+Manual approach:
+
+```bash
+npm install -g @vscode/vsce
+vsce package
+code --install-extension roblox-lua-snippets-1.0.0.vsix
+```