Compile TSQX geometry files to high-quality PDF diagrams via Asymptote, with live preview, syntax highlighting, and auto-compile — all inside VS Code.
Features
Live Preview — Click the preview icon in the editor title bar to compile and view the PDF side-by-side.
Auto-Compile on Save — Enabled by default. Every time you save a .tsqx file, the PDF is recompiled and refreshed automatically.
Syntax Highlighting — Full TextMate grammar for .tsqx files: comments, point definitions, draw commands, built-in functions, Asymptote color names, and operators.
TXT File Support — Right-click any .txt file and choose Set Current File as TSQX to get full TSQX support.
Inline Diagnostics — Compilation errors and warnings appear directly in the editor's Problems panel.
Status Bar — Shows compilation status and auto-compile toggle (click to switch on/off).
Configurable Paths — Point the extension at custom tsqx and asy executables if they aren't on $PATH.
Quick Start
Open a .tsqx file
Click the preview icon (⧉) in the editor toolbar
The compiled PDF opens in a side panel — edit, save, and it refreshes automatically
Requirements
Tool
Install
tsqx
pip install tsqx or pip install -e . from this repo
{
"tsqx.autoCompileOnSave": true, // auto-compile on save (default: true)
"tsqx.compilationTimeout": 30, // max seconds per compilation
"tsqx.tsqxPath": "tsqx", // path to tsqx executable
"tsqx.asyPath": "asy", // path to Asymptote executable
"tsqx.extraTsqxArgs": "-p" // extra CLI args (e.g. "-p" for preamble, "-s 200" for size)
}
The PDF is opened (or refreshed) in VS Code's built-in viewer
Activity Bar
The extension adds a TSQX panel to the Activity Bar (left sidebar) with quick-access buttons:
Compile Current File — run the tsqx → asy → pdf pipeline
Preview PDF — open the PDF in a side panel
Toggle Auto-Compile — switch auto-compile on save on/off
Set File as TSQX — mark a .txt file for TSQX support
Development
git clone https://github.com/yzdame/tsqx-compiler.git
cd tsqx-compiler
npm install
npm run compile # build once
npm run watch # rebuild on change
# Press F5 in VS Code to launch the Extension Development Host
