retrovim 0.0.3

package/nvim/plugins/mini.nvim/readmes/mini-bufremove.md

@@ -0,0 +1,139 @@
+<p align="center"> <img src="https://github.com/nvim-mini/assets/blob/main/logo-2/logo-bufremove_readme.png?raw=true" alt="mini.bufremove" style="max-width:100%;border:solid 2px"/> </p>
+
+### Buffer removing (unshow, delete, wipeout), which saves window layout
+
+See more details in [Features](#features) and [Documentation](../doc/mini-bufremove.txt).
+
+---
+
+> [!NOTE]
+> This was previously hosted at a personal `echasnovski` GitHub account. It was transferred to a dedicated organization to improve long term project stability. See more details [here](https://github.com/nvim-mini/mini.nvim/discussions/1970).
+
+⦿ This is a part of [mini.nvim](https://nvim-mini.org/mini.nvim) library. Please use [this link](https://nvim-mini.org/mini.nvim/readmes/mini-bufremove) if you want to mention this module.
+
+⦿ All contributions (issues, pull requests, discussions, etc.) are done inside of 'mini.nvim'.
+
+⦿ See [whole library documentation](https://nvim-mini.org/mini.nvim/doc/mini-nvim) to learn about general design principles, disable/configuration recipes, and more.
+
+⦿ See [MiniMax](https://nvim-mini.org/MiniMax) for a full config example that uses this module.
+
+---
+
+If you want to help this project grow but don't know where to start, check out [contributing guides of 'mini.nvim'](https://nvim-mini.org/mini.nvim/CONTRIBUTING) or leave a Github star for 'mini.nvim' project and/or any its standalone Git repositories.
+
+## Demo
+
+<!-- Demo source: https://github.com/nvim-mini/assets/blob/main/demo/demo-bufremove.mp4 -->
+https://user-images.githubusercontent.com/24854248/173044032-7874cf95-2e41-49fb-8abe-3aa73526972f.mp4
+
+## Features
+
+Which buffer to show in window(s) after its current buffer is removed is decided by the algorithm:
+
+- If alternate buffer is listed, use it.
+- If previous listed buffer is different, use it.
+- Otherwise create a scratch one with `nvim_create_buf(true, true)` and use it.
+
+## Installation
+
+This plugin can be installed as part of 'mini.nvim' library (**recommended**) or as a standalone Git repository.
+
+There are two branches to install from:
+
+- `main` (default, **recommended**) will have latest development version of plugin. All changes since last stable release should be perceived as being in beta testing phase (meaning they already passed alpha-testing and are moderately settled).
+- `stable` will be updated only upon releases with code tested during public beta-testing phase in `main` branch.
+
+Here are code snippets for some common installation methods (use only one):
+
+<details>
+<summary><b>(Recommended)</b> With <a href="https://neovim.io/doc/user/helptag.html?tag=vim.pack">vim.pack</a> (on Neovim 0.12 and newer)</summary>
+
+**Full library**
+
+Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
+
+**Standalone plugin**
+
+Main branch:
+
+```lua
+vim.pack.add({ 'https://github.com/nvim-mini/mini.bufremove' })
+```
+
+Stable branch:
+
+```lua
+vim.pack.add({
+  { src = 'https://github.com/nvim-mini/mini.bufremove', version = 'stable' },
+})
+```
+
+</details>
+
+<details>
+<summary>With <a href="https://nvim-mini.org/mini.nvim/readmes/mini-deps">mini.deps</a> (before Neovim 0.12)</summary>
+
+**Full library**
+
+Follow [recommended 'mini.deps' installation](https://nvim-mini.org/mini.nvim/readmes/mini-deps#installation).
+
+**Standalone plugin**:
+
+Main branch:
+
+```lua
+add('nvim-mini/mini.bufremove')
+```
+
+Stable branch:
+
+```lua
+add({ source = 'nvim-mini/mini.bufremove', checkout = 'stable' })
+```
+
+</details>
+
+<details>
+<summary>With <a href="https://github.com/folke/lazy.nvim">folke/lazy.nvim</a></summary>
+
+**Full library**
+
+Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
+
+**Standalone plugin**
+
+Main branch:
+
+```lua
+{ 'nvim-mini/mini.bufremove', version = false },
+```
+
+Stable branch:
+
+```lua
+{ 'nvim-mini/mini.bufremove', version = '*' },
+```
+
+</details>
+
+**Important**: no need to call `require('mini.bufremove').setup()`, but it can be done to improve usability.
+
+**Note**: if you are on Windows, there might be problems with too long file paths (like `error: unable to create file <some file name>: Filename too long`). Try doing one of the following:
+
+- Enable corresponding git global config value: `git config --system core.longpaths true`. Then try to reinstall.
+- Install plugin in other place with shorter path.
+
+## Default config
+
+```lua
+-- No need to copy this inside `setup()`. Will be used automatically.
+{
+  -- Whether to disable showing non-error feedback
+  silent = false,
+}
+```
+
+## Similar plugins
+
+- [mhinz/vim-sayonara](https://github.com/mhinz/vim-sayonara)
+- [moll/vim-bbye](https://github.com/moll/vim-bbye)

package/nvim/plugins/mini.nvim/readmes/mini-clue.md

@@ -0,0 +1,260 @@
+<p align="center"> <img src="https://github.com/nvim-mini/assets/blob/main/logo-2/logo-clue_readme.png?raw=true" alt="mini.clue" style="max-width:100%;border:solid 2px"/> </p>
+
+### Show next key clues
+
+See more details in [Features](#features) and [Documentation](../doc/mini-clue.txt).
+
+---
+
+> [!NOTE]
+> This was previously hosted at a personal `echasnovski` GitHub account. It was transferred to a dedicated organization to improve long term project stability. See more details [here](https://github.com/nvim-mini/mini.nvim/discussions/1970).
+
+⦿ This is a part of [mini.nvim](https://nvim-mini.org/mini.nvim) library. Please use [this link](https://nvim-mini.org/mini.nvim/readmes/mini-clue) if you want to mention this module.
+
+⦿ All contributions (issues, pull requests, discussions, etc.) are done inside of 'mini.nvim'.
+
+⦿ See [whole library documentation](https://nvim-mini.org/mini.nvim/doc/mini-nvim) to learn about general design principles, disable/configuration recipes, and more.
+
+⦿ See [MiniMax](https://nvim-mini.org/MiniMax) for a full config example that uses this module.
+
+---
+
+If you want to help this project grow but don't know where to start, check out [contributing guides of 'mini.nvim'](https://nvim-mini.org/mini.nvim/CONTRIBUTING) or leave a Github star for 'mini.nvim' project and/or any its standalone Git repositories.
+
+## Demo
+
+<!-- Demo source: https://github.com/nvim-mini/assets/blob/main/demo/demo-clue.mp4 -->
+https://github.com/nvim-mini/mini.nvim/assets/24854248/ea931966-067c-48af-93e9-36e9b8afb0ae
+
+## Features
+
+- Implement custom key query process to reach target key combination:
+    - Starts after customizable opt-in triggers (mode + keys).
+
+    - Each key press narrows down set of possible targets.
+
+      Pressing `<BS>` removes previous user entry.
+
+      Pressing `<Esc>` or `<C-c>` leads to an early stop.
+
+      Doesn't depend on 'timeoutlen' and has basic support for 'langmap'.
+
+    - Ends when there is at most one target left or user pressed `<CR>`. Results into emulating pressing all query keys plus possible postkeys.
+
+- Show window (after configurable delay) with clues. It lists available next keys along with their descriptions (auto generated from descriptions present keymaps and user-supplied clues; preferring the former).
+
+- Configurable "postkeys" for key combinations - keys which will be emulated after combination is reached during key query process.
+
+- Provide customizable sets of clues for common built-in keys/concepts:
+    - `g` key.
+    - `z` key.
+    - Window commands.
+    - Built-in completion.
+    - Marks.
+    - Registers.
+
+- Lua functions to disable/enable triggers globally or per buffer.
+
+For more information see these parts of help:
+
+- `:h MiniClue-key-query-process`
+- `:h MiniClue-examples`
+- `:h MiniClue.config`
+- `:h MiniClue.gen_clues`
+
+Notes:
+
+- There is no functionality to create mappings in order to clearly separate two different tasks.
+
+  The best suggested practice is to manually create mappings with descriptions (`desc` field in options), as they will be automatically used inside clue window.
+
+- Triggers are implemented as special buffer-local mappings. This leads to several caveats:
+    - They will override same regular buffer-local mappings and have precedence over global one.
+
+      Example: having set `<C-w>` as Normal mode trigger means that there should not be another `<C-w>` mapping.
+
+    - They need to be the latest created buffer-local mappings or they will not function properly. Most common indicator of this is that some mapping starts to work only after clue window is shown.
+
+      Example: `g` is set as Normal mode trigger, but `gcc` from 'mini.comment' doesn't work right away. This is probably because there are some other buffer-local mappings starting with `g` which were created after mapping for `g` trigger. Most common places for this are in LSP server's `on_attach` or during tree-sitter start in buffer.
+
+      To check if trigger is the most recent buffer-local mapping, execute `:<mode-char>map <trigger-keys>` (like `:nmap g` for previous example). Mapping for trigger should be the first listed.
+
+      This module makes the best effort to work out of the box and cover most common cases, but it is not foolproof. The solution here is to ensure that triggers are created after making all buffer-local mappings: run either `MiniClue.setup()` or `MiniClue.ensure_buf_triggers()`.
+
+- Descriptions from existing mappings take precedence over user-supplied clues. This is to ensure that information shown in clue window is as relevant as possible. To add/customize description of an already existing mapping, use `MiniClue.set_mapping_desc()`.
+
+- Due to technical difficulties, there is no foolproof support for Operator-pending mode triggers (like `a`/`i` from 'mini.ai'):
+    - Doesn't work as part of a command in "temporary Normal mode" (like after `<C-o>` in Insert mode) due to implementation difficulties.
+    - Can have unexpected behavior with custom operators.
+
+- Has (mostly solved) issues with macros:
+    - All triggers are disabled during macro recording due to technical reasons.
+    - The `@` and `Q` keys are specially mapped inside `MiniClue.setup()` to temporarily disable triggers.
+
+## Config quick start
+
+```lua
+local miniclue = require('mini.clue')
+miniclue.setup({
+  triggers = {
+    -- Leader triggers
+    { mode = { 'n', 'x' }, keys = '<Leader>' },
+
+    -- `[` and `]` keys
+    { mode = 'n', keys = '[' },
+    { mode = 'n', keys = ']' },
+
+    -- Built-in completion
+    { mode = 'i', keys = '<C-x>' },
+
+    -- `g` key
+    { mode = { 'n', 'x' }, keys = 'g' },
+
+    -- Marks
+    { mode = { 'n', 'x' }, keys = "'" },
+    { mode = { 'n', 'x' }, keys = '`' },
+
+    -- Registers
+    { mode = { 'n', 'x' }, keys = '"' },
+    { mode = { 'i', 'c' }, keys = '<C-r>' },
+
+    -- Window commands
+    { mode = 'n', keys = '<C-w>' },
+
+    -- `z` key
+    { mode = { 'n', 'x' }, keys = 'z' },
+  },
+
+  clues = {
+    -- Enhance this by adding descriptions for <Leader> mapping groups
+    miniclue.gen_clues.square_brackets(),
+    miniclue.gen_clues.builtin_completion(),
+    miniclue.gen_clues.g(),
+    miniclue.gen_clues.marks(),
+    miniclue.gen_clues.registers(),
+    miniclue.gen_clues.windows(),
+    miniclue.gen_clues.z(),
+  },
+})
+```
+
+## Installation
+
+This plugin can be installed as part of 'mini.nvim' library (**recommended**) or as a standalone Git repository.
+
+There are two branches to install from:
+
+- `main` (default, **recommended**) will have latest development version of plugin. All changes since last stable release should be perceived as being in beta testing phase (meaning they already passed alpha-testing and are moderately settled).
+- `stable` will be updated only upon releases with code tested during public beta-testing phase in `main` branch.
+
+Here are code snippets for some common installation methods (use only one):
+
+<details>
+<summary><b>(Recommended)</b> With <a href="https://neovim.io/doc/user/helptag.html?tag=vim.pack">vim.pack</a> (on Neovim 0.12 and newer)</summary>
+
+**Full library**
+
+Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
+
+**Standalone plugin**
+
+Main branch:
+
+```lua
+vim.pack.add({ 'https://github.com/nvim-mini/mini.clue' })
+```
+
+Stable branch:
+
+```lua
+vim.pack.add({
+  { src = 'https://github.com/nvim-mini/mini.clue', version = 'stable' },
+})
+```
+
+</details>
+
+<details>
+<summary>With <a href="https://nvim-mini.org/mini.nvim/readmes/mini-deps">mini.deps</a> (before Neovim 0.12)</summary>
+
+**Full library**
+
+Follow [recommended 'mini.deps' installation](https://nvim-mini.org/mini.nvim/readmes/mini-deps#installation).
+
+**Standalone plugin**:
+
+Main branch:
+
+```lua
+add('nvim-mini/mini.clue')
+```
+
+Stable branch:
+
+```lua
+add({ source = 'nvim-mini/mini.clue', checkout = 'stable' })
+```
+
+</details>
+
+<details>
+<summary>With <a href="https://github.com/folke/lazy.nvim">folke/lazy.nvim</a></summary>
+
+**Full library**
+
+Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
+
+**Standalone plugin**
+
+Main branch:
+
+```lua
+{ 'nvim-mini/mini.clue', version = false },
+```
+
+Stable branch:
+
+```lua
+{ 'nvim-mini/mini.clue', version = '*' },
+```
+
+</details>
+
+**Important**: don't forget to call `require('mini.clue').setup()` to enable its functionality. **Needs to have triggers configured**.
+
+**Note**: if you are on Windows, there might be problems with too long file paths (like `error: unable to create file <some file name>: Filename too long`). Try doing one of the following:
+
+- Enable corresponding git global config value: `git config --system core.longpaths true`. Then try to reinstall.
+- Install plugin in other place with shorter path.
+
+## Default config
+
+```lua
+-- No need to copy this inside `setup()`. Will be used automatically.
+{
+  -- Array of extra clues to show
+  clues = {},
+
+  -- Array of opt-in triggers which start custom key query process.
+  -- **Needs to have something in order to show clues**.
+  triggers = {},
+
+  -- Clue window settings
+  window = {
+    -- Floating window config
+    config = {},
+
+    -- Delay before showing clue window
+    delay = 1000,
+
+    -- Keys to scroll inside the clue window
+    scroll_down = '<C-d>',
+    scroll_up = '<C-u>',
+  },
+}
+```
+
+## Similar plugins
+
+- [folke/which-key.nvim](https://github.com/folke/which-key.nvim)
+- [anuvyklack/hydra.nvim](https://github.com/anuvyklack/hydra.nvim)

package/nvim/plugins/mini.nvim/readmes/mini-cmdline.md

@@ -0,0 +1,183 @@
+<p align="center"> <img src="https://github.com/nvim-mini/assets/blob/main/logo-2/logo-cmdline_readme.png?raw=true" alt="mini.cmdline" style="max-width:100%;border:solid 2px"/> </p>
+
+### Command line tweaks
+
+See more details in [Features](#features) and [Documentation](../doc/mini-cmdline.txt).
+
+---
+
+⦿ This is a part of [mini.nvim](https://nvim-mini.org/mini.nvim) library. Please use [this link](https://nvim-mini.org/mini.nvim/readmes/mini-cmdline) if you want to mention this module.
+
+⦿ All contributions (issues, pull requests, discussions, etc.) are done inside of 'mini.nvim'.
+
+⦿ See [whole library documentation](https://nvim-mini.org/mini.nvim/doc/mini-nvim) to learn about general design principles, disable/configuration recipes, and more.
+
+⦿ See [MiniMax](https://nvim-mini.org/MiniMax) for a full config example that uses this module.
+
+---
+
+If you want to help this project grow but don't know where to start, check out [contributing guides of 'mini.nvim'](https://nvim-mini.org/mini.nvim/CONTRIBUTING) or leave a Github star for 'mini.nvim' project and/or any its standalone Git repositories.
+
+## Demo
+
+<!-- Demo source: https://github.com/nvim-mini/assets/blob/main/demo/demo-cmdline.mp4 -->
+https://github.com/user-attachments/assets/9d3e12ac-ff17-4bdb-bbe8-3010c966c110
+
+## Features
+
+- Autocomplete with customizable delay. Enhances [`:h cmdline-completion`](https://neovim.io/doc/user/helptag.html?tag=cmdline-completion) and manual [`:h 'wildchar'`](https://neovim.io/doc/user/helptag.html?tag='wildchar') pressing experience. Requires Neovim>=0.11, though Neovim>=0.12 is recommended.
+
+- Autocorrect words as-you-type. Only words that must come from a fixed set of candidates (like commands and options) are autocorrected by default.
+
+- Autopeek command range as-you-type. Shows a floating window with range lines along with customizable context lines.
+
+What it doesn't do:
+
+- Customization of command line UI. Use [`:h vim._extui`](https://neovim.io/doc/user/helptag.html?tag=vim._extui) (on Neovim>=0.12).
+
+- Customization of autocompletion candidates. They are computed via [`:h cmdline-completion`](https://neovim.io/doc/user/helptag.html?tag=cmdline-completion).
+
+## Installation
+
+This plugin can be installed as part of 'mini.nvim' library (**recommended**) or as a standalone Git repository.
+
+There are two branches to install from:
+
+- `main` (default, **recommended**) will have latest development version of plugin. All changes since last stable release should be perceived as being in beta testing phase (meaning they already passed alpha-testing and are moderately settled).
+- `stable` will be updated only upon releases with code tested during public beta-testing phase in `main` branch.
+
+Here are code snippets for some common installation methods (use only one):
+
+<details>
+<summary><b>(Recommended)</b> With <a href="https://neovim.io/doc/user/helptag.html?tag=vim.pack">vim.pack</a> (on Neovim 0.12 and newer)</summary>
+
+**Full library**
+
+Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
+
+**Standalone plugin**
+
+Main branch:
+
+```lua
+vim.pack.add({ 'https://github.com/nvim-mini/mini.cmdline' })
+```
+
+Stable branch:
+
+```lua
+vim.pack.add({
+  { src = 'https://github.com/nvim-mini/mini.cmdline', version = 'stable' },
+})
+```
+
+</details>
+
+<details>
+<summary>With <a href="https://nvim-mini.org/mini.nvim/readmes/mini-deps">mini.deps</a> (before Neovim 0.12)</summary>
+
+**Full library**
+
+Follow [recommended 'mini.deps' installation](https://nvim-mini.org/mini.nvim/readmes/mini-deps#installation).
+
+**Standalone plugin**:
+
+Main branch:
+
+```lua
+add('nvim-mini/mini.cmdline')
+```
+
+Stable branch:
+
+```lua
+add({ source = 'nvim-mini/mini.cmdline', checkout = 'stable' })
+```
+
+</details>
+
+<details>
+<summary>With <a href="https://github.com/folke/lazy.nvim">folke/lazy.nvim</a></summary>
+
+**Full library**
+
+Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
+
+**Standalone plugin**
+
+Main branch:
+
+```lua
+{ 'nvim-mini/mini.cmdline', version = false },
+```
+
+Stable branch:
+
+```lua
+{ 'nvim-mini/mini.cmdline', version = '*' },
+```
+
+</details>
+
+**Important**: don't forget to call `require('mini.cmdline').setup()` to enable its functionality.
+
+**Note**: if you are on Windows, there might be problems with too long file paths (like `error: unable to create file <some file name>: Filename too long`). Try doing one of the following:
+
+- Enable corresponding git global config value: `git config --system core.longpaths true`. Then try to reinstall.
+- Install plugin in other place with shorter path.
+
+## Default config
+
+```lua
+-- No need to copy this inside `setup()`. Will be used automatically.
+{
+  -- Autocompletion: show `:h 'wildmenu'` as you type
+  autocomplete = {
+    enable = true,
+
+    -- Delay (in ms) after which to trigger completion
+    -- Neovim>=0.12 is recommended for positive values
+    delay = 0,
+
+    -- Custom rule of when to trigger completion
+    predicate = nil,
+
+    -- Whether to map arrow keys for more consistent wildmenu behavior
+    map_arrows = true,
+  },
+
+  -- Autocorrection: adjust non-existing words (commands, options, etc.)
+  autocorrect = {
+    enable = true,
+
+    -- Custom autocorrection rule
+    func = nil,
+  },
+
+  -- Autopeek: show command's target range in a floating window
+  autopeek = {
+    enable = true,
+
+    -- Number of lines to show above and below range lines
+    n_context = 1,
+
+    -- Custom rule of when to show peek window
+    predicate = nil,
+
+    -- Window options
+    window = {
+      -- Floating window config
+      config = {},
+
+      -- Function to render statuscolumn
+      statuscolumn = nil,
+    },
+  },
+}
+```
+
+## Similar plugins
+
+- [folke/noice.nvim](https://github.com/folke/noice.nvim)
+- [nacro90/numb.nvim](https://github.com/nacro90/numb.nvim)
+- Built-in [cmdline-autocompletion](https://neovim.io/doc/user/helptag.html?tag=cmdline-autocompletion) (on Neovim>=0.12)