HFSM Language

Language for modeling hierarchical finite state machines, implemented using Langium and utilizing the Language Server Protocol.

Features

• Web-based editor with syntax highlighting and LSP integration
• Extension for Visual Studio Code with syntax highlighting and LSP integration
• Command line tooling for simulation and code generation

Instructions

Make sure to have Node.js installed. Download or clone the repository and use the following commands in the project directory to set everything up:

# Install dependencies.
npm install

# Generate the AST.
npm run langium:generate

# Build the project.
npm run build

Web Editor

Locally serve a web editor by running the following command:

npm run serve

Visual Studio Code Extension

To try the Visual Studio Code extension, open the project directory, navigate to "Run and Debug" in the side bar and run the "Run Extension" launch configuration (or use the default key binding by pressing F5).

This will open an Extension Development Host for Visual studio code in the examples directory. Use the command line tooling by running the following command in the integrated terminal:

node ../bin/cli.js

Command Line Tooling

Use the command line tooling by running the following command:

node bin/cli.js

Generate

Use the command line tooling to generate extendable Java code of the state machine:

node bin/cli.js generate <file>

If you don't specify a directory, the code will output to the same directory as the state machine file.

Interact

Use the command line tooling to interactively test the state machine:

node bin/cli.js interact <file>