Deno Tools

Use Deno tools, such as formatter and linter, without the baggage of Deno LSP.

Deno Tools is a lightweight VS Code extension that provides Deno's powerful formatting and linting capabilities without requiring the full Deno Language Server Protocol (LSP). Perfect for projects that want to leverage Deno's excellent tooling while maintaining flexibility in their development setup.

✨ Features

⚙️ Deno Configuration

This extension respects deno.json or deno.jsonc configuration files; automatically finds them in your project hierarchy and falls back to the user's home directory.

🎨 Code Formatting

• Built-in Integration: Format documents using VS Code's standard formatting functionalities (Format Document, Format Selection, Format on Save, etc.).
• Multi-Language Support: Supports TypeScript, JavaScript, JSX, TSX, JSON, JSONC, Markdown, HTML, CSS, SCSS, Sass, Less, Vue, Svelte, Astro, YAML, and SQL.
• Integrity: Respects include and exclude settings in deno.json, but with user-friendly warnings when trying to format excluded files.

🔍 Linting

• Real-time Diagnostics: Live linting with detailed diagnostics and helpful hints.
• Auto-fixes: Quick fix actions for various rules.
• Integrity: Respects include and exclude settings in deno.json.

🛠 Commands

• Fix Current File: Apply all available auto-fixes to the current file (Deno Tools: Fix Current File).

🎆 Screenshots

Integrated Code Formatter

Real-time Linting Diagnostics

Quick Fix Actions

🚀 Quick Start

1. Install Deno: Make sure Deno is installed on your system.
2. Install Extension: Install "Deno Tools" from the VS Code marketplace.
3. Create Deno Config: Add a deno.json or deno.jsonc file to your project root (the extension auto-enables when these files are found).
4. Start Coding: The extension automatically activates for supported file types in Deno projects.

Basic Usage

// Open any TypeScript/JavaScript file
// Use Shift+Alt+F (Windows/Linux) or Shift+Option+F (macOS) to format
// Linting diagnostics appear automatically as you type

// Create a deno.json file for custom configuration:
{
  "fmt": {
    "lineWidth": 100,
    "indentWidth": 4,
    "singleQuote": false,
    "semiColons": false,
    "proseWrap": "preserve"
  },
  "lint": {
    "rules": {
      "tags": ["recommended"]
    }
  }
}

⚙️ Configuration

This extension provides several configuration options accessible via VS Code settings:

🎯 Supported Languages

📋 Commands

Access these commands via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

📝 Usage Tips

Formatting

• Use standard VS Code formatting shortcuts: Shift+Alt+F (Windows/Linux) or Shift+Option+F (macOS).
• Right-click and select "Format Document" or "Format Selection".
• Enable "Format on Save" in VS Code settings for automatic formatting.
• Use deno-tools.formatter.warnOnExclude setting to control whether exclusion warnings should be displayed.

Linting

• Diagnostics appear automatically as you type (with configurable debouncing).
• Hover over underlined issues to see detailed information and quick fixes.
• Use "Fix Current File" to apply all available auto-fixes at once.
• Linting respects your deno.json configuration for included/excluded files and rules.
• Disable noUnusedLocals and noUnusedParameters compiler options in tsconfig.json in favor of the no-unused-vars linting rule.

Performance

• Adjust deno-tools.linter.debounceMs if linting feels too intrusive while typing.
• Disable deno-tools.linter.lintOnChange to only lint on save and manual triggers.
• The extension is lightweight and doesn't include the full Deno LSP overhead.

🔧 Requirements

• Deno: Must be installed and available in your system PATH.
• VS Code: Version 1.97.0 or higher.
• Operating System: Windows, macOS, or Linux.

🆚 Comparison with Deno LSP

Choose Deno Tools when:

• You want lightweight Deno tooling without LSP overhead.
• You're using other TypeScript language servers, like the builtin one.
• You only need formatting and linting capabilities.
• You want simple, zero-configuration setup.

Choose Deno LSP when:

• You're building a pure Deno project.
• You need advanced Deno-specific features like import maps and Deno APIs.

🤝 Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

📄 License

This extension is licensed under the MIT License.

Enjoy coding with Deno Tools! 🦕