Visualfiles S&F

Visualfiles S&F adds language support for Visualfiles (.vf) and Visualfiles Business Language (.vbl) script files in VS Code and Cursor.

It is designed to make Visualfiles scripts easier to read and edit with syntax highlighting, formatting, IntelliSense, and hover help for common scripting constructs.

Features

Syntax Highlighting

The extension provides Visualfiles-aware highlighting for:

• commands such as [&Assign ...], [&If ...], and [&Call ...]
• operators such as &And, &Or, and &IsOneOf
• common functions used in expressions
• strings, field codes, and inline comments
• trailing comment text after command blocks

IntelliSense and Hover Help

While editing a .vf or .vbl file, the extension offers:

• completion suggestions for common Visualfiles commands
• operator suggestions inside command expressions
• function suggestions in expression contexts
• hover documentation with syntax and short descriptions

This helps when writing common constructs like:

[&If LF20 &IsOneOf "A,B,C"]
   [&Message "Matched"]
[&EndIf]

Document Formatting

Use Format Document to normalize common Visualfiles layout rules:

• 3-space indentation for supported block structures
• correct indentation for &If, &Else, &EndIf
• correct indentation for &ForEach, &EndFor
• correct indentation for &Sub, &EndSub
• correct indentation for &DoWhile, &EndDoWhile
• a single space after commas outside quoted strings

The formatter preserves:

• line endings
• trailing comments
• content on non-command lines
• existing spacing around =

Optional Theme

The extension includes an optional light theme named Visualfiles Classic for a more traditional Visualfiles color style.

Quick Start

1. Install the extension.
2. Open any .vf or .vbl file.
3. Start typing inside a command block to see completions.
4. Use Format Document to tidy script indentation and comma spacing.
5. Optionally switch to the Visualfiles Classic theme.

Supported File Types

• .vf — Visualfiles
• .vbl — Visualfiles Business Language

Example

[&Sub Example]
[&If LF20 = "OPEN"]
   [&Assign LF21="Ready", LF22="Yes"] Script state update
[&Else]
   [&Message "Not open"]
[&EndIf]
[&EndSub]

Known Limitations

• IntelliSense currently covers a curated set of common commands, operators, and functions rather than the full Visualfiles language surface.
• The extension does not currently provide diagnostics or validation.
• Formatting is intentionally conservative and does not aggressively rewrite every style choice.

Requirements

No external dependencies or configuration are required after installation.

Extension Settings

This extension does not currently add custom settings.

Release Notes

0.1.4

• added support for .vbl (Visualfiles Business Language) with the same syntax highlighting, formatting, and IntelliSense as .vf

0.1.3

• added Visualfiles syntax highlighting for .vf files
• added formatter support for common block structures and comma spacing
• added IntelliSense and hover help for common commands, operators, and functions
• included the optional Visualfiles Classic theme