DhrLang VS Code Extension

Modern language tooling for the DhrLang language: syntax highlighting, snippets, run / compile commands, diagnostics, and quality-of-life helpers.

This README now reflects the current English‑core token set (num, duo, sab, kya, any, kaam, class, static, etc.). Legacy Hindi keyword forms were removed from the language docs and are no longer advertised here.

✨ Features

🚀 Zero Config Run

• Bundled Compiler: The extension includes the DhrLang compiler. Just install and run!
• No Setup: You don't need to download the JAR separately.
• Requirement: Ensure Java 17+ is installed on your system.

🎨 Syntax Highlighting

• Accurate grammar for .dhr files
• Highlights keywords, literals, strings, comments, classes, functions, numbers
• Updated for the simplified English‑core tokens

🧠Full Language Server (go-to-def, hover, rename, references, completion, diagnostics)

• The extension now launches the real DhrLang Language Server (java -jar DhrLang.jar --lsp) over stdio via vscode-languageclient, instead of the old static/in-process providers.
• Go to Definition and Find All References across the open file
• Hover with symbol/type information
• Rename Symbol (F2) with prepareRename support
• Scope-aware Completion — suggests symbols actually in scope at the cursor (locals, parameters, class members), not a flat keyword dump
• Diagnostics (textDocument/publishDiagnostics) with full-span ranges and DHR-Exxx error codes
• If Java or DhrLang.jar can't be found, the extension falls back to the older static keyword-completion/hover and shell-out diagnostics so it still degrades gracefully instead of crashing on activation (governed by dhrlang.enableAutoCompletion / dhrlang.enableErrorSquiggles, which now only apply to that fallback path).

🧩 Snippets

• Snippets for: main entry, class, method, if / if-else, while, for, foreach, arrays, printLine, try/catch skeleton

🚀 Run & Compile

• Ctrl+F5 Run current DhrLang file
• Ctrl+Shift+B Compile / diagnostics
• Status bar indicator (auto jar detection state)
• Error squiggles (when enabled) sourced from compiler output

⚙️ Configuration (Settings)

🛠 Installation

From Marketplace (Coming Soon)

Once published to the VS Code Marketplace:

1. Open VS Code
2. Extensions (Ctrl+Shift+X)
3. Search: DhrLang Support (publisher: dhruv-15-03)
4. Install

Manual (VSIX) - Recommended

1. Download dhrlang-vscode-1.1.8.vsix from the GitHub Releases page.
2. Open VS Code.
3. Press Ctrl+Shift+P (Command Palette).
4. Type "Install from VSIX" and select Extensions: Install from VSIX....
5. Select the downloaded .vsix file.

🚧 Packaging / Updating the VSIX

The repository currently contains an older dhrlang-vscode-3.0.0.vsix. Rebuild to match new version:

1. In vscode-extension/ run (PowerShell):
   • Install dependencies: npm ci
   • (If not installed) npm install -g @vscode/vsce
2. Compile: npm run compile
3. Package: vsce package (produces dhrlang-vscode-1.1.4.vsix)
4. (Optional) Publish: vsce publish patch (requires a Personal Access Token and verified publisher)

🚀 Quick Start

Create Main.dhr:

class Main {
  static kaam main() {
    printLine("Hello, DhrLang!");
  }
}

Press Ctrl+F5 to run (jar must be resolvable or dhrlang.jarPath set).

🔑 Core Tokens (Current)

Language feature status is tracked in the main docs (README/SPEC).

📦 Snippet Prefix Samples

🧪 Troubleshooting

📚 Links

• Core README – language overview
• Tutorials – stepwise examples
• Examples – curated sample programs
• Issues / Discussions – feedback & support

🤝 Contributing

See the project CONTRIBUTING guidelines. PRs to improve grammar, diagnostics, or snippets are welcome.

📄 License

MIT License – see repository root LICENSE.

Happy hacking with DhrLang!