haskell-tools.nvim

<!-- markdownlint-disable -->
<br />
<div align="center">
  <a href="https://github.com/mrcjkb/haskell-tools.nvim">
    <img src="./nvim-haskell.svg" alt="haskell-tools.nvim">
  </a>
  <p align="center">
    <br />
    <a href="./doc/haskell-tools.txt"><strong>Explore the docs »</strong></a>
    <br />
    <br />
    <a href="https://github.com/mrcjkb/haskell-tools.nvim/issues/new?assignees=&labels=bug&projects=&template=bug_report.yml">Report Bug</a>
    ·
    <a href="https://github.com/mrcjkb/haskell-tools.nvim/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.yml">Request Feature</a>
    ·
    <a href="https://github.com/mrcjkb/haskell-tools.nvim/discussions/new?category=q-a">Ask Question</a>
  </p>
  <p>
    <strong>
      Supercharge your Haskell experience in <a href="https://neovim.io/">Neovim</a>!
    </strong>
  </p>
  <p>🦥</p>

[![Neovim][neovim-shield]][neovim-url]
[![Lua][lua-shield]][lua-url]
[![Haskell][haskell-shield]][haskell-url]
[![Nix][nix-shield]][nix-url]

[![GPL2 License][license-shield]][license-url]
[![Issues][issues-shield]][issues-url]
[![Build Status][ci-shield]][ci-url]
[![LuaRocks][luarocks-shield]][luarocks-url]
</div>
<!-- markdownlint-restore -->

> [!NOTE]
>
> - Just works. [No need to call `setup`!](https://mrcjkb.dev/posts/2023-08-22-setup.html)
> - No dependency on `lspconfig`.
> - Lazy initialization by design.

## :link: Quick Links

- [:pencil: Prerequisites](#pencil-prerequisites)
- [:inbox_tray: Installation](#inbox_tray-installation)
- [:zap: Quick Setup](#zap-quick-setup)
- [:star2: Features](#star2-features)
- [:gear: Advanced configuration](#gear-advanced-configuration)
  - [Available functions and commands](#available-functions-and-commands)
  - [Telescope extension](#telescope-extension)
- [:stethoscope: Troubleshooting](#stethoscope-troubleshooting)
- [:link: Recommendations](#link-recommendations)
- [:green_heart: Contributing](./CONTRIBUTING.md)

## :grey_question: Do I need haskell-tools.nvim

If you are starting out with Haskell, [`nvim-lspconfig.hls`](https://github.com/neovim/nvim-lspconfig)
is probably enough for you.
It provides the lowest common denominator of LSP support.
This plugin is for those who would like [additional features](#star2-features)
that are specific to Haskell tooling.

## :pencil: Prerequisites

### Required

- `neovim >= 0.12`

> [!NOTE]
>
> For versions that are compatible with older Neovim versions,
> see previous major version bumps in [the changelog](./CHANGELOG.md).

### Optional

- [`haskell-language-server`](https://haskell-language-server.readthedocs.io/en/latest/installation.html)
  (recommended).
- [`telescope.nvim`](https://github.com/nvim-telescope/telescope.nvim).
- A local [`hoogle`](https://github.com/ndmitchell/hoogle/blob/master/docs/Install.md)
  installation (recommended for better hoogle search performance).
- [`fast-tags`](https://github.com/elaforge/fast-tags)
  (for automatic tag generation as a fallback for
  [`vim.lsp.