FlipJump for VS Code

Syntax highlighting for the FlipJump assembly language — the one-instruction esoteric language. Opens .fj files with the exact token colours used by the FlipJump IDE and the docs site.

What it highlights

• def / ns / rep keywords, and the macro / namespace names they introduce
• Macro calls at the start of a line (e.g. stl.output "Hi")
• Directives: pad, reserve, segment, wflip
• Types dbit / dw / w, labels (loop:), and constants (X = ...)
• // comments, "…" / '…' strings, and 0x / 0b / decimal numbers
• Operators and punctuation

The grammar is a TextMate port of the FlipJump IDE's Monaco tokenizer, kept in lock-step with the docs site's Pygments lexer by an automated parity test, so code looks identical across the IDE, the docs, and your editor.

Go to definition

Ctrl+click (Cmd+click on macOS), F12, or Go to Definition on a macro name jumps to where it's declared. Clicking xor in hex.xor a b c finds the matching def xor across every .fj file in your workspace — one match jumps straight there, several open a peek list. The clicked segment is used on its own, so the hex. namespace prefix is ignored (a macro is declared def xor inside ns hex).

Colours

The extension ships the exact fj-dark colours and applies them only to FlipJump tokens (every scope ends in .flipjump), so your own editor theme is left untouched for every other language. No theme switch required.

Prefer to tune them yourself? Add an editor.tokenColorCustomizations block to your settings.json with textMateRules targeting the *.flipjump scopes.

Install

From the VS Code Marketplace:

• In the editor: search for FlipJump in the Extensions view, click Install.

• Command line:

  code --install-extension flipjump.flipjump
  

Source & issues

Developed in the docs repo: https://github.com/tomhea/flipjump-docs under editors/vscode. The shared grammar lives at editors/grammars/flipjump.tmLanguage.json.

License

BSD 2-Clause — see LICENSE.