.github/CONTRIBUTING.md

@@ -8,42 +8,23 @@
 
 ## Welcome
 
-I'm glad you are thinking about contributing to nvf! If you're unsure about
+I'm glad you are thinking about contributing to neovim-flake! If you're unsure about anything, just ask - or submit the issue or pull request anyway. The worst that can happen is you'll be politely asked to change something. Friendly contributions are always welcome.
-anything, just ask - or submit the issue or pull request anyway. The worst that
-can happen is you'll be politely asked to change something. Friendly
-contributions are always welcome.
 
-Before you contribute, I encourage you to read this project's CONTRIBUTING
+Before you contribute, I encourage you to read this project's CONTRIBUTING policy (you are here), its [LICENSE](LICENSE.md), and its [README](README.md).
-policy (you are here) and its [LICENSE](../LICENSE) to understand how your
-contributions are licensed.
 
-If you have any questions regarding those files, feel free to open an issue or
+If you have any questions regarding those files, feel free to open an issue or [shoot me an email](mailto:me@notashelf.dev). Discussions tab is also available for more informal discussions.
-[shoot me an email](mailto:me@notashelf.dev). Discussions tab is also available
-for more informal discussions.
 
 ## Contributing
 
-The contribution process is mostly documented in the
+The contribution process is mostly documented in the [pull request template](pull_request_template.md). You will find a checklist of items to complete before submitting a pull request. Please make sure you complete it before submitting a pull request. If you are unsure about any of the items, please ask.
-[pull request template](PULL_REQUEST_TEMPLATE/pull_request_template.md). You
-will find a checklist of items to complete before submitting a pull request.
-Please make sure you complete it before submitting a pull request. If you are
-unsure about any of the items, please ask.
 
 ### Guidelines
 
