JUSU++ VS Code Extension - Complete IDE

A complete professional IDE for the JUSU++ programming language with full language intelligence and debugging support.

🎯 Complete IDE Features

✨ Advanced Syntax Highlighting

Full syntax highlighting for .jusu files
Color-coded keywords, types, strings, numbers, and operators
Comment highlighting (line and block)
Smart bracket matching and auto-closing

🧠 IntelliSense & Code Completion

Smart Autocomplete - Context-aware suggestions for keywords, functions, types, and built-in functions
IntelliSense - Real-time code suggestions as you type
Parameter Hints - Function signature information
60+ Built-in Completions - Keywords, types, standard library functions

Go to Definition (F12 / Cmd+Click) - Jump to symbol definition
Find References (Shift+F12) - Find all uses of a symbol
Document Symbols (Ctrl+O) - Navigate symbols in current file
Workspace Symbols (Ctrl+T) - Search symbols across all files

ℹ️ Hover Information

Type Information - Hover to see variable types
Function Signatures - View function parameters and return types
Documentation - See docstring comments on hover
Smart Tooltips - Context-sensitive help

🛠️ Refactoring Tools

Symbol Renaming (F2) - Rename symbols across entire project
Find & Replace - Smart find and replace with scope options
Code Actions - Quick fixes for common issues

📝 Code Formatting

Auto-Format (Shift+Alt+F) - Format entire document
On-Save Formatting - Auto-format when saving
Indentation Normalization - Consistent code style
Whitespace Cleanup - Remove trailing spaces

🐛 Diagnostics & Error Checking

Real-time Diagnostics - Errors displayed inline
Error Squiggles - Visual error indication
Problems Panel - Centralized error list
On-Save Validation - Check syntax when saving
Auto-Validation - Live error detection

🔧 Workspace Analysis

Project Statistics - Count functions, structs, lines of code
Symbol Index - Index all symbols in workspace
File Analysis - Analyze structure of each file
Report Generation - Detailed workspace analysis reports

📝 Code Snippets

Quick snippets for common JUSU++ patterns:

main - Main function template
fn - Function definition
if - If statement
ifelse - If-else statement
for - For loop
while - While loop
match - Match expression
struct - Struct definition
print - Print statement
let - Variable declaration

🎮 Debugging Support (Framework Ready)

Breakpoint management framework
Stack frame inspection framework
Watch expression evaluation
Debug adapter integration ready

🚀 Code Execution

Check File (Ctrl+Shift+C / Cmd+Shift+C): Validate syntax
Run File (Ctrl+Shift+R / Cmd+Shift+R): Execute JUSU++ programs
Show Version: Display compiler information
Analyze Workspace (Ctrl+Shift+A): Comprehensive project analysis

🔧 Language Support

Bracket matching and auto-closing pairs
Code folding regions
Block comment support
Proper indentation and formatting

Installation

From VS Code Marketplace (When Published)

Open VS Code
Go to Extensions (Ctrl+Shift+X)
Search for "JUSU++ Complete IDE"
Click Install

Development Installation

Clone the repository
Navigate to VSCODE/jusu-vscode-extension
Run: npm install
Run: npm run compile
Press F5 to launch extension in debug mode

Keyboard Shortcuts

Action	Windows/Linux	macOS
Check Syntax	Ctrl+Shift+C	Cmd+Shift+C
Run Program	Ctrl+Shift+R	Cmd+Shift+R
Go to Definition	F12	Cmd+Click
Find References	Shift+F12	Shift+Cmd+F12
Document Symbols	Ctrl+O	Cmd+O
Workspace Symbols	Ctrl+T	Cmd+T
Format Document	Shift+Alt+F	Shift+Option+F
Rename Symbol	F2	F2
Analyze Workspace	Ctrl+Shift+A	Cmd+Shift+A

Configuration

Open VS Code Settings and configure:

{
  "jusu.compilerPath": "jusu",
  "jusu.enableSyntaxHighlighting": true,
  "jusu.enableCodeCompletion": true,
  "jusu.showCompilationErrors": true
}

