The repository contains multiple projects that use web technologies to visualize KLighD generated diagrams.

This repository contains a monorepo for different KLighD related, web-based packages. The packages are seperated in two types:

• Packages that produce usable applications are placed in the applications folder.
• Packages that serve as library code are placed in the packages folder.

Moreover, the default branches of both repositories should be compatible but might experience regression.

Development of this project requires Node.js v16.x and yarn v1.x.

Developing the klighd-vscode extension requires an extension that has a dependency on klighd-vscode and provides a language client with KLighD synthesis capabilities. A good candidate for development is the kieler.keith-vscode (under development) extension.

Furthermore, development of the klighd-cli requires a language server with KLighD synthesis capabilities. The server can either be started separately, using a socket for communication, or placed as a jar named language-server.jar in the applications/klighd-cli folder.

Developing a language server that uses KLighD to fulfill all requirements to be usable with these applications is no easy task. Until the distribution of KLighD and documentation about building your own language server is improved, feel free to seek advice from a member of the KIELER working group.

An example for a simple language server with KLighD synthesis support can be found here. Configuration for the build process using Maven Tycho can be found here. The VS Code extension for this language server can be found here.

All scripts that are available at the monorepo root. Run a script with yarn <script>. More specific scripts may be provided by each package.

1. Fulfill the requirements above.
2. Run yarn in the monorepo root to install all dependencies (if not already done).
3. (only on the first build:) Run yarn build to first do a sequential build to link the internal dependencies.
4. Run yarn watch in the monorepo root to watch all packages for changes.
5. Run yarn start or yarn socket in the applications/klighd-cli folder to start a web-server, serving the standalone view.
   • yarn start uses a language-server.jar file placed in the klighd-cli folder.
   • yarn socket uses a socket connection (default port 5007) to connect to the LS.
6. Navigate to http://localhost:8000?source=file:///<path-to-diagram-file> in your browser to inspect the standalone view.

1. Fulfill the requirements above.
2. Run yarn in the monorepo root to install all dependencies (if not already done).
3. Run yarn package
4. The packaged CLI can be found in applications/klighd-cli/bin with a version for each platform.

The self-contained CLI does not contain a language server to make it more flexible for different language servers. Run klighd-{os} -h for information on how to provide a language server for the CLI.

We recommend VS Code to develop the VS Code extension to make use of the provided launch tasks. The following steps have are required to start developing.

1. Fulfill the requirements above.
2. Install all workspace recommended extensions.
3. Run yarn in the monorepo root to install all dependencies (if not already done).
4. Run the "Launch VS Code Extension" launch configuration. This also runs a task to watch all packages.
5. A VS Code instance with the klighd-vscode extension should be started.
6. After changes to your files, run the "Reload Window" command in your dev VS Code instance.

1. Fulfill the requirements above.
2. Run yarn in the monorepo root to install all dependencies (if not already done).
3. Run yarn package
4. Run code --install-extension applications/klighd-vscode/klighd-vscode.vsix