-We provide instructions on a healthy contribution to neovim-flake - including
+We provide instructions on a healthy contribution to neovim-flake - including styling, commit formats, how-to guides for adding new modules and options.
-styling, commit formats, how-to guides for adding new modules and options. You
+You are very well recommended to read the contributing guideliner over at [the documentation](https://notashelf.github.io/neovim-flake#hacking)
-are very well recommended to read the contributing guidelines over at
-[the documentation](https://notashelf.github.io/nvf#hacking)
 
 ### Code of Conduct
 
-This project does not quite have a code of conduct yet. And to be perfectly
+This project does not quite have a code of conduct yet. And to be honest, I'm not sure if I want one or if it will ever have one. I'm not expecting this project to be a hotbed of activity, but I do want to make sure that everyone who does contribute feels welcome and safe. As such, I will do my best to make sure that those who distrupt the project are dealt with swiftly and appropriately.
-honest, I'm not sure if I want one or if it will ever have one. I'm not
-expecting this project to be a hotbed of activity, but I do want to make sure
-that everyone who does contribute feels welcome and safe. As such, I will do my
-best to make sure that those who distrupt the project are dealt with swiftly and
-appropriately.
 
-If you feel that you are not being treated with respect, please contact me
+If you feel that you are not being treated with respect, please contact me directly.
-directly.

.github/README.md

@@ -48,7 +48,7 @@
 [Documentation]: #documentation
 [Help]: #help
 [Contribute]: #contributing
-[FAQ]: #frequently-asked-questions
+[FAQ]: #faq
 [Credits]: #credits
 
 **[<kbd><br> Features <br></kbd>][Features]**
@@ -56,7 +56,7 @@
 **[<kbd><br> Documentation <br></kbd>][Documentation]**
 **[<kbd><br> Help <br></kbd>][Help]**
 **[<kbd><br> Contribute <br></kbd>][Contribute]**
-**[<kbd><br> FAQ <br></kbd>][FAQ]** **[<kbd><br> Credits <br></kbd>][Credits]**
+**[<kbd><br> FAQ <br></kbd>][Faq]** **[<kbd><br> Credits <br></kbd>][Credits]**
 
 </p></div>
 
@@ -64,21 +64,12 @@
 
 ## Features
 
-[standalone]: https://notashelf.github.io/nvf/index.xhtml#ch-standalone-installation
-[NixOS module]: https://notashelf.github.io/nvf/index.xhtml#ch-standalone-nixos
-[Home-Manager module]: https://notashelf.github.io/nvf/index.xhtml#ch-standalone-hm
-
-- **Simple**: One language to rule them all! Use Nix to configure everything,
-  with additional Lua Support
 - **Reproducible**: Your configuration will behave the same _anywhere_. No
   surprises, promise!
 - **Portable**: nvf depends _solely_ on your Nix store, and nothing else. No
   more global binaries! Works on all platforms, without hassle.
-  - Options to install [standalone], [NixOS module] or [Home-Manager module].
 - **Customizable**: There are _almost no defaults_ to annoy you. nvf is fully
   customizable through the Nix module system.
-- Not comfortable with a full-nix config or want to bring your Lua config? You
-  can do just that, no unnecessary restrictions.
 - **Well-documented**: Documentation is priority. You will _never_ face
   undocumented, obscure behaviour.
 - **Idiomatic**: nvf does things ✨ _the right way_ ✨ - the codebase is, and
@@ -129,9 +120,7 @@ instructions.
 
 ## Documentation
 
-### Installation
+The _recommended_ way of installing **nvf** is using either the NixOS or the
-
-The _recommended_ way of installing nvf is using either the NixOS or the
 Home-Manager module, though it is completely possible and no less supported to
 install **nvf** as a standalone package, or a flake output.
 
@@ -149,13 +138,11 @@ Please create an issue on the [issue tracker] if you find the documentation
 lacking or confusing. Any improvements to the documentation through pull
 requests are also welcome, and appreciated.
 
-## Getting Help
+## Help
 
-If you are confused, stuck or would like to ask a simple question; you may
+You can create an issue on the [issue tracker] to ask questions or report bugs.
-create an issue on the [issue tracker] to ask questions or report bugs.
+I am not yet on spaces like matrix or IRC, so please use the issue tracker for
-
+now.
-We are not not yet on spaces like matrix or IRC, so please use the issue tracker
-for now.
 
 ## Contributing
 
@@ -165,7 +152,7 @@ submitting a pull request. You can also create an issue on the [issue tracker]
 before submitting a pull request if you would like to discuss a feature or bug
 fix.
 
-## Frequently Asked Questions
+## FAQ
 
 [appropriate issue template]: https://github.com/NotAShelf/nvf/issues/new/choose
 [list of branches]: https://github.com/NotAShelf/nvf/branches
@@ -173,15 +160,13 @@ fix.
 
 **Q**: What platforms are supported?
 <br/> **A**: nvf actively supports Linux and Darwin platforms using standalone
-Nix, NixOS or Home-Manager. Please take a look at the [nvf manual] for available
+Nix, NixOS or Home-Manager. Please take a look at the
-installation instructions.
 
 **Q**: Can you add _X_?
 <br/> **A**: Maybe! It is not one of our goals to support each and every Neovim
 plugin, however, I am always open to new modules and plugin setup additions to
 **nvf**. Use the [appropriate issue template] and I will consider a module
-addition. As mentioned before, pull requests to add new features are also
+addition. As mentioned before, PRs adding new features are also welcome.
-welcome.
 
 **Q**: A plugin I need is not available in **nvf**. What to do?
 <br/> **A**: **nvf** exposes several APIs for you to be able to add your own
@@ -200,26 +185,22 @@ better prepare to breaking changes.
 
 ### Contributors
 
-[mnw]: https://github.com/gerg-l/mnw
+Special, heart-felt thanks to
 
-nvf would not be what it is today without the awesome people below. Special,
+- [@fufexan](https://github.com/fufexan) - For the transition to flake-parts
-heart-felt thanks to
+- [@FlafyDev](https://github.com/FlafyDev) - For getting the home-manager to
-
+  work
-- [@fufexan](https://github.com/fufexan) - For the transition to flake-parts and
-  invaluable Nix assistance.
-- [@FlafyDev](https://github.com/FlafyDev) - For getting home-manager module to
-  work and Nix assistance.
 - [@n3oney](https://github.com/n3oney) - For making custom keybinds finally
-  possible, and other module additions.
+  possible
 - [@horriblename](https://github.com/horriblename) - For actively implementing
-  planned features and quality of life updates.
+  planned features and quality of life updates
 - [@Yavko](https://github.com/Yavko) - For the amazing **nvf** logo
 - [@FrothyMarrow](https://github.com/FrothyMarrow) - For seeing mistakes that I
-  could not.
+  could not
-- [@Diniamo](https://github.com/Diniamo) - For actively submitting pull
+- [@Diniamo](https://github.com/Diniamo) - For actively submitting PRs, pull
-  requests, issues and assistance with maintenance of nvf.
+  requests and overall assistence
-- [@Gerg-l](https://github.com/gerg-l) - For the modern Neovim wrapper, [mnw],
+- [@Gerg-l](https://github.com/gerg-l) - For the modern Neovim wrapper, mnw and
-  and occasional code improvements.
+  occasional code improvements
 
 and everyone who has submitted issues or pull requests!
 
@@ -233,7 +214,7 @@ including:
   is originally based on.
 - [@sioodmy's](https://github.com/sioodmy)
   [dotfiles](https://github.com/sioodmy/dotfiles) that inspired the design
-  choices for UI and plugin defaults.
+  choices.
 - [@wiltaylor's](https://github.com/wiltaylor)
   [neovim-flake](https://github.com/wiltaylor/neovim-flake) for plugin and
   design ideas.
@@ -248,11 +229,10 @@ recommend checking their work out.
 ## License
 
 Following the license of the
-[original neovim-flake](https://github.com/jordanisaacs/neovim-flake), nvf has
+[original neovim-flake](https://github.com/jordanisaacs/neovim-flake), **nvf**
-been made available under the [**MIT License**](LICENSE). However, all assets
+has been made available under the [**MIT License**](LICENSE). However, all
-and documentation are published under the
+assets and documentation are published under the
-[**CC BY License**](https://github.com/NotAShelf/nvf/blob/main/.github/assets/LICENSE)
+[**CC BY License**](https://github.com/NotAShelf/nvf/blob/main/.github/assets/LICENSE).
-under explicit permission by the artist.
 
 <h6 align="center">Yes, this includes the logo work too. Stop taking artwork that is not yours!</h6>
 

.github/pull_request_template.md

@@ -6,7 +6,7 @@ or dependency in this section.
 
 If your pull request aims to fix an open issue or a please bug, please also link the relevant issue
 below this line. You may attach an issue to your pull request with `Fixes #<issue number>` outside
-this comment, and it will be closed when your pull request is merged.
+this comment.
 -->
 
 ## Sanity Checking
@@ -23,20 +23,20 @@ it above in your description.
 [editorconfig]: https://editorconfig.org
 [changelog]: https://github.com/NotAShelf/nvf/tree/main/docs/release-notes
 
-- [ ] I have updated the [changelog] as per my changes
+- [ ] I have updated the [changelog] as per my changes.
-- [ ] I have tested, and self-reviewed my code
+- [ ] I have tested, and self-reviewed my code.
 - Style and consistency
-  - [ ] I ran **Alejandra** to format my code (`nix fmt`)
+  - [ ] I ran **Alejandra** to format my code (`nix fmt`).
-  - [ ] My code conforms to the [editorconfig] configuration of the project
+  - [ ] My code conforms to the [editorconfig] configuration of the project.
-  - [ ] My changes are consistent with the rest of the codebase
+  - [ ] My changes are consistent with the rest of the codebase.
 - If new changes are particularly complex:
   - [ ] My code includes comments in particularly complex areas
-  - [ ] I have added a section in the manual
+  - [ ] I have added a section in the manual.
-  - [ ] _(For breaking changes)_ I have included a migration guide
+  - [ ] _(For breaking changes)_ I have included a migration guide.
 - Package(s) built:
   - [ ] `.#nix` (default package)
   - [ ] `.#maximal`
-  - [ ] `.#docs-html` (manual, must build)
+  - [ ] `.#docs-html`
 - Tested on platform(s)
   - [ ] `x86_64-linux`
   - [ ] `aarch64-linux`

.github/typos.toml

@@ -1,2 +0,0 @@
-
-default.extend-ignore-words-re = ["(?i)(noice)", "befores", "annote", "viw"]

.github/workflows/check-docs.yml

@@ -19,12 +19,19 @@ jobs:
           - docs-manpages
           - docs-json
     steps:
+      - uses: easimon/maximize-build-space@v10
+        with:
+          overprovision-lvm: true
+          remove-android: true
+          remove-dotnet: true
+          remove-haskell: true
+
       - name: Install Nix
         uses: DeterminateSystems/nix-installer-action@main
       - uses: DeterminateSystems/magic-nix-cache-action@main
 
-      - name: Checkout
+      - uses: actions/checkout@v4
-        uses: actions/checkout@v4
+        name: Checkout
 
       - name: Set default git branch (to reduce log spam)
         run: git config --global init.defaultBranch main
@@ -42,16 +49,3 @@ jobs:
         with:
           name: "${{ matrix.package }}"
           path: result/share/doc/nvf
-  flake-docs-linkcheck:
-    name: Validate hyperlinks in documentation sources
-    runs-on: ubuntu-latest
-    steps:
-      - name: Install Nix
-        uses: DeterminateSystems/nix-installer-action@main
-      - uses: DeterminateSystems/magic-nix-cache-action@main
-
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Build documentation packages
-        run: nix build .#docs-linkcheck -Lv

.github/workflows/editorconfig.yml

@@ -15,7 +15,7 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           gh api \
-            repos/notashelf/nvf/pulls/${{github.event.number}}/files --paginate \
+            repos/notashelf/neovim-flake/pulls/${{github.event.number}}/files --paginate \
             | jq '.[] | select(.status != "removed") | .filename' \
             > "$HOME/changed_files"
 

.github/workflows/manual.yml

@@ -47,7 +47,7 @@ jobs:
       - uses: DeterminateSystems/nix-installer-action@main
       - uses: DeterminateSystems/magic-nix-cache-action@main
       - run: |
-          nix build .#docs -Lv
+          nix build .#docs
           cp -r result/share/doc/nvf public
       - uses: peaceiris/actions-gh-pages@v4
         with:

.github/workflows/typos.yml

@@ -1,30 +0,0 @@
-name: "Check for typos in the source tree"
-
-permissions: read-all
-
-on:
-  pull_request:
-  workflow_dispatch:
-  push:
-
-jobs:
-  check-typos:
-    runs-on: ubuntu-latest
-    if: "!contains(github.event.pull_request.title, '[skip ci]')"
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Check for typos
-        uses: crate-ci/typos@master
-        with:
-          config: .github/typos.toml
-
-      - name: Fail Gracefully
-        if: ${{ failure() }}
-        shell: bash
-        run: |
-          echo "::error:: Current codebase contains typos that were caught by the CI!"
-          echo "If those typos were intentional, please add them to the ignored regexes in .github/typos.toml"
-          echo "[skip ci] label may be used if this is a one-time issue"
-          exit 1

configuration.nix

@@ -76,7 +76,6 @@ isMaximal: {
       csharp.enable = isMaximal;
       julia.enable = isMaximal;
       vala.enable = isMaximal;
-      nu.enable = false;
     };
 
     visuals = {
@@ -113,7 +112,7 @@ isMaximal: {
     snippets.luasnip.enable = true;
 
     filetree = {
-      neo-tree = {
+      nvimTree = {
         enable = true;
       };
     };

docs/manual.nix

@@ -1,112 +1,63 @@
 {
   lib,
   stdenvNoCC,
-  fetchzip,
-  runCommandLocal,
   # build inputs
   nixos-render-docs,
   documentation-highlighter,
-  dart-sass,
   path,
   # nrd configuration
   release,
   optionsJSON,
-} @ args: let
+}:
-  manual-release = args.release or "unstable";
+stdenvNoCC.mkDerivation {
-
+  name = "nvf-manual";
-  scss-reset = fetchzip {
+  src = builtins.path {
-    url = "https://github.com/Frontend-Layers/scss-reset/archive/refs/tags/1.4.2.zip";
+    path = lib.sourceFilesBySuffices ./manual [".md"];
-    hash = "sha256-cif5Sx8Ca5vxdw/mNAgpulLH15TwmzyJFNM7JURpoaE=";
+    name = "nvf-manual";
   };
 
-  compileStylesheet = runCommandLocal "compile-nvf-stylesheet" {} ''
+  nativeBuildInputs = [nixos-render-docs];
-    mkdir -p $out
 
-    tmpfile=$(mktemp -d)
+  buildPhase = ''
-    trap "rm -r $tmpfile" EXIT
+    dest="$out/share/doc/nvf"
+    mkdir -p "$(dirname "$dest")"
+    mkdir -p $dest/{highlightjs,media}
 
-    ln -s "${scss-reset}/build" "$tmpfile/scss-reset"
+    cp -vt $dest/highlightjs \
+      ${documentation-highlighter}/highlight.pack.js \
+      ${documentation-highlighter}/LICENSE \
+      ${documentation-highlighter}/mono-blue.css \
+      ${documentation-highlighter}/loader.js
 
-    ${dart-sass}/bin/sass --load-path "$tmpfile" \
+    substituteInPlace ./options.md \
-      ${./static/style.scss} "$out/style.css"
+      --subst-var-by \
+        OPTIONS_JSON \
+        ${optionsJSON}/share/doc/nixos/options.json
 
-    echo "Generated styles"
+    substituteInPlace ./manual.md \
+      --subst-var-by \
+        NVF_VERSION \
+        ${release}
+
+    # copy stylesheet
+    cp ${./static/style.css} "$dest/style.css"
+
+    # copy release notes
+    cp -vr ${./release-notes} release-notes
+
+    # generate manual from
+    nixos-render-docs manual html \
+      --manpage-urls ${path + "/doc/manpage-urls.json"} \
+      --revision ${lib.trivial.revisionWithDefault release} \
+      --stylesheet style.css \
+      --script highlightjs/highlight.pack.js \
+      --script highlightjs/loader.js \
+      --toc-depth 2 \
+      --section-toc-depth 1 \
+      manual.md \
+      "$dest/index.xhtml"
+
+      mkdir -p $out/nix-support/
+      echo "doc manual $dest index.html" >> $out/nix-support/hydra-build-products
   '';
-in
+}
-  stdenvNoCC.mkDerivation {
-    name = "nvf-manual";
-    src = builtins.path {
-      name = "nvf-manual-${manual-release}";
-      path = lib.sourceFilesBySuffices ./manual [".md" ".md.in"];
-    };
-
-    strictDependencies = true;
-    nativeBuildInputs = [nixos-render-docs];
-
-    postPatch = ''
-      ln -s ${optionsJSON}/share/doc/nixos/options.json ./config-options.json
-    '';
-
-    buildPhase = ''
-      dest="$out/share/doc/nvf"
-      mkdir -p "$(dirname "$dest")"
-      mkdir -p $dest/{highlightjs,script}
-
-      # Copy highlight scripts to /highlights in document root.
-      cp -vt $dest/highlightjs \
-        ${documentation-highlighter}/highlight.pack.js \
-        ${documentation-highlighter}/LICENSE \
-        ${documentation-highlighter}/mono-blue.css \
-        ${documentation-highlighter}/loader.js
-
-      # Copy anchor scripts to the script directory in document root.
-      cp -vt "$dest"/script \
-        ${./static/script}/anchor-min.js \
-        ${./static/script}/anchor-use.js
-
-      substituteInPlace ./options.md \
-        --subst-var-by OPTIONS_JSON ./config-options.json
-
-      substituteInPlace ./manual.md \
-        --subst-var-by NVF_VERSION ${manual-release}
-
-      substituteInPlace ./hacking/additional-plugins.md \
-        --subst-var-by NVF_REPO "https://github.com/notashelf/nvf/blob/${manual-release}"
-
-      # Move compiled stylesheet
-      cp -vt $dest \
-        ${compileStylesheet}/style.css
-
-      # Move release notes
-      cp -vr ${./release-notes} release-notes
-
-      # Generate final manual from a set of parameters. Explanation of the CLI flags are
-      # as follows:
-      #
-      #  1. --manpage-urls will allow you to use manual pages as they are defined in
-      #  the nixpkgs documentation.
-      #  2. --revision is the project revision as it is defined in 'release.json' in the
-      #  repository root
-      #  3. --script will inject a given Javascript file into the resulting pages inside
-      #  the <script> tag.
-      #  4. --toc-depth will determine the depth of the initial Table of Contents while
-      #  --section-toc-depth will determine the depth of per-section Table of Contents
-      #  sections.
-      nixos-render-docs manual html \
-        --manpage-urls ${path + "/doc/manpage-urls.json"} \
-        --revision ${lib.trivial.revisionWithDefault manual-release} \
-        --stylesheet "$dest"/style.css \
-        --script ./highlightjs/highlight.pack.js \
-        --script ./highlightjs/loader.js \
-        --script script/anchor-use.js \
-        --script script/anchor-min.js \
-        --toc-depth 2 \
-        --section-toc-depth 1 \
-        manual.md \
-        "$dest/index.xhtml"
-
-        # Hydra support. Probably not necessary.
-        mkdir -p $out/nix-support/
-        echo "doc manual $dest index.html" >> $out/nix-support/hydra-build-products
-    '';
-  }

docs/manual/configuring.md

@@ -3,7 +3,6 @@
 ```{=include=} chapters
 configuring/custom-package.md
 configuring/custom-plugins.md
-configuring/custom-inputs.md
 configuring/languages.md
 configuring/dags.md
 configuring/dag-entries.md

docs/manual/configuring/custom-inputs.md

@@ -1,53 +0,0 @@
-# Custom Inputs {#ch-custom-inputs}
-
-One of the greatest strengths of **nvf** is its ability to get plugins from
-flake inputs and build them locally from any given source. For plugins that do
-not require any kind of additional building step, this is a powerful method of
-adding plugins to your configuration that are not packaged in nixpkgs, or those
-you want to track from source without relying on nixpkgs.
-
-The [additional plugins section](#sec-additional-plugins) details the addition
-of new plugins to nvf under regular circumstances, i.e. while making a pull
-request to the project. You may _override_ those plugin inputs in your own
-`flake.nix` to change source versions, e.g., to use newer versions of plugins
-that are not yet updated in **nvf**.
-
-```nix
-{
-
-  inputs = {
-    # ...
-
-    # The name here is arbitrary, you can name it whatever.
-    # This will add a plugin input called "your-neodev-input"
-    # that you can reference in a `follows` line.
-    your-neodev-input = {
-      url = "github:folke/neodev.nvim";
-      flake = false;
-    };
-
-    nvf = {
-      url = "github:notashelf/nvf";
-
-      # The name of the input must match for the follows line
-      # plugin-neodev-nvim is what the input is called inside nvf
-      # so you must match the exact name here.
-      inputs.plugin-neodev-nvim.follows = "your-neodev-input";
-    };
-    # ...
-  };
-}
-```
-
-This will override the source for the `neodev.nvim` plugin that is used in nvf
-with your own input. You can update your new input via `nix flake update` or
-more specifically `nix flake update <name of your input>` to keep it up to date.
-
-::: {.warning}
-
-While updating plugin inputs, make sure that any configuration that has been
-deprecated in newer versions is changed in the plugin's `setupOpts`. If you
-depend on a new version, requesting a version bump in the issues section is a
-more reliable option.
-
-:::

docs/manual/configuring/custom-plugins.md

@@ -1,8 +1,8 @@
 # Custom Plugins {#ch-custom-plugins}
 
-**nvf**, by default, exposes a wide variety of plugins as module options for
+**nvf**, by default, exposes a wide variety of plugins as module options
-your convenience and bundles necessary dependencies into **nvf**'s runtime. In
+for your convenience and bundles necessary dependencies into **nvf**'s runtime.
-case a plugin is not available in **nvf**, you may consider making a pull
+In case a plugin is not available in **nvf**, you may consider making a pull
 request to **nvf** to include it as a module or you may add it to your
 configuration locally.
 
@@ -11,12 +11,12 @@ configuration locally.
 There are multiple ways of adding custom plugins to your **nvf** configuration.
 
 You can use custom plugins, before they are implemented in the flake. To add a
-plugin to the runtime, you need to add it to the [](#opt-vim.startPlugins) list
+plugin to the runtime, you need to add it to the `vim.startPlugins` list in
-in your configuration.
+your configuration.
 
 Adding a plugin to `startPlugins` will not allow you to configure the plugin
-that you have added, but **nvf** provides multiple way of configuring any custom
+that you have adeed, but **nvf** provides multiple way of configuring any
-plugins that you might have added to your configuration.
+custom plugins that you might have added to your configuration.
 
 ```{=include=} sections
 custom-plugins/configuring.md

docs/manual/configuring/custom-plugins/configuring.md

@@ -1,13 +1,12 @@
 # Configuring {#sec-configuring-plugins}
 
-Just making the plugin to your Neovim configuration available might not always
+Just making the plugin to your Neovim configuration available might not always be enough. In that
-be enough. In that case, you can write custom lua config using either
+case, you can write custom lua config using either `config.vim.lazy.plugins.*.setupOpts`
-`config.vim.lazy.plugins.*.setupOpts` `config.vim.extraPlugins.*.setup` or
+`config.vim.extraPlugins.*.setup` or `config.vim.luaConfigRC`. 
-`config.vim.luaConfigRC`.
 
-The first option uses an extended version of `lz.n`'s PluginSpec. `setupModule`
+The first option uses an extended version of `lz.n`'s PluginSpec. `setupModule` and `setupOpt` can
-and `setupOpt` can be used if the plugin uses a `require('module').setup(...)`
+be used if the plugin uses a `require('module').setup(...)` pattern. Otherwise, the `before` and
-pattern. Otherwise, the `before` and `after` hooks should do what you need.
+`after` hooks should do what you need.
 
 ```nix
 {
@@ -25,11 +24,10 @@ pattern. Otherwise, the `before` and `after` hooks should do what you need.
 }
 ```
 
-The second option uses an attribute set, which maps DAG section names to a
+The second option uses an attribute set, which maps DAG section names to a custom type, which has
-custom type, which has the fields `package`, `after`, `setup`. They allow you to
+the fields `package`, `after`, `setup`. They allow you to set the package of the plugin, the
-set the package of the plugin, the sections its setup code should be after (note
+sections its setup code should be after (note that the `extraPlugins` option has its own DAG
-that the `extraPlugins` option has its own DAG scope), and the its setup code
+scope), and the its setup code respectively. For example:
-respectively. For example:
 
 ```nix
 config.vim.extraPlugins = with pkgs.vimPlugins; {
@@ -58,17 +56,13 @@ For example:
 }
 ```
 
-<!-- deno-fmt-ignore-start -->
+:::{.note}
-
+If your configuration needs to be put in a specific place in the config, you
-::: {.note}
+can use functions from `inputs.nvf.lib.nvim.dag` to order it. Refer to
-One of the greatest strengths of nvf is the ability to order
+https://github.com/nix-community/home-manager/blob/master/modules/lib/dag.nix
-snippets of configuration via the DAG system. It will allow specifying positions
-of individual sections of configuration as needed. nvf provides helper functions
-in the extended library, usually under `inputs.nvf.lib.nvim.dag` that you may
-use.
-
-Please refer to the [DAG section](/index.xhtml#ch-dag-entries) in the nvf manual
 to find out more about the DAG system.
 :::
 
-<!-- deno-fmt-ignore-end -->
+If you successfully made your plugin work, please feel free to create a PR to
+add it to **nvf** or open an issue with your findings so that we can make it
+available for everyone easily.

docs/manual/configuring/custom-plugins/legacy-method.md

@@ -1,6 +1,6 @@
 # Legacy Method {#sec-legacy-method}
 
-Prior to version v0.5, the method of adding new plugins was adding the plugin
+Prior to version 0.5, the method of adding new plugins was adding the plugin
 package to `vim.startPlugins` and add its configuration as a DAG under one of
 `vim.configRC` or `vim.luaConfigRC`. Users who have not yet updated to 0.5, or
 prefer a more hands-on approach may use the old method where the load order of
@@ -8,14 +8,13 @@ the plugins is determined by DAGs.
 
 ## Adding plugins {#sec-adding-plugins}
 
-To add a plugin not available in nvf as a module to your configuration, you may
+To add a plugin to **nvf**'s runtime, you may add it
-add it to [](#opt-vim.startPlugins) in order to make it available to Neovim at
-runtime.
 
 ```nix
 {pkgs, ...}: {
-  # Add a Neovim plugin from Nixpkgs to the runtime.
+  # add a package from nixpkgs to startPlugins
-  vim.startPlugins = [pkgs.vimPlugins.aerial-nvim];
+  vim.startPlugins = [
+    pkgs.vimPlugins.aerial-nvim  ];
 }
 ```
 
@@ -24,9 +23,7 @@ provide configuration as a DAG using the **nvf** extended library.
 
 ```nix
 {inputs, ...}: let
-  # This assumes you have an input called 'nvf' in your flake inputs
+  # assuming you have an input called nvf pointing at the nvf repository
-  # and 'inputs' in your specialArgs. In the case you have passed 'nvf'
-  # to specialArgs, the 'inputs' prefix may be omitted.
   inherit (inputs.nvf.lib.nvim.dag) entryAnywhere;
 in {
   vim.luaConfigRC.aerial-nvim= entryAnywhere ''

docs/manual/configuring/dag-entries.md

@@ -12,9 +12,9 @@ entries in nvf:
 2. `globalsScript` - used to set globals defined in `vim.globals`
 3. `basic` - used to set basic configuration options
 4. `optionsScript` - used to set options defined in `vim.o`
-5. `theme` (this is simply placed before `pluginConfigs` and `lazyConfigs`,
+5. `theme` (this is simply placed before `pluginConfigs` and `lazyConfigs`, meaning that
-   meaning that surrounding entries don't depend on it) - used to set up the
+   surrounding entries don't depend on it) - used to set up the theme, which has to be done before
-   theme, which has to be done before other plugins
+   other plugins
 6. `lazyConfigs` - `lz.n` and `lzn-auto-require` configs. If `vim.lazy.enable`
    is false, this will contain each plugin's config instead.
 7. `pluginConfigs` - the result of the nested `vim.pluginRC` (internal option,

docs/manual/configuring/dags.md

@@ -1,23 +1,25 @@
 # Using DAGs {#ch-using-dags}
 
 We conform to the NixOS options types for the most part, however, a noteworthy
-addition for certain options is the
+addition for certain options is the [**DAG
-[**DAG (Directed acyclic graph)**](https://en.wikipedia.org/wiki/Directed_acyclic_graph)
+(Directed acyclic graph)**](https://en.wikipedia.org/wiki/Directed_acyclic_graph)
 type which is borrowed from home-manager's extended library. This type is most
 used for topologically sorting strings. The DAG type allows the attribute set
-entries to express dependency relations among themselves. This can, for example,
+entries to express dependency relations among themselves. This can, for
-be used to control the order of configuration sections in your `luaConfigRC`.
+example, be used to control the order of configuration sections in your 
+`luaConfigRC`.
 
-The below section, mostly taken from the
+The below section, mostly taken from the [home-manager
-[home-manager manual](https://raw.githubusercontent.com/nix-community/home-manager/master/docs/manual/writing-modules/types.md)
+manual](https://raw.githubusercontent.com/nix-community/home-manager/master/docs/manual/writing-modules/types.md)
 explains in more detail the overall usage logic of the DAG type.
 
 ## entryAnywhere {#sec-types-dag-entryAnywhere}
 
 > `lib.dag.entryAnywhere (value: T) : DagEntry<T>`
 
-Indicates that `value` can be placed anywhere within the DAG. This is also the
+Indicates that `value` can be placed anywhere within the DAG.
-default for plain attribute set entries, that is
+This is also the default for plain attribute set entries, that
+is
 
 ```nix
 foo.bar = {
@@ -39,8 +41,8 @@ are equivalent.
 
 > `lib.dag.entryAfter (afters: list string) (value: T) : DagEntry<T>`
 
-Indicates that `value` must be placed _after_ each of the attribute names in the
+Indicates that `value` must be placed _after_ each of the
-given list. For example
+attribute names in the given list. For example
 
 ```nix
 foo.bar = {
@@ -55,8 +57,8 @@ would place `b` after `a` in the graph.
 
 > `lib.dag.entryBefore (befores: list string) (value: T) : DagEntry<T>`
 
-Indicates that `value` must be placed _before_ each of the attribute names in
+Indicates that `value` must be placed _before_ each of the
-the given list. For example
+attribute names in the given list. For example
 
 ```nix
 foo.bar = {
@@ -71,8 +73,9 @@ would place `b` before `a` in the graph.
 
 > `lib.dag.entryBetween (befores: list string) (afters: list string) (value: T) : DagEntry<T>`
 
-Indicates that `value` must be placed _before_ the attribute names in the first
+Indicates that `value` must be placed _before_ the attribute
-list and _after_ the attribute names in the second list. For example
+names in the first list and _after_ the attribute names in the
+second list. For example
 
 ```nix
 foo.bar = {
@@ -84,18 +87,18 @@ foo.bar = {
 
 would place `c` before `b` and after `a` in the graph.
 
-There are also a set of functions that generate a DAG from a list. These are
+There are also a set of functions that generate a DAG from a list.
-convenient when you just want to have a linear list of DAG entries, without
+These are convenient when you just want to have a linear list of DAG
-having to manually enter the relationship between each entry. Each of these
+entries, without having to manually enter the relationship between
-functions take a `tag` as argument and the DAG entries will be named
+each entry. Each of these functions take a `tag` as argument and the
-`${tag}-${index}`.
+DAG entries will be named `${tag}-${index}`.
 
 ## entriesAnywhere {#sec-types-dag-entriesAnywhere}
 
 > `lib.dag.entriesAnywhere (tag: string) (values: [T]) : Dag<T>`
 
-Creates a DAG with the given values with each entry labeled using the given tag.
+Creates a DAG with the given values with each entry labeled
-For example
+using the given tag. For example
 
 ```nix
 foo.bar = lib.dag.entriesAnywhere "a" [ 0 1 ];
@@ -114,9 +117,9 @@ foo.bar = {
 
 > `lib.dag.entriesAfter (tag: string) (afters: list string) (values: [T]) : Dag<T>`
 
-Creates a DAG with the given values with each entry labeled using the given tag.
+Creates a DAG with the given values with each entry labeled
-The list of values are placed are placed _after_ each of the attribute names in
+using the given tag. The list of values are placed are placed
-`afters`. For example
+_after_ each of the attribute names in `afters`. For example
 
 ```nix
 foo.bar =
@@ -137,13 +140,13 @@ foo.bar = {
 
 > `lib.dag.entriesBefore (tag: string) (befores: list string) (values: [T]) : Dag<T>`
 
-Creates a DAG with the given values with each entry labeled using the given tag.
+Creates a DAG with the given values with each entry labeled
-The list of values are placed _before_ each of the attribute names in `befores`.
+using the given tag. The list of values are placed _before_ each
-For example
+of the attribute names in `befores`. For example
 
 ```nix
-foo.bar =
+  foo.bar =
-  { b = 0; } // lib.dag.entriesBefore "a" [ "b" ] [ 1 2 ];
+    { b = 0; } // lib.dag.entriesBefore "a" [ "b" ] [ 1 2 ];
 ```
 
 is equivalent to
@@ -160,9 +163,10 @@ foo.bar = {
 
 > `lib.dag.entriesBetween (tag: string) (befores: list string) (afters: list string) (values: [T]) : Dag<T>`
 
-Creates a DAG with the given values with each entry labeled using the given tag.
+Creates a DAG with the given values with each entry labeled
-The list of values are placed _before_ each of the attribute names in `befores`
+using the given tag. The list of values are placed _before_ each
-and _after_ each of the attribute names in `afters`. For example
+of the attribute names in `befores` and _after_ each of the
+attribute names in `afters`. For example
 
 ```nix
 foo.bar =

docs/manual/configuring/languages.md

@@ -2,9 +2,9 @@
 
 Language specific support means there is a combination of language specific
 plugins, `treesitter` support, `nvim-lspconfig` language servers, and `null-ls`
-integration. This gets you capabilities ranging from autocompletion to
+integration. This gets you capabilities ranging from autocompletion to formatting
-formatting to diagnostics. The following languages have sections under the
+to diagnostics. The following languages have sections under the `vim.languages`
-`vim.languages` attribute.
+attribute.
 
 - Rust: [vim.languages.rust.enable](#opt-vim.languages.rust.enable)
 - Nix: [vim.languages.nix.enable](#opt-vim.languages.nix.enable)
@@ -20,8 +20,8 @@ formatting to diagnostics. The following languages have sections under the
 - Lua: [vim.languages.lua.enable](#opt-vim.languages.lua.enable)
 - PHP: [vim.languages.php.enable](#opt-vim.languages.php.enable)
 
-Adding support for more languages, and improving support for existing ones are
+Adding support for more languages, and improving support for existing ones are great places
-great places where you can contribute with a PR.
+where you can contribute with a PR.
 
 ```{=include=} sections
 languages/lsp.md

docs/manual/configuring/languages/lsp.md

@@ -1,8 +1,8 @@
 # LSP Custom Packages/Command {#sec-languages-custom-lsp-packages}
 
 In any of the `opt.languages.<language>.lsp.package` options you can provide
-your own LSP package, or provide the command to launch the language server, as a
+your own LSP package, or provide the command to launch the language server, as
-list of strings. You can use this to skip automatic installation of a language
+a list of strings. You can use this to skip automatic installation of a language
 server, and instead use the one found in your `$PATH` during runtime, for
 example:
 

docs/manual/default-configs.md

@@ -1,8 +1,7 @@
 # Default Configs {#ch-default-configs}
 
-While you can configure **nvf** yourself using the builder, you can also use the
+While you can configure **nvf** yourself using the builder, you can also use the pre-built configs that are available.
-pre-built configs that are available. Here are a few default configurations you
+Here are a few default configurations you can use.
-can use.
 
 ```{=include=} chapters
 default-configs/maximal.md

docs/manual/default-configs/maximal.md

@@ -7,5 +7,7 @@ $ nix shell github:notashelf/nvf#maximal test.nix
 It is the same fully configured Neovim as with the [Nix](#sec-default-nix)
 configuration, but with every supported language enabled.
 
-::: {.note} Running the maximal config will download _a lot_ of packages as it
+::: {.note}
-is downloading language servers, formatters, and more. :::
+Running the maximal config will download _a lot_ of packages as it is
+downloading language servers, formatters, and more.
+:::

docs/manual/hacking.md

@@ -1,25 +1,16 @@
 # Hacking nvf {#ch-hacking}
 
-[open issues]: https://github.com/notashelf/nvf/issues
+**nvf** is designed for developers as much as it is for the end user. I would like any potential contributor
-[new issue]: https://github.com/notashelf/nvf/issues/new
+to be able to propagate their desired changes into the repository without the extra effort. As such, below are guides
+(and guidelines) to streamline the contribution process and ensure that your valuable input seamlessly integrates
+into **nvf**'s development without leaving question marks in your head.
 
-nvf is designed for the developer as much as it is designed for the end-user. We
+This section is mainly directed towards those who wish to contribute code into **nvf**. If you wish to instead
-would like for any contributor to be able to propagate their changes, or add new
+report a bug or discuss a potential feature implementation, first look among the
-features to the project with minimum possible friction. As such, below are the
+already [open issues](https://github.com/notashelf/nvf/issues) and if no matching issue exists you may open
-guides and guidelines written to streamline the contribution process and to
+a [new issue](https://github.com/notashelf/nvf/issues/new) and describe your problem/request. While creating an
-ensure that your valuable input integrates into nvf's development as seamlessly
+issue, please try to include as much information as you can, ideally also include relevant context in which an issue
-as possible without leaving any question marks in your head.
+occurs or a feature should be implemented.
-
-This section is directed mainly towards those who wish to contribute code into
-the project. If you instead wish to report a bug, or discuss a potential new
-feature implementation (which you do not wish to implement yourself) first look
-among the already [open issues] and if no matching issue exists you may open a
-[new issue] and describe your problem/request.
-
-While creating an issue, please try to include as much information as you can,
-ideally also include relevant context in which an issue occurs or a feature
-should be implemented. If you wish to make a contribution, but feel stuck -
-please do not be afraid to submit a pull request, we will help you get it in.
 
 ```{=include=} sections
 hacking/getting-started.md

docs/manual/hacking/additional-plugins.md

@@ -1,9 +1,10 @@
 # Adding Plugins {#sec-additional-plugins}
 
-To add a new Neovim plugin, first add the source url in the inputs section of
+To add a new Neovim plugin, first add the source url in the inputs section of `flake.nix`
-`flake.nix` with the prefix `plugin-`
+with the prefix `plugin-`
 
 ```nix
+
 {
   inputs = {
     # ...
@@ -16,18 +17,13 @@ To add a new Neovim plugin, first add the source url in the inputs section of
 }
 ```
 
-Prepending `plugin-` to the name of the input will allow nvf to automatically
-discover inputs that are marked as plugins, and make them available in
-`vim.startPlugins` or other areas that require a very specific plugin type as it
-is defined in `@NVF_REPO@/lib/types/plugins.nix`
-
 The addition of the `plugin-` prefix will allow **nvf** to autodiscover the
 input from the flake inputs automatically, allowing you to refer to it in areas
 that require a very specific plugin type as defined in `lib/types/plugins.nix`
 
 You can now reference this plugin using its string name, the plugin will be
-built with the name and source URL from the flake input, allowing you to refer
+built with the name and source URL from the flake input, allowing you to
-to it as a **string**.
+refer to it as a **string**.
 
 ```nix
 config.vim.startPlugins = ["neodev-nvim"];
@@ -37,11 +33,11 @@ config.vim.startPlugins = ["neodev-nvim"];
 
 Most plugins is initialized with a call to `require('plugin').setup({...})`.
 
-We use a special function that lets you easily add support for such setup
+We use a special function that lets you easily add support for such setup options in a modular way:
-options in a modular way: `mkPluginSetupOption`.
+`mkPluginSetupOption`.
 
-Once you have added the source of the plugin as shown above, you can define the
+Once you have added the source of the plugin as shown above, you can define the setup options like
-setup options like this:
+this:
 
 ```nix
 # in modules/.../your-plugin/your-plugin.nix
@@ -90,8 +86,7 @@ require('plugin-name').setup({
 })
 ```
 
-Now users can set any of the pre-defined option field, and can also add their
+Now users can set any of the pre-defined option field, and can also add their own fields!
-own fields!
 
 ```nix
 # in user's config
@@ -115,8 +110,8 @@ As you've seen above, `toLuaObject` is used to convert our nix attrSet
 1. nix `null` converts to lua `nil`
 2. number and strings convert to their lua counterparts
 3. nix attrSet/list convert into lua tables
-4. you can write raw lua code using `lib.generators.mkLuaInline`. This function
+4. you can write raw lua code using `lib.generators.mkLuaInline`. This
-   is part of nixpkgs.
+   function is part of nixpkgs.
 
 Example:
 
@@ -132,8 +127,8 @@ vim.your-plugin.setupOpts = {
 
 ## Lazy plugins {#sec-lazy-plugins}
 
-If the plugin can be lazy-loaded, `vim.lazy.plugins` should be used to add it.
+If the plugin can be lazy-loaded, `vim.lazy.plugins` should be used to add it. Lazy
-Lazy plugins are managed by `lz.n`.
+plugins are managed by `lz.n`.
 
 ```nix
 # in modules/.../your-plugin/config.nix
@@ -168,7 +163,6 @@ in {
 ```
 
 This results in the following lua code:
-
 ```lua
 require('lz.n').load({
   {

docs/manual/hacking/getting-started.md

@@ -1,17 +1,16 @@
 # Getting Started {#sec-contrib-getting-started}
 
 You, naturally, would like to start by forking the repository to get started. If
-you are new to Git and GitHub, do have a look at GitHub's
+you are new to Git and GitHub, do have a look at GitHub's [Fork a repo guide](https://help.github.com/articles/fork-a-repo/)
-[Fork a repo guide](https://help.github.com/articles/fork-a-repo/) for
+for instructions on how you can do this. Once you have a fork of **nvf**, you
-instructions on how you can do this. Once you have a fork of **nvf**, you should
+should create a separate branch based on the msot recent `main` branch. Give
-create a separate branch based on the most recent `main` branch. Give your
+your branch a reasonably descriptive name (e.g. `feature/debugger` or
-branch a reasonably descriptive name (e.g. `feature/debugger` or
 `fix/pesky-bug`) and you are ready to work on your changes
 
 Implement your changes and commit them to the newly created branch and when you
-are happy with the result, and positive that it fulfills our
+are happy with the result, and positive that it fullfills our [Contributing
-[Contributing Guidelines](#sec-guidelines), push the branch to GitHub and
+Guidelines](#sec-guidelines), push the branch to GitHub and [create a pull
-[create a pull request](https://help.github.com/articles/creating-a-pull-request).
+request](https://help.github.com/articles/creating-a-pull-request). The default
-The default pull request template available on the **nvf** repository will guide
+pull request template available on the **nvf** repository will guide you through
-you through the rest of the process, and we'll gently nudge you in the correct
+the rest of the process, and we'll gently nudge you in the correct direction if
-direction if there are any mistakes.
+there are any mistakes.

docs/manual/hacking/guidelines.md

@@ -3,29 +3,30 @@
 If your contribution tightly follows the guidelines, then there is a good chance
 it will be merged without too much trouble. Some of the guidelines will be
 strictly enforced, others will remain as gentle nudges towards the correct
-direction. As we have no automated system enforcing those guidelines, please try
+direction. As we have no automated system enforcing those guidelines, please
-to double check your changes before making your pull request in order to avoid
+try to double check your changes before making your pull request in order to
-"faulty" code slipping by.
+avoid "faulty" code slipping by.
 
 If you are uncertain how these rules affect the change you would like to make
-then feel free to start a discussion in the
+then feel free to start a discussion in the [discussions tab](https://github.com/NotAShelf/nvf/discussions)
-[discussions tab](https://github.com/NotAShelf/nvf/discussions) ideally (but not
+ideally (but not necessarily) before you start developing.
-necessarily) before you start developing.
 
 ## Adding Documentation {#sec-guidelines-documentation}
 
 Most, if not all, changes warrant changes to the documentation. Module options
-should be documented with
+should be documented with [Nixpkgs-flavoured Markdown](https://nixos.org/manual/nixpkgs/unstable/#sec-contributing-markup),
-[Nixpkgs-flavoured Markdown](https://nixos.org/manual/nixpkgs/unstable/#sec-contributing-markup),
 albeit with exceptions.
 
-::: {.note} As of **v0.5**, **nvf** is itself documented using full markdown in
+::: {.note}
-both module options and the manual. With **v0.6**, this manual has also been
+As of **v0.5**, **nvf** is itself documented using full markdown in both module
-converted to markdown in full. :::
+options and the manual. With **v0.6**, this manual has also been converted to
+markdown in full.
+:::
 
 The HTML version of this manual containing both the module option descriptions
-and the documentation of **nvf** (such as this page) can be generated and opened
+and the documentation of **nvf** (such as this page) can be generated and
-by typing the following in a shell within a clone of the **nvf** Git repository:
+opened by typing the following in a shell within a clone of the **nvf** Git
+repository:
 
 ```console
 $ nix build .#docs-html
@@ -34,28 +35,28 @@ $ xdg-open $PWD/result/share/doc/nvf/index.html
 
 ## Formatting Code {#sec-guidelines-formatting}
 
-Make sure your code is formatted as described in
+Make sure your code is formatted as described in [code-style
-[code-style section](#sec-guidelines-code-style). To maintain consistency
+section](#sec-guidelines-code-style). To maintain consistency throughout the
-throughout the project you are encouraged to browse through existing code and
+project you are encouraged to browse through existing code and adopt its style
-adopt its style also in new code.
+also in new code.
 
 ## Formatting Commits {#sec-guidelines-commit-message-style}
 
 Similar to [code style guidelines](#sec-guidelines-code-style) we encourage a
-consistent commit message format as described in
+consistent commit message format as described in [commit style
-[commit style guidelines](#sec-guidelines-commit-style).
+guidelines](#sec-guidelines-commit-style).
 
 ## Commit Style {#sec-guidelines-commit-style}
 
 The commits in your pull request should be reasonably self-contained. Which
-means each and every commit in a pull request should make sense both on its own
+means each and every commit in a pull request should make sense both on its
-and in general context. That is, a second commit should not resolve an issue
+own and in general context. That is, a second commit should not resolve an
-that is introduced in an earlier commit. In particular, you will be asked to
+issue that is introduced in an earlier commit. In particular, you will be
-amend any commit that introduces syntax errors or similar problems even if they
+asked to amend any commit that introduces syntax errors or similar problems
-are fixed in a later commit.
+even if they are fixed in a later commit.
 
-The commit messages should follow the
+The commit messages should follow the [seven
-[seven rules](https://chris.beams.io/posts/git-commit/#seven-rule), except for
+rules](https://chris.beams.io/posts/git-commit/#seven-rule), except for
 "Capitalize the subject line". We also ask you to include the affected code
 component or module in the first line. A commit message ideally, but not
 necessarily, follow the given template from home-manager's own documentation
@@ -68,16 +69,15 @@ necessarily, follow the given template from home-manager's own documentation
 
 where `{component}` refers to the code component (or module) your change
 affects, `{description}` is a very brief description of your change, and
-`{long description}` is an optional clarifying description. As a rare exception,
+`{long description}` is an optional clarifying description. As a rare
-if there is no clear component, or your change affects many components, then the
+exception, if there is no clear component, or your change affects many
-`{component}` part is optional. See
+components, then the `{component}` part is optional. See [example commit
-[example commit message](#sec-guidelines-ex-commit-message) for a commit message
+message](#sec-guidelines-ex-commit-message) for a commit message that
-that fulfills these requirements.
+fulfills these requirements.
 
 ## Example Commit {#sec-guidelines-ex-commit-message}
 
-The commit
+The commit [69f8e47e9e74c8d3d060ca22e18246b7f7d988ef](https://github.com/nix-community/home-manager/commit/69f8e47e9e74c8d3d060ca22e18246b7f7d988ef)
-[69f8e47e9e74c8d3d060ca22e18246b7f7d988ef](https://github.com/nix-community/home-manager/commit/69f8e47e9e74c8d3d060ca22e18246b7f7d988ef)
 in home-manager contains the following commit message.
 
 ```
@@ -93,10 +93,10 @@ the commit followed by the description:
 ```
 languages/ruby: init module
 
-Adds a language module for Ruby, adds appropriate formatters and Treesitter grammars
+Adds a language module for Ruby, adds appropriate formatters and Treesitter grammers
 ```
 
-Long description can be omitted if the change is too simple to warrant it. A
+Long description can be ommitted if the change is too simple to warrant it. A
 minor fix in spelling or a formatting change does not warrant long description,
 however, a module addition or removal does as you would like to provide the
 relevant context, i.e. the reasoning behind it, for your commit.
@@ -112,22 +112,21 @@ to contain the parent as well - for example `languages/java: some major change`.
 
 ### Treewide {#sec-code-style-treewide}
 
-Keep lines at a reasonable width, ideally 80 characters or less. This also
+Keep lines at a reasonable width, ideally 80 characters or less. This also applies
-applies to string literals and module descriptions and documentation.
+to string literals and module descriptions and documentation.
 
 ### Nix {#sec-code-style-nix}
 
-**nvf** is formatted by the
+**nvf** is formatted by the [alejandra](https://github.com/kamadorueda/alejandra)
-[alejandra](https://github.com/kamadorueda/alejandra) tool and the formatting is
+tool and the formatting is checked in the pull request and push workflows. Run the
-checked in the pull request and push workflows. Run the `nix fmt` command inside
+`nix fmt` command inside the project repository before submitting your pull request.
-the project repository before submitting your pull request.
 
 While Alejandra is mostly opinionated on how code looks after formatting,
-certain changes are done at the user's discretion based on how the original code
+certain changes are done at the user's discretion based on how the original
-was structured.
+code was structured.
 
-Please use one line code for attribute sets that contain only one subset. For
+Please use one line code for attribute sets that contain only one subset.
-example:
+For example:
 
 ```nix
 # parent modules should always be unfolded
@@ -159,8 +158,8 @@ module = {
 ```
 
 For lists, it is mostly up to your own discretion how you want to format them,
-but please try to unfold lists if they contain multiple items and especially if
+but please try to unfold lists if they contain multiple items and especially
-they are to include comments.
+if they are to include comments.
 
 ```nix
 # this is ok

docs/manual/hacking/keybinds.md

@@ -1,10 +1,9 @@
 # Keybinds {#sec-keybinds}
 
 As of 0.4, there exists an API for writing your own keybinds and a couple of
-useful utility functions are available in the
+useful utility functions are available in the [extended standard
-[extended standard library](https://github.com/NotAShelf/nvf/tree/main/lib). The
+library](https://github.com/NotAShelf/nvf/tree/main/lib). The following
-following section contains a general overview to how you may utilize said
+section contains a general overview to how you may utilize said functions.
-functions.
 
 ## Custom Key Mappings Support for a Plugin {#sec-custom-key-mappings}
 
@@ -27,35 +26,79 @@ An example, simple keybinding, can look like this:
 ```
 
 There are many settings available in the options. Please refer to the
-[documentation](https://notashelf.github.io/nvf/options.html#opt-vim.keymaps) to
+[documentation](https://notashelf.github.io/nvf/options.html#opt-vim.keymaps)
-see a list of them.
+to see a list of them.
 
-**nvf** provides a helper function, so that you don't have to write the
+**nvf** provides a list of helper commands, so that you don't have to write the
 mapping attribute sets every time:
 
-- `mkKeymap`, which mimics neovim's `vim.keymap.set` function
+- `mkBinding = key: action: desc:` - makes a basic binding, with `silent` set
+  to true.
+- `mkExprBinding = key: action: desc:` - makes an expression binding, with
+  `lua`, `silent`, and `expr` set to true.
+- `mkLuaBinding = key: action: desc:` - makes an expression binding, with
+  `lua`, and `silent` set to true.
 
-You can read the source code of some modules to see them in action, but the
+Do note that the Lua in these bindings is actual Lua, and not pasted into a
+`:lua` command. Therefore, you should either pass in a function like
+`require('someplugin').some_function`, without actually calling it, or you
+should define your own functions, for example
+
+```lua
+function()
+  require('someplugin').some_function()
+end
+```
+
+Additionally, to not have to repeat the descriptions, there's another utility
+function with its own set of functions: Utility function that takes two
+attribute sets:
+
+- `{ someKey = "some_value" }`
+- `{ someKey = { description = "Some Description"; }; }`
+
+and merges them into `{ someKey = { value = "some_value"; description = "Some Description"; }; }`
+
+```nix
+addDescriptionsToMappings = actualMappings: mappingDefinitions:
+```
+
+This function can be used in combination with the same `mkBinding` functions as
+above, except they only take two arguments - `binding` and `action`, and have
+different names:
+
+- `mkSetBinding = binding: action:` - makes a basic binding, with `silent`
+  set to true.
+- `mkSetExprBinding = binding: action:` - makes an expression binding, with
+  `lua`, `silent`, and `expr` set to true.
+- `mkSetLuaBinding = binding: action:` - makes an expression binding, with
+  `lua`, and `silent` set to true.
+
+You can read the source code of some modules to see them in action, but their
 usage should look something like this:
 
 ```nix
 # plugindefinition.nix
-{lib, ...}: let
+{lib, ...}: with lib; {
-  inherit (lib.options) mkEnableOption;
-  inherit (lib.nvim.binds) mkMappingOption;
-in {
   options.vim.plugin = {
     enable = mkEnableOption "Enable plugin";
 
     # Mappings should always be inside an attrset called mappings
     mappings = {
-      workspaceDiagnostics = mkMappingOption "Workspace diagnostics [trouble]" "<leader>lwd";
+      # mkMappingOption is a helper function from lib,
-      documentDiagnostics = mkMappingOption "Document diagnostics [trouble]" "<leader>ld";
+      # that takes a description (which will also appear in which-key),
-      lspReferences = mkMappingOption "LSP References [trouble]" "<leader>lr";
+      # and a default mapping (which can be null)
-      quickfix = mkMappingOption "QuickFix [trouble]" "<leader>xq";
+      toggleCurrentLine = mkMappingOption "Toggle current line comment" "gcc";
-      locList = mkMappingOption "LOCList [trouble]" "<leader>xl";
+      toggleCurrentBlock = mkMappingOption "Toggle current block comment" "gbc";
-      symbols = mkMappingOption "Symbols [trouble]" "<leader>xs";
+
+      toggleOpLeaderLine = mkMappingOption "Toggle line comment" "gc";
+      toggleOpLeaderBlock = mkMappingOption "Toggle block comment" "gb";
+
+      toggleSelectedLine = mkMappingOption "Toggle selected comment" "gc";
+      toggleSelectedBlock = mkMappingOption "Toggle selected block" "gb";
     };
+
+  };
 }
 ```
 
@@ -63,35 +106,62 @@ in {
 # config.nix
 {
   config,
+  pkgs,
   lib,
-  options,
   ...
-}: let
+}:
-  inherit (lib.modules) mkIf;
+  with lib;
-  inherit (lib.nvim.binds) mkKeymap;
+  with builtins; let
+    cfg = config.vim.plugin;
+    self = import ./plugindefinition.nix {inherit lib;};
+    mappingDefinitions = self.options.vim.plugin;
 
-  cfg = config.vim.plugin;
+    # addDescriptionsToMappings is a helper function from lib,
-
+    # that merges mapping values and their descriptions
-  keys = cfg.mappings;
+    # into one nice attribute set
-  inherit (options.vim.lsp.trouble) mappings;
+    mappings = addDescriptionsToMappings cfg.mappings mappingDefinitions;
 in {
-  config = mkIf cfg.enable {
+  config = mkIf (cfg.enable) {
-    vim.keymaps = [
+    # ...
-      (mkKeymap "n" keys.workspaceDiagnostics "<cmd>Trouble toggle diagnostics<CR>" {desc = mappings.workspaceDiagnostics.description;})
+    vim.maps.normal = mkMerge [
-      (mkKeymap "n" keys.documentDiagnostics "<cmd>Trouble toggle diagnostics filter.buf=0<CR>" {desc = mappings.documentDiagnostics.description;})
+      # mkSetBinding is another helper function from lib,
-      (mkKeymap "n" keys.lspReferences "<cmd>Trouble toggle lsp_references<CR>" {desc = mappings.lspReferences.description;})
+      # that actually adds the mapping with a description.
-      (mkKeymap "n" keys.quickfix "<cmd>Trouble toggle quickfix<CR>" {desc = mappings.quickfix.description;})
+      (mkSetBinding mappings.findFiles "<cmd> Telescope find_files<CR>")
-      (mkKeymap "n" keys.locList "<cmd>Trouble toggle loclist<CR>" {desc = mappings.locList.description;})
+      (mkSetBinding mappings.liveGrep "<cmd> Telescope live_grep<CR>")
-      (mkKeymap "n" keys.symbols "<cmd>Trouble toggle symbols<CR>" {desc = mappings.symbols.description;})
+      (mkSetBinding mappings.buffers "<cmd> Telescope buffers<CR>")
+      (mkSetBinding mappings.helpTags "<cmd> Telescope help_tags<CR>")
+      (mkSetBinding mappings.open "<cmd> Telescope<CR>")
+
+      (mkSetBinding mappings.gitCommits "<cmd> Telescope git_commits<CR>")
+      (mkSetBinding mappings.gitBufferCommits "<cmd> Telescope git_bcommits<CR>")
+      (mkSetBinding mappings.gitBranches "<cmd> Telescope git_branches<CR>")
+      (mkSetBinding mappings.gitStatus "<cmd> Telescope git_status<CR>")
+      (mkSetBinding mappings.gitStash "<cmd> Telescope git_stash<CR>")
+
+      (mkIf config.vim.lsp.enable (mkMerge [
+        (mkSetBinding mappings.lspDocumentSymbols "<cmd> Telescope lsp_document_symbols<CR>")
+        (mkSetBinding mappings.lspWorkspaceSymbols "<cmd> Telescope lsp_workspace_symbols<CR>")
+
+        (mkSetBinding mappings.lspReferences "<cmd> Telescope lsp_references<CR>")
+        (mkSetBinding mappings.lspImplementations "<cmd> Telescope lsp_implementations<CR>")
+        (mkSetBinding mappings.lspDefinitions "<cmd> Telescope lsp_definitions<CR>")
+        (mkSetBinding mappings.lspTypeDefinitions "<cmd> Telescope lsp_type_definitions<CR>")
+        (mkSetBinding mappings.diagnostics "<cmd> Telescope diagnostics<CR>")
+      ]))
+
+      (
+        mkIf config.vim.treesitter.enable
+        (mkSetBinding mappings.treesitter "<cmd> Telescope treesitter<CR>")
+      )
     ];
+    # ...
   };
 }
+
 ```
 
 ::: {.note}
-
 If you have come across a plugin that has an API that doesn't seem to easily
 allow custom keybindings, don't be scared to implement a draft PR. We'll help
 you get it done.
-
 :::

docs/manual/hacking/testing.md

@@ -1,15 +1,15 @@
 # Testing Changes {#sec-testing-changes}
 
-Once you have made your changes, you will need to test them thoroughly. If it is
+Once you have made your changes, you will need to test them throughly. If it is
 a module, add your module option to `configuration.nix` (located in the root of
 this project) inside `neovimConfiguration`. Enable it, and then run the maximal
 configuration with `nix run .#maximal -Lv` to check for build errors. If neovim
 opens in the current directory without any error messages (you can check the
 output of `:messages` inside neovim to see if there are any errors), then your
 changes are good to go. Open your pull request, and it will be reviewed as soon
-as possible.
+as posssible.
 
 If it is not a new module, but a change to an existing one, then make sure the
 module you have changed is enabled in the maximal configuration by editing
-`configuration.nix`, and then run it with `nix run .#maximal -Lv`. Same
+`configuration.nix`, and then run it with `nix run .#maximal -Lv`. Same procedure
-procedure as adding a new module will apply here.
+as adding a new module will apply here.

docs/manual/installation.md

@@ -1,12 +1,9 @@
 # Installing nvf {#ch-installation}
 
-[module installation section]: #ch-module-installation
-
 There are multiple ways of installing nvf on your system. You may either choose
-the standalone installation method, which does not depend on a module system and
+the standalone installation method, which does not depend on a module system and may
-may be done on any system that has the Nix package manager or the appropriate
+be done on any system that has the Nix package manager or the appropriate modules
-modules for NixOS and home-manager as described in the
+for NixOS and home-manager as described in the [module installation section](#ch-module-installation)
-[module installation section].
 
 ```{=include=} chapters
 installation/custom-configuration.md

docs/manual/installation/custom-configuration.md

@@ -1,9 +1,8 @@
 # Standalone Installation {#ch-standalone-installation}
 
-It is possible to install nvf without depending on NixOS or Home-Manager as the
+It is possible to install **nvf** without depending on NixOS or home-manager as the parent
-parent module system, using the `neovimConfiguration` function exposed in the
+module system, using the `neovimConfiguration` function exposed by **nvf** extended library.
-extended library. This function will take `modules` and `extraSpecialArgs` as
+It takes in the configuration as a module, and returns an attribute set as a result.
-arguments, and return the following schema as a result.
 
 ```nix
 {
@@ -14,55 +13,6 @@ arguments, and return the following schema as a result.
 }
 ```
 
-An example flake that exposes your custom Neovim configuration might look like
-
-```nix
-{
-  inputs = {
-    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
-    nvf.url = "github:notashelf/nvf";
-  };
-
-  outputs = {
-    self,
-    nixpkgs,
-    ...
-  } @ inputs: {
-    packages."x86_64-linux" = let
-        neovimConfigured = (inputs.nvf.lib.neovimConfiguration {
-          inherit (nixpkgs.legacyPackages."x86_64-linux") pkgs;
-          modules = [{
-              config.vim = {
-                # Enable custom theming options
-                theme.enable = true;
-
-                # Enable Treesitter
-                tree-sitter.enable = true;
-
-                # Other options will go here. Refer to the config
-                # reference in Appendix B of the nvf manual.
-                # ...
-              };
-          }];
-        });
-    in {
-      # Set the default package to the wrapped instance of Neovim.
-      # This will allow running your Neovim configuration with
-      # `nix run` and in addition, sharing your configuration with
-      # other users in case your repository is public.
-      default = neovimConfigured.neovim;
-    };
-  };
-}
-```
-
-<!-- TODO: mention the built-in flake template here when it is added -->
-
-The above setup will allow to set up nvf as a standalone flake, which you can
-build independently from your system configuration while also possibly sharing
-it with others. The next two chapters will detail specific usage of such a setup
-for a package output in the context of NixOS or Home-Manager installation.
-
 ```{=include=} chapters
 standalone/nixos.md
 standalone/home-manager.md

docs/manual/installation/modules.md

@@ -1,9 +1,5 @@
 # Module Installation {#ch-module-installation}
 
-The below chapters will describe installing nvf as NixOS and Home-Manager
-modules. Note that those methods are mutually exclusive, and will likely cause
-path collisions if used simultaneously.
-
 ```{=include=} chapters
 modules/nixos.md
 modules/home-manager.md

docs/manual/installation/modules/home-manager.md

@@ -77,9 +77,7 @@ configure **nvf**.
 ```
 
 ::: {.note}
-
 **nvf** exposes a lot of options, most of which are not referenced in the
-installation sections of the manual. You may find all available options in the
+installation sections of the manual. You may find all avaliable options
-[appendix](https://notashelf.github.io/nvf/options)
+in the [appendix](https://notashelf.github.io/nvf/options)
-
 :::

docs/manual/installation/modules/nixos.md

@@ -76,9 +76,7 @@ configure **nvf**.
 ```
 
 ::: {.note}
-
 **nvf** exposes a lot of options, most of which are not referenced in the
-installation sections of the manual. You may find all available options in the
+installation sections of the manual. You may find all avaliable options
-[appendix](https://notashelf.github.io/nvf/options)
+in the [appendix](https://notashelf.github.io/nvf/options)
-
 :::

docs/manual/installation/standalone/home-manager.md

@@ -1,12 +1,12 @@
 # Standalone Installation on Home-Manager {#ch-standalone-hm}
 
-Your built Neovim configuration can be exposed as a flake output to make it
+Your built Neoevim configuration can be exposed as a flake output to make it
 easier to share across machines, repositories and so on. Or it can be added to
 your system packages to make it available across your system.
 
 The following is an example installation of `nvf` as a standalone package with
 the default theme enabled. You may use other options inside `config.vim` in
-`configModule`, but this example will not cover that extensively.
+`configModule`, but this example will not cover that.
 
 ```nix
 {
@@ -30,22 +30,23 @@ the default theme enabled. You may use other options inside `config.vim` in
     };
 
     customNeovim = nvf.lib.neovimConfiguration {
-      inherit pkgs;
       modules = [configModule];
+      inherit pkgs;
     };
   in {
-    # This will make the package available as a flake output under 'packages'
+    # this will make the package available as a flake input
     packages.${system}.my-neovim = customNeovim.neovim;
 
-    # Example Home-Manager configuration using the configured Neovim package
+    # this is an example home-manager configuration
+    # using the built neovim package
     homeConfigurations = {
       "your-username@your-hostname" = home-manager.lib.homeManagerConfiguration {
         # ...
         modules = [
-          # This will make Neovim available to users using the Home-Manager
+          ./home.nix
-          # configuration. To make the package available to all users, prefer
+
-          # environment.systemPackages in your NixOS configuration.
+          # this will make wrapped neovim available in your system packages
-          {home.packages = [customNeovim.neovim];}
+          {environment.systemPackages = [customNeovim.neovim];}
         ];
         # ...
       };

docs/manual/installation/standalone/nixos.md

@@ -1,12 +1,12 @@
 # Standalone Installation on NixOS {#ch-standalone-nixos}
 
-Your built Neovim configuration can be exposed as a flake output to make it
+Your built Neoevim configuration can be exposed as a flake output to make it
 easier to share across machines, repositories and so on. Or it can be added to
 your system packages to make it available across your system.
 
 The following is an example installation of `nvf` as a standalone package with
 the default theme enabled. You may use other options inside `config.vim` in
-`configModule`, but this example will not cover that extensively.
+`configModule`, but this example will not cover that.
 
 ```nix
 {
@@ -30,19 +30,21 @@ the default theme enabled. You may use other options inside `config.vim` in
     };
 
     customNeovim = nvf.lib.neovimConfiguration {
-      inherit pkgs;
       modules = [configModule];
+      inherit pkgs;
     };
   in {
-    # This will make the package available as a flake output under 'packages'
+    # this will make the package available as a flake input
     packages.${system}.my-neovim = customNeovim.neovim;
 
-    # Example nixosConfiguration using the configured Neovim package
+    # this is an example nixosConfiguration using the built neovim package
     nixosConfigurations = {
       yourHostName = nixpkgs.lib.nixosSystem {
         # ...
         modules = [
-          # This will make wrapped neovim available in your system packages
+          ./configuration.nix # or whatever your configuration is
+
+          # this will make wrapped neovim available in your system packages
           {environment.systemPackages = [customNeovim.neovim];}
         ];
         # ...

docs/manual/manual.md

@@ -17,8 +17,8 @@ configuring.md
 hacking.md
 ```
 
-```{=include=} appendix html:into-file=//quirks.html
+```{=include=} appendix html:into-file=//plugins.html
-quirks.md
+plugins.md
 ```
 
 ```{=include=} appendix html:into-file=//options.html

docs/manual/options.md

@@ -1,14 +1,8 @@
 # Neovim Flake Configuration Options {#ch-options}
 
-Below are the module options provided by nvf, in no particular order. Most
+Below are the options provided by nvf provided in no particular order.
-options will include useful comments, warnings or setup tips on how a module
+They may include useful comments and warnings, or examples on how a module option
-option is meant to be used as well as examples in complex cases.
+is meant to be used.
-
-<!--
-In the manual, individual options may be referenced in Hyperlinks as follows:
-[](#opt-vim.*) If changing the prefix here, do keep in mind the #opt- suffix will have
-to be changed everywhere.
--->
 
 ```{=include=} options
 id-prefix: opt-

docs/manual/plugins.md

@@ -0,0 +1,16 @@
+# Plugin specific quirks {#ch-plugins}
+
+At times, certain plugins refuse to play nicely. Be it as a result of generating
+lua from Nix, or the state of packaging. This page shall list any plugins that
+are known to misbehave, and potential workarounds.
+
+```{=include=} chapters
+plugins/nodejs.md
+```
+<!--
+If adding a new section, uncomment this part and add your page to
+plugins/<page>.md
+```{=include=} chapters
+plugins/page.md
+```
+-->

docs/manual/plugins/nodejs.md

@@ -1,22 +1,16 @@
-# NodeJS {#ch-quirks-nodejs}
+# NodeJS {#ch-plugins-nodejs}
 
 ## eslint-plugin-prettier {#sec-eslint-plugin-prettier}
 
-When working with NodeJS, everything works as expected, but some projects have
+When working with NodeJS, everything works as expected, but some projects have settings that can fool nvf.
-settings that can fool nvf.
 
-If [this plugin](https://github.com/prettier/eslint-plugin-prettier) or similar
+If [this plugin](https://github.com/prettier/eslint-plugin-prettier) or similar is included, you might get a situation where your eslint configuration diagnoses your formatting according to its own config (usually `.eslintrc.js`).
-is included, you might get a situation where your eslint configuration diagnoses
-your formatting according to its own config (usually `.eslintrc.js`).
 
 The issue there is your formatting is made via prettierd.
 
-This results in auto-formatting relying on your prettier config, while your
+This results in auto-formating relying on your prettier config, while your eslint config diagnoses formatting [which it's not supposed to](https://prettier.io/docs/en/comparison.html))
-eslint config diagnoses formatting
-[which it's not supposed to](https://prettier.io/docs/en/comparison.html))
 
-In the end, you get discrepancies between what your editor does and what it
+In the end, you get discrepancies between what your editor does and what it wants.
-wants.
 
 Solutions are:
 

docs/manual/preface.md

@@ -1,20 +1,7 @@
 # Preface {#ch-preface}
 
-## What is nvf {#sec-what-is-it}
+If you noticed a bug caused by **nvf** then please consider reporting it over
+[the issue tracker](https://github.com/notashelf/nvf/issues).
 
-nvf is a highly modular, configurable, extensible and easy to use Neovim
+Bugfixes, feature additions and upstreamed changes from your local configurations
-configuration in Nix. Designed for flexibility and ease of use, nvf allows you
+are always welcome in the [the pull requests tab](https://github.com/notashelf/nvf/pulls).
-to easily configure your fully featured Neovim instance with a few lines of Nix.
-
-## Bugs & Suggestions {#sec-bugs-suggestions}
-
-[issue tracker]: https://github.com/notashelf/nvf/issues
-[discussions tab]: https://github.com/notashelf/nvf/discussions
-[pull requests tab]: https://github.com/notashelf/nvf/pulls
-
-If you notice any issues with nvf, or this documentation, then please consider
-reporting them over at the [issue tracker]. Issues tab, in addition to the
-[discussions tab] is a good place as any to request new features.
-
-You may also consider submitting bugfixes, feature additions and upstreamed
-changes that you think are critical over at the [pull requests tab].

docs/manual/quirks.md

@@ -1,13 +0,0 @@
-# Known Issues and Quirks {#ch-known-issues-quirks}
-
-At times, certain plugins and modules may refuse to play nicely with your setup,
-be it a result of generating Lua from Nix, or the state of packaging. This page,
-in turn, will list any known modules or plugins that are known to misbehave, and
-possible workarounds that you may apply.
-
-<!-- If adding a new known quirk, please create a new page in quirks/ and include
-the name of the file here.-->
-
-```{=include=} chapters
-quirks/nodejs.md
-```

docs/manual/try-it-out.md

@@ -1,27 +1,25 @@
 # Try it out {#ch-try-it-out}
 
-Thanks to the portability of Nix, you can try out nvf without actually
+Thanks to the portability of Nix, you can try out nvf without actually installing it to your machine.
-installing it to your machine. Below are the commands you may run to try out
+Below are the commands you may run to try out different configurations provided by this flake. As of v0.5, three
-different configurations provided by this flake. As of v0.5, two specialized
 configurations are provided:
 
-- **Nix** - Nix language server + simple utility plugins
+- Nix
-- **Maximal** - Variable language servers + utility and decorative plugins
+- Maximal
 
-You may try out any of the provided configurations using the `nix run` command
+You may try out any of the provided configurations using the `nix run` command on a system where Nix is installed.
-on a system where Nix is installed.
 
-```bash
+```console
 $ cachix use nvf                   # Optional: it'll save you CPU resources and time
 $ nix run github:notashelf/nvf#nix # will run the default minimal configuration
 ```
 
-Do keep in mind that this is **susceptible to garbage collection** meaning it
+Do keep in mind that this is **susceptible to garbage collection** meaning it will be removed from your Nix store
-will be removed from your Nix store once you garbage collect.
+once you garbage collect.
 
-## Using Prebuilt Configs {#sec-using-prebuilt-configs}
+## Using Prebuilt Configs {#sec-using-prebuild-configs}
 
-```bash
+```console
 $ nix run github:notashelf/nvf#nix
 $ nix run github:notashelf/nvf#maximal
 ```
@@ -30,19 +28,12 @@ $ nix run github:notashelf/nvf#maximal
 
 #### Nix {#sec-configs-nix}
 
-`Nix` configuration by default provides LSP/diagnostic support for Nix alongside
+`Nix` configuration by default provides LSP/diagnostic support for Nix alongisde a set of visual and functional plugins.
-a set of visual and functional plugins. By running `nix run .#`, which is the
+By running `nix run .#`, which is the default package, you will build Neovim with this config.
-default package, you will build Neovim with this config.
 
 #### Maximal {#sec-configs-maximal}
 
-`Maximal` is the ultimate configuration that will enable support for more
+`Maximal` is the ultimate configuration that will enable support for more commonly used language as well as additional
-commonly used language as well as additional complementary plugins. Keep in
+complementary plugins. Keep in mind, however, that this will pull a lot of dependencies.
-mind, however, that this will pull a lot of dependencies.
 
-::: {.tip}
+You are _strongly_ recommended to use the binary cache if you would like to try the Maximal configuration.
-
-You are _strongly_ recommended to use the binary cache if you would like to try
-the Maximal configuration.
-
-:::

docs/release-notes/release-notes.md

@@ -1,7 +1,7 @@
 # Release Notes {#ch-release-notes}
 
-This section lists the release notes for tagged version of **nvf** and the
+This section lists the release notes for tagged version of **nvf** and
-current main current main branch
+the current main current main branch
 
 ```{=include=} chapters
 rl-0.1.md

docs/release-notes/rl-0.1.md

@@ -1,42 +1,34 @@
 # Release 0.1 {#sec-release-0.1}
 
-This is the current master branch and information here is not final. These are
+This is the current master branch and information here is not final. These are changes from the v0.01 tag.
-changes from the v0.1 tag.
 
-Special thanks to [home-manager](https://github.com/nix-community/home-manager/)
+Special thanks to [home-manager](https://github.com/nix-community/home-manager/) for this release.
-for this release. Docs/manual generation, the new module evaluation system, and
+Docs/manual generation, the new module evaluation system, and DAG implementation are from them.
-DAG implementation are from them.
 
 ## Changelog {#sec-release-0.1-changelog}
 
 [jordanisaacs](https://github.com/jordanisaacs):
 
-- Removed hare language support (lsp/tree-sitter/etc). `vim.lsp.hare` is no
+- Removed hare language support (lsp/tree-sitter/etc). `vim.lsp.hare` is no longer defined.
-  longer defined. If you use hare and would like it added back, please file an
+  If you use hare and would like it added back, please file an issue.
-  issue.
 
-- [](#opt-vim.startPlugins) & [](#opt-vim.optPlugins) are now an enum of
+- [vim.stratPlugins](opt-vim.startPlugins) & [vim.optPlugins](opt-vim.optPlugins) are now
-  `string` for options sourced from the flake inputs. Users can still provide
+  an enum of `string` for options sourced from the flake inputs. Users can still provide vim
-  vim plugin packages.
+  plugin packages.
 
-  - If you are contributing and adding a new plugin, add the plugin name to
+  - If you are contributing and adding a new plugin, add the plugin name to `availablePlugins` in
-    `availablePlugins` in [types-plugin.nix].
+    [types-plugin.nix](https://github.com/jordanisaacs/neovim-flake/blob/20cec032bd74bc3d20ac17ce36cd84786a04fd3e/modules/lib/types-plugin.nix).
 
-- `neovimBuilder` has been removed for configuration. Using an overlay is no
+- `neovimBuilder` has been removed for configuration. Using an overlay is no longer required.
-  longer required. See the manual for the new way to configuration.
+  See the manual for the new way to configuration.
 
-[relevant discourse post]: https://discourse.nixos.org/t/psa-if-you-are-on-unstable-try-out-nvim-treesitter-withallgrammars/23321?u=snowytrees
+- Treesitter grammars are now configurable with [vim.treesitter.grammars](opt-vim.treesitter.grammars).
+  Utilizes the nixpkgs `nvim-treesitter` plugin rather than a custom input in order to take advantage of build support of pinned versions.
+  See [relevant discourse post](https://discourse.nixos.org/t/psa-if-you-are-on-unstable-try-out-nvim-treesitter-withallgrammars/23321?u=snowytrees)
+  for more information. Packages can be found under the `vimPlugins.nvim-treesitter.builtGrammars` namespace.
 
-- Treesitter grammars are now configurable with
+- [vim.configRC](opt-vim.configRC) and [vim.luaConfigRC](opt-vim.luaConfigRC) are now of type DAG lines.
-  [](#opt-vim.treesitter.grammars). Utilizes the nixpkgs `nvim-treesitter`
+  This allows for ordering of the config. Usage is the same is in home-manager's `home.activation` option.
-  plugin rather than a custom input in order to take advantage of build support
-  of pinned versions. See the [relevant discourse post] for more information.
-  Packages can be found under the `vimPlugins.nvim-treesitter.builtGrammars`
-  namespace.
-
-- `vim.configRC` and [](#opt-vim.luaConfigRC) are now of type DAG lines. This
-  allows for ordering of the config. Usage is the same is in home-manager's
-  `home.activation` option.
 
 ```nix
 vim.luaConfigRC = lib.nvim.dag.entryAnywhere "config here"
@@ -44,5 +36,5 @@ vim.luaConfigRC = lib.nvim.dag.entryAnywhere "config here"
 
 [MoritzBoehme](https://github.com/MoritzBoehme):
 
-- `catppuccin` theme is now available as a neovim theme [](#opt-vim.theme.style)
+- `catppuccin` theme is now available as a neovim theme [vim.theme.style](opt-vim.theme.style) and lualine theme
-  and Lualine theme [](#opt-vim.statusline.lualine.theme).
+  [vim.statusline.lualine.theme](opt-vim.statusline.lualine.theme).

docs/release-notes/rl-0.2.md

@@ -6,59 +6,48 @@ Release notes for release 0.2
 
 [notashelf](https://github.com/notashelf):
 
-- Added two minimap plugins under `vim.minimap`. `codewindow.nvim` is enabled by
+- Added two minimap plugins under `vim.minimap`. `codewindow.nvim` is enabled by default, while `minimap.vim` is
-  default, while `minimap.vim` is available with its code-minimap dependency.
+  available with its code-minimap dependency.
-- A complementary plugin, `obsidian.nvim` and the Neovim alternative for Emacs'
+- A complementary plugin, `obsidian.nvim` and the Neovim alternative for Emacs' orgmode with `orgmode.nvim` have been
-  orgmode with `orgmode.nvim` have been added. Both will be disabled by default.
+  added. Both will be disabled by default.
 
-- Smooth scrolling for ANY movement command is now available with
+- Smooth scrolling for ANY movement command is now available with `cinnamon.nvim`
-  `cinnamon.nvim`
 
-- You will now notice a dashboard on startup. This is provided by the
+- You will now notice a dashboard on startup. This is provided by the `alpha.nvim` plugin. You can use any of the
-  `alpha.nvim` plugin. You can use any of the three available dashboard plugins,
+  three available dashboard plugins, or disable them entirely.
-  or disable them entirely.
 
-- There is now a scrollbar on active buffers, which can highlight errors by
+- There is now a scrollbar on active buffers, which can highlight errors by hooking to your LSPs. This is on by
-  hooking to your LSPs. This is on by default, but can be toggled off under
+  default, but can be toggled off under `vim.visuals` if seen necessary.
-  `vim.visuals` if seen necessary.
 
-- Discord Rich Presence has been added through `presence.nvim` for those who
+- Discord Rich Presence has been added through `presence.nvim` for those who want to flex that they are using
-  want to flex that they are using the _superior_ text editor.
+  the _superior_ text editor.
 
-- An icon picker is now available with telescope integration. You can use
+- An icon picker is now available with telescope integration. You can use `:IconPickerInsert` or `:IconPickerYank`
-  `:IconPickerInsert` or `:IconPickerYank` to add icons to your code.
+  to add icons to your code.
 
-- A general-purpose cheatsheet has been added through `cheatsheet.nvim`. Forget
+- A general-purpose cheatsheet has been added through `cheatsheet.nvim`. Forget no longer!
-  no longer!
 
-- `ccc.nvim` has been added to the default plugins to allow picking colors with
+- `ccc.nvim` has been added to the default plugins to allow picking colors with ease.
-  ease.
 
-- Most UI components of Neovim have been replaced through the help of
+- Most UI components of Neovim have been replaced through the help of `noice.nvim`. There are also notifications
-  `noice.nvim`. There are also notifications and custom UI elements available
+  and custom UI elements available for Neovim messages and prompts.
-  for Neovim messages and prompts.
 
 - A (floating by default) terminal has been added through `toggleterm.nvim`.
 
-- Harness the power of ethical (`tabnine.nvim`) and not-so-ethical
+- Harness the power of ethical (`tabnine.nvim`) and not-so-ethical (`copilot.lua`) AI by those new assistant plugins.
-  (`copilot.lua`) AI by those new assistant plugins. Both are off by default,
+  Both are off by default, TabNine needs to be wrapped before it's working.
-  TabNine needs to be wrapped before it's working.
 
-- Experimental mouse gestures have been added through `gesture.nvim`. See plugin
+- Experimental mouse gestures have been added through `gesture.nvim`. See plugin page and the relevant module for
-  page and the relevant module for more details on how to use.
+  more details on how to use.
 
-- Re-open last visited buffers via `nvim-session-manager`. Disabled by default
+- Re-open last visited buffers via `nvim-session-manager`. Disabled by default as deleting buffers seems to be
-  as deleting buffers seems to be problematic at the moment.
+  problematic at the moment.
 
-- Most of NvimTree's configuration options have been changed with some options
+- Most of NvimTree's configuration options have been changed with some options being toggled to off by default.
-  being toggled to off by default.
 
-- Lualine had its configuration simplified and style toned down. Less color,
+- Lualine had its configuration simplified and style toned down. Less color, more info.
-  more info.
 
-- Modules where multiple plugin configurations were in the same directory have
+- Modules where multiple plugin configurations were in the same directory have been simplified. Each plugin inside
-  been simplified. Each plugin inside a single module gets its directory to be
+  a single module gets its directory to be imported.
-  imported.
 
-- Separate config options with the same parent attribute have been merged into
+- Separate config options with the same parent attribute have been merged into one for simplicity.
-  one for simplicity.

docs/release-notes/rl-0.3.md

@@ -1,88 +1,67 @@
 # Release 0.3 {#sec-release-0.3}
 
-Release 0.3 had to come out before I wanted it to due to Neovim 0.9 dropping
+Release 0.3 had to come out beore I wanted it to due to Neovim 0.9 dropping into nixpkgs-unstable.
-into nixpkgs-unstable. The Treesitter changes have prompted a Treesitter rework,
+The treesitter changes have prompted a treesitter rework, which was followed by reworking the languages system.
-which was followed by reworking the languages system. Most of the changes to
+Most of the changes to those are downstreamed from the original repository. The feature requests that was originally
-those are downstreamed from the original repository. The feature requests that
+planned for 0.3 have been moved to 0.4, which should come out soon.
-was originally planned for 0.3 have been moved to 0.4, which should come out
-soon.
 
 ## Changelog {#sec-release-0.3-changelog}
 
-- We have transitioned to flake-parts, from flake-utils to extend the
+- We have transitioned to flake-parts, from flake-utils to extend the flexibility of this flake. This means the flake structure
-  flexibility of this flake. This means the flake structure is different than
+  is different than usual, but the functionality remains the same.
-  usual, but the functionality remains the same.
 
-- We now provide a home-manager module. Do note that it is still far from
+- We now provide a home-manager module. Do note that it is still far from perfect, but it works.
-  perfect, but it works.
 
-- `nodejs_16` is now bundled with `Copilot.lua` if the user has enabled Copilot
+- `nodejs_16` is now bundled with `Copilot.lua` if the user has enabled Copilot assistant.
-  assistant.
 
-- which-key section titles have been fixed. This is to be changed once again in
+- which-key section titles have been fixed. This is to be changed once again in a possible keybind rewrite, but now it should
-  a possible keybind rewrite, but now it should display the correct titles
+  display the correct titles instad of `+prefix`
-  instead of `+prefix`
 
-- Most of `presence.nvim`'s options have been made fully configurable through
+- Most of `presence.nvim`'s options have been made fully configurable through your configuration file.
-  your configuration file.
 
-- Most of the modules have been refactored to separate `config` and `options`
+- Most of the modules have been refactored to separate `config` and `options` attributes.
-  attributes.
 
-- Darwin has been deprecated as the Zig package is marked as broken. We will
+- Darwin has been deprecated as the zig package is marked as broken. We will attempt to use the zig overlay to return Darwin
-  attempt to use the Zig overlay to return Darwin support.
+  support.
 
 - `Fidget.nvim` has been added as a neat visual addition for LSP installations.
 
 - `diffview.nvim` has been added to provide a convenient diff utility.
 
-  [discourse]: https://discourse.nixos.org/t/psa-if-you-are-on-unstable-try-out-nvim-treesitter-withallgrammars/23321?u=snowytrees
+- Treesitter grammars are now configurable with [vim.treesitter.grammars](vim.treesitter.grammars).
-
+  Utilizes the nixpkgs `nvim-treesitter` plugin rather than a custom input in order to take advantage of build support of pinned versions.
-- Treesitter grammars are now configurable with
+  See [discourse](https://discourse.nixos.org/t/psa-if-you-are-on-unstable-try-out-nvim-treesitter-withallgrammars/23321?u=snowytrees) for more information.
-  [](#opt-vim.treesitter.grammars). Utilizes the nixpkgs `nvim-treesitter`
+  Packages can be found under the `pkgs.vimPlugins.nvim-treesitter.builtGrammars` attribute. Treesitter grammars for supported languages should be
-  plugin rather than a custom input in order to take advantage of build support
+  enabled within the module. By default no grammars are installed, thus the following grammars which do not have a language section are not included anymore:
-  of pinned versions. See [discourse] for more information. Packages can be
+  **comment**, **toml**, **make**, **html**, **css**, **graphql**, **json**.
-  found under the `pkgs.vimPlugins.nvim-treesitter.builtGrammars` attribute.
-  Treesitter grammars for supported languages should be enabled within the
-  module. By default no grammars are installed, thus the following grammars
-  which do not have a language section are not included anymore: **comment**,
-  **toml**, **make**, **html**, **css**, **graphql**, **json**.
 
 - A new section has been added for language support: `vim.languages.<language>`.
 
-  - The options [](#opt-vim.languages.enableLSP),
+  - The options [vim.languages.enableLSP](vim.languages.enableLSP), [vim.languages.enableTreesitter](vim.languages.enableTreesitter), etc.
-    [](#opt-vim.languages.enableTreesitter), etc. will enable the respective
+    will enable the respective section for all languages that have been enabled.
-    section for all languages that have been enabled.
   - All LSP languages have been moved here
   - `plantuml` and `markdown` have been moved here
-  - A new section has been added for `html`. The old
+  - A new section has been added for `html`. The old `vim.treesitter.autotagHtml` can be found at <<opt-vim.languages.html.treesitter.autotagHtml>>.
-    `vim.treesitter.autotagHtml` can be found at
-    [](#opt-vim.languages.html.treesitter.autotagHtml).
 
-- `vim.git.gitsigns.codeActions` has been added, allowing you to turn on
+- [vim.git.gitsigns.codeActions](vim.git.gitsigns.codeActions) has been added allowing you to turn on gitsigns codeactions.
-  Gitsigns' code actions.
 
 - Removed the plugins document in the docs. Was too unwieldy to keep updated.
 
-- `vim.visual.lspkind` has been moved to [](#opt-vim.lsp.lspkind.enable)
+- `vim.visual.lspkind` has been moved to [vim.lsp.lspkind.enable](vim.lsp.lspkind.enable)
 
-- Improved handling of completion formatting. When setting
+- Improved handling of completion formatting. When setting [vim.autocomplete.sources](vim.autocomplete.sources), can also include optional menu mapping.
-  `vim.autocomplete.sources`, can also include optional menu mapping. And can
+  And can provide your own function with [vim.autocomplete.formatting.format](vim.autocomplete.formatting.format).
-  provide your own function with `vim.autocomplete.formatting.format`.
 
-- For `vim.visuals.indentBlankline.fillChar` and
+- For [vim.visuals.indentBlankline.fillChar](vim.visuals.indentBlankline.fillChar) and [vim.visuals.indentBlankline.eolChar](vim.visuals.indentBlankline.eolChar)
-  `vim.visuals.indentBlankline.eolChar` options, turning them off should be done
+  turning them off should use `null` rather than `""` now.
-  by using `null` rather than `""` now.
 
-- Transparency has been made optional and has been disabled by default.
+- Transparency has been made optional and has been disabled by default. [vim.theme.transparent](vim.theme.transparent) option can be used to enable or
-  [](#opt-vim.theme.transparent) option can be used to enable or disable
+  disable transparency for your configuration.
-  transparency for your configuration.
 
-- Fixed deprecated configuration method for Tokyonight, and added new style
+- Fixed deprecated configuration method for Tokyonight, and added new style "moon"
-  "moon"
 
-- Dart language support as well as extended flutter support has been added.
+- Dart language support as well as extended flutter support has been added. Thanks to @FlafyDev for his contributions towards Dart
-  Thanks to @FlafyDev for his contributions towards Dart language support.
+  language support.
 
 - Elixir language support has been added through `elixir-tools.nvim`.
 
@@ -90,14 +69,13 @@ soon.
 
 - `modes.nvim` has been added to the UI plugins as a minor error highlighter.
 
-- `smartcollumn.nvim` has been added to dynamically display a colorcolumn when
+- `smartcollumn.nvim` has been added to dynamically display a colorcolumn when the limit has been exceeded, providing
-  the limit has been exceeded, providing per-buftype column position and more.
+  per-buftype column position and more.
 
 - `project.nvim` has been added for better project management inside Neovim.
 
 - More configuration options have been added to `nvim-session-manager`.
 
-- Editorconfig support has been added to the core functionality, with an enable
+- Editorconfig support has been added to the core functionality, with an enable option.
-  option.
 
 - `venn-nvim` has been dropped due to broken keybinds.

docs/release-notes/rl-0.4.md

@@ -1,16 +1,12 @@
 # Release 0.4 {#sec-release-0.4}
 
-Following the release of v0.3, I have decided to release v0.4 with a massive new
+Following the release of v0.3, I have decided to release v0.4 with a massive new change: customizable keybinds.
-change: customizable keybinds. As of the 0.4 release, keybinds will no longer be
+As of the 0.4 release, keybinds will no longer be hardcoded and instead provided by each module's own keybinds section.
-hardcoded and instead provided by each module's own keybinds section. The old
+The old keybind system (`vim.keybinds = {}`) is now considered deprecated and the new lib functions are recommended to be
-keybind system (`vim.keybinds = {}`) is now considered deprecated and the new
+used for adding keybinds for new plugins, or adding keybinds to existing plugins.
-lib functions are recommended to be used for adding keybinds for new plugins, or
-adding keybinds to existing plugins.
 
-Alongside customizable keybinds, there are a few quality of life updates, such
+Alongside customizable keybinds, there are a few quality of life updates, such as `lazygit` integration and the
-as `lazygit` integration and the new experimental Lua loader of Neovim 0.9
+new experimental Lua loader of Neovim 0.9 thanks to our awesome contributors who made this update possible during my absence.
-thanks to our awesome contributors who made this update possible during my
-absence.
 
 ## Changelog {#sec-release-0.4-changelog}
 
@@ -22,8 +18,7 @@ absence.
 
 - Simplified luaConfigRC and configRC setting - they can now just take strings
 
-- Refactored the resolveDag function - you can just provide a string now, which
+- Refactored the resolveDag function - you can just provide a string now, which will default to dag.entryAnywhere
-  will default to dag.entryAnywhere
 
 - Fixed formatting sometimes removing parts of files
 
@@ -37,8 +32,7 @@ absence.
 
 - Added `toggleterm` integration for `lazygit`.
 
-- Added new option `enableluaLoader` to enable neovim's experimental module
+- Added new option `enableluaLoader` to enable neovim's experimental module loader for faster startup time.
-  loader for faster startup time.
 
 - Fixed bug where flutter-tools can't find `dart` LSP
 
@@ -46,28 +40,23 @@ absence.
 
 [notashelf](https://github.com/notashelf):
 
-- Made Copilot's Node package configurable. It is recommended to keep as
+- Made Copilot's Node package configurable. It is recommended to keep as default, but providing a different NodeJS version is now possible.
-  default, but providing a different NodeJS version is now possible.
 
-- Added `vim.cursorlineOpt` for configuring Neovim's `vim.o.cursorlineopt`.
+- Added [vim.cursorlineOpt](vim.cursorlineOpt) for configuring Neovim's cursorlineOpt.
 
-- Added `filetree.nvimTreeLua.view.cursorline`, default false, to enable
+- Added `filetree.nvimTreeLua.view.cursorline`, default false, to enable cursorline in nvimtre.
-  cursorline in nvimtre.
 
 - Added Fidget.nvim support for the Catppuccin theme.
 
-- Updated bundled NodeJS version used by `Copilot.lua`. v16 is now marked as
+- Updated bundled NodeJS version used by `Copilot.lua`. v16 is now marked as insecure on Nixpkgs, and we updated to v18
-  insecure on Nixpkgs, and we updated to v18
 
 - Enabled Catppuccin modules for plugins available by default.
 
 - Added experimental Svelte support under `vim.languages`.
 
-- Removed unnecessary scrollbar element from notifications and codeaction
+- Removed unnecessary scrollbar element from notifications and codeaction warning UI.
-  warning UI.
 
-- `vim.utility.colorizer` has been renamed to `vim.utility.ccc` after the plugin
+- `vim.utility.colorizer` has been renamed to `vim.utility.ccc` after the plugin it uses
-  it uses
 
 - Color preview via `nvim-colorizer.lua`
 
@@ -77,8 +66,7 @@ absence.
 
 - Added a module for enabling Neovim's spellchecker
 
-- Added prettierd as an alternative formatter to prettier - currently defaults
+- Added prettierd as an alternative formatter to prettier - currently defaults to prettier
-  to prettier
 
 - Fixed presence.nvim inheriting the wrong client id
 

docs/release-notes/rl-0.5.md

@@ -16,35 +16,33 @@ Release notes for release 0.5
 
 - Fixed a bug where cmp's close and scrollDocs mappings wasn't working
 
-- Streamlined and simplified extra plugin API with the addition of
+- Streamlined and simplified extra plugin API with the addition of [vim.extraPlugins](vim.extraPlugins)
-  [](#opt-vim.extraPlugins)
 
-- Allow using command names in place of LSP packages to avoid automatic
+- Allow using command names in place of LSP packages to avoid automatic installation
-  installation
 
-- Add lua LSP and Treesitter support, and neodev.nvim plugin support
+- Add lua LSP and treesitter support, and neodev.nvim plugin support
 
-- Add [](#opt-vim.lsp.mappings.toggleFormatOnSave) keybind
+- Add [vim.lsp.mappings.toggleFormatOnSave](vim.lsp.mappings.toggleFormatOnSave) keybind
 
 [amanse](https://github.com/amanse):
 
 - Added daily notes options for obsidian plugin
 
-- Added `jdt-language-server` for Java
+- Added jdt-language-server for Java
 
 [yavko](https://github.com/yavko):
 
-- Added Deno Language Server for Javascript/Typescript
+- Added Deno Language Server for javascript/typescript
 
-- Added support for multiple languages under `vim.spellChecking.languages`, and
+- Added support for multiple languages [vim.spellChecking.languages](vim.spellChecking.languages), and added
-  added vim-dirtytalk through `vim.spellChecking.enableProgrammingWordList`
+  vim-dirtytalk through [vim.spellChecking.enableProgrammingWordList](vim.spellChecking.enableProgrammingWordList)
 
 [frothymarrow](https://github.com/FrothyMarrow):
 
-- Renamed `vim.visuals.cursorWordline` to `vim.visuals.cursorline.enable`
+- Renamed `vim.visuals.cursorWordline` to [vim.visuals.cursorline.enable](vim.visuals.cursorline.enable)
 
-- Added `vim.visuals.cursorline.lineNumbersOnly` to display cursorline only in
+- Added [vim.visuals.cursorline.lineNumbersOnly](vim.visuals.cursorline.lineNumbersOnly) to display cursorline
-  the presence of line numbers
+  only in the presence of line numbers
 
 - Added Oxocarbon to the list of available themes.
 
@@ -52,44 +50,38 @@ Release notes for release 0.5
 
 - Added GitHub Copilot to nvim-cmp completion sources.
 
-- Added [](#opt-vim.ui.borders.enable) for global and individual plugin border
+- Added [vim.ui.borders.enable](vim.ui.borders.enable) for global and individual plugin border configuration.
-  configuration.
 
-- LSP integrated breadcrumbs with [](#opt-vim.ui.breadcrumbs.enable) through
+- LSP integrated breadcrumbs with [vim.ui.breadcrumbs.enable](vim.ui.breadcrumbs.enable) through nvim-navic
-  nvim-navic
 
-- LSP navigation helper with nvim-navbuddy, depends on nvim-navic (automatically
+- LSP navigation helper with nvim-navbuddy, depends on nvim-navic (automatically enabled if navic is enabled)
-  enabled if navic is enabled)
 
-- Added nvim-navic integration for Catppuccin theme
+- Addeed nvim-navic integration for catppuccin theme
 
-- Fixed mismatching Zig language description
+- Fixed mismatching zig language description
 
-- Added support for `statix` and `deadnix` through
+- Added support for `statix` and `deadnix` through [vim.languages.nix.extraDiagnostics.types](vim.languages.nix.extraDiagnostics.types)
-  [](#opt-vim.languages.nix.extraDiagnostics.types)
 
 - Added `lsp_lines` plugin for showing diagnostic messages
 
 - Added a configuration option for choosing the leader key
 
-- The package used for neovim is now customizable by the user, using
+- The package used for neovim is now customizable by the user, using [vim.package](vim.package).
-  [](#opt-vim.package). For best results, always use an unwrapped package
+  For best results, always use an unwrapped package
 
 - Added highlight-undo plugin for highlighting undo/redo targets
 
 - Added bash LSP and formatter support
 
-- Disabled Lualine LSP status indicator for Toggleterm buffer
+- Disabled Lualine LSP status indicator for toggleterm buffer
 
-- Added `nvim-docs-view`, a plugin to display LSP hover documentation in a side
+- Added `nvim-docs-view`, a plugin to display lsp hover documentation in a side panel
-  panel
 
-- Switched to `nixosOptionsDoc` in option documentation. To quote home-manager
+- Switched to `nixosOptionsDoc` in option documentation.
-  commit: "Output is mostly unchanged aside from some minor typographical and
+  To quote home-manager commit: "Output is mostly unchanged aside from some minor typographical and
   formatting changes, along with better source links."
 
-- Updated indent-blankine.nvim to v3 - this comes with a few option changes,
+- Updated indent-blankine.nvim to v3 - this comes with a few option changes, which will be migrated with `renamedOptionModule`
-  which will be migrated with `renamedOptionModule`
 
 [jacekpoz](https://jacekpoz.pl):
 
@@ -107,11 +99,9 @@ Release notes for release 0.5
 
 - Removed redundant "Enable ..." in `mkEnableOption` descriptions
 
-- Add options to modify LSP key bindings and add proper which-key descriptions
+- Add options to modify LSP key bindings and add proper whichkey descriptions
 
-- Changed type of `statusline.lualine.activeSection` and
+- Changed type of `statusline.lualine.activeSection` and `statusline.lualine.inactiveSection`
-  `statusline.lualine.inactiveSection` from `attrsOf str` to
+  from `attrsOf str` to `attrsOf (listOf str)`
-  `attrsOf (listOf str)`
 
-- Added `statusline.lualine.extraActiveSection` and
+- Added `statusline.lualine.extraActiveSection` and `statusline.lualine.extraInactiveSection`
-  `statusline.lualine.extraInactiveSection`

docs/release-notes/rl-0.6.md

@@ -4,21 +4,17 @@ Release notes for release 0.6
 
 ## Breaking Changes and Migration Guide {#sec-breaking-changes-and-migration-guide}
 
-In v0.6 we are introducing `setupOpts`: many plugin related options are moved
+In v0.6 we are introducing `setupOpts`: many plugin related options are moved into their respective `setupOpts`
-into their respective `setupOpts` submodule, e.g. `nvimTree.disableNetrw` is
+submodule, e.g. `nvimTree.disableNetrw` is renamed to `nvimTree.setupOpts.disable_netrw`.
-renamed to `nvimTree.setupOpts.disable_netrw`.
 
-_Why?_ in short, you can now pass in anything to setupOpts and it will be passed
+_Why?_ in short, you can now pass in anything to setupOpts and it will be passed to your `require'plugin'.setup{...}`.
-to your `require'plugin'.setup{...}`. No need to wait for us to support every
+No need to wait for us to support every single plugin option.
-single plugin option.
 
-The warnings when you rebuild your config should be enough to guide you through
+The warnings when you rebuild your config should be enough to guide you through what you need to do, if there's an
-what you need to do, if there's an option that was renamed but wasn't listed in
+option that was renamed but wasn't listed in the warning, please file a bug report!
-the warning, please file a bug report!
 
-To make your migration process less annoying, here's a keybind that will help
+To make your migration process less annoying, here's a keybind that will help you with renaming stuff from camelCase to
-you with renaming stuff from camelCase to snake_case (you'll be doing that a
+snake_case (you'll be doing that a lot):
-lot):
 
 ```lua
 -- paste this in a temp.lua file and load it in vim with :source /path/to/temp.lua
@@ -47,9 +43,8 @@ vim.api.nvim_set_keymap('n', '<leader>a', ':lua camelToSnake()<CR>', { noremap =
 
 - Added Terraform language support.
 
-- Added `ChatGPT.nvim`, which can be enabled with
+- Added `ChatGPT.nvim`, which can be enabled with [`vim.assistant.chatgpt`](vim.assistant.chatgpt). Do
-  [](#opt-vim.assistant.chatgpt.enable). Do keep in mind that this option
+  keep in mind that this option requires `OPENAI_API_KEY` environment variable to be set.
-  requires `OPENAI_API_KEY` environment variable to be set.
 
 [donnerinoern](https://github.com/donnerinoern):
 
@@ -57,13 +52,11 @@ vim.api.nvim_set_keymap('n', '<leader>a', ':lua camelToSnake()<CR>', { noremap =
 
 - Added marksman LSP for Markdown.
 
-- Fixed markdown preview with Glow not working and added an option for changing
+- Fixed markdown preview with Glow not working and added an option for changing the preview keybind.
-  the preview keybind.
 
 - colorizer.nvim: switched to a maintained fork.
 
-- Added `markdown-preview.nvim`, moved `glow.nvim` to a brand new
+- Added `markdown-preview.nvim`, moved `glow.nvim` to a brand new `vim.utility.preview` category.
-  `vim.utility.preview` category.
 
 [elijahimmer](https://github.com/elijahimmer)
 
@@ -71,8 +64,7 @@ vim.api.nvim_set_keymap('n', '<leader>a', ':lua camelToSnake()<CR>', { noremap =
 
 [jacekpoz](https://jacekpoz.pl):
 
-- Added `vim.autocomplete.alwaysComplete`. Allows users to have the autocomplete
+- Added `vim.autocomplete.alwaysComplete`. Allows users to have the autocomplete window popup only when manually activated.
-  window popup only when manually activated.
 
 [horriblename](https://github.com/horriblename):
 
@@ -88,14 +80,11 @@ vim.api.nvim_set_keymap('n', '<leader>a', ':lua camelToSnake()<CR>', { noremap =
 
 - Added option `vim.luaPackages` to wrap neovim with extra Lua packages.
 
-- Rewrote the entire `fidget.nvim` module to include extensive configuration
+- Rewrote the entire `fidget.nvim` module to include extensive configuration options. Option `vim.fidget-nvim.align.bottom` has
-  options. Option `vim.fidget-nvim.align.bottom` has been removed in favor of
+  been removed in favor of [vim.fidget-nvim.notification.window.align](vim.fidget-nvim.notification.window.align), which now supports
-  `vim.fidget-nvim.notification.window.align`, which now supports `top` and
+  `top` and `bottom` values. `vim.fidget-nvim.align.right` has no longer any equivalent and also has been removed.
-  `bottom` values. `vim.fidget-nvim.align.right` has no longer any equivalent
-  and also has been removed.
 
-- `which-key.nvim` categories can now be customized through
+- `which-key.nvim` categories can now be customized through [vim.binds.whichKey.register](vim.binds.whichKey.register)
-  [vim.binds.whichKey.register](#opt-vim.binds.whichKey.register)
 
 - Added `magick` to `vim.luaPackages` for `image.nvim`.
 
@@ -105,79 +94,65 @@ vim.api.nvim_set_keymap('n', '<leader>a', ':lua camelToSnake()<CR>', { noremap =
 
 [notashelf](https://github.com/notashelf):
 
-- Finished moving to `nixosOptionsDoc` in the documentation and changelog. All
+- Finished moving to `nixosOptionsDoc` in the documentation and changelog. All documentation options
-  documentation options and files are fully free of Asciidoc, and will now use
+  and files are fully free of Asciidoc, and will now use Nixpkgs flavored markdown.
-  Nixpkgs flavored markdown.
 
 - Bumped plugin inputs to their latest versions.
 
-- Deprecated `presence.nvim` in favor of `neocord`. This means
+- Deprecated `presence.nvim` in favor of `neocord`. This means `vim.rich-presence.presence-nvim` is removed and will throw
-  `vim.rich-presence.presence-nvim` is removed and will throw a warning if used.
+  a warning if used. You are recommended to rewrite your neocord configuration from scratch based on the.
-  You are recommended to rewrite your neocord configuration from scratch based
+  [official documentation](https://github.com/IogaMaster/neocord)
-  on the. [official documentation](https://github.com/IogaMaster/neocord)
 
-- Removed Tabnine plugin due to the usage of imperative tarball downloads. If
+- Removed Tabnine plugin due to the usage of imperative tarball downloads. If you'd like to see it back, please create an issue.
-  you'd like to see it back, please create an issue.
 
-- Added support for css and tailwindcss through
+- Added support for css and tailwindcss through vscode-language-servers-extracted & tailwind-language-server.
-  vscode-language-servers-extracted & tailwind-language-server. Those can be
+  Those can be enabled through `vim.languages.css` and `vim.languages.tailwind`.
-  enabled through `vim.languages.css` and `vim.languages.tailwind`.
 
-- Lualine module now allows customizing `always_divide_middle`, `ignore_focus`
+- Lualine module now allows customizing `always_divide_middle`, `ignore_focus` and `disabled_filetypes` through the new
-  and `disabled_filetypes` through the new options:
+  options: [vim.statusline.lualine.alwaysDivideMiddle](vim.statusline.lualine.alwaysDivideMiddle),
-  [vim.statusline.lualine.alwaysDivideMiddle](#opt-vim.statusline.lualine.alwaysDivideMiddle),
+  [vim.statusline.lualine.ignoreFocus](vim.statusline.lualine.ignoreFocus) and
-  [vim.statusline.lualine.ignoreFocus](#opt-vim.statusline.lualine.ignoreFocus)
+  [vim.statusline.lualine.disabledFiletypes](vim.statusline.lualine.disabledFiletypes).
-  and
-  [vim.statusline.lualine.disabledFiletypes](#opt-vim.statusline.lualine.disabledFiletypes).
 
-- Updated all plugin inputs to their latest versions (**21.04.2024**) - this
+- Updated all plugin inputs to their latest versions (**21.04.2024**) - this brought minor color changes to the Catppuccin
-  brought minor color changes to the Catppuccin theme.
+  theme.
 
-- Moved home-manager module entrypoint to `flake/modules` and added an
+- Moved home-manager module entrypoint to `flake/modules` and added an experimental Nixos module. This requires further testing
-  experimental Nixos module. This requires further testing before it can be
+  before it can be considered ready for use.
-  considered ready for use.
 
-- Made lib calls explicit. E.g. `lib.strings.optionalString` instead of
+- Made lib calls explicit. E.g. `lib.strings.optionalString` instead of `lib.optionalString`. This is a pattern expected
-  `lib.optionalString`. This is a pattern expected to be followed by all
+  to be followed by all contributors in the future.
-  contributors in the future.
 
 - Added `image.nvim` for image previews.
 
-- The final neovim package is now exposed. This means you can build the neovim
+- The final neovim package is now exposed. This means you can build the neovim package that will be added to your
-  package that will be added to your package list without rebuilding your system
+  package list without rebuilding your system to test if your configuration yields a broken package.
-  to test if your configuration yields a broken package.
 
-- Changed the tree structure to distinguish between core options and plugin
+- Changed the tree structure to distinguish between core options and plugin options.
-  options.
 
 - Added plugin auto-discovery from plugin inputs. This is mostly from
-  [JordanIsaac's neovim-flake](https://github.com/jordanisaacs/neovim-flake).
+  [JordanIsaac's neovim-flake](https://github.com/jordanisaacs/neovim-flake). Allows contributors to add plugin inputs
-  Allows contributors to add plugin inputs with the `plugin-` prefix to have
+  with the `plugin-` prefix to have them automatically discovered for the `plugin` type in `lib/types`.
-  them automatically discovered for the `plugin` type in `lib/types`.
 
-- Moved internal `wrapLuaConfig` to the extended library, structured its
+- Moved internal `wrapLuaConfig` to the extended library, structured its arguments to take `luaBefore`, `luaConfig`
-  arguments to take `luaBefore`, `luaConfig` and `luaAfter` as strings, which
+  and `luaAfter` as strings, which are then concatted inside a lua block.
-  are then concatted inside a lua block.
 
-- Added [](#opt-vim.luaConfigPre) and [](#opt-vim.luaConfigPost) for inserting
+- Added [`vim.luaConfigBefore`](vim.luaConfigBefore) and [`vim.luaConfigAfter`](vim.luaConfigAfter)
-  verbatim Lua configuration before and after the resolved Lua DAG respectively.
+  for inserting verbatim Lua configuration before and after the resolved Lua DAG respectively. Both of those options
-  Both of those options take strings as the type, so you may read the contents
+  take strings as the type, so you may read the contents of a Lua file from a given path.
-  of a Lua file from a given path.
 
-- Added `vim.spellchecking.ignoredFiletypes` and
+- Added [`vim.spellChecking.ignoredFiletypes`](vim.spellChecking.ignoredFiletypes)
-  `vim.spellChecking.programmingWordlist.enable` for ignoring certain filetypes
+  and [`vim.spellChecking.programmingWordlist.enable`](vim.spellChecking.programmingWordlist.enable) for ignoring certain filetypes
-  in spellchecking and enabling `vim-dirtytalk` respectively. The previously
+  in spellchecking and enabling `vim-dirtytalk` respectively. The previously used `vim.spellcheck.vim-dirtytalk` aliases to the latter
-  used `vim.spellcheck.vim-dirtytalk` aliases to the latter option.
+  option.
 
-- Exposed `withRuby`, `withNodeJs`, `withPython3`, and `python3Packages` from
+- Exposed `withRuby`, `withNodeJs`, `withPython3`, and `python3Packages` from the `makeNeovimConfig` function under their respective options.
-  the `makeNeovimConfig` function under their respective options.
 
-- Added [](#opt-vim.extraPackages) for appending additional packages to the
+- Added [`vim.extraPackages`](vim.extraPackages) for appending additional packages to the wrapper PATH, making said packages available
-  wrapper PATH, making said packages available while inside the Neovim session.
+  while inside the Neovim session.
 
-- Made Treesitter options configurable, and moved treesitter-context to
+- Made treesitter options configurable, and moved `treesitter-context to
-  `setupOpts` while it is enabled.
+`setupOpts` while it is enabled.
 
-- Added [](#opt-vim.notify.nvim-notify.setupOpts.render) which takes either a
+- Added `vim.notify.nvim-notify.setupOpts.render` which takes either a string of enum or
-  string of enum, or a Lua function. The default is "compact", but you may
+  a lua function. The default is "compact", but you may change it according to
-  change it according to nvim-notify documentation.
+  nvim-notify documentation.

docs/release-notes/rl-0.7.md

@@ -81,40 +81,6 @@ favor of nixfmt (more information can be found
 To migrate to `nixfmt`, simply change `vim.languages.nix.format.type` to
 `nixfmt`.
 
-### leader changes {#sec-leader-changes}
-
-This has been deprecated in favor of using the more generic `vim.globals` (you
-can use `vim.globals.mapleader` to change this instead).
-
-Rust specific keymaps now use `maplocalleader` instead of `localleader` by
-default. This is to avoid conflicts with other modules. You can change
-`maplocalleader` with `vim.globals.maplocalleader`, but it's recommended to set
-it to something other than `mapleader` to avoid conflicts.
-
-### `vim.*` changes {#sec-vim-opt-changes}
-
-Inline with the [leader changes](#sec-leader-changes), we have removed some
-options that were under `vim` as convenient shorthands for `vim.o.*` options.
-
-::: {.warning}
-
-As v0.7 features the addition of [](#opt-vim.options), those options are now
-considered as deprecated. You should migrate to the appropriate options in the
-`vim.options` submodule.
-
-:::
-
-The changes are, in no particular order:
-
-- `colourTerm`, `mouseSupport`, `cmdHeight`, `updateTime`, `mapTime`,
-  `cursorlineOpt`, `splitBelow`, `splitRight`, `autoIndent` and `wordWrap` have
-  been mapped to their [](#opt-vim.options) equivalents. Please see the module
-  definition for the updated options.
-
-- `tabWidth` has been **removed** as it lead to confusing behaviour. You can
-  replicate the same functionality by setting `shiftwidth`, `tabstop` and
-  `softtabstop` under `vim.options` as you see fit.
-
 ## Changelog {#sec-release-0.7-changelog}
 
 [ItsSorae](https://github.com/ItsSorae):
@@ -157,10 +123,9 @@ The changes are, in no particular order:
   recommended to go through rustacean.nvim's README to take a closer look at its
   features and usage
 
-[lz.n]: https://github.com/mrcjkb/lz.n
-
 - Add [lz.n] support and lazy-load some builtin plugins.
-- Add simpler helper functions for making keymaps
+
+[lz.n]: https://github.com/mrcjkb/lz.n
 
 [jacekpoz](https://jacekpoz.pl):
 
@@ -236,9 +201,6 @@ The changes are, in no particular order:
   is bundled with nvf, if you enable the module, since there is no way to
   provide only the LSP server.
 
-- Add [`run.nvim`](https://github.com/diniamo/run.nvim) support for running code
-  using cached commands.
-
 [Neovim documentation on `vim.cmd`]: https://neovim.io/doc/user/lua.html#vim.cmd()
 
 - Make Neovim's configuration file entirely Lua based. This comes with a few
@@ -325,27 +287,21 @@ The changes are, in no particular order:
   spellfiles to Neovim's runtime with ease.
 
 - Add combined nvf configuration (`config.vim`) into the final package's
-  `passthru` as `passthru.neovimConfiguration` for easier debugging.
+  passthru as `passthru.neovimConfiguration` for easier debugging.
 
 - Add support for [tiny-devicons-auto-colors] under
   `vim.visuals.tiny-devicons-auto-colors`
 
-- Move options that used to set `vim.o` values (e.g. `vim.wordWrap`) into
-  `vim.options` as default values. Some are left as they don't have a direct
-  equivalent, but expect a switch eventually.
-
 [ppenguin](https://github.com/ppenguin):
 
 - Telescope:
   - Fixed `project-nvim` command and keybinding
   - Added default ikeybind/command for `Telescope resume` (`<leader>fr`)
-- Add `hcl` lsp/formatter (not the same as `terraform`, which is not useful for
-  e.g. `nomad` config files).
 
 [Soliprem](https://github.com/Soliprem):
 
 - Add LSP and Treesitter support for R under `vim.languages.R`.
-  - Add formatter support for R, with styler and formatR as options
+  - Add formatter suppoort for R, with styler and formatR as options
 - Add Otter support under `vim.lsp.otter` and an assert to prevent conflict with
   ccc
 - Fixed typo in Otter's setupOpts
@@ -358,7 +314,6 @@ The changes are, in no particular order:
   the Typst language module.
 - Add LSP and Treesitter support for Assembly under `vim.languages.assembly`
 - Move [which-key](https://github.com/folke/which-key.nvim) to the new spec
-- Add LSP and Treesitter support for Nushell under `vim.languages.nu`
 
 [Bloxx12](https://github.com/Bloxx12)
 

docs/static/script/anchor-use.js

@@ -1,4 +0,0 @@
-document.addEventListener('DOMContentLoaded', function(event) {
-  anchors.add('h1[id]:not(div.note h1, div.warning h1, div.tip h1, div.caution h1, div.important h1), h2[id]:not(div.note h2, div.warning h2, div.tip h2, div.caution h2, div.important h2), h3[id]:not(div.note h3, div.warning h3, div.tip h3, div.caution h3, div.important h3), h4[id]:not(div.note h4, div.warning h4, div.tip h4, div.caution h4, div.important h4), h5[id]:not(div.note h5, div.warning h5, div.tip h5, div.caution h5, div.important h5), h6[id]:not(div.note h6, div.warning h6, div.tip h6, div.caution h6, div.important h6)');
-});
-

docs/static/style.scss

@@ -1,5 +1,3 @@
-@use "scss-reset/reset";
-
 :root {
 	--nmd-color0: #0a3e68;
 	--nmd-color1: #268598;
@@ -34,6 +32,8 @@ $color-blue-700: #1d4ed8;
 $color-blue-800: #1e40af;
 $color-blue-900: #1e3a8a;
 
+@use "scss-reset/reset";
+
 @mixin boxed {
 	background: $color-gray-50;
 	margin: 2rem 16px;

docs/static/tomorrow-night.min.css

@@ -4,4 +4,99 @@
   License: ~ MIT (or more permissive) [via base16-schemes-source]
   Maintainer: @highlightjs/core-team
   Version: 2021.09.0
-*/pre code.hljs{display:block;overflow-x:auto;padding:1em}code.hljs{padding:3px 5px}.hljs{color:#ccc;background:#2d2d2d}.hljs ::selection,.hljs::selection{background-color:#515151;color:#ccc}.hljs-comment{color:#999}.hljs-tag{color:#b4b7b4}.hljs-operator,.hljs-punctuation,.hljs-subst{color:#ccc}.hljs-operator{opacity:.7}.hljs-bullet,.hljs-deletion,.hljs-name,.hljs-selector-tag,.hljs-template-variable,.hljs-variable{color:#f2777a}.hljs-attr,.hljs-link,.hljs-literal,.hljs-number,.hljs-symbol,.hljs-variable.constant_{color:#f99157}.hljs-class .hljs-title,.hljs-title,.hljs-title.class_{color:#fc6}.hljs-strong{font-weight:700;color:#fc6}.hljs-addition,.hljs-code,.hljs-string,.hljs-title.class_.inherited__{color:#9c9}.hljs-built_in,.hljs-doctag,.hljs-keyword.hljs-atrule,.hljs-quote,.hljs-regexp{color:#6cc}.hljs-attribute,.hljs-function .hljs-title,.hljs-section,.hljs-title.function_,.ruby .hljs-property{color:#69c}.diff .hljs-meta,.hljs-keyword,.hljs-template-tag,.hljs-type{color:#c9c}.hljs-emphasis{color:#c9c;font-style:italic}.hljs-meta,.hljs-meta .hljs-keyword,.hljs-meta .hljs-string{color:#a3685a}.hljs-meta .hljs-keyword,.hljs-meta-keyword{font-weight:700}
+*/
+pre code.hljs {
+	display: block;
+	overflow-x: auto;
+	padding: 1em;
+}
+code.hljs {
+	padding: 3px 5px;
+}
+.hljs {
+	color: #ccc;
+	background: #2d2d2d;
+}
+.hljs ::selection,
+.hljs::selection {
+	background-color: #515151;
+	color: #ccc;
+}
+.hljs-comment {
+	color: #999;
+}
+.hljs-tag {
+	color: #b4b7b4;
+}
+.hljs-operator,
+.hljs-punctuation,
+.hljs-subst {
+	color: #ccc;
+}
+.hljs-operator {
+	opacity: 0.7;
+}
+.hljs-bullet,
+.hljs-deletion,
+.hljs-name,
+.hljs-selector-tag,
+.hljs-template-variable,
+.hljs-variable {
+	color: #f2777a;
+}
+.hljs-attr,
+.hljs-link,
+.hljs-literal,
+.hljs-number,
+.hljs-symbol,
+.hljs-variable.constant_ {
+	color: #f99157;
+}
+.hljs-class .hljs-title,
+.hljs-title,
+.hljs-title.class_ {
+	color: #fc6;
+}
+.hljs-strong {
+	font-weight: 700;
+	color: #fc6;
+}
+.hljs-addition,
+.hljs-code,
+.hljs-string,
+.hljs-title.class_.inherited__ {
+	color: #9c9;
+}
+.hljs-built_in,
+.hljs-doctag,
+.hljs-keyword.hljs-atrule,
+.hljs-quote,
+.hljs-regexp {
+	color: #6cc;
+}
+.hljs-attribute,
+.hljs-function .hljs-title,
+.hljs-section,
+.hljs-title.function_,
+.ruby .hljs-property {
+	color: #69c;
+}
+.diff .hljs-meta,
+.hljs-keyword,
+.hljs-template-tag,
+.hljs-type {
+	color: #c9c;
+}
+.hljs-emphasis {
+	color: #c9c;
+	font-style: italic;
+}
+.hljs-meta,
+.hljs-meta .hljs-keyword,
+.hljs-meta .hljs-string {
+	color: #a3685a;
+}
+.hljs-meta .hljs-keyword,
+.hljs-meta-keyword {
+	font-weight: 700;
+}

flake.lock

@@ -23,11 +23,11 @@
         "systems": "systems"
       },
       "locked": {
-        "lastModified": 1731533236,
+        "lastModified": 1726560853,
-        "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",
+        "narHash": "sha256-X6rJYSESBVr3hBoH0WbKE5KvhPU5bloyZ2L4K60/fPQ=",
         "owner": "numtide",
         "repo": "flake-utils",
-        "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",
+        "rev": "c1dfcf08411b08f6b8615f7d8971a2bfa81d5e8a",
         "type": "github"
       },
       "original": {
@@ -38,11 +38,11 @@
     },
     "mnw": {
       "locked": {
-        "lastModified": 1733021555,
+        "lastModified": 1731182209,
-        "narHash": "sha256-bc+reHXXfdn94MnDsqBrNm2ojOnJfbd64e00nzsP0EI=",
+        "narHash": "sha256-yftvwv8bHEKjmSKREdkGLWTDhf7vA2Ssvl/XMpykigg=",
         "owner": "Gerg-L",
         "repo": "mnw",
-        "rev": "6841d93fe50eb335da45e11d4dabaa1844f3f79a",
+        "rev": "0a5e50286ca9f1b70eb4fa29ce84304cad657700",
         "type": "github"
       },
       "original": {
@@ -83,11 +83,11 @@
         "rust-overlay": "rust-overlay"
       },
       "locked": {
-        "lastModified": 1732053863,
+        "lastModified": 1726716330,
-        "narHash": "sha256-DCIVdlb81Fct2uwzbtnawLBC/U03U2hqx8trqTJB7WA=",
+        "narHash": "sha256-mIuOP4I51eFLquRaxMKx67pHmhatZrcVPjfHL98v/M8=",
         "owner": "oxalica",
         "repo": "nil",
-        "rev": "2e24c9834e3bb5aa2a3701d3713b43a6fb106362",
+        "rev": "c8e8ce72442a164d89d3fdeaae0bcc405f8c015a",
         "type": "github"
       },
       "original": {
@@ -98,11 +98,11 @@
     },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1733024928,
+        "lastModified": 1730958623,
-        "narHash": "sha256-n/DOfpKH1vkukuBnach91QBQId2dr5tkE7/7UrkV2zw=",
+        "narHash": "sha256-JwQZIGSYnRNOgDDoIgqKITrPVil+RMWHsZH1eE1VGN0=",
         "owner": "nixos",
         "repo": "nixpkgs",
-        "rev": "2c27ab2e60502d1ebb7cf38909de38663f762a79",
+        "rev": "85f7e662eda4fa3a995556527c87b2524b691933",
         "type": "github"
       },
       "original": {
@@ -159,11 +159,11 @@
     "plugin-alpha-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1731604504,
+        "lastModified": 1727720738,
-        "narHash": "sha256-sNi5qarejYqM4/J7lBZI3gjVLxer5FBPq8K6qjqcMjA=",
+        "narHash": "sha256-33lhPP1C4TGo0UQJ61bwRHaiOMAB7XNehcZGaFXOPjQ=",
         "owner": "goolord",
         "repo": "alpha-nvim",
-        "rev": "de72250e054e5e691b9736ee30db72c65d560771",
+        "rev": "bf3c8bb8c02ed3d9644cc5bbc48e2bdc39349cd7",
         "type": "github"
       },
       "original": {
@@ -207,11 +207,11 @@
     "plugin-catppuccin": {
       "flake": false,
       "locked": {
-        "lastModified": 1732428187,
+        "lastModified": 1731169755,
-        "narHash": "sha256-Oogw5wmYkx/zsMlPE/r6Kt3cy5sC92rwVzf0P9rzqyw=",
+        "narHash": "sha256-lsnePejThsEygTCKV/rfJJ/h+RSrro91am841iznJe4=",
         "owner": "catppuccin",
         "repo": "nvim",
-        "rev": "faf15ab0201b564b6368ffa47b56feefc92ce3f4",
+        "rev": "637d99e638bc6f1efedac582f6ccab08badac0c6",
         "type": "github"
       },
       "original": {
@@ -463,11 +463,11 @@
     "plugin-csharpls-extended": {
       "flake": false,
       "locked": {
-        "lastModified": 1732674428,
+        "lastModified": 1730857197,
-        "narHash": "sha256-d7ll3OlOLx/7E+6+uga26L/FAqd8pZ4XquMakxMsFwU=",
+        "narHash": "sha256-eKkFpEB7ZXNttXz62y3GaKptt4n0xRY+iuTI8RU5z0Q=",
         "owner": "Decodetalkers",
         "repo": "csharpls-extended-lsp.nvim",
-        "rev": "c788fed627827238de348195c3f318cd090e8e77",
+        "rev": "ef02017d80b1cd914d61285b1fb063cb7fe0aa8f",
         "type": "github"
       },
       "original": {
@@ -511,11 +511,11 @@
     "plugin-dracula": {
       "flake": false,
       "locked": {
-        "lastModified": 1731308832,
+        "lastModified": 1729038981,
-        "narHash": "sha256-3Tlk+utoF4QUjTIPszbyMDh5vUyNiBmq4bRW/leMjaU=",
+        "narHash": "sha256-3jFOaFtH+EIx4mUKV0U/cFkUo8By0JgorTYgFUKEs/s=",
         "owner": "Mofiqul",
         "repo": "dracula.nvim",
-        "rev": "e6128ec3923b92bb2b16e81b4a0f04ed0308038e",
+        "rev": "94fa7885a06a67f0a8bfa03e064619d05d1ba496",
         "type": "github"
       },
       "original": {
@@ -527,11 +527,11 @@
     "plugin-dressing-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1731521499,
+        "lastModified": 1730759661,
-        "narHash": "sha256-O0sdxU+ZQnclnnC5IfBpgqlMxjsJKlmPYQYPP+S3cn8=",
+        "narHash": "sha256-F9mdyANs9QTzlB/VAXt+9GXJUiA5th7Fj79WArdUmRE=",
         "owner": "stevearc",
         "repo": "dressing.nvim",
-        "rev": "fc78a3ca96f4db9f8893bb7e2fd9823e0780451b",
+        "rev": "6ef1ca479d37d4ff66f13eed44d08912caff483a",
         "type": "github"
       },
       "original": {
@@ -559,11 +559,11 @@
     "plugin-fastaction-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1732135971,
+        "lastModified": 1731000037,
-        "narHash": "sha256-Q+FX7XiX8LyTC4OZ43Q2pXIdSViDn65P9pkDp8jvbnA=",
+        "narHash": "sha256-oNLKwWj2lze/ZCcwT98ucw6oT4765EiW1CB0BAjox8A=",
         "owner": "Chaitanyabsprip",
         "repo": "fastaction.nvim",
-        "rev": "24255a74e0d35f1e1807aa78997f5c31ae419dbc",
+        "rev": "a55feac91f39b83aa21b9ef3df1e465d9122753c",
         "type": "github"
       },
       "original": {
@@ -591,11 +591,11 @@
     "plugin-flutter-tools": {
       "flake": false,
       "locked": {
-        "lastModified": 1732910301,
+        "lastModified": 1730275333,
-        "narHash": "sha256-iU0aTq3F5U2z8iKdUMxkvQ8ZopmWIGdx1I8ir0q7n0U=",
+        "narHash": "sha256-fKsC+ouSfW07dLipXP+RPMzQfCQ70oGknSdVo7dMAxw=",
         "owner": "akinsho",
         "repo": "flutter-tools.nvim",
-        "rev": "40f974b15f82f9af498adda8d93aabd637f3ab58",
+        "rev": "7e6d8611d8606efca64cb8cf1ca07550b7087d1c",
         "type": "github"
       },
       "original": {
@@ -623,11 +623,11 @@
     "plugin-gesture-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1731669851,
+        "lastModified": 1726696689,
-        "narHash": "sha256-LTkttlDmKO9ngzrJrMWeeG9R0Bz/PoroCAF2URhUEbM=",
+        "narHash": "sha256-d1+czQXyJUyNlMhPjRzb6cEiCJVTFrkYnv7XXh2BLNs=",
         "owner": "notomo",
         "repo": "gesture.nvim",
-        "rev": "dbd839bda337cb73911aeef06897eb29cb99f76f",
+        "rev": "a63d81325a1f84ad87a7d9e1a36e4eeb4e786fc1",
         "type": "github"
       },
       "original": {
@@ -639,11 +639,11 @@
     "plugin-gitsigns-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1732361574,
+        "lastModified": 1730713501,
-        "narHash": "sha256-H7A+AxioiedSuC+jqRwP4c7DjZR/0j4o/fTUasT2urc=",
+        "narHash": "sha256-FHzufzeVrPnbU5j3UabVTCYXP+QNcb7gMgef0BmuclA=",
         "owner": "lewis6991",
         "repo": "gitsigns.nvim",
-        "rev": "5f808b5e4fef30bd8aca1b803b4e555da07fc412",
+        "rev": "4daf7022f1481edf1e8fb9947df13bb07c18e89a",
         "type": "github"
       },
       "original": {
@@ -671,11 +671,11 @@
     "plugin-gruvbox": {
       "flake": false,
       "locked": {
-        "lastModified": 1732485864,
+        "lastModified": 1727809136,
-        "narHash": "sha256-qasIg1nvAlUWUUzSZLF36jnoNm8PmQa3owgh0tKGgHk=",
+        "narHash": "sha256-/kgZuNJ1vHyOpvFHiJKCb1HzjSPgqis9Ng4aT7jHXG4=",
         "owner": "ellisonleao",
         "repo": "gruvbox.nvim",
-        "rev": "68c3460a5d1d1a362318960035c9f3466d5011f5",
+        "rev": "49d9c0b150ba70efcd831ec7b3cb8ee740067045",
         "type": "github"
       },
       "original": {
@@ -687,11 +687,11 @@
     "plugin-highlight-undo": {
       "flake": false,
       "locked": {
-        "lastModified": 1732378966,
+        "lastModified": 1729426343,
-        "narHash": "sha256-b0JrMu3vbbYgyHPs9hyayMzUypFwugEAxvZOcuRMc/o=",
+        "narHash": "sha256-zNzVmt4WJcspuloePhc6HbDvNA7B92NscE+fEYvCumc=",
         "owner": "tzachar",
         "repo": "highlight-undo.nvim",
-        "rev": "5f588b420179a31d7073854bfd07ed9d5f364645",
+        "rev": "c87a6ec1ded241ef223269077cbd5f97a6f0d5bf",
         "type": "github"
       },
       "original": {
@@ -735,11 +735,11 @@
     "plugin-image-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1732136347,
+        "lastModified": 1730854538,
-        "narHash": "sha256-Az/jiHW/DtvHNlV+Wzw6U+p8b2Ic9pNJRQ6YGerL81c=",
+        "narHash": "sha256-G7Nqs8BqLCR46vw6VVazvdGOpan6Wkkv/PfJB+nBbGE=",
         "owner": "3rd",
         "repo": "image.nvim",
-        "rev": "5f8fceca2d1be96a45b81de21c2f98bf6084fb34",
+        "rev": "9c9dbed0cdb4dbd199ebfc678a881f5745a36f50",
         "type": "github"
       },
       "original": {
@@ -751,11 +751,11 @@
     "plugin-indent-blankline": {
       "flake": false,
       "locked": {
-        "lastModified": 1731320409,
+        "lastModified": 1730170343,
-        "narHash": "sha256-WVDNi/woG0ohPEYzM83mmXDCRNYnQbqooSDVUtBsJbY=",
+        "narHash": "sha256-odv43EyZ3gMg410eBFAkye/SdAj+LcVVZPaZm8w0biM=",
         "owner": "lukas-reineke",
         "repo": "indent-blankline.nvim",
-        "rev": "7871a88056f7144defca9c931e311a3134c5d509",
+        "rev": "04e44b09ee3ff189c69ab082edac1ef7ae2e256c",
         "type": "github"
       },
       "original": {
@@ -879,11 +879,11 @@
     "plugin-luasnip": {
       "flake": false,
       "locked": {
-        "lastModified": 1732967555,
+        "lastModified": 1730895001,
-        "narHash": "sha256-iWivJ6dIOEqT3uLQA5KzvCHkDcjC62OlNWagEW680qc=",
+        "narHash": "sha256-Vb4unHnhppcM1HZtd8oohJHPlkUHORoYUjKUWyhRM6g=",
         "owner": "L3MON4D3",
         "repo": "LuaSnip",
-        "rev": "2592b91577136dbb355a4708be1e60619456b7f6",
+        "rev": "2737edc9e674e537dc0a97e3405658d57d2d31ed",
         "type": "github"
       },
       "original": {
@@ -895,11 +895,11 @@
     "plugin-lz-n": {
       "flake": false,
       "locked": {
-        "lastModified": 1733019070,
+        "lastModified": 1730598851,
-        "narHash": "sha256-Go9FBjF3EBFy+/53lpC5AdKYpJBK+uFzInTk6lODxdQ=",
+        "narHash": "sha256-L7og7ZTo5Soyn6pvBHkJcgGuON96eV0V5QC3J1uz/ko=",
         "owner": "nvim-neorocks",
         "repo": "lz.n",
-        "rev": "f308fa4dd81355fb5fddf3ca209847d679af6917",
+        "rev": "c8675c983e0682c49a13f17fc7ff9353bcb32120",
         "type": "github"
       },
       "original": {
@@ -976,11 +976,11 @@
     "plugin-neo-tree-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1732465535,
+        "lastModified": 1726542367,
-        "narHash": "sha256-3wRojpFbdjcRQPv62/mHqQgyfytTqaBcsX1X0zCNgC8=",
+        "narHash": "sha256-Lqt0KJNT9HmpJwZoWChYeVBrDWhscRe8COqVCwgcTwk=",
         "owner": "nvim-neo-tree",
         "repo": "neo-tree.nvim",
-        "rev": "42caaf5c3b7ca346ab278201151bb878006a6031",
+        "rev": "a77af2e764c5ed4038d27d1c463fa49cd4794e07",
         "type": "github"
       },
       "original": {
@@ -1024,11 +1024,11 @@
     "plugin-neorg": {
       "flake": false,
       "locked": {
-        "lastModified": 1732289702,
+        "lastModified": 1730333767,
-        "narHash": "sha256-8RQ+PFnIcjPoNJQB/qz+zv1fjVjFEwPhuAh+JL7GPL4=",
+        "narHash": "sha256-qTo8rxwvANrgP8UccFhzsNsH+Jbmqv2iOlw0ccLNYm4=",
         "owner": "nvim-neorg",
         "repo": "neorg",
-        "rev": "7a893a176a7d9c074a5371865b53c6aa4e223991",
+        "rev": "488507bb996f75ee29073f50dec32fa220867ca5",
         "type": "github"
       },
       "original": {
@@ -1072,11 +1072,11 @@
     "plugin-noice-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1732649160,
+        "lastModified": 1731163840,
-        "narHash": "sha256-0RLMkThaE6AxYvUKx056Ac63Oc2NTJxvgyRnZJ5/D2g=",
+        "narHash": "sha256-zT+fJ88V/LfmibXs4QpIyxCu1HHSjbqsrcQK/vadeRA=",
         "owner": "folke",
         "repo": "noice.nvim",
-        "rev": "c6f6fb178ebe9b4fd90383de743c3399f8c3a37c",
+        "rev": "2087bbf8cd64482b47fb5f33b5e0eabf329ab14b",
         "type": "github"
       },
       "original": {
@@ -1121,11 +1121,11 @@
     "plugin-nvim-autopairs": {
       "flake": false,
       "locked": {
-        "lastModified": 1731803843,
+        "lastModified": 1727742362,
-        "narHash": "sha256-LbaxiU3ienVBcMKrug3Coppc4R+MD2rjREw7rHQim1w=",
+        "narHash": "sha256-pqYOaEjKUd5YLVWX0Bf/kYT+sBlN1D24rOBuIz2BIqk=",
         "owner": "windwp",
         "repo": "nvim-autopairs",
-        "rev": "b464658e9b880f463b9f7e6ccddd93fb0013f559",
+        "rev": "ee297f215e95a60b01fde33275cc3c820eddeebe",
         "type": "github"
       },
       "original": {
@@ -1137,11 +1137,11 @@
     "plugin-nvim-bufferline-lua": {
       "flake": false,
       "locked": {
-        "lastModified": 1732824069,
+        "lastModified": 1729768480,
-        "narHash": "sha256-zqz2GMius0gLxtgxt12RmLUVQFVaWe+MQaGCfUGr6bI=",
+        "narHash": "sha256-MpSX8a51Avc9O1XxfWIDOVLiqD7omwAFIwSa02oXNs0=",
         "owner": "akinsho",
         "repo": "nvim-bufferline.lua",
-        "rev": "261a72b90d6db4ed8014f7bda976bcdc9dd7ce76",
+        "rev": "5cc447cb2b463cb499c82eaeabbed4f5fa6a0a44",
         "type": "github"
       },
       "original": {
@@ -1153,11 +1153,11 @@
     "plugin-nvim-cmp": {
       "flake": false,
       "locked": {
-        "lastModified": 1732948484,
+        "lastModified": 1730523275,
-        "narHash": "sha256-+0nflL0WCaxPuJgUviELhbXASNYYl/SKZ+nz70sEAXU=",
+        "narHash": "sha256-iNEoMl/X0nh2sAio1h+dkuobeOXRBXKFJCcElUyyW54=",
         "owner": "hrsh7th",
         "repo": "nvim-cmp",
-        "rev": "ca4d3330d386e76967e53b85953c170658255ecb",
+        "rev": "f17d9b4394027ff4442b298398dfcaab97e40c4f",
         "type": "github"
       },
       "original": {
@@ -1169,11 +1169,11 @@
     "plugin-nvim-colorizer-lua": {
       "flake": false,
       "locked": {
-        "lastModified": 1732386340,
+        "lastModified": 1730855006,
-        "narHash": "sha256-lAWeljYC17bmEs1Ss80o6eJYrJ9fsFlKvyJWu9e44XU=",
+        "narHash": "sha256-jDnTDUzslVa+4S2vAwqUZeJN+9Fxf5Naunf6uG54HLI=",
         "owner": "NvChad",
         "repo": "nvim-colorizer.lua",
-        "rev": "4acf88d31b3a7a1a7f31e9c30bf2b23c6313abdb",
+        "rev": "f134063618a65cad4d7415fddbd96ff7e0c5b4ae",
         "type": "github"
       },
       "original": {
@@ -1201,11 +1201,11 @@
     "plugin-nvim-dap": {
       "flake": false,
       "locked": {
-        "lastModified": 1732901614,
+        "lastModified": 1730842757,
-        "narHash": "sha256-atsgMdPyAAbh4dIxZOAE3hHLLb/664112lHdXHcXtZQ=",
+        "narHash": "sha256-WiypPzEQnModkzgI7ikq2C9OKc/DBeGLZ8ZaKmzHt2c=",
         "owner": "mfussenegger",
         "repo": "nvim-dap",
-        "rev": "0a0daa796a5919a51e5e5019ffa91219c94c4fef",
+        "rev": "8517126e9323e346f6a99b3b594c5a940b914dcd",
         "type": "github"
       },
       "original": {
@@ -1281,11 +1281,11 @@
     "plugin-nvim-lspconfig": {
       "flake": false,
       "locked": {
-        "lastModified": 1733062298,
+        "lastModified": 1730978746,
-        "narHash": "sha256-tLZYWbKSQxiRU1tQqRXAUSTfCS7a1tHNSIMbt0aOamU=",
+        "narHash": "sha256-N1vqosgHHVUWoszhdGImH//mb7hiSWWsG1Pq9WNnQxk=",
         "owner": "neovim",
         "repo": "nvim-lspconfig",
-        "rev": "90c1c6cc822b1836209514c096069b9bbeab63d9",
+        "rev": "d01864641c6e43c681c3e9f6cf4745c75fdd9dcc",
         "type": "github"
       },
       "original": {
@@ -1425,11 +1425,11 @@
     "plugin-nvim-surround": {
       "flake": false,
       "locked": {
-        "lastModified": 1732818349,
+        "lastModified": 1730136751,
-        "narHash": "sha256-sC+V86FEDfIapY4Qy0Ch2dTUpqe+C/xEUR/iSIEY6LA=",
+        "narHash": "sha256-XVwvoM3Id9lCi9EgK/Y944UuCXj9niTnZ5I5+d1yVqQ=",
         "owner": "kylechui",
         "repo": "nvim-surround",
-        "rev": "9f0cb495f25bff32c936062d85046fbda0c43517",
+        "rev": "dca2e998ff26681ee422b92c6ed39b3d2908d8a9",
         "type": "github"
       },
       "original": {
@@ -1441,11 +1441,11 @@
     "plugin-nvim-tree-lua": {
       "flake": false,
       "locked": {
-        "lastModified": 1732428058,
+        "lastModified": 1731123986,
-        "narHash": "sha256-HHgC7aH2m3gv2FtOK1jhjBgJOGWrdc+FQOEpMiEWe74=",
+        "narHash": "sha256-zt04Q3Mr1k9x6X6l3F9iy3C1edQYha4pQhDsOX5atPM=",
         "owner": "nvim-tree",
         "repo": "nvim-tree.lua",
-        "rev": "ca7c4c33cac2ad66ec69d45e465379716ef0cc97",
+        "rev": "c7639482a1598f4756798df1b2d72f79fe5bb34f",
         "type": "github"
       },
       "original": {
@@ -1457,11 +1457,11 @@
     "plugin-nvim-treesitter-context": {
       "flake": false,
       "locked": {
-        "lastModified": 1733041360,
+        "lastModified": 1731163983,
-        "narHash": "sha256-wcz3F0vDrgMXJjB0Zz7naoVQ8YvHdd55gG4NHqQMYQY=",
+        "narHash": "sha256-oRmhwRIynCNmgKpTtwUIliYf0Qo+zP3ymEWYs+vzx8A=",
         "owner": "nvim-treesitter",
         "repo": "nvim-treesitter-context",
-        "rev": "920999bf53daa63ddf12efdeb5137a7cea1cc201",
+        "rev": "158377d700596367a91ea41818f76abdbf75a232",
         "type": "github"
       },
       "original": {
@@ -1473,11 +1473,11 @@
     "plugin-nvim-ts-autotag": {
       "flake": false,
       "locked": {
-        "lastModified": 1732998473,
+        "lastModified": 1724798540,
-        "narHash": "sha256-HtF0arW9cuE4yQN+1ccRaonqiH6fcoTpyuSecLPKtKc=",
+        "narHash": "sha256-QEzUKvT+ChYSa9F4zg3Lw+7Sj0JzJem9nh2mWmS8Y+I=",
         "owner": "windwp",
         "repo": "nvim-ts-autotag",
-        "rev": "f2d24aca1bcbbd2c0306fd93d52e3697027b77ff",
+        "rev": "e239a560f338be31337e7abc3ee42515daf23f5e",
         "type": "github"
       },
       "original": {
@@ -1489,11 +1489,11 @@
     "plugin-nvim-web-devicons": {
       "flake": false,
       "locked": {
-        "lastModified": 1732925137,
+        "lastModified": 1728608318,
-        "narHash": "sha256-Sh+r54pTI60j5tOmSyEkTVS6MzMIt52nqjNdtMp8kpI=",
+        "narHash": "sha256-SUWEOp+QcfHjYaqqr4Zwvh0x91IAJXvrdMkQtuWMlGc=",
         "owner": "nvim-tree",
         "repo": "nvim-web-devicons",
-        "rev": "203da76ecfbb4b192cf830665b03eb651b635c94",
+        "rev": "19d257cf889f79f4022163c3fbb5e08639077bd8",
         "type": "github"
       },
       "original": {
@@ -1521,11 +1521,11 @@
     "plugin-omnisharp-extended": {
       "flake": false,
       "locked": {
-        "lastModified": 1732802864,
+        "lastModified": 1719701797,
-        "narHash": "sha256-lA22ncMWHz2oVcZMPQGpLL3UjjXOXGxhtXR1LX5cX3A=",
+        "narHash": "sha256-P1ZCaW8w+e3H3oBhbEjDc7vuR+XuxJmb/7IbPL3KWi4=",
         "owner": "Hoffs",
         "repo": "omnisharp-extended-lsp.nvim",
-        "rev": "4916fa12e5b28d21a1f031f0bdd10aa15a75d85d",
+        "rev": "aad7bf06b4ca0de816b919d475a75b30f5f62b61",
         "type": "github"
       },
       "original": {
@@ -1553,11 +1553,11 @@
     "plugin-orgmode-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1731656059,
+        "lastModified": 1730794385,
-        "narHash": "sha256-uKJuJsxQhdh3NxZx1Uu72poQVFN7KEyyMFEHPUr7UgQ=",
+        "narHash": "sha256-Rt/qhulJjNolQLz9OdP25U2+3KButPHgHc886yFpLpE=",
         "owner": "nvim-orgmode",
         "repo": "orgmode",
-        "rev": "1d8c9b9417f8c8e9fb146d4f54fb1e90a4f7e534",
+        "rev": "fafb8f14d85a68d8f0fca812444cc0fd594f0168",
         "type": "github"
       },
       "original": {
@@ -1633,11 +1633,11 @@
     "plugin-precognition-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1732647805,
+        "lastModified": 1730325090,
-        "narHash": "sha256-m3dKoKxCd/QODM+EL89c3RVOoZnuA4nrBG0KhPZ/o9Y=",
+        "narHash": "sha256-onY1Aa+dwLR1wRua52hpSXj6zZOZXjkUlDjDa0xEEcE=",
         "owner": "tris203",
         "repo": "precognition.nvim",
-        "rev": "531971e6d883e99b1572bf47294e22988d8fbec0",
+        "rev": "0189e8d6f96275a079b2805d68d49414871885cd",
         "type": "github"
       },
       "original": {
@@ -1710,30 +1710,14 @@
         "type": "github"
       }
     },
-    "plugin-run-nvim": {
-      "flake": false,
-      "locked": {
-        "lastModified": 1732918526,
-        "narHash": "sha256-kiszNmZZDXG8tAPMQKuGJDCkqCMzsWT7BkCvkVsH2lA=",
-        "owner": "diniamo",
-        "repo": "run.nvim",
-        "rev": "d867466e01b8fa4e54a589b9ef446cf43fb966de",
-        "type": "github"
-      },
-      "original": {
-        "owner": "diniamo",
-        "repo": "run.nvim",
-        "type": "github"
-      }
-    },
     "plugin-rustaceanvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1732919014,
+        "lastModified": 1731172933,
-        "narHash": "sha256-7UZ54b3IPS1cPyu+JCM/dHhJLHuqa16suaC2XlSw5Og=",
+        "narHash": "sha256-B2AdSgGPANCBbVN+Sd7gvJ16ODZZwv4WSOxnRs3SWnk=",
         "owner": "mrcjkb",
         "repo": "rustaceanvim",
-        "rev": "4ac7a3c6cca9e393229651cc90733afbdc7c6395",
+        "rev": "244443311f1c4e34ec1ea7f219a4b682b6ec066e",
         "type": "github"
       },
       "original": {
@@ -1761,11 +1745,11 @@
     "plugin-sqls-nvim": {
       "flake": false,
       "locked": {
-        "lastModified": 1733003065,
+        "lastModified": 1684697500,
-        "narHash": "sha256-VKN4ggWogAr+hwr/gtIDgY5j3afL9R7dZ2oJ4+qpEtE=",
+        "narHash": "sha256-jKFut6NZAf/eIeIkY7/2EsjsIhvZQKCKAJzeQ6XSr0s=",
         "owner": "nanotee",
         "repo": "sqls.nvim",
-        "rev": "8d7b6010d276fdda494ede23df511eba120886b9",
+        "rev": "4b1274b5b44c48ce784aac23747192f5d9d26207",
         "type": "github"
       },
       "original": {
@@ -1793,11 +1777,11 @@
     "plugin-telescope": {
       "flake": false,
       "locked": {
-        "lastModified": 1732884846,
+        "lastModified": 1730164948,
-        "narHash": "sha256-npb61MZYAotz71Co5G1dUeIqWt7GVeqZNz0A2Yz2dy4=",
+        "narHash": "sha256-Qa/f+0asQvA8mhIUajC4BGZCI92OqA6ySVoQSC3ZY3s=",
         "owner": "nvim-telescope",
         "repo": "telescope.nvim",
-        "rev": "2eca9ba22002184ac05eddbe47a7fe2d5a384dfc",
+        "rev": "85922dde3767e01d42a08e750a773effbffaea3e",
         "type": "github"
       },
       "original": {
@@ -1857,11 +1841,11 @@
     "plugin-tokyonight": {
       "flake": false,
       "locked": {
-        "lastModified": 1732026921,
+        "lastModified": 1730826006,
-        "narHash": "sha256-vKXlFHzga9DihzDn+v+j3pMNDfvhYHcCT8GpPs0Uxgg=",
+        "narHash": "sha256-BkSkC9UKcDExpIx91air280soPa8QIa3eK/e/E5QYLc=",
         "owner": "folke",
         "repo": "tokyonight.nvim",
-        "rev": "c2725eb6d086c8c9624456d734bd365194660017",
+        "rev": "ce91ba480070c95f40753e4663e32b4632ac6db3",
         "type": "github"
       },
       "original": {
@@ -1873,11 +1857,11 @@
     "plugin-trouble": {
       "flake": false,
       "locked": {
-        "lastModified": 1732701472,
+        "lastModified": 1730928038,
-        "narHash": "sha256-JhnERZfma2JHFEn/DElVmrSU5KxM2asx3SJ+86lCfoo=",
+        "narHash": "sha256-zUh0o+piRVDMSXLjBj+IygZj3VX7i5nXsaNn2pPu1fg=",
         "owner": "folke",
         "repo": "trouble.nvim",
-        "rev": "46cf952fc115f4c2b98d4e208ed1e2dce08c9bf6",
+        "rev": "3dc00c0447c016cd43e03054c3d49436a1f2076d",
         "type": "github"
       },
       "original": {
@@ -1889,11 +1873,11 @@
     "plugin-ts-error-translator": {
       "flake": false,
       "locked": {
-        "lastModified": 1731721659,
+        "lastModified": 1727112009,
-        "narHash": "sha256-fi68jJVNTL2WlTehcl5Q8tijAeu2usjIsWXjcuixkCM=",
+        "narHash": "sha256-8eUDQJYfhEsqv9G1QU96k5tTIcVa8oR8/SAoFN1XZ5I=",
         "owner": "dmmulroy",
         "repo": "ts-error-translator.nvim",
-        "rev": "47e5ba89f71b9e6c72eaaaaa519dd59bd6897df4",
+        "rev": "3bd23c4cfe4c2edc99278e01b75cdb2a26f03152",
         "type": "github"
       },
       "original": {
@@ -1921,11 +1905,11 @@
     "plugin-vim-fugitive": {
       "flake": false,
       "locked": {
-        "lastModified": 1732036604,
+        "lastModified": 1725670815,
-        "narHash": "sha256-RGS2T6tHuFPZROU0W4Z6j6wMEiJmd8xuKv3qqM3XHPI=",
+        "narHash": "sha256-ArYerBws+MBY4BpKh16J5TfVTrA0OFKPoZq7c2YQjp0=",
         "owner": "tpope",
         "repo": "vim-fugitive",
-        "rev": "320b18fba2a4f2fe3c8225c778c687e0d2620384",
+        "rev": "d4877e54cef67f5af4f950935b1ade19ed6b7370",
         "type": "github"
       },
       "original": {
@@ -2001,11 +1985,11 @@
     "plugin-which-key": {
       "flake": false,
       "locked": {
-        "lastModified": 1732804356,
+        "lastModified": 1730919714,
-        "narHash": "sha256-55RmbdN0rNG8946eIMFd5BlN82eY1GKqmHdUiC7BP+U=",
+        "narHash": "sha256-5t6UnOP2+CXB55/C4YWbp2pE+xKDLMvCJK8m085Fk4w=",
         "owner": "folke",
         "repo": "which-key.nvim",
-        "rev": "9b365a6428a9633e3eeb34dbef1b791511c54f70",
+        "rev": "68e37e12913a66b60073906f5d3f14dee0de19f2",
         "type": "github"
       },
       "original": {
@@ -2139,7 +2123,6 @@
         "plugin-registers": "plugin-registers",
         "plugin-rose-pine": "plugin-rose-pine",
         "plugin-rtp-nvim": "plugin-rtp-nvim",
-        "plugin-run-nvim": "plugin-run-nvim",
         "plugin-rustaceanvim": "plugin-rustaceanvim",
         "plugin-smartcolumn": "plugin-smartcolumn",
         "plugin-sqls-nvim": "plugin-sqls-nvim",
@@ -2170,11 +2153,11 @@
         ]
       },
       "locked": {
-        "lastModified": 1731983527,
+        "lastModified": 1726453838,
-        "narHash": "sha256-JECaBgC0pQ91Hq3W4unH6K9to8s2Zl2sPNu7bLOv4ek=",
+        "narHash": "sha256-pupsow4L79SBfNwT6vh/5RAbVZuhngIA0RTCZksXmZY=",
         "owner": "oxalica",
         "repo": "rust-overlay",
-        "rev": "71287228d96e9568e1e70c6bbfa3f992d145947b",
+        "rev": "ca2e79cd22625d214b8437c2c4080ce79bd9f7d2",
         "type": "github"
       },
       "original": {

flake.nix

@@ -21,7 +21,6 @@
         ./flake/legacyPackages.nix
         ./flake/overlays.nix
         ./flake/packages.nix
-        ./flake/develop.nix
       ];
 
       flake = {
@@ -31,29 +30,46 @@
         };
 
         homeManagerModules = {
-          nvf = import ./flake/modules/home-manager.nix self.packages lib;
-          default = self.homeManagerModules.nvf;
           neovim-flake =
             lib.warn ''
-              'homeManagerModules.neovim-flake' has been deprecated, and will be removed
+              homeManagerModules.neovim-flake has been deprecated.
-              in a future release. Please use 'homeManagerModules.nvf' instead.
+              Plese use the homeManagerModules.nvf instead
             ''
             self.homeManagerModules.nvf;
+
+          nvf = import ./flake/modules/home-manager.nix self.packages lib;
+
+          default = self.homeManagerModules.nvf;
         };
 
         nixosModules = {
-          nvf = import ./flake/modules/nixos.nix self.packages lib;
-          default = self.nixosModules.nvf;
           neovim-flake =
             lib.warn ''
-              'nixosModules.neovim-flake' has been deprecated, and will be removed
+              nixosModules.neovim-flake has been deprecated.
-              in a future release. Please use 'nixosModules.nvf' instead.
+              Please use the nixosModules.nvf instead
             ''
             self.nixosModules.nvf;
+
+          nvf = import ./flake/modules/nixos.nix self.packages lib;
+
+          default = self.nixosModules.nvf;
         };
       };
 
-      perSystem = {pkgs, ...}: {
+      perSystem = {
+        self',
+        config,
+        pkgs,
+        ...
+      }: {
+        devShells = {
+          default = self'.devShells.lsp;
+          nvim-nix = pkgs.mkShell {packages = [config.packages.nix];};
+          lsp = pkgs.mkShell {
+            packages = with pkgs; [nil statix deadnix alejandra];
+          };
+        };
+
         # Provide the default formatter. `nix fmt` in project root
         # will format available files with the correct formatter.
         # P.S: Please do not format with nixfmt! It messes with many
@@ -238,12 +254,6 @@
       flake = false;
     };
 
-    # Runners
-    plugin-run-nvim = {
-      url = "github:diniamo/run.nvim";
-      flake = false;
-    };
-
     # Debuggers
     plugin-nvim-dap = {
       url = "github:mfussenegger/nvim-dap";

flake/develop.nix

@@ -1,30 +0,0 @@
-{lib, ...}: {
-  perSystem = {
-    pkgs,
-    config,
-    self',
-    ...
-  }: {
-    devShells = {
-      default = self'.devShells.lsp;
-      nvim-nix = pkgs.mkShellNoCC {packages = [config.packages.nix];};
-      lsp = pkgs.mkShellNoCC {
-        packages = with pkgs; [nil statix deadnix alejandra];
-      };
-    };
-
-    # This package exists to make development easier by providing the place and
-    # boilerplate to build a test nvf configuration. Feel free to use this for
-    # testing, but make sure to discard the changes before creating a pull
-    # request.
-    packages.dev = let
-      configuration = {};
-
-      customNeovim = lib.nvim.neovimConfiguration {
-        inherit pkgs;
-        modules = [configuration];
-      };
-    in
-      customNeovim.neovim;
-  };
-}

flake/packages.nix

@@ -14,20 +14,6 @@
       docs-html = docs.manual.html;
       docs-manpages = docs.manPages;
       docs-json = docs.options.json;
-      docs-linkcheck = let
-        site = config.packages.docs;
-      in
-        pkgs.testers.lycheeLinkCheck {
-          inherit site;
-          remap = {
-            "https://notashelf.github.io/nvf/" = site;
-          };
-          extraConfig = {
-            exclude = [];
-            include_mail = true;
-            include_verbatim = true;
-          };
-        };
 
       # Build and open the built manual in your system browser
       docs-html-wrapped = pkgs.writeScriptBin "docs-html-wrapped" ''

lib/binds.nix

@@ -68,7 +68,29 @@
 
     pushDownDefault = attr: mapAttrs (_: mkDefault) attr;
 
-    mkKeymap = mode: key: action: opt: opt // {inherit mode key action;};
+    mkLznBinding = mode: key: action: desc: {
+      inherit mode desc key action;
+    };
+
+    mkLznExprBinding = mode: key: action: desc: {
+      inherit mode desc key action;
+      lua = true;
+      silent = true;
+      expr = true;
+    };
+
+    mkSetLznBinding = binding: action: {
+      inherit action;
+      key = binding.value;
+      desc = binding.description;
+    };
+
+    mkSetLuaLznBinding = binding: action: {
+      inherit action;
+      key = binding.value;
+      lua = true;
+      desc = binding.description;
+    };
   };
 in
   binds

lib/types/languages.nix

@@ -1,37 +1,31 @@
-{lib}: let
+{lib}:
-  inherit (lib.options) mkOption mkPackageOption;
+with lib; let
-  inherit (lib.attrsets) attrNames;
-  inherit (lib.types) listOf either enum submodule package;
-
   diagnosticSubmodule = _: {
     options = {
       type = mkOption {
         description = "Type of diagnostic to enable";
         type = attrNames diagnostics;
       };
-
       package = mkOption {
-        type = package;
         description = "Diagnostics package";
+        type = types.package;
       };
     };
   };
-
+in {
   diagnostics = {
     langDesc,
     diagnosticsProviders,
     defaultDiagnosticsProvider,
   }:
     mkOption {
-      type = listOf (either (enum (attrNames diagnosticsProviders)) (submodule diagnosticSubmodule));
-      default = defaultDiagnosticsProvider;
       description = "List of ${langDesc} diagnostics to enable";
+      type = with types; listOf (either (enum (attrNames diagnosticsProviders)) (submodule diagnosticSubmodule));
+      default = defaultDiagnosticsProvider;
     };
 
   mkGrammarOption = pkgs: grammar:
     mkPackageOption pkgs ["${grammar} treesitter"] {
       default = ["vimPlugins" "nvim-treesitter" "builtGrammars" grammar];
     };
-in {
-  inherit diagnostics diagnosticSubmodule mkGrammarOption;
 }

modules/extra/deprecations.nix

@@ -1,93 +1,58 @@
 {lib, ...}: let
   inherit (lib.modules) mkRemovedOptionModule mkRenamedOptionModule;
-  inherit (lib.lists) concatLists;
-  inherit (lib.nvim.config) batchRenameOptions;
-
-  renamedVimOpts = batchRenameOptions ["vim"] ["vim" "options"] {
-    colourTerm = "termguicolors";
-    mouseSupport = "mouse";
-    cmdHeight = "cmdheight";
-    updateTime = "updatetime";
-    mapTimeout = "tm";
-    cursorlineOpt = "cursorlineopt";
-    splitBelow = "splitbelow";
-    splitRight = "splitright";
-    autoIndent = "autoindent";
-    wordWrap = "wrap";
-  };
 in {
-  imports = concatLists [
+  imports = [
-    [
+    # 2024-06-06
-      # 2024-06-06
+    (mkRemovedOptionModule ["vim" "tidal"] ''
-      (mkRemovedOptionModule ["vim" "tidal"] ''
+      Tidalcycles language support has been removed as of 2024-06-06 as it was long unmaintained. If
-        Tidalcycles language support has been removed as of 2024-06-06 as it was long unmaintained. If
+      you depended on this functionality, please open an issue.
-        you depended on this functionality, please open an issue.
+    '')
-      '')
 
-      # 2024-07-20
+    # 2024-07-20
-      (mkRemovedOptionModule ["vim" "lsp" "nvimCodeActionMenu"] ''
+    (mkRemovedOptionModule ["vim" "lsp" "nvimCodeActionMenu"] ''
-        nvimCodeActionMenu has been deprecated and removed upstream. As of 0.7, fastaction will be
+      nvimCodeActionMenu has been deprecated and removed upstream. As of 0.7, fastaction will be
-        available under `vim.ui.fastaction` as a replacement. Simply remove everything under
+      available under `vim.ui.fastaction` as a replacement. Simply remove everything under
-        `vim.lsp.nvimCodeActionMenu`, and set `vim.ui.fastaction.enable` to `true`.
+      `vim.lsp.nvimCodeActionMenu`, and set `vim.ui.fastaction.enable` to `true`.
-      '')
+    '')
 
-      (mkRemovedOptionModule ["vim" "autopairs" "enable"] ''
+    (mkRemovedOptionModule ["vim" "autopairs" "enable"] ''
-        vim.autopairs.enable has been removed in favor of per-plugin modules.
+      vim.autopairs.enable has been removed in favor of per-plugin modules.
-        You can enable nvim-autopairs with vim.autopairs.nvim-autopairs.enable instead.
+      You can enable nvim-autopairs with vim.autopairs.nvim-autopairs.enable instead.
-      '')
+    '')
-      (mkRemovedOptionModule ["vim" "autopairs" "type"] ''
+    (mkRemovedOptionModule ["vim" "autopairs" "type"] ''
-        vim.autopairs.type has been removed in favor of per-plugin modules.
+      vim.autopairs.type has been removed in favor of per-plugin modules.
-        You can enable nvim-autopairs with vim.autopairs.nvim-autopairs.enable instead.
+      You can enable nvim-autopairs with vim.autopairs.nvim-autopairs.enable instead.
-      '')
+    '')
-      (mkRemovedOptionModule ["vim" "autocomplete" "enable"] ''
+    (mkRemovedOptionModule ["vim" "autocomplete" "enable"] ''
-        vim.autocomplete.enable has been removed in favor of per-plugin modules.
+      vim.autocomplete.enable has been removed in favor of per-plugin modules.
-        You can enable nvim-cmp with vim.autocomplete.nvim-cmp.enable instead.
+      You can enable nvim-cmp with vim.autocomplete.nvim-cmp.enable instead.
-      '')
+    '')
-      (mkRemovedOptionModule ["vim" "autocomplete" "type"] ''
+    (mkRemovedOptionModule ["vim" "autocomplete" "type"] ''
-        vim.autocomplete.type has been removed in favor of per-plugin modules.
+      vim.autocomplete.type has been removed in favor of per-plugin modules.
-        You can enable nvim-cmp with vim.autocomplete.nvim-cmp.enable instead.
+      You can enable nvim-cmp with vim.autocomplete.nvim-cmp.enable instead.
-      '')
+    '')
-      (mkRemovedOptionModule ["vim" "autocomplete" "sources"] ''
+    (mkRemovedOptionModule ["vim" "autocomplete" "sources"] ''
-        vim.autocomplete.sources has been removed in favor of per-plugin modules.
+      vim.autocomplete.sources has been removed in favor of per-plugin modules.
-        You can add nvim-cmp sources with vim.autocomplete.nvim-cmp.sources
+      You can add nvim-cmp sources with vim.autocomplete.nvim-cmp.sources
-        instead.
+      instead.
-      '')
+    '')
-      (mkRemovedOptionModule ["vim" "snippets" "vsnip" "enable"] ''
+    (mkRemovedOptionModule ["vim" "snippets" "vsnip" "enable"] ''
-        vim.snippets.vsnip.enable has been removed in favor of the more modern luasnip.
+      vim.snippets.vsnip.enable has been removed in favor of the more modern luasnip.
-      '')
+    '')
-      (mkRenamedOptionModule ["vim" "lsp" "lspkind" "mode"] ["vim" "lsp" "lspkind" "setupOpts" "mode"])
+    (mkRenamedOptionModule ["vim" "lsp" "lspkind" "mode"] ["vim" "lsp" "lspkind" "setupOpts" "mode"])
 
-      # 2024-10-14
+    # 2024-10-14
-      (mkRemovedOptionModule ["vim" "configRC"] ''
+    (mkRemovedOptionModule ["vim" "configRC"] ''
-        Please migrate your configRC sections to Neovim's Lua format, and
+      Please migrate your configRC sections to Neovim's Lua format, and
-        add them to `vim.luaConfigRC`.
+      add them to `vim.luaConfigRC`.
 
-        See the v0.7 release notes for more information on why and how to
+      See the v0.7 release notes for more information on why and how to
-        migrate your existing configurations to the new format.
+      migrate your existing configurations to the new format.
-      '')
+    '')
 
-      (mkRemovedOptionModule ["vim" "disableDefaultRuntimePaths"] ''
+    (mkRemovedOptionModule ["vim" "disableDefaultRuntimePaths"] ''
-        Nvf now uses $NVIM_APP_NAME so there is no longer the problem of
+      Nvf now uses $NVIM_APP_NAME so there is no longer the problem of
-        (accidental) leaking of user configuration.
+      (accidental) leaking of user configuration.
-      '')
+    '')
-
-      (mkRemovedOptionModule ["vim" "lsp" "trouble" "mappings" "toggle"] ''
-        With Trouble having so many different modes, and breaking changes
-        upstream, it no longer makes sense, nor works, to toggle only Trouble.
-      '')
-
-      # 2024-11-30
-      (mkRenamedOptionModule ["vim" "leaderKey"] ["vim" "globals" "mapleader"])
-
-      (mkRemovedOptionModule ["vim" "tabWidth"] ''
-        Previous behaviour of this option was confusing and undocumented. Please set
-        `tabstop` and `shiftwidth` manually in `vim.options` or per-filetype in a
-        `ftplugin` directory added to your runtime path.
-      '')
-    ]
-
-    # 2024-12-1
-    # Migrated via batchRenameOptions. Further batch renames must be below this line.
-    renamedVimOpts
   ];
 }

modules/modules.nix

@@ -31,7 +31,6 @@
       "notes"
       "projects"
       "rich-presence"
-      "runner"
       "session"
       "snippets"
       # "spellcheck" # FIXME: see neovim/init/spellcheck.nix

modules/neovim/init/basic.nix

@@ -3,18 +3,29 @@
   lib,
   ...
 }: let
-  inherit (lib.options) mkOption mkEnableOption literalMD;
+  inherit (lib.options) mkOption mkEnableOption literalExpression literalMD;
   inherit (lib.strings) optionalString;
   inherit (lib.types) enum bool str int either;
   inherit (lib.generators) mkLuaInline;
   inherit (lib.nvim.dag) entryAfter;
-  inherit (lib.nvim.binds) pushDownDefault;
   inherit (lib.nvim.lua) toLuaObject;
   inherit (lib.nvim.types) luaInline;
 
   cfg = config.vim;
 in {
   options.vim = {
+    leaderKey = mkOption {
+      type = str;
+      default = " ";
+      description = "The leader key used for `<leader>` mappings";
+    };
+
+    colourTerm = mkOption {
+      type = bool;
+      default = true;
+      description = "Set terminal up for 256 colours";
+    };
+
     disableArrows = mkOption {
       type = bool;
       default = false;
@@ -33,6 +44,12 @@ in {
       description = "Start scrolling this number of lines from the top or bottom of the page.";
     };
 
+    wordWrap = mkOption {
+      type = bool;
+      default = true;
+      description = "Enable word wrapping.";
+    };
+
     syntaxHighlighting = mkOption {
       type = bool;
       default = !config.vim.treesitter.highlight.enable;
@@ -45,10 +62,24 @@ in {
       description = "Make use of the clipboard for default yank and paste operations. Don't use * and +";
     };
 
+    mouseSupport = mkOption {
+      type = enum ["a" "n" "v" "i" "c"];
+      default = "a";
+      description = ''
+        Set modes for mouse support.
+
+        * a - all
+        * n - normal
+        * v - visual
+        * i - insert
+        * c - command
+      '';
+    };
+
     lineNumberMode = mkOption {
       type = enum ["relative" "number" "relNumber" "none"];
       default = "relNumber";
-      example = "none";
+      example = literalExpression "none";
       description = "How line numbers are displayed.";
     };
 
@@ -58,6 +89,30 @@ in {
       description = "Prevent swapfile and backupfile from being created";
     };
 
+    tabWidth = mkOption {
+      type = int;
+      default = 4;
+      description = "Set the width of tabs";
+    };
+
+    autoIndent = mkOption {
+      type = bool;
+      default = true;
+      description = "Enable auto indent";
+    };
+
+    cmdHeight = mkOption {
+      type = int;
+      default = 1;
+      description = "Height of the command pane";
+    };
+
+    updateTime = mkOption {
+      type = int;
+      default = 300;
+      description = "The number of milliseconds till Cursor Hold event is fired";
+    };
+
     showSignColumn = mkOption {
       type = bool;
       default = true;
@@ -70,12 +125,36 @@ in {
       description = "Set how bells are handled. Options: on, visual or none";
     };
 
+    mapTimeout = mkOption {
+      type = int;
+      default = 500;
+      description = "Timeout in ms that neovim will wait for mapped action to complete";
+    };
+
+    splitBelow = mkOption {
+      type = bool;
+      default = true;
+      description = "New splits will open below instead of on top";
+    };
+
+    splitRight = mkOption {
+      type = bool;
+      default = true;
+      description = "New splits will open to the right";
+    };
+
     enableEditorconfig = mkOption {
       type = bool;
       default = true;
       description = "Follow editorconfig rules in current directory";
     };
 
+    cursorlineOpt = mkOption {
+      type = enum ["line" "screenline" "number" "both"];
+      default = "line";
+      description = "Highlight the text line of the cursor with CursorLine hl-CursorLine";
+    };
+
     searchCase = mkOption {
       type = enum ["ignore" "smart" "sensitive"];
       default = "sensitive";
@@ -102,35 +181,46 @@ in {
     };
   };
 
-  config.vim = {
+  config = {
-    # Set options that were previously interpolated in 'luaConfigRC.basic' as vim.options (vim.o)
+    vim.luaConfigRC.basic = entryAfter ["globalsScript"] ''
-    # and 'vim.globals' (vim.g). Future options, if possible, should be added here instead of the
-    # luaConfigRC section below.
-    options = pushDownDefault {
-      encoding = "utf-8";
-      hidden = true;
-      expandtab = true;
-    };
-
-    globals = pushDownDefault {
-      editorconfig = cfg.enableEditorconfig;
-    };
-
-    # Options that are more difficult to set through 'vim.options'. Fear not, though
-    # as the Lua DAG is still as powerful as it could be.
-    luaConfigRC.basic = entryAfter ["globalsScript"] ''
       -- Settings that are set for everything
+      vim.o.encoding = "utf-8"
+      vim.o.hidden = true
       vim.opt.shortmess:append("c")
+      vim.o.expandtab = true
+      vim.o.mouse = ${toLuaObject cfg.mouseSupport}
+      vim.o.tabstop = ${toLuaObject cfg.tabWidth}
+      vim.o.shiftwidth = ${toLuaObject cfg.tabWidth}
+      vim.o.softtabstop = ${toLuaObject cfg.tabWidth}
+      vim.o.cmdheight = ${toLuaObject cfg.cmdHeight}
+      vim.o.updatetime = ${toLuaObject cfg.updateTime}
+      vim.o.tm = ${toLuaObject cfg.mapTimeout}
+      vim.o.cursorlineopt = ${toLuaObject cfg.cursorlineOpt}
+      vim.o.scrolloff = ${toLuaObject cfg.scrollOffset}
+      vim.g.mapleader = ${toLuaObject cfg.leaderKey}
+      vim.g.maplocalleader = ${toLuaObject cfg.leaderKey}
 
       ${optionalString cfg.undoFile.enable ''
         vim.o.undofile = true
         vim.o.undodir = ${toLuaObject cfg.undoFile.path}
       ''}
 
+      ${optionalString cfg.splitBelow ''
+        vim.o.splitbelow = true
+      ''}
+
+      ${optionalString cfg.splitRight ''
+        vim.o.splitright = true
+      ''}
+
       ${optionalString cfg.showSignColumn ''
         vim.o.signcolumn = "yes"
       ''}
 
+      ${optionalString cfg.autoIndent ''
+        vim.o.autoindent = true
+      ''}
+
       ${optionalString cfg.preventJunkFiles ''
         vim.o.swapfile = false
         vim.o.backup = false
@@ -171,11 +261,23 @@ in {
         vim.cmd("syntax on")
       ''}
 
+      ${optionalString (!cfg.wordWrap) ''
+        vim.o.wrap = false
+      ''}
+
       ${optionalString cfg.hideSearchHighlight ''
         vim.o.hlsearch = false
         vim.o.incsearch = true
       ''}
 
+      ${optionalString cfg.colourTerm ''
+        vim.o.termguicolors = true
+      ''}
+
+      ${optionalString (!cfg.enableEditorconfig) ''
+        vim.g.editorconfig = false
+      ''}
+
       ${optionalString (cfg.searchCase == "ignore") ''
         vim.o.smartcase = false
         vim.o.ignorecase = true

modules/plugins/assistant/copilot/config.nix

@@ -40,13 +40,13 @@ in {
           cmd = ["Copilot" "CopilotAuth" "CopilotDetach" "CopilotPanel" "CopilotStop"];
           keys = [
             (mkLuaKeymap ["n"] cfg.mappings.panel.accept (wrapPanelBinding ''require("copilot.panel").accept'' cfg.mappings.panel.accept) "[copilot] Accept suggestion" {})
-            (mkLuaKeymap ["n"] cfg.mappings.panel.jumpNext (wrapPanelBinding "require(\"copilot.panel\").jump_next" cfg.mappings.panel.jumpNext) "[copilot] Next panel suggestion" {})
+            (mkLuaKeymap ["n"] cfg.mappings.panel.jumpNext (wrapPanelBinding "require(\"copilot.panel\").jump_next" cfg.mappings.panel.jumpNext) "[copilot] Accept suggestion" {})
-            (mkLuaKeymap ["n"] cfg.mappings.panel.jumpPrev (wrapPanelBinding "require(\"copilot.panel\").jump_prev" cfg.mappings.panel.jumpPrev) "[copilot] Previous panel suggestion" {})
+            (mkLuaKeymap ["n"] cfg.mappings.panel.jumpPrev (wrapPanelBinding "require(\"copilot.panel\").jump_prev" cfg.mappings.panel.jumpPrev) "[copilot] Accept suggestion" {})
-            (mkLuaKeymap ["n"] cfg.mappings.panel.refresh (wrapPanelBinding "require(\"copilot.panel\").refresh" cfg.mappings.panel.refresh) "[copilot] Refresh suggestion" {})
+            (mkLuaKeymap ["n"] cfg.mappings.panel.refresh (wrapPanelBinding "require(\"copilot.panel\").refresh" cfg.mappings.panel.refresh) "[copilot] Accept suggestion" {})
             (mkLuaKeymap ["n"] cfg.mappings.panel.open (wrapPanelBinding ''
                 function() require("copilot.panel").open({ position = "${cfg.setupOpts.panel.layout.position}", ratio = ${toString cfg.setupOpts.panel.layout.ratio}, }) end
               ''
-              cfg.mappings.panel.open) "[copilot] Open Panel" {})
+              cfg.mappings.panel.open) "[copilot] Accept suggestion" {})
 
             (mkLuaKeymap ["i"] cfg.mappings.suggestion.accept "function() require('copilot.suggestion').accept() end" "[copilot] Accept suggestion" {})
             (mkLuaKeymap ["i"] cfg.mappings.suggestion.acceptLine "function() require('copilot.suggestion').accept_line() end" "[copilot] Accept suggestion (line)" {})

modules/plugins/autopairs/nvim-autopairs/nvim-autopairs.nix

@@ -4,7 +4,7 @@
   inherit (lib.nvim.types) mkPluginSetupOption;
 in {
   imports = [
-    (mkRemovedOptionModule ["vim" "autopairs" "nvim-compe"] "nvim-compe is deprecated and no longer supported.")
+    (mkRemovedOptionModule ["vim" "autopairs" "nvim-compe"] "nvim-compe is deprecated and no longer suported.")
   ];
 
   options.vim.autopairs.nvim-autopairs = {

modules/plugins/comments/comment-nvim/config.nix

@@ -1,14 +1,14 @@
 {
-  options,
   config,
   lib,
   ...
 }: let
   inherit (lib.modules) mkIf;
-  inherit (lib.nvim.binds) mkKeymap;
+  inherit (lib.nvim.binds) mkLznExprBinding mkLznBinding;
 
   cfg = config.vim.comments.comment-nvim;
-  inherit (options.vim.comments.comment-nvim) mappings;
+  self = import ./comment-nvim.nix {inherit lib;};
+  inherit (self.options.vim.comments.comment-nvim) mappings;
 in {
   config = mkIf cfg.enable {
     vim.lazy.plugins.comment-nvim = {
@@ -16,28 +16,24 @@ in {
       setupModule = "Comment";
       inherit (cfg) setupOpts;
       keys = [
-        (mkKeymap "n" cfg.mappings.toggleOpLeaderLine "<Plug>(comment_toggle_linewise)" {desc = mappings.toggleOpLeaderLine.description;})
+        (mkLznBinding ["n"] cfg.mappings.toggleOpLeaderLine "<Plug>(comment_toggle_linewise)" mappings.toggleOpLeaderLine.description)
-        (mkKeymap "n" cfg.mappings.toggleOpLeaderBlock "<Plug>(comment_toggle_blockwise)" {desc = mappings.toggleOpLeaderBlock.description;})
+        (mkLznBinding ["n"] cfg.mappings.toggleOpLeaderBlock "<Plug>(comment_toggle_blockwise)" mappings.toggleOpLeaderBlock.description)
-        (mkKeymap "n" cfg.mappings.toggleCurrentLine ''
+        (mkLznExprBinding ["n"] cfg.mappings.toggleCurrentLine ''
             function()
               return vim.api.nvim_get_vvar('count') == 0 and '<Plug>(comment_toggle_linewise_current)'
                       or '<Plug>(comment_toggle_linewise_count)'
             end
-          '' {
+          ''
-            expr = true;
+          mappings.toggleCurrentLine.description)
-            desc = mappings.toggleCurrentLine.description;
+        (mkLznExprBinding ["n"] cfg.mappings.toggleCurrentBlock ''
-          })
-        (mkKeymap ["n"] cfg.mappings.toggleCurrentBlock ''
             function()
               return vim.api.nvim_get_vvar('count') == 0 and '<Plug>(comment_toggle_blockwise_current)'
                       or '<Plug>(comment_toggle_blockwise_count)'
             end
-          '' {
+          ''
-            expr = true;
+          mappings.toggleCurrentBlock.description)
-            desc = mappings.toggleCurrentBlock.description;
+        (mkLznBinding ["x"] cfg.mappings.toggleSelectedLine "<Plug>(comment_toggle_linewise_visual)" mappings.toggleSelectedLine.description)
-          })
+        (mkLznBinding ["x"] cfg.mappings.toggleSelectedBlock "<Plug>(comment_toggle_blockwise_visual)" mappings.toggleSelectedBlock.description)
-        (mkKeymap "x" cfg.mappings.toggleSelectedLine "<Plug>(comment_toggle_linewise_visual)" {desc = mappings.toggleSelectedLine.description;})
-        (mkKeymap "x" cfg.mappings.toggleSelectedBlock "<Plug>(comment_toggle_blockwise_visual)" {desc = mappings.toggleSelectedBlock.description;})
       ];
     };
   };

modules/plugins/completion/nvim-cmp/config.nix

@@ -10,8 +10,6 @@
   inherit (lib.nvim.attrsets) mapListToAttrs;
   inherit (builtins) attrNames typeOf tryEval concatStringsSep;
 
-  borders = config.vim.ui.borders.plugins.nvim-cmp;
-
   cfg = config.vim.autocomplete.nvim-cmp;
   luasnipEnable = config.vim.snippets.luasnip.enable;
   getPluginName = plugin:
@@ -83,9 +81,10 @@ in {
         setupOpts = {
           sources = map (s: {name = s;}) (attrNames cfg.sources);
 
-          window = mkIf borders.enable {
+          # TODO: try to get nvim-cmp to follow global border style
-            completion.border = borders.style;
+          window = mkIf config.vim.ui.borders.enable {
-            documentation.border = borders.style;
+            completion = mkLuaInline "cmp.config.window.bordered()";
+            documentation = mkLuaInline "cmp.config.window.bordered()";
           };
 
           formatting.format = cfg.format;

modules/plugins/completion/nvim-cmp/nvim-cmp.nix

@@ -48,7 +48,7 @@ in {
 
           A `deprio` function and a `kinds`
           (`require("cmp.types").lsp.CompletionItemKind`) variable is provided
-          above `setupOpts`. By passing a type to the function, the returned
+          above `setupOpts`. By passing a type to the funcion, the returned
           function will be a comparator that always ranks the specified kind the
           lowest.
         '';
@@ -72,7 +72,7 @@ in {
     };
 
     format = mkOption {
-      type = nullOr luaInline;
+      type = luaInline;
       default = mkLuaInline ''
         function(entry, vim_item)
           vim_item.menu = (${toLuaObject cfg.sources})[entry.source.name]
@@ -88,7 +88,7 @@ in {
         ```
       '';
       description = ''
-        The function used to customize the completion menu entries. This is
+        The function used to customize the completion menu entires. This is
         outside of `setupOpts` to allow for an easier integration with
         lspkind.nvim.
 

modules/plugins/dashboard/startify/startify.nix

@@ -101,7 +101,7 @@ in {
 
     customIndices = mkOption {
       default = [];
-      description = "Specify a list of default characters to use instead of numbers";
+      description = "Specify a list of default charecters to use instead of numbers";
       type = listOf str;
     };
 

modules/plugins/debugger/nvim-dap/config.nix

@@ -1,5 +1,4 @@
 {
-  options,
   config,
   lib,
   ...
@@ -7,11 +6,13 @@
   inherit (lib.strings) optionalString;
   inherit (lib.modules) mkIf mkMerge;
   inherit (lib.attrsets) mapAttrs;
-  inherit (lib.nvim.binds) mkKeymap;
+  inherit (lib.nvim.binds) addDescriptionsToMappings mkSetLuaBinding mkSetLuaLznBinding;
   inherit (lib.nvim.dag) entryAnywhere entryAfter;
 
   cfg = config.vim.debugger.nvim-dap;
-  inherit (options.vim.debugger.nvim-dap) mappings;
+  self = import ./nvim-dap.nix {inherit lib;};
+  mappingDefinitions = self.options.vim.debugger.nvim-dap.mappings;
+  mappings = addDescriptionsToMappings cfg.mappings mappingDefinitions;
 in {
   config = mkMerge [
     (mkIf cfg.enable {
@@ -28,24 +29,24 @@ in {
           }
           // mapAttrs (_: v: (entryAfter ["nvim-dap"] v)) cfg.sources;
 
-        keymaps = [
+        maps.normal = mkMerge [
-          (mkKeymap "n" cfg.mappings.continue "require('dap').continue" {desc = mappings.continue.description;})
+          (mkSetLuaBinding mappings.continue "require('dap').continue")
-          (mkKeymap "n" cfg.mappings.restart "require('dap').restart" {desc = mappings.restart.description;})
+          (mkSetLuaBinding mappings.restart "require('dap').restart")
-          (mkKeymap "n" cfg.mappings.terminate "require('dap').terminate" {desc = mappings.terminate.description;})
+          (mkSetLuaBinding mappings.terminate "require('dap').terminate")
-          (mkKeymap "n" cfg.mappings.runLast "require('dap').run_last" {desc = mappings.runLast.description;})
+          (mkSetLuaBinding mappings.runLast "require('dap').run_last")
 
-          (mkKeymap "n" cfg.mappings.toggleRepl "require('dap').repl.toggle" {desc = mappings.toggleRepl.description;})
+          (mkSetLuaBinding mappings.toggleRepl "require('dap').repl.toggle")
-          (mkKeymap "n" cfg.mappings.hover "require('dap.ui.widgets').hover" {desc = mappings.hover.description;})
+          (mkSetLuaBinding mappings.hover "require('dap.ui.widgets').hover")
-          (mkKeymap "n" cfg.mappings.toggleBreakpoint "require('dap').toggle_breakpoint" {desc = mappings.toggleBreakpoint.description;})
+          (mkSetLuaBinding mappings.toggleBreakpoint "require('dap').toggle_breakpoint")
 
-          (mkKeymap "n" cfg.mappings.runToCursor "require('dap').run_to_cursor" {desc = mappings.runToCursor.description;})
+          (mkSetLuaBinding mappings.runToCursor "require('dap').run_to_cursor")
-          (mkKeymap "n" cfg.mappings.stepInto "require('dap').step_into" {desc = mappings.stepInto.description;})
+          (mkSetLuaBinding mappings.stepInto "require('dap').step_into")
-          (mkKeymap "n" cfg.mappings.stepOut "require('dap').step_out" {desc = mappings.stepOut.description;})
+          (mkSetLuaBinding mappings.stepOut "require('dap').step_out")
-          (mkKeymap "n" cfg.mappings.stepOver "require('dap').step_over" {desc = mappings.stepOver.description;})
+          (mkSetLuaBinding mappings.stepOver "require('dap').step_over")
-          (mkKeymap "n" cfg.mappings.stepBack "require('dap').step_back" {desc = mappings.stepBack.description;})
+          (mkSetLuaBinding mappings.stepBack "require('dap').step_back")
 
-          (mkKeymap "n" cfg.mappings.goUp "require('dap').up" {desc = mappings.goUp.description;})
+          (mkSetLuaBinding mappings.goUp "require('dap').up")
-          (mkKeymap "n" cfg.mappings.goDown "require('dap').down" {desc = mappings.goDown.description;})
+          (mkSetLuaBinding mappings.goDown "require('dap').down")
         ];
       };
     })
@@ -59,7 +60,7 @@ in {
           inherit (cfg.ui) setupOpts;
 
           keys = [
-            (mkKeymap "n" cfg.mappings.toggleDapUI "function() require('dapui').toggle() end" {desc = mappings.toggleDapUI.description;})
+            (mkSetLuaLznBinding mappings.toggleDapUI "function() require('dapui').toggle() end")
           ];
         };
 

modules/plugins/debugger/nvim-dap/nvim-dap.nix

@@ -26,7 +26,7 @@ in {
     };
 
     mappings = {
-      continue = mkMappingOption "Continue" "<leader>dc";
+      continue = mkMappingOption "Contiue" "<leader>dc";
       restart = mkMappingOption "Restart" "<leader>dR";
       terminate = mkMappingOption "Terminate" "<leader>dq";
       runLast = mkMappingOption "Re-run Last Debug Session" "<leader>d.";

modules/plugins/filetree/neo-tree/config.nix

@@ -4,7 +4,6 @@
   ...
 }: let
   inherit (lib.modules) mkIf;
-  inherit (lib.nvim.dag) entryAnywhere;
 
   cfg = config.vim.filetree.neo-tree;
 in {
@@ -26,26 +25,6 @@ in {
       };
 
       visuals.nvim-web-devicons.enable = true;
-      # from https://github.com/nvim-neo-tree/neo-tree.nvim/discussions/1326
-      pluginRC.neo-tree =
-        mkIf (cfg.setupOpts.filesystem.hijack_netrw_behavior != "disabled" && config.vim.lazy.enable)
-        (entryAnywhere ''
-          vim.api.nvim_create_autocmd("BufEnter", {
-            group = vim.api.nvim_create_augroup("load_neo_tree", {}),
-            desc = "Loads neo-tree when opening a directory",
-            callback = function(args)
-              local stats = vim.uv.fs_stat(args.file)
-
-              if not stats or stats.type ~= "directory" then
-                return
-              end
-
-              require("lz.n").trigger_load("neo-tree-nvim")
-
-              return true
-            end,
-          })
-        '');
     };
   };
 }

modules/plugins/filetree/neo-tree/neo-tree.nix

@@ -1,5 +1,5 @@
 {lib, ...}: let
-  inherit (lib.types) bool str enum either listOf;
+  inherit (lib.types) bool str int submodule enum either listOf;
   inherit (lib.options) mkOption mkEnableOption literalExpression;
   inherit (lib.nvim.types) mkPluginSetupOption;
 in {
@@ -150,14 +150,6 @@ in {
           A list of filetypes that should not be replaced when opening a file
         '';
       };
-
-      filesystem = {
-        hijack_netrw_behavior = mkOption {
-          type = enum ["disabled" "open_default" "open_current"];
-          default = "open_default";
-          description = "Hijack Netrw behavior";
-        };
-      };
     };
   };
 }

modules/plugins/filetree/nvimtree/config.nix

@@ -6,7 +6,7 @@
 }: let
   inherit (lib.strings) optionalString;
   inherit (lib.modules) mkIf;
-  inherit (lib.nvim.binds) mkKeymap;
+  inherit (lib.nvim.binds) mkLznBinding;
   inherit (lib.nvim.dag) entryAnywhere;
   inherit (lib.nvim.binds) pushDownDefault;
 
@@ -24,17 +24,16 @@ in {
         package = "nvim-tree-lua";
         setupModule = "nvim-tree";
         inherit (cfg) setupOpts;
-
         cmd = ["NvimTreeClipboard" "NvimTreeClose" "NvimTreeCollapse" "NvimTreeCollapseKeepBuffers" "NvimTreeFindFile" "NvimTreeFindFileToggle" "NvimTreeFocus" "NvimTreeHiTest" "NvimTreeOpen" "NvimTreeRefresh" "NvimTreeResize" "NvimTreeToggle"];
         keys = [
-          (mkKeymap "n" cfg.mappings.toggle ":NvimTreeToggle<cr>" {desc = mappings.toggle.description;})
+          (mkLznBinding ["n"] cfg.mappings.toggle ":NvimTreeToggle<cr>" mappings.toggle.description)
-          (mkKeymap "n" cfg.mappings.refresh ":NvimTreeRefresh<cr>" {desc = mappings.refresh.description;})
+          (mkLznBinding ["n"] cfg.mappings.refresh ":NvimTreeRefresh<cr>" mappings.refresh.description)
-          (mkKeymap "n" cfg.mappings.findFile ":NvimTreeFindFile<cr>" {desc = mappings.findFile.description;})
+          (mkLznBinding ["n"] cfg.mappings.findFile ":NvimTreeFindFile<cr>" mappings.findFile.description)
-          (mkKeymap "n" cfg.mappings.focus ":NvimTreeFocus<cr>" {desc = mappings.focus.description;})
+          (mkLznBinding ["n"] cfg.mappings.focus ":NvimTreeFocus<cr>" mappings.focus.description)
         ];
       };
 
-      pluginRC.nvim-tree = entryAnywhere ''
+      pluginRC.nvimtreelua = entryAnywhere ''
         ${
           optionalString cfg.setupOpts.disable_netrw ''
             -- disable netrew completely
@@ -43,24 +42,6 @@ in {
           ''
         }
 
-        ${optionalString (config.vim.lazy.enable && cfg.setupOpts.hijack_netrw && !cfg.openOnSetup) ''
-          vim.api.nvim_create_autocmd("BufEnter", {
-            group = vim.api.nvim_create_augroup("load_nvim_tree", {}),
-            desc = "Loads nvim-tree when opening a directory",
-            callback = function(args)
-              local stats = vim.uv.fs_stat(args.file)
-
-              if not stats or stats.type ~= "directory" then
-                return
-              end
-
-              require("lz.n").trigger_load("nvim-tree-lua")
-
-              return true
-            end,
-          })
-        ''}
-
         ${
           optionalString cfg.openOnSetup ''
             ${optionalString config.vim.lazy.enable ''require('lz.n').trigger_load("nvim-tree-lua")''}

modules/plugins/languages/default.nix

@@ -9,7 +9,6 @@ in {
     ./css.nix
     ./elixir.nix
     ./go.nix
-    ./hcl.nix
     ./kotlin.nix
     ./html.nix
     ./java.nix
@@ -33,7 +32,6 @@ in {
     ./zig.nix
     ./csharp.nix
     ./julia.nix
-    ./nu.nix
   ];
 
   options.vim.languages = {

modules/plugins/languages/hcl.nix

@@ -1,117 +0,0 @@
-{
-  config,
-  pkgs,
-  lib,
-  ...
-}: let
-  inherit (builtins) attrNames;
-  inherit (lib.options) mkEnableOption mkOption;
-  inherit (lib.modules) mkIf mkMerge;
-  inherit (lib.types) package bool enum;
-  inherit (lib.nvim.types) mkGrammarOption;
-
-  cfg = config.vim.languages.hcl;
-
-  defaultServer = "terraform-ls";
-  servers = {
-    terraform-ls = {
-      package = pkgs.terraform-ls;
-      lspConfig = ''
-        lspconfig.terraformls.setup {
-          capabilities = capabilities,
-          on_attach=default_on_attach,
-          cmd = {"${lib.getExe cfg.lsp.package}", "serve"},
-        }
-      '';
-    };
-  };
-
-  defaultFormat = "hclfmt";
-  formats = {
-    hclfmt = {
-      package = pkgs.hclfmt;
-      nullConfig = ''
-        table.insert(
-          ls_sources,
-          null_ls.builtins.formatting.hclfmt.with({
-            command = "${lib.getExe cfg.format.package}",
-          })
-        )
-      '';
-    };
-  };
-in {
-  options.vim.languages.hcl = {
-    enable = mkEnableOption "HCL support";
-
-    treesitter = {
-      enable = mkEnableOption "HCL treesitter" // {default = config.vim.languages.enableTreesitter;};
-      package = mkGrammarOption pkgs "hcl";
-    };
-
-    lsp = {
-      enable = mkEnableOption "HCL LSP support (terraform-ls)" // {default = config.vim.languages.enableLSP;};
-      # TODO: (maybe, is it better?) it would be cooler to use vscode-extensions.hashicorp.hcl probably, shouldn't be too hard
-      package = mkOption {
-        type = package;
-        default = servers.${defaultServer}.package;
-        description = "HCL language server package (terraform-ls)";
-      };
-    };
-
-    format = {
-      enable = mkOption {
-        type = bool;
-        default = config.vim.languages.enableFormat;
-        description = "Enable HCL formatting";
-      };
-      type = mkOption {
-        type = enum (attrNames formats);
-        default = defaultFormat;
-        description = "HCL formatter to use";
-      };
-      package = mkOption {
-        type = package;
-        default = formats.${cfg.format.type}.package;
-        description = "HCL formatter package";
-      };
-    };
-  };
-
-  config = mkIf cfg.enable (mkMerge [
-    {
-      # hcl style official: https://developer.hashicorp.com/terraform/language/style#code-formatting
-      vim.pluginRC.hcl = ''
-        vim.api.nvim_create_autocmd("FileType", {
-          pattern = "hcl",
-          callback = function(opts)
-            local bo = vim.bo[opts.buf]
-            bo.tabstop = 2
-            bo.shiftwidth = 2
-            bo.softtabstop = 2
-          end
-        })
-
-        local ft = require('Comment.ft')
-        ft
-          .set('hcl', '#%s')
-      '';
-    }
-    (mkIf cfg.treesitter.enable {
-      vim.treesitter.enable = true;
-      vim.treesitter.grammars = [cfg.treesitter.package];
-    })
-
-    (mkIf cfg.lsp.enable {
-      vim.lsp.lspconfig.enable = true;
-      vim.lsp.lspconfig.sources = lib.optionalAttrs (! config.vim.languages.terraform.lsp.enable) {
-        terraform-ls = servers.${cfg.lsp.server}.lspConfig;
-      };
-    })
-
-    (mkIf cfg.format.enable {
-      vim.lsp.null-ls.enable = true;
-      vim.lsp.null-ls.sources.hcl-format = formats.${cfg.format.type}.nullConfig;
-    })
-  ]);
-}

modules/plugins/languages/nu.nix

@@ -1,70 +0,0 @@
-{
-  lib,
-  pkgs,
-  config,
-  ...
-}: let
-  inherit (lib.options) mkEnableOption mkOption;
-  inherit (lib.types) str either package listOf;
-  inherit (lib.modules) mkIf mkMerge;
-  inherit (lib.nvim.lua) expToLua;
-  inherit (lib.nvim.types) mkGrammarOption;
-  inherit (builtins) isList;
-
-  defaultServer = "nushell";
-  servers = {
-    nushell = {
-      package = pkgs.nushell;
-      lspConfig = ''
-        lspconfig.nushell.setup{
-          capabilities = capabilities,
-          on_attach = default_on_attach,
-          cmd = ${
-          if isList cfg.lsp.package
-          then expToLua cfg.lsp.package
-          else ''{"${cfg.lsp.package}/bin/nu", "--no-config-file", "--lsp"}''
-        }
-        }
-      '';
-    };
-  };
-
-  cfg = config.vim.languages.nu;
-in {
-  options.vim.languages.nu = {
-    enable = mkEnableOption "Nu language support";
-
-    treesitter = {
-      enable = mkEnableOption "Nu treesitter" // {default = config.vim.languages.enableTreesitter;};
-      package = mkGrammarOption pkgs "nu";
-    };
-
-    lsp = {
-      enable = mkEnableOption "Nu LSP support" // {default = config.vim.languages.enableLSP;};
-      server = mkOption {
-        type = str;
-        default = defaultServer;
-        description = "Nu LSP server to use";
-      };
-
-      package = mkOption {
-        type = either package (listOf str);
-        default = servers.${cfg.lsp.server}.package;
-        example = ''[(lib.getExe pkgs.nushell) "--lsp"]'';
-        description = "Nu LSP server package, or the command to run as a list of strings";
-      };
-    };
-  };
-
-  config = mkIf cfg.enable (mkMerge [
-    (mkIf cfg.treesitter.enable {
-      vim.treesitter.enable = true;
-      vim.treesitter.grammars = [cfg.treesitter.package];
-    })
-
-    (mkIf cfg.lsp.enable {
-      vim.lsp.lspconfig.enable = true;
-      vim.lsp.lspconfig.sources.nu-lsp = servers.${cfg.lsp.server}.lspConfig;
-    })
-  ]);
-}

modules/plugins/languages/rust.nix

@@ -89,7 +89,7 @@ in {
       };
 
       package = mkOption {
-        description = "lldb package";
+        description = "lldb pacakge";
         type = package;
         default = pkgs.lldb;
       };
@@ -145,13 +145,13 @@ in {
               on_attach = function(client, bufnr)
                 default_on_attach(client, bufnr)
                 local opts = { noremap=true, silent=true, buffer = bufnr }
-                vim.keymap.set("n", "<localleader>rr", ":RustLsp runnables<CR>", opts)
+                vim.keymap.set("n", "<leader>rr", ":RustLsp runnables<CR>", opts)
-                vim.keymap.set("n", "<localleader>rp", ":RustLsp parentModule<CR>", opts)
+                vim.keymap.set("n", "<leader>rp", ":RustLsp parentModule<CR>", opts)
-                vim.keymap.set("n", "<localleader>rm", ":RustLsp expandMacro<CR>", opts)
+                vim.keymap.set("n", "<leader>rm", ":RustLsp expandMacro<CR>", opts)
-                vim.keymap.set("n", "<localleader>rc", ":RustLsp openCargo", opts)
+                vim.keymap.set("n", "<leader>rc", ":RustLsp openCargo", opts)
-                vim.keymap.set("n", "<localleader>rg", ":RustLsp crateGraph x11", opts)
+                vim.keymap.set("n", "<leader>rg", ":RustLsp crateGraph x11", opts)
                 ${optionalString cfg.dap.enable ''
-              vim.keymap.set("n", "<localleader>rd", ":RustLsp debuggables<cr>", opts)
+              vim.keymap.set("n", "<leader>rd", ":RustLsp debuggables<cr>", opts)
               vim.keymap.set(
                "n", "${config.vim.debugger.nvim-dap.mappings.continue}",
                function()

modules/plugins/languages/ts.nix

@@ -181,10 +181,8 @@ in {
     extensions = {
       ts-error-translator = {
         enable = mkEnableOption ''
-          [ts-error-translator.nvim]: https://github.com/dmmulroy/ts-error-translator.nvim
+          Typescript error translation with
-
+          [ts-error-translator.nvim](github.com/dmmulroy/ts-error-translator.nvim)
-          Typescript error translation with [ts-error-translator.nvim]
-
         '';
 
         setupOpts = mkPluginSetupOption "ts-error-translator" {

modules/plugins/languages/typst.nix

@@ -21,10 +21,7 @@
       lspConfig = ''
         lspconfig.typst_lsp.setup {
           capabilities = capabilities,
-          on_attach = function(client, bufnr)
+          on_attach = default_on_attach,
-            -- Disable semantic tokens as a workaround for a semantic token error when using non-english characters
-            client.server_capabilities.semanticTokensProvider = nil
-          end,
           cmd = ${
           if isList cfg.lsp.package
           then expToLua cfg.lsp.package
@@ -38,11 +35,7 @@
       lspConfig = ''
         lspconfig.tinymist.setup {
           capabilities = capabilities,
-          single_file_support = true,
+          on_attach = default_on_attach,
-          on_attach = function(client, bufnr)
-            -- Disable semantic tokens as a workaround for a semantic token error when using non-english characters
-            client.server_capabilities.semanticTokensProvider = nil
-          end,
           cmd = ${
           if isList cfg.lsp.package
           then expToLua cfg.lsp.package

modules/plugins/lsp/null-ls/null-ls.nix

@@ -22,7 +22,7 @@ in {
     default_timeout = mkOption {
       type = int;
       default = 5000;
-      description = "Default timeout value, in milliseconds";
+      description = "Default timeout value, in miliseconds";
     };
 
     sources = mkOption {

modules/plugins/lsp/otter/otter.nix

@@ -31,7 +31,7 @@ in {
             description = ''
               if set to true, the filetype of the otterbuffers will be set. Other wide only
               the autocommand of lspconfig that attaches the language server will be
-              executed without setting the filetype
+              executed without stting the filetype
             '';
           };
           write_to_disk = mkOption {

modules/plugins/lsp/trouble/config.nix

@@ -5,11 +5,12 @@
   ...
 }: let
   inherit (lib.modules) mkIf;
-  inherit (lib.nvim.binds) mkKeymap pushDownDefault;
+  inherit (lib.nvim.binds) addDescriptionsToMappings mkSetLznBinding pushDownDefault;
 
   cfg = config.vim.lsp;
 
-  inherit (options.vim.lsp.trouble) mappings;
+  mappingDefinitions = options.vim.lsp.trouble.mappings;
+  mappings = addDescriptionsToMappings cfg.trouble.mappings mappingDefinitions;
 in {
   config = mkIf (cfg.enable && cfg.trouble.enable) {
     vim = {
@@ -20,18 +21,19 @@ in {
 
         cmd = "Trouble";
         keys = [
-          (mkKeymap "n" cfg.trouble.mappings.workspaceDiagnostics "<cmd>Trouble toggle diagnostics<CR>" {desc = mappings.workspaceDiagnostics.description;})
+          (mkSetLznBinding mappings.toggle "<cmd>TroubleToggle<CR>")
-          (mkKeymap "n" cfg.trouble.mappings.documentDiagnostics "<cmd>Trouble toggle diagnostics filter.buf=0<CR>" {desc = mappings.documentDiagnostics.description;})
+          (mkSetLznBinding mappings.workspaceDiagnostics "<cmd>TroubleToggle workspace_diagnostics<CR>")
-          (mkKeymap "n" cfg.trouble.mappings.lspReferences "<cmd>Trouble toggle lsp_references<CR>" {desc = mappings.lspReferences.description;})
+          (mkSetLznBinding mappings.documentDiagnostics "<cmd>TroubleToggle document_diagnostics<CR>")
-          (mkKeymap "n" cfg.trouble.mappings.quickfix "<cmd>Trouble toggle quickfix<CR>" {desc = mappings.quickfix.description;})
+          (mkSetLznBinding mappings.lspReferences "<cmd>TroubleToggle lsp_references<CR>")
-          (mkKeymap "n" cfg.trouble.mappings.locList "<cmd>Trouble toggle loclist<CR>" {desc = mappings.locList.description;})
+          (mkSetLznBinding mappings.quickfix "<cmd>TroubleToggle quickfix<CR>")
-          (mkKeymap "n" cfg.trouble.mappings.symbols "<cmd>Trouble toggle symbols<CR>" {desc = mappings.symbols.description;})
+          (mkSetLznBinding mappings.locList "<cmd>TroubleToggle loclist<CR>")
         ];
       };
 
       binds.whichKey.register = pushDownDefault {
+        "<leader>l" = "Trouble";
         "<leader>x" = "+Trouble";
-        "<leader>lw" = "+Workspace";
+        "<leader>lw" = "Workspace";
       };
     };
   };

modules/plugins/lsp/trouble/trouble.nix

@@ -10,12 +10,12 @@ in {
       setupOpts = mkPluginSetupOption "Trouble" {};
 
       mappings = {
+        toggle = mkMappingOption "Toggle trouble [trouble]" "<leader>xx";
         workspaceDiagnostics = mkMappingOption "Workspace diagnostics [trouble]" "<leader>lwd";
         documentDiagnostics = mkMappingOption "Document diagnostics [trouble]" "<leader>ld";
         lspReferences = mkMappingOption "LSP References [trouble]" "<leader>lr";
         quickfix = mkMappingOption "QuickFix [trouble]" "<leader>xq";
         locList = mkMappingOption "LOCList [trouble]" "<leader>xl";
-        symbols = mkMappingOption "Symbols [trouble]" "<leader>xs";
       };
     };
   };

modules/plugins/rich-presence/neocord/neocord.nix

@@ -12,7 +12,7 @@ in {
         migration is required.
 
         Please see neocord documentation and options page on the **nvf** manual
-        for more information
+        for mor einformation
       '')
     ]
     ++ (map

modules/plugins/runner/default.nix

@@ -1,5 +0,0 @@
-{
-  imports = [
-    ./run-nvim
-  ];
-}

modules/plugins/runner/run-nvim/config.nix

@@ -1,38 +0,0 @@
-{
-  lib,
-  config,
-  options,
-  ...
-}: let
-  inherit (lib.modules) mkIf mkDefault;
-  inherit (lib.nvim.binds) addDescriptionsToMappings mkSetLznBinding mkSetLuaLznBinding;
-
-  cfg = config.vim.runner.run-nvim;
-  mappingDefinitions = options.vim.runner.run-nvim.mappings;
-  mappings = addDescriptionsToMappings cfg.mappings mappingDefinitions;
-in {
-  config = mkIf cfg.enable {
-    vim = {
-      lazy.plugins.run-nvim = {
-        package = "run-nvim";
-        setupModule = "run";
-        inherit (cfg) setupOpts;
-
-        cmd = "Run";
-
-        keys = [
-          (mkSetLznBinding "n" mappings.run "<cmd>Run<CR>")
-          (mkSetLznBinding "n" mappings.runOverride "<cmd>Run!<CR>")
-          (mkSetLuaLznBinding "n" mappings.runCommand ''
-            function()
-              local input = vim.fn.input("Run command: ")
-              if input ~= "" then require("run").run(input, false) end
-            end
-          '')
-        ];
-      };
-
-      binds.whichKey.register."<leader>r" = mkDefault "+Run";
-    };
-  };
-}

modules/plugins/runner/run-nvim/default.nix

@@ -1,6 +0,0 @@
-{
-  imports = [
-    ./run-nvim.nix
-    ./config.nix
-  ];
-}

modules/plugins/runner/run-nvim/run-nvim.nix

@@ -1,18 +0,0 @@
-{lib, ...}: let
-  inherit (lib.options) mkEnableOption;
-  inherit (lib.nvim.types) mkPluginSetupOption;
-  inherit (lib.nvim.binds) mkMappingOption;
-in {
-  options = {
-    vim.runner.run-nvim = {
-      enable = mkEnableOption "run.nvim";
-      setupOpts = mkPluginSetupOption "run.nvim" {};
-
-      mappings = {
-        run = mkMappingOption "Run cached" "<leader>ri";
-        runOverride = mkMappingOption "Run and override" "<leader>ro";
-        runCommand = mkMappingOption "Run prompt" "<leader>rc";
-      };
-    };
-  };
-}

modules/plugins/session/nvim-session-manager/nvim-session-manager.nix

@@ -105,7 +105,7 @@ in {
       autosave_ignore_buftypes = mkOption {
         type = types.listOf types.str;
         default = [];
-        description = "All buffers of these buffer types will be closed before the session is saved";
+        description = "All buffers of these bufer types will be closed before the session is saved";
       };
 
       autosave_only_in_session = mkOption {

modules/plugins/tabline/nvim-bufferline/nvim-bufferline.nix

@@ -49,7 +49,7 @@ in {
           type = bool;
           default = true;
           description = ''
-            Whether or not to allow highlight groups to be overridden.
+            Whether or not to allow highlight groups to be overriden.
 
             While false, bufferline.nvim sets highlights as default.
           '';
@@ -101,7 +101,7 @@ in {
               The indicatotor icon to use for the current buffer.
 
               ::: {.warning}
-              This **must** be omitted while style is not `icon`
+              This **must** be ommitted while style is not `icon`
               :::
             '';
           };
@@ -338,6 +338,17 @@ in {
           description = "Whether or not the move command \"wraps\" at the first or last position";
         };
 
+        seperator_style = mkOption {
+          type = either (enum ["thick" "thin" "slope" "slant"]) (listOf str);
+          default = [" " " "];
+          description = ''
+            Style of the buffer separator.
+
+            Can be either one of the suspported values, or a list containing
+            **at most** two elements for `focused` and `unfocused` respectively.
+          '';
+        };
+
         separator_style = mkOption {
           type = nullOr (either (enum ["slant" "padded_slant" "slope" "padded_slope" "thick" "thin"]) (listOf str));
           default = "thin";

modules/plugins/terminal/toggleterm/config.nix

@@ -7,7 +7,7 @@
   inherit (lib.lists) optional;
   inherit (lib.modules) mkIf;
   inherit (lib.meta) getExe;
-  inherit (lib.nvim.binds) mkKeymap;
+  inherit (lib.nvim.binds) mkLznBinding;
   inherit (lib.nvim.lua) toLuaObject;
 
   cfg = config.vim.terminal.toggleterm;
@@ -19,10 +19,9 @@ in {
         package = "toggleterm-nvim";
         cmd = ["ToggleTerm" "ToggleTermSendCurrentLine" "ToggleTermSendVisualLines" "ToggleTermSendVisualSelection" "ToggleTermSetName" "ToggleTermToggleAll"];
         keys =
-          [(mkKeymap "n" cfg.mappings.open "<Cmd>execute v:count . \"ToggleTerm\"<CR>" {desc = "Toggle terminal";})]
+          [(mkLznBinding ["n"] cfg.mappings.open "<Cmd>execute v:count . \"ToggleTerm\"<CR>" "Toggle terminal")]
           ++ optional cfg.lazygit.enable {
             key = cfg.lazygit.mappings.open;
-            mode = "n";
             desc = lazygitMapDesc;
           };
 

modules/plugins/theme/supported-themes.nix

@@ -93,7 +93,6 @@ in {
     setup = {
       style ? "dark",
       transparent ? false,
-      ...
     }: let
       style' =
         warnIf (style == "light") "oxocarbon: light theme is not well-supported" style;
@@ -118,7 +117,6 @@ in {
     setup = {
       style ? "dark",
       transparent ? false,
-      ...
     }: ''
       -- Gruvbox theme
       require("gruvbox").setup({
@@ -154,7 +152,6 @@ in {
     setup = {
       style ? "main",
       transparent ? false,
-      ...
     }: ''
       require("rose-pine").setup({
         dark_variant = "${style}", -- main, moon, or dawn

modules/plugins/treesitter/ts-context/context.nix

@@ -10,7 +10,7 @@
     multilineThreshold = "multiline_threshold";
     trimScope = "trim_scope";
     mode = "mode";
-    separator = "separator";
+    seperator = "separator";
     zindex = "z_index";
   };
 

modules/plugins/utility/motion/hop/hop.nix

@@ -4,7 +4,7 @@
 in {
   options.vim.utility.motion.hop = {
     mappings = {
-      hop = mkMappingOption "Jump to occurrences [hop.nvim]" "<leader>h";
+      hop = mkMappingOption "Jump to occurences [hop.nvim]" "<leader>h";
     };
 
     enable = mkEnableOption "Hop.nvim plugin (easy motion)";

modules/plugins/utility/motion/leap/config.nix

@@ -4,7 +4,7 @@
   ...
 }: let
   inherit (lib.modules) mkIf mkDefault;
-  inherit (lib.nvim.binds) mkKeymap;
+  inherit (lib.nvim.binds) mkLznBinding;
 
   cfg = config.vim.utility.motion.leap;
 in {
@@ -14,11 +14,11 @@ in {
       lazy.plugins.leap-nvim = {
         package = "leap-nvim";
         keys = [
-          (mkKeymap ["n" "o" "x"] cfg.mappings.leapForwardTo "<Plug>(leap-forward-to)" {desc = "Leap forward to";})
+          (mkLznBinding ["n" "o" "x"] cfg.mappings.leapForwardTo "<Plug>(leap-forward-to)" "Leap forward to")
-          (mkKeymap ["n" "o" "x"] cfg.mappings.leapBackwardTo "<Plug>(leap-backward-to)" {desc = "Leap backward to";})
+          (mkLznBinding ["n" "o" "x"] cfg.mappings.leapBackwardTo "<Plug>(leap-backward-to)" "Leap backward to")
-          (mkKeymap ["n" "o" "x"] cfg.mappings.leapForwardTill "<Plug>(leap-forward-till)" {desc = "Leap forward till";})
+          (mkLznBinding ["n" "o" "x"] cfg.mappings.leapForwardTill "<Plug>(leap-forward-till)" "Leap forward till")
-          (mkKeymap ["n" "o" "x"] cfg.mappings.leapBackwardTill "<Plug>(leap-backward-till)" {desc = "Leap backward till";})
+          (mkLznBinding ["n" "o" "x"] cfg.mappings.leapBackwardTill "<Plug>(leap-backward-till)" "Leap backward till")
-          (mkKeymap ["n" "o" "x"] cfg.mappings.leapFromWindow "<Plug>(leap-from-window)" {desc = "Leap from window";})
+          (mkLznBinding ["n" "o" "x"] cfg.mappings.leapFromWindow "<Plug>(leap-from-window)" "Leap from window")
         ];
 
         after = ''

modules/plugins/utility/telescope/config.nix

@@ -5,14 +5,15 @@
   ...
 }: let
   inherit (lib.modules) mkIf;
+  inherit (lib.nvim.binds) addDescriptionsToMappings;
   inherit (lib.strings) optionalString;
   inherit (lib.lists) optionals;
-  inherit (lib.nvim.binds) pushDownDefault mkKeymap;
+  inherit (lib.nvim.binds) pushDownDefault mkSetLznBinding;
 
   cfg = config.vim.telescope;
+  mappingDefinitions = options.vim.telescope.mappings;
 
-  keys = cfg.mappings;
+  mappings = addDescriptionsToMappings cfg.mappings mappingDefinitions;
-  inherit (options.vim.telescope) mappings;
 in {
   config = mkIf cfg.enable {
     vim = {
@@ -33,35 +34,38 @@ in {
 
         keys =
           [
-            (mkKeymap "n" keys.findFiles "<cmd>Telescope find_files<CR>" {desc = mappings.findFiles.description;})
+            (mkSetLznBinding mappings.findFiles "<cmd> Telescope find_files<CR>")
-            (mkKeymap "n" keys.liveGrep "<cmd>Telescope live_grep<CR>" {desc = mappings.liveGrep.description;})
+            (mkSetLznBinding mappings.liveGrep "<cmd> Telescope live_grep<CR>")
-            (mkKeymap "n" keys.buffers "<cmd>Telescope buffers<CR>" {desc = mappings.buffers.description;})
+            (mkSetLznBinding mappings.buffers "<cmd> Telescope buffers<CR>")
-            (mkKeymap "n" keys.helpTags "<cmd>Telescope help_tags<CR>" {desc = mappings.helpTags.description;})
+            (mkSetLznBinding mappings.helpTags "<cmd> Telescope help_tags<CR>")
-            (mkKeymap "n" keys.open "<cmd>Telescope<CR>" {desc = mappings.open.description;})
+            (mkSetLznBinding mappings.open "<cmd> Telescope<CR>")
-            (mkKeymap "n" keys.resume "<cmd>Telescope resume<CR>" {desc = mappings.resume.description;})
 
-            (mkKeymap "n" keys.gitCommits "<cmd>Telescope git_commits<CR>" {desc = mappings.gitCommits.description;})
+            (mkSetLznBinding mappings.gitCommits "<cmd> Telescope git_commits<CR>")
-            (mkKeymap "n" keys.gitBufferCommits "<cmd>Telescope git_bcommits<CR>" {desc = mappings.gitBufferCommits.description;})
+            (mkSetLznBinding mappings.gitBufferCommits "<cmd> Telescope git_bcommits<CR>")
-            (mkKeymap "n" keys.gitBranches "<cmd>Telescope git_branches<CR>" {desc = mappings.gitBranches.description;})
+            (mkSetLznBinding mappings.gitBranches "<cmd> Telescope git_branches<CR>")
-            (mkKeymap "n" keys.gitStatus "<cmd>Telescope git_status<CR>" {desc = mappings.gitStatus.description;})
+            (mkSetLznBinding mappings.gitStatus "<cmd> Telescope git_status<CR>")
-            (mkKeymap "n" keys.gitStash "<cmd>Telescope git_stash<CR>" {desc = mappings.gitStash.description;})
+            (mkSetLznBinding mappings.gitStash "<cmd> Telescope git_stash<CR>")
           ]
           ++ (optionals config.vim.lsp.enable [
-            (mkKeymap "n" keys.lspDocumentSymbols "<cmd>Telescope lsp_document_symbols<CR>" {desc = mappings.lspDocumentSymbols.description;})
+            (mkSetLznBinding mappings.lspDocumentSymbols "<cmd> Telescope lsp_document_symbols<CR>")
-            (mkKeymap "n" keys.lspWorkspaceSymbols "<cmd>Telescope lsp_workspace_symbols<CR>" {desc = mappings.lspWorkspaceSymbols.description;})
+            (mkSetLznBinding mappings.lspWorkspaceSymbols "<cmd> Telescope lsp_workspace_symbols<CR>")
 
-            (mkKeymap "n" keys.lspReferences "<cmd>Telescope lsp_references<CR>" {desc = mappings.lspReferences.description;})
+            (mkSetLznBinding mappings.lspReferences "<cmd> Telescope lsp_references<CR>")
-            (mkKeymap "n" keys.lspImplementations "<cmd>Telescope lsp_implementations<CR>" {desc = mappings.lspImplementations.description;})
+            (mkSetLznBinding mappings.lspImplementations "<cmd> Telescope lsp_implementations<CR>")
-            (mkKeymap "n" keys.lspDefinitions "<cmd>Telescope lsp_definitions<CR>" {desc = mappings.lspDefinitions.description;})
+            (mkSetLznBinding mappings.lspDefinitions "<cmd> Telescope lsp_definitions<CR>")
-            (mkKeymap "n" keys.lspTypeDefinitions "<cmd>Telescope lsp_type_definitions<CR>" {desc = mappings.lspTypeDefinitions.description;})
+            (mkSetLznBinding mappings.lspTypeDefinitions "<cmd> Telescope lsp_type_definitions<CR>")
-            (mkKeymap "n" keys.diagnostics "<cmd>Telescope diagnostics<CR>" {desc = mappings.diagnostics.description;})
+            (mkSetLznBinding mappings.diagnostics "<cmd> Telescope diagnostics<CR>")
           ])
-          ++ optionals config.vim.treesitter.enable [
+          ++ (
-            (mkKeymap "n" keys.treesitter "<cmd>Telescope treesitter<CR>" {desc = mappings.treesitter.description;})
+            optionals config.vim.treesitter.enable [
-          ]
+              (mkSetLznBinding mappings.treesitter "<cmd> Telescope treesitter<CR>")
-          ++ optionals config.vim.projects.project-nvim.enable [
+            ]
-            (mkKeymap "n" keys.findProjects "<cmd>Telescope projects<CR>" {desc = mappings.findProjects.description;})
+          )
-          ];
+          ++ (
+            optionals config.vim.projects.project-nvim.enable [
+              (mkSetLznBinding mappings.findProjects "<cmd Telescope projects<CR>")
+            ]
+          );
       };
 
       binds.whichKey.register = pushDownDefault {

modules/plugins/utility/telescope/telescope.nix

@@ -134,7 +134,7 @@
         default = ["absolute"];
       };
       set_env = mkOption {
-        description = "Set an environment for term_previewer";
+        description = "Set an envrionment for term_previewer";
         type = attrsOf str;
         default = {
           COLORTERM = "truecolor";

modules/wrapper/lazy/config.nix

@@ -3,12 +3,13 @@
   config,
   ...
 }: let
-  inherit (builtins) toJSON typeOf head length filter concatLists concatStringsSep tryEval;
+  inherit (builtins) toJSON typeOf head length filter concatLists concatStringsSep;
   inherit (lib.attrsets) mapAttrsToList;
   inherit (lib.modules) mkIf mkMerge;
   inherit (lib.generators) mkLuaInline;
   inherit (lib.strings) optionalString;
   inherit (lib.nvim.lua) toLuaObject;
+  inherit (lib.nvim.dag) entryBefore entryAfter;
   cfg = config.vim.lazy;
 
   toLuaLznKeySpec = keySpec:
@@ -21,45 +22,10 @@
         else keySpec.action;
     };
 
-  toLuaLznSpec = name: spec: let
+  toLuaLznSpec = name: spec:
-    packageName =
-      if typeOf spec.package == "string"
-      then spec.package
-      else if (spec.package ? pname && (tryEval spec.package.pname).success)
-      then spec.package.pname
-      else spec.package.name;
-  in
     (removeAttrs spec ["package" "setupModule" "setupOpts" "keys"])
     // {
-      "@1" =
+      "@1" = name;
-        if spec.package != null && packageName != name && spec.load == null
-        then
-          abort ''
-            vim.lazy.plugins.${name} does not match the package name ${packageName}.
-
-            Please either:
-            - rename it to vim.lazy.plugins.${packageName}, or
-            - if you intend to use a custom loader, specify a
-              vim.lazy.plugins.${name}.load function.
-          ''
-        else if spec.package == null && spec.load == null
-        then
-          abort ''
-            vim.lazy.plugins.${name} has null package but no load function given.
-
-            Please either specify a package, or (if you know what you're doing) provide a
-            custom load function.
-          ''
-        else name;
-      beforeAll =
-        if spec.beforeAll != null
-        then
-          mkLuaInline ''
-            function()
-              ${spec.beforeAll}
-            end
-          ''
-        else null;
       before =
         if spec.before != null
         then
@@ -84,16 +50,6 @@
             end
           '';
 
-      load =
-        if spec.load != null
-        then
-          mkLuaInline ''
-            function(name)
-              ${spec.load}
-            end
-          ''
-        else null;
-
       keys =
         if typeOf spec.keys == "list" && length spec.keys > 0 && typeOf (head spec.keys) == "set"
         then map toLuaLznKeySpec (filter (keySpec: keySpec.key != null) spec.keys)
@@ -102,7 +58,7 @@
     };
   lznSpecs = mapAttrsToList toLuaLznSpec cfg.plugins;
 
-  pluginPackages = filter (x: x != null) (mapAttrsToList (_: plugin: plugin.package) cfg.plugins);
+  pluginPackages = mapAttrsToList (_: plugin: plugin.package) cfg.plugins;
 
   specToNotLazyConfig = _: spec: ''
     do

modules/wrapper/lazy/lazy.nix

@@ -22,21 +22,21 @@
       '';
 
       desc = mkOption {
+        description = "Description of the key map";
         type = nullOr str;
         default = null;
-        description = "Description of the key map";
       };
 
       ft = mkOption {
+        description = "TBD";
         type = nullOr (listOf str);
         default = null;
-        description = "TBD";
       };
 
       mode = mkOption {
-        type = either str (listOf str);
-        example = ["n" "x" "o"];
         description = "Modes to bind in";
+        type = either str (listOf str);
+        default = ["n" "x" "s" "o"];
       };
 
       silent = mkBool true "Whether this mapping should be silent. Equivalent to adding <silent> to a map.";
@@ -48,95 +48,93 @@
     };
   };
 
-  lznEvent = submodule {
-    options = {
-      event = mkOption {
-        type = nullOr (either str (listOf str));
-        example = "BufEnter";
-        description = "Exact event name";
-      };
-      pattern = mkOption {
-        type = nullOr (either str (listOf str));
-        example = "BufEnter *.lua";
-        description = "Event pattern";
-      };
-    };
-  };
-
   lznPluginType = submodule {
     options = {
       package = mkOption {
-        type = nullOr pluginType;
+        type = pluginType;
-        description = ''
+        description = "Plugin package";
-          Plugin package.
-
-          If null, a custom load function must be provided
-        '';
       };
 
       setupModule = mkOption {
         type = nullOr str;
-        default = null;
         description = "Lua module to run setup function on.";
+        default = null;
       };
 
       setupOpts = mkOption {
         type = attrsOf anything;
-        default = {};
         description = "Options to pass to the setup function";
+        default = {};
       };
 
       # lz.n options
 
       enabled = mkOption {
         type = nullOr (either bool str);
-        default = null;
         description = "When false, or if the lua function returns false, this plugin will not be included in the spec";
+        default = null;
       };
 
       beforeAll = mkOption {
         type = nullOr lines;
-        default = null;
         description = "Lua code to run before any plugins are loaded. This will be wrapped in a function.";
+        default = null;
       };
 
       before = mkOption {
         type = nullOr lines;
-        default = null;
         description = "Lua code to run before plugin is loaded. This will be wrapped in a function.";
+        default = null;
       };
 
       after = mkOption {
         type = nullOr lines;
-        default = null;
         description = ''
           Lua code to run after plugin is loaded. This will be wrapped in a function.
 
           If [](#opt-vim.lazy.plugins._name_.setupModule) is provided, the setup will be ran before `after`.
         '';
+        default = null;
       };
 
       event = mkOption {
-        type = nullOr (oneOf [str (listOf str) lznEvent]);
-        default = null;
         description = "Lazy-load on event";
+        default = null;
+        type = let
+          event = submodule {
+            options = {
+              event = mkOption {
+                type = nullOr (either str (listOf str));
+                description = "Exact event name";
+                example = "BufEnter";
+              };
+              pattern = mkOption {
+                type = nullOr (either str (listOf str));
+                description = "Event pattern";
+                example = "BufEnter *.lua";
+              };
+            };
+          };
+        in
+          nullOr (oneOf [str (listOf str) event]);
       };
 
       cmd = mkOption {
-        type = nullOr (either str (listOf str));
-        default = null;
         description = "Lazy-load on command";
+        default = null;
+        type = nullOr (either str (listOf str));
       };
 
       ft = mkOption {
-        type = nullOr (either str (listOf str));
-        default = null;
         description = "Lazy-load on filetype";
+        default = null;
+        type = nullOr (either str (listOf str));
       };
 
       keys = mkOption {
-        type = nullOr (oneOf [str (listOf lznKeysSpec) (listOf str)]);
+        description = "Lazy-load on key mapping";
         default = null;
+        type = nullOr (oneOf [str (listOf lznKeysSpec) (listOf str)]);
         example = ''
           keys = [
             {
@@ -154,21 +152,20 @@
             }
           ]
         '';
-        description = "Lazy-load on key mapping";
       };
 
       colorscheme = mkOption {
+        description = "Lazy-load on colorscheme.";
         type = nullOr (either str (listOf str));
         default = null;
-        description = "Lazy-load on colorscheme.";
       };
 
       lazy = mkBool false "Lazy-load manually, e.g. using `trigger_load`.";
 
       priority = mkOption {
         type = nullOr int;
-        default = null;
         description = "Only useful for stat plugins (not lazy-loaded) to force loading certain plugins first.";
+        default = null;
       };
 
       load = mkOption {
@@ -177,7 +174,7 @@
         description = ''
           Lua code to override the `vim.g.lz_n.load()` function for a single plugin.
 
-          This will be wrapped in a `function(name) ... end`.
+          This will be wrapped in a function.
         '';
       };
     };
@@ -186,14 +183,20 @@ in {
   options.vim.lazy = {
     enable = mkEnableOption "plugin lazy-loading via lz.n and lzn-auto-require" // {default = true;};
     loader = mkOption {
+      description = "Lazy loader to use";
       type = enum ["lz.n"];
       default = "lz.n";
-      description = "Lazy loader to use";
     };
 
     plugins = mkOption {
-      type = attrsOf lznPluginType;
       default = {};
+      type = attrsOf lznPluginType;
+      description = ''
+        Plugins to lazy load.
+
+        The attribute key is used as the plugin name: for the default `vim.g.lz_n.load`
+        function this should be either the `package.pname` or `package.name`.
+      '';
       example = ''
         {
           toggleterm-nvim = {
@@ -211,21 +214,15 @@ in {
           };
         }
       '';
-      description = ''
-        Plugins to lazy load.
-
-        The attribute key is used as the plugin name: for the default `vim.g.lz_n.load`
-        function this should be either the `package.pname` or `package.name`.
-      '';
     };
 
     enableLznAutoRequire = mkOption {
-      type = bool;
-      default = true;
       description = ''
         Enable lzn-auto-require. Since builtin plugins rely on this, only turn
         off for debugging.
       '';
+      type = bool;
+      default = true;
     };
 
     builtLazyConfig = mkOption {