Editor setup

VS Code / Cursor: official extension, LSP, and DAP debugging for .ny files.

Official extension

Job: One install for syntax, language server, debugger, test explorer, and build tasks.

bash scripts/package-vscode-extension.sh
# or: cd extensions/nyra && npm install && npm run compile && npm run package
code --install-extension extensions/nyra/nyra-*.vsix

Uses nyra lsp and nyra dap on your PATH (or bundled binary with nyra.useBundledToolchain). Features: format-on-save, Test Explorer (nyra test --list-json), CodeLens ▶ Run Test, status bar version, snippets. Publish steps: extensions/nyra/PUBLISHING.md.

LSP capabilities

Feature	Notes
Diagnostics	Same pipeline as `nyra diag` / `nyra check`
Completion / hover / signature help	Symbols + stdlib docs where available
Go to definition / references / rename	Cross-file via project index
Inlay hints	Inferred types and parameter names
Code actions	Quick fixes, “did you mean”, `source.fixAll`
CodeLens	▶ Run Test above `test fn`
Format	AST formatter (`nyra fmt`)

Manual LSP / DAP

{
  "nyra.languageServerPath": "nyra",
  "nyra.languageServerArgs": ["lsp"],
  "nyra.debugAdapterPath": "nyra"
}

Debug with nyra build . --debug-symbols then launch type nyra (breakpoints, stack, locals, stepping via nyra dap). For race hunting under the debugger: nyra debug . --race or nyra race ..

Grammar only

Grammar file: grammar/nyra.tmLanguage.json

nyra-syntax/
  package.json
  syntaxes/nyra.tmLanguage.json

Copy from repo or use raw URL from grammar README. This is highlighting only — see Language spec for semantics.