Options

compilerPath: Path to JUSU++ compiler (default: jusu)
- If JUSU++ is not in PATH, provide full path: C:\\Program Files\\JUSU\\jusu.exe
- Or: /usr/local/bin/jusu
enableSyntaxHighlighting: Toggle syntax highlighting (default: true)
enableCodeCompletion: Enable IntelliSense suggestions (default: true)
showCompilationErrors: Show errors in problems panel (default: true)

Usage

Check Syntax

Open a .jusu file
Press Ctrl+Shift+C (Windows/Linux) or Cmd+Shift+C (macOS)
Results appear in the Output panel

Run Program

Open a .jusu file
Press Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (macOS)
Program output appears in the Output panel

View Compiler Info

Press Ctrl+Shift+P to open Command Palette
Type "JUSU++: Show Compiler Version"
View version information

Example Program

Create a file hello.jusu:

fn main() {
    print("Hello from JUSU++!")
}

Press Ctrl+Shift+R to run it.

Development

Project Structure

jusu-vscode-extension/
├── src/
│   └── extension.ts          # Main extension code
├── syntaxes/
│   └── jusu.tmLanguage.json  # Syntax highlighting grammar
├── snippets/
│   └── jusu.json             # Code snippets
├── language-configuration.json # Language config
├── package.json              # Extension manifest
├── tsconfig.json             # TypeScript config
└── README.md                 # This file

Building

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch mode (auto-compile on changes)
npm run watch

Testing

# Run tests
npm test

Debugging

Open project in VS Code
Press F5 to launch Extension Development Host
Extension loads in a new VS Code window
Use console.log() for debugging
Output appears in Debug Console (Ctrl+`)

Publishing to VS Code Marketplace

Prerequisites

Create publisher account: https://aka.ms/vscode-create-publisher
Install VSCE tool: npm install -g vsce
Login: vsce login <publisher-name>

Steps

# Package the extension
vsce package

# Creates: jusu-1.0.0.vsix

# Publish to marketplace
vsce publish

# Or publish pre-built package
vsce publish --packagePath jusu-1.0.0.vsix

Requirements

VS Code 1.60.0 or later
JUSU++ compiler installed and in PATH
- Download: https://github.com/jusufrancis/jusu-plus-plus/releases
- Or install via:
  - Windows: choco install jusu
  - macOS/Linux: brew install jusu

Troubleshooting

"jusu: command not found"

The JUSU++ compiler is not installed or not in PATH.

Solution:

Install JUSU++ compiler
Add to PATH, or

Configure jusu.compilerPath in settings:

"jusu.compilerPath": "C:\\Program Files\\JUSU\\jusu.exe"

Commands don't work

Make sure you're editing a .jusu file. Commands are only available for JUSU++ files.

Output panel doesn't show

Open the Output panel:

View → Output, or
Ctrl+` then click "Output" tab

Syntax highlighting not working

Verify file extension is .jusu
Reload VS Code: Ctrl+Shift+P → "Reload Window"
Check if syntax highlighting is enabled in settings

Support

Issues: https://github.com/jusufrancis/jusu-plus-plus/issues
Discussions: https://github.com/jusufrancis/jusu-plus-plus/discussions
Documentation: https://github.com/jusufrancis/jusu-plus-plus/blob/main/QUICK_REFERENCE.md

Roadmap

Planned features for future versions:

[ ] IntelliSense / Code completion
[ ] Debugging support (breakpoints, step through)
[ ] Code formatting (auto-format on save)
[ ] Hover information for types and functions
[ ] REPL integration for interactive coding
[ ] Testing framework integration
[ ] Project templates

Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Make your changes
Submit a pull request

See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE file

Credits

Developer: Francis Jusu
Repository: https://github.com/jusufrancis/jusu-plus-plus
Email: jusufrancis08@gmail.com

Version: 1.0.0
Last Updated: January 25, 2026
VS Code API Version: 1.60.0+

JUSU++

Francis Jusu