Futhark language support for Highlightjs

This repo contains the grammar for the Futhark language. The repo comes with a tiny grammar that shows some basic grammar that you can tweak for your purposes.

⚠️ To ensure that the package can be integrated on the Exercism website, don't change the packages' versions:

"highlight.js": "^11.10.0"

Install

• NPM: npm install @exercism/highlightjs-futhark
• Yarn: yarn add @exercism/highlightjs-futhark
• Bun: bun add @exercism/highlightjs-futhark

Prerequisites

• Bun

Resources

• CodeMirror
• Lezer
  • Writing a Grammar
  • Examples
  • Existing grammar files

Structure

The repo's source files are defined in TypeScript.

The repo is structured as follows:

.
├── src
│   ├── index.ts (the main plugin)
│   ├── syntax.grammar (the Lezer grammar)
│   └── syntax.grammar.d.ts (the grammar typings)
├── test
│   ├── cases (test cases)
│   │   └ *.txt (test case)
│   └── grammar.test.ts (test file)
├── index.html (dev server file)
├── rollup.config.js (bundling config)
├── tsconfig.json (typescript confif)
└── vite.config.js (vite dev server config)

Setup

Run bun install to install all dependencies.

Developing

To help with development, run bun run dev. This will start a Vite dev server (usually at http://localhost:5173/) that renders the index.html file. The #editor element gets populated with some sample source code of your choosing and then it will get transformed by the grammar defined in src/syntax.grammar. Any changes to the grammar will auto-refresh the dev server's rendered contents.

Testing

The test/cases directory contains the tests files. Run bun test to run these tests.

Note: test (case) files should be relatively small and focus on a single aspect of a grammar.

Publishing

Run bun publish to publish the plugin to NPM.