WLPFO Items Highlighter

Syntax highlighting, smart hovers, Go to Definition, and transaction tools for WLPFO in VS Code.

Overview

A VS Code extension purpose-built for the WLPFO. You can turn messages, commands, and transaction listings into richly highlighted, navigable, and interactive documents, regardless of the underlying protocol..

Screenshots

Internal Tool

Go to Definition Ctrl+Click any field key to jump to its definition in the WLPFO source tree	Field Key Hover Hover over a msg key to see more details. Simplifying txn orchestrations
Field Key Hover Same stuff as pic 2 but Again... because its cool	Easy previews Get most detailed preview & easy run shortcuts for txn_doer, compose_msg, decompose_msg & item format. Without ever having to touch your terminal
Message Hover | CodeLens Buttons Hover over hex payloads to see the decomposed message with action buttons. ▶ Run and 🖨 Print buttons on decomposed files and txn_doer lines

Features

Syntax Highlighting

• Full Featured syntax highlighting for messages.

Hex Hover

• Hover over any x<hex> value in a .items file to see:
  • ASCII representation (printable chars, dots for non-printable)
  • Hex dump (classic 16-byte rows with offset + hex + ASCII columns)
  • Byte count

Go to Definition (Ctrl + Click)

• Ctrl+click any field key (e.g. P002, H_420, Q69.00, Ter.123) to jump to its C++ definition in the WLPFO source tree
• Multi-protocol aware — searches the protocol-specific module first, then falls back to core

Field Key Hover

• Hover over a field key to see:
  • The C++ variable declaration from the idx source
  • The file path and line number
  • Multiple definitions shown when a key is defined in several modules

Message Hover (All File Types)

Works in any file — logs, untitled buffers, terminals, etc.:

• txn_doer <origin> <proto> <flags> <role> <hex> — hover over the hex to see the decomposed message with:
  • Protocol name and message type in the header
  • Pretty-printed table with aligned columns
  • ⎘ Copy — copy decomposed text to clipboard
  • ⧉ Copy Itemized — copy as item["KEY"]="VALUE"; format
  • ⭳ Save to File — save as a .items file to /winshare/txn_menu/saved/
  • ▶ Fire Txn — execute the full txn_doer command in terminal
• decompose_msg <hex> -proto <id> — same decompose hover
• compose_msg <proto> '<items>' — hover to see the composed hex output
• Standalone long hex (≥40 chars) — auto-detects protocol from filename and decomposes

Context Menu Commands

• WLPFO: Compose Print — right-click a .items file (editor or explorer) to compose and print the txn_doer command via fire_file -p

CodeLens Buttons (Decomposed Files)

For files matching the pattern *#<origin>_<proto>_<flags>_<role>_decomposed.items:

• ▶ Run — compose and fire the transaction via fire_file
• 🖨 Print — compose and print the txn_doer command (no fire)

Buttons appear at the bottom of the file, similar to git merge/conflict resolution buttons.

File Associations

Commands

• WLPFO: Compose Print — Right-click context menu
• WLPFO: Run — CodeLens / command palette

Requirements

• WLPFO Docker environment : decompose_msg, compose_msg, txn_doer must be available in PATH
• WLPFO Toolkit : fire_file and item functions and other txn orchestration tools
• WLPFO source tree : for Go to Definition

To source the toolkit manually (or in environments without the local file):

<You will have to source WLPFO-Toolkit>

Installation

From VSIX

code --install-extension wlpfo-items-highlighter-<version>.vsix

Building from Source

npm install -g @vscode/vsce
cd wlpfo-items-highlighter
vsce package --no-dependencies

Repository

gitlab.kazan.myworldline.com/W136629/wlpfo-items-highlighter

Author

Jesvi Jonathan

License

MIT