PP Explorer - HXPS ESPRIT Post Processor

This extension is specifically designed for developers working with .asc files for ESPRIT EDGE Post-Processors. The main goal is to streamline your workflow by providing quick access to relevant information directly within the editor, reducing the constant need to switch back and forth with the online help documentation.

Features

Syntax Highlighting

• Full syntax highlighting for ASC language
• Semantic tokens for control flow, functions, data keywords, and user variables
• Comments, macros, subroutines, and special operators

Code Navigation

• Go to Definition - Ctrl+Click on $MacroName to jump to its definition
• Breadcrumb Trail - Track your navigation history through macro definitions using the Breadcrumb panel.
• Find References - Shift+F12 to find all usages of a macro or user variable
• Document Outline - View all Define/Sub/Variables/Examples in the outline panel

IntelliSense

• Auto-completion for keywords, macros ($), variables; post commands.
• Hover Documentation - Tooltips with descriptions for:
  • Formattable Codes
  • Symbolic Codes & Switches
  • System Variables
  • CL Registers
  • Built-in Functions
  • Machine Modes

Code Lens

• Reference count displayed above Define/Sub blocks
• Quick access to find all references

Specialized Panels

Access via the ESPRIT PP Explorer icon in the Activity Bar:

• Breadcrumb Trail - Navigation history through macro jumps
• CL Register Search - Search CL registers by number or name
• Post Register Search - Search Formattable/Symbolic codes
• Post Functions - Browse and search ESPRIT functions
• Examples List - View all categorized examples available in ESPRIT EDGE
• Custom Settings - View all customs settings usage in the current post

Formattable Codes Editor

Interactive visual editor for complex formattable codes (Ctrl+Alt+F):

• Parse existing formattable code lines
• Visual form for INCH/METRIC packets
• Configure sign modes, zero handling, decimal places
• Live preview of formatted output

ESPRIT EDGE Compiler Integration

• Compile Post (Ctrl+Shift+B) - Compile the current post-processor
• Compile Post (Copy) - Compile to a new copy

Associative Custom Settings Import/Export

Preserve the custom settings associated with your post.

• Import Custom Settings – Select your MPRJ file to import all custom settings at the end of the ASC file.
• Export Custom Settings – Export the custom settings available in your ASC file into a DUMMY MPRJ file, ready to be imported into your correct MPRJ.

Snippets

Quick code templates for common structures:

• Define/EndDefine blocks
• Sub/EndSub blocks
• If/ElseIf/Else/EndIf
• While/EndWhile

Keyboard Shortcuts

Requirements

• For compilation: ESPRIT EDGE Accessories Pack with Ultra Post Compiler

Installation

From VSIX file

1. Download the .vsix file
2. In VS Code, open Command Palette (Ctrl+Shift+P)
3. Run "Extensions: Install from VSIX..."
4. Select the downloaded file

Extension Settings

This extension contributes the following commands:

• pp-explorer.compilePost - Compile ESPRIT EDGE Post
• pp-explorer.compilePostCopy - Compile ESPRIT EDGE Post (Create Copy)
• pp-explorer.openFormatableEditor - Open Formattable Codes Editor
• pp-explorer.goToDefinitionBreadcrumb - Go to Definition with breadcrumb tracking
• pp-explorer.searchCLRegister - Search CL Registers
• pp-explorer.searchPostRegister - Search Post Registers
• pp-explorer.searchPostFunctions - Search Post Functions

Release Notes

See CHANGELOG.md for detailed release notes.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This extension is an experimental project developed with a unique approach. Before installing, please keep the following in mind:

• AI-Generated: This extension was built entirely using Claude AI and Gemini. The code was assembled and tested through iterative prompts and AI assistance.
• Stability & Optimization: Because of this development process, the extension may contain bugs, might not be fully optimized, or may not strictly follow all VS Code "best practices.“
• Automated Scraping: The documentation and data used in this extension were extracted via an automated process from the software's help files (*.chm).
• Accuracy Warning: Because of this automated extraction, some data might be outdated, incomplete, or incorrectly formatted. Please cross-reference with the official ESPRIT EDGE documentation for critical tasks.

Enjoy coding your post-processors!