Flow-Wing

Flow-Wing language support for Visual Studio Code, Cursor, and other editors that use the Open VSX Registry (e.g. VSCodium): syntax highlighting, a bundled dark theme, diagnostics, IntelliSense, and format-on-save, powered by the Flow-Wing compiler you configure locally (FlowWing.compilerPath).

Syntax highlighting and IntelliSense

Highlighting covers every keyword the compiler knows, including spawn, fill, inout, extends, and the module and class namespaces. Completions are context-aware and come from the compiler itself, not from a word list.

Error reporting as you type

Red squiggles appear on the line that is wrong, with the compiler's own message on hover. This is the part the web playground cannot give you: there, errors only surface after you press Run.

Code browsing

Go to definition, references, and symbol navigation across a multi-file project.

Features

Syntax highlighting with a bundled dark theme tuned for Flow-Wing.
IntelliSense: context-aware completions as you type.
Error reporting (diagnostics): compiler errors inline, while you edit.
Code browsing: jump to definitions and references across files.
Format on save, using the compiler's own formatter.

Source repository: github.com/kushagra1212/Flow-Wing (extension lives under src/lsp/). Publisher ID on marketplaces must match publisher in package.json (e.g. Kushagra on the Visual Studio Marketplace).

REPL

The compiler also ships an interactive REPL, which is separate from this extension.

Installation

Open Visual Studio Code.
Go to the Extensions view by clicking on the Extensions icon in the Activity Bar on the side or by pressing Ctrl+Shift+X.
Search for Flow-Wing (or Flow-Wing IntelliSense).
Click on the install button.

Usage

Once installed, the Flow-Wing IntelliSense extension will automatically activate when you open a Flow-Wing file. Begin typing in your Flow-Wing code, and enjoy real-time suggestions and diagnostics.

Configuration

Settings are under the FlowWing section (User or Workspace settings.json):

Setting	Default	Purpose
`FlowWing.enable`	`true`	When `false`, the extension does not start the language server.
`FlowWing.compilerPath`	`FlowWing`	Executable name on `PATH`, or absolute path to the Flow-Wing compiler. In an open workspace, the extension may fall back to `build/sdk/bin/FlowWing` under the workspace root.
`FlowWing.modulePath`	(empty)	Directory for standard modules (e.g. `build/sdk/lib/modules`). Empty uses the workspace `build/sdk/lib/modules` when possible.
`FlowWing.maxNumberOfProblems`	`100`	Reserved cap for diagnostics (the compiler currently surfaces one primary error per validation).
`FlowWing.trace.server`	`off`	LSP message tracing: `off`, `messages`, or `verbose`.

Contributing

If you would like to contribute to Flow-Wing IntelliSense, feel free to fork the repository and submit a pull request. Your contributions and feedback are welcome!

Privacy and data

This extension does not ship analytics, advertising, or third-party telemetry. It starts a local Language Server Protocol (LSP) process and, for analysis and formatting, invokes the Flow-Wing compiler binary you configure (default: FlowWing on your PATH). Your source files and workspace paths remain on your machine.

Optional editor settings can increase logging (for example FlowWing.trace.server), which may print LSP traffic to your editor’s output panel. That is still local, not sent to Flow-Wing or Eclipse servers.

Trademarks

Flow-Wing naming and project icons in this repo refer to the Flow-Wing open-source project. Visual Studio Code, VS Code, and related marks are trademarks of Microsoft Corporation. Cursor is a trademark of its owner. Open VSX and related Eclipse marks are trademarks of their respective owners. This extension is not endorsed by those organizations unless they say so explicitly.

Changelog

[1.0.0] - 2024-10-16

Initial release of Flow-Wing IntelliSense.
Added IntelliSense, code completion, and error reporting features.

License

This extension uses the same license as the Flow-Wing compiler and the rest of this repository: GNU General Public License v2.0 only (GPL-2.0). See LICENSE.txt in the repository root. SPDX: GPL-2.0-only.

Support

If you encounter any issues or have questions about using the Flow-Wing IntelliSense extension, please open an issue on the GitHub repository.

Thank you for using Flow-Wing IntelliSense! Happy coding!