This is the log of changes for past and current development versions. It lists changes in user-facing functionality per module (or all modules) and type.

There are following change types:
- `Evolve` - change in previously intended functionality *while* adding a new one.
- `Refine` - change in previously intended functionality *without* adding new one. This is usually described as a "breaking change", but used here in a sense that it might break user's expectations about existing functionality.
- `Expand` - adding new functionality without affecting existing ones. This is essentially new features.

# Version 0.15.0.9000

## All

### Evolve

- Unify behavior of floating windows:
    - Truncate title/footer from left if it is too wide.
    - Set default title if window is allowed to have border.
    - Use single space padding for default title/footer.
    - Use 'single' as default window border in modules where it can be configured. On Neovim>=0.11 also respect non-empty 'winborder' option with lower precedence than explicitly configured value for the module.

- Unify how module-related buffers are named: `mini<module-name>://<buffer-number>/<useful-info>`. This structure allows creating identifiable, reasonably unique, and useful buffer names. This is a user facing change because in some cases the shown buffer's name will change (like in statusline of opened 'mini.starter' buffer or output of `:buffers!`).

- Stop forcing recommended option values behind `set_vim_settings` config setting. Instead set them automatically in `setup()`. If it is not essential, do so only if it was not set by user/plugin beforehand (no matter the value). Document this as a new general principle to be followed in the future. Affected modules:
    - 'mini.bufremove' (do nothing as recommended 'hidden' is on by default)
    - 'mini.completion' (conditionally set 'completeopt=menuone,noselect' and flags "c" in 'shortmess')
    - 'mini.statusline' (do nothing as recommended 'laststatus=2' is default)
    - 'mini.tabline' (unconditionally set 'showtabline=2', as it is essential to module's functinonality)

### Refine

- Soft deprecate support for Neovim 0.8. It will be fully stopped in next release.

## mini.ai

### Refine

- Visual textobject selection now puts the cursor on the right edge instead of left. This better aligns with the (undocumented) behavior of how built-in `a` / `i` textobjects work in Visual mode, as opposed to the (documented in `:h operator-resulting-pos`) behavior of how it is done after applying the operator.

### Expand

- Textobject identifier can now be any single character supported by `:h getcharstr()`. This also makes it possible to use characters outside of Latin alphanumeric and punctuation sets as `custom_textobjects` keys. Default textobject is extended to be anything but Latin letters (to fall back to `:h text-objects`).

- Update `gen_spec.treesitter()` to respect capture ranges specified by query directives (like `(#offset! @table.inner 0 1 0 -1)`).

## mini.base16

### Refine

- Update 'mini.pick' highlight groups to show prompt text with same colors as match ranges, as they are connected.

### Expand

- Add support for colored markdown headings.

- Add new plugin integrations:
    - 'ibhagwan/fzf-lua'
    - 'MeanderingProgrammer/render-markdown.nvim'
    - 'OXY2DEV/helpview.nvim'
    - 'OXY2DEV/markview.nvim'

## mini.colors

### Expand

- Update `convert()` to have `adjust_lightness` option which can be used to disable lightness adjustment (which is enabled by default for a more uniform progression from 0 to 100). This can be useful for output to be more consistent with other Oklab/Oklch implementations.

## mini.comment

### Expand

- Update textobject to respect `ignore_blank_line` option. Blank lines between commented lines are treated as part of a textobject.

## mini.completion

### Evolve

- Add snippet support. By default uses 'mini.snippets' to manage snippet session (if enabled, **highly recommended), falls back to `vim.snippet` on Neovim>=0.10. See "Snippets" section in `:h MiniCompletion` for more details.<br>
  This affect existing functionality because items with `Snippet` kind are no longer filtered out by default.

- Rework how LSP completion items are converted to Neovim's completion items:
    - Show `detail` highlighted as buffer's language at the start of info window, but only if `detail` provides information not already present in `documentation`. It was previously used as extra text in the popup menu (via `menu` field), but this doesn't quite follow LSP specification: `detail` and `documentation` fields can be delayed up until `completionItem/resolve` request which implies they should be treated similarly.
    - Show `labelDetails` as a part of the popup menu via `menu` completion item field.

- Rework how information window is shown with the goal to reduce flickering during fast up/down navigation through completion candidates:
    - Do not close the window immediately after the move. Instead highlight border with `MiniCompletionInfoBorderOutdated` immediately while update window when its content is ready. Close the window only if no candidate is selected.
    - Show content of already visited/resolved candidate without delay.
    - Show default `-No-info-` text if there is no extra information about the candidate.

- Update behavior and capabilities of `default_process_items()`:
    - Add `filtersort` option to control how items are filtered and/or sorted. Its new default value has changed behavior: do fuzzy matching if 'completeopt' option contains "fuzzy" entry; same as before otherwise.
    - Add `kind_priority` option to allow arranging items by completion item kind (like "Variable", "Snippet", "Text", etc.) after applying `filtersort`. This allows finer filter and/or sort based on kind, like "put Variable on top, Snippet on bottom, remove Text".
    - Use `filterText` and `label` item fields during matching (instead of `textEdit.newText`, `insertText`, and `label` as before). This is more aligned with LSP specification.

### Refine

- Prefer in some cases to use `nil` as default config value with explicit fallback. This should not have any user facing effects and marked as breaking only because a structure of a default config has changed. Affected fields:
    - `lsp_completion.process_items` (use `default_process_items` as fallback) and `fallback_action` (use `'<C-n>'` as fallback). This makes it more aligned with other modules that usually avoid using function values in default config.
    - `window.info.border` and `window.signature.border` (use non-empty 'winborder' and `'single'` as fallback).

- Change default value of `MiniCompletionActiveParameter` highlight group to link to `LspSignatureActiveParameter` (instead of forcing underline).

- Call `lsp_completion.process_items` with an array of items from all buffer servers at once (and not for each server separately). This can be used for more elaborate filter/sort strategies.

### Expand

- Add scrolling in info and signature window. By default can be done with `<C-f>` / `<C-b>` when target window is shown. Can be configured via `mappings.scroll_down` and `mappings.scroll_up` config options.

- Respect `isIncomplete` in LSP completion response and immediately force new completion request on the next key press.

- Add support for context in 'textDocument/completion' request.

- Both info and signature help windows now use tree-sitter highlighting:
    - Info window uses "markdown" parser (works best on Neovim>=0.10 as its parser is built-in). Special markdown characters are concealed (i.e. hidden) which might result into seemingly unnecessary whitespace as dimensions are computed not accounting for that.
    - Signature help uses same parser as in current filetype.

- Update signature help without delay if it is already shown. This helps to keep signature help up to date after cursor jumps in Insert mode (like during snippet session).

- Add support for item defaults in `CompletionList` response.

- Add `get_lsp_capabilities()` that returns data about which part of LSP specification is supported in 'mini.completion'.

- Input items for `lsp_completion.process_items` now have `client_id` field with the identifier of the server that item came from. Use `vim.lsp.get_client_by_id()` to get an actual data about the server.

## mini.diff

### Expand

- The `config.source` can now be array of sources, which will be attempted to attach in order. Important for source's `attach` to either return `false` or call `MiniDiff.fail_attach()` (even not immediately) to signal that source has failed to attach to a particular buffer.

- Overlay virtual lines now scroll horizontally along with buffer lines. Requires Neovim>=0.11 and disabled 'wrap' option.

- Highlighting of buffer parts of change hunks can now be customized with these new highlight groups:
    - `MiniDiffOverChangeBuf` - changed buffer text. Previously used `MiniDiffOverChange` (for changed reference text); links to it by default.
    - `MiniDiffOverContextBuf` - context of a change shown in buffer overlay. Previously not highlighted, default highlight group is not created.

## mini.doc

### Expand

- FEATURE: improve detection and formatting for types in `@param`, `@return`, and similar.

## mini.fuzzy

### Refine

- Update `process_lsp_items()` to only use `filterText` and `label` item fields during fuzzy matching (instead of `textEdit.newText`, `insertText`, and `label` as before). This is more aligned with LSP specification.

- Treat empty `word` as matching any candidate (matched positions is empty array and score is -1). This behavior is usually more useful in practice.

## mini.hues

### Evolve

### Refine

- Update 'mini.pick' highlight groups to show prompt text with same colors as match ranges, as they are connected.

### Expand

- Add support for colored markdown headings.

- Add new plugin integrations:
    - 'ibhagwan/fzf-lua'
    - 'MeanderingProgrammer/render-markdown.nvim'
    - 'OXY2DEV/helpview.nvim'
    - 'OXY2DEV/markview.nvim'


## mini.keymap

### Expand

- Introduction of a new module.

## mini.notify

### Expand

- Add `lsp_progress.level` option to control level of LSP progress notifications.

- Add `MiniNotifyLspProgress` highlight group to be used for LSP progress notifications.

- Add `data` field to notification specification and as a new argument to `MiniNotify.add()`. It can be used to store any data relevant to the notification. For example, notifications from `make_notify()` output set `source` field to `'vim.notify'`, while notifications from LSP progress set `source` to `'lsp_progress'`.

## mini.operators

### Expand

- Update `setup()` to remap built-in `gx` Normal/Visual mode mappings (for opening an URI under cursor) to `gX` (if that is not already taken).

## mini.pairs

### Expand

- Update all actions to work with pairs containing multibyte characters (like "¿?", "「」", and similar).

## mini.pick

### Refine

- Rename `prompt_cursor` in `config.window` to `prompt_caret` for better naming consistency. It works for now, but will stop in the next release. Sorry for the inconvenience.

### Expand

- Add `MiniPickPromptCaret` and `MiniPickPromptPrefix` highlight groups to allow finer customization of picker's prompt.

- Update `get_picker_matches()` to return data (items and indexes) about currently shown items.

- Update `set_picker_match_inds()` to be able to set current match and marked items indexes.

## mini.snippets

### Expand

- Add `start_lsp_server()` to start specialized in-process LSP server to show loaded snippets inside (auto)completion engines (like 'mini.completion').

## mini.statusline

### Refine

- Function `section_fileinfo()` got several updates:
    - File size is now computed based on the current buffer text and not for file's saved version.
    - File info is now shown even for buffers with empty 'filetype'. It previously was treated as a sign of a "temporary buffer", but it might be a result of an unsuccessful filetype matching.

## mini.surround

### Expand

- Surrounding identifier can now be any single character supported by `:h getcharstr()`. This also makes it possible to use characters outside of Latin alphanumeric and punctuation sets as `custom_surroundings` keys.

- Update `gen_spec.input.treesitter()` to respect capture ranges specified by query directives (like `(#offset! @table.inner 0 1 0 -1)`).

## mini.tabline

### Expand

- Add support for showing special (truncation) characters at left and/or right if there are more tabs to the left and/or right. They are shown with the new `MiniTablineTrunc` highlight group in case 'list' option is enabled (i.e. user deliberately enabled similar functionality for windows). Exact characters are taken from 'listchars' option: `precedes` and `extends` fields.

- Labels for quickfix and location lists are now different.


# Version 0.15.0

## mini.align

### Expand

- Add built-in modifier for "|" character with aligning Markdown-like tables in mind.

## mini.animate

### Evolve

- Add `max_output_steps` option to `gen_path.line()` and `gen_path.angle()` to limit the number of steps the return. Default is 1000 to improve performance on large cursor jumps which also is set for `config.cursor.path`.

## mini.files

### Expand

- Closing and refreshing explorer now requires confirmation only if there are pending file system actions (and not in case of at least one modified buffer present).

- Confirming file system actions in `synchronize()` now can cancel synchronization (by pressing `c`) while keeping buffer contents the same. `synchronize()` also returns a boolean representing whether synchronization was done.

## mini.git

### Expand

- Git data is computed after resolving symlinks. This allows working with files symlinked into outside of Git repo. This behavior is the same as in 'mini.diff'.

## mini.hipatterns

### Refine

- Make `MiniHipatterns{Fixme,Hack,Todo,Note}` highlight groups by default be reverse and bold variant of `Diagnostic{Error,Warn,Info,Hint}` group instead of directly link to them. This ensures better visibility for color schemes which don't have explicit 'mini.hipatterns' support.

## mini.hues

### Expand

- Add `'lowmedium'` and `'mediumhigh'` saturation levels.

## mini.icons

### Expand

- Add distinctive glyphs and highlighting for special Neovim directories (from `:h 'runtimepath'`).

## mini.indentscope

### Evolve

- Add `options.n_lines` option to limit the scope computation (for better performance). It's default value is 10000 while previous behavior behavior had no restriction (as with `n_lines = math.huge`) which should matter only in very big scopes.

- Add `draw.predicate` configuration to customize whether the scope should be autodrawn. It's default value does not draw scope with incomplete computation (i.e. interrupted due to `options.n_lines` value), which should matter only in very big scopes.

## mini.notify

- FEATURE: `setup()` now also can be used to clean history (for example, like `MiniNotify.setup(MiniNotify.config)`).

## mini.pick

### Evolve

- Picker window now has local current directory set to source's `cwd`. This allows easier code for "in window" functions (callable items, choose, preview, etc.) as relative paths will be properly resolved. It also results in some changes:
    - Calling `set_picker_items_from_cli()` with active picker now resolves explicitly set to relative path `spawn_opts.cwd` against picker's `cwd` (and not against global current directory as was done previously).

### Expand

- Update `grep` and `grep_live` pickers to allow `globs` local option which restricts search to files that match any of its glob patterns (for example, `{ '*.lua', 'lua/**' }` will only search in Lua files and files in 'lua' directory). The `grep_live` picker also has custom `<C-o>` mapping to add globs interactively after picker is opened.

- Update `help` picker to have `default_split` local option which customizes split direction of `choose` action (`<CR>` by default).

- Update `ui_select()` to allow fourth argument `start_opts` to customize `MiniPick.start()` call.

- Add `MiniPickMatch` event triggered after updating query matches or setting items. Can be used, for example, to adjust window height based on current matches.

## mini.snippets

### Expand

- Introduction of a new module.

## mini.surround

### Refine

- Created mappings for `find`, `find_left`, and `highlight` are now *not* dot-repeatable. Dot-repeat should repeat last text change but neither of those actions change text. Having them dot-repeatable breaks the common "move cursor -> press dot" workflow. Initially making them dot-repeatable was a "you can but you should not" type of mistake.

## mini.test

### Evolve

- Now calling `skip()` in set's `pre_case` hook results in skipping all test cases in a set. Calling in other hooks has no effect. This enables a more structured skipping of all test cases inside a set. To skip inside hooks, use `add_note()` followed by `return`.

### Expand

- Add `n_retry` test set property. When set, each case will be tried that at most that many times until first success (if any).

- Add `hooks.pre_source` and `hooks.post_source` fields to collected cases. They can be either `'once'` or `'case'` and allow a more granular control over case execution.

- Function `finally()` now can be called several times inside a single function with callbacks executed in order of how they were registered.

- Update `expect.reference_screenshot()` to allow `directory` option pointing to a directory where automatically constructed reference path is located.


# Version 0.14.0

## All

### Evolve

- Update help files to use code blocks with language annotation, as it results in a better code highlighting. Implies enabled tree-sitter highlighting in 'help' filetype:
    - It is default in Neovim>=0.10.
    - Tree-sitter parser is built-in in Neovim 0.9.x, needs manual enabling via `vim.treesitter.start()`.
    - Has visual regressions on Neovim 0.8.0 and 0.8.1 without enabled tree-sitter (code blocks are highlighted as normal text). Use 0.8.2 or newer.

- Universally prefer 'mini.icons' module over 'nvim-tree/nvim-web-devicons'.

### Refine

- Stop official support of Neovim 0.7.

### Expand

- Start automated testing on Windows and MacOS.

- Universally ensure that all plugin's highlight groups are defined after any color scheme takes effect.

## mini.base16

### Expand

- Add 'kevinhwang91/nvim-bqf' plugin integration.

## mini.completion

### Expand

- Add highlighting of LSP kind (like "Function", "Keyword", etc.). Works only on Neovim>=0.11. Requires enabled 'mini.icons' to work out of the box.

## mini.doc

### Evolve

- Update `afterlines_to_code()` to result into Lua code block in help file by using `>lua` at the start instead of `>`. NOTE: users need enabled `help` tree-sitter parser (which is default on Neovim>=0.9) for code blocks to have proper highlighting.

## mini.extra

### Refine

- Use "│" as line/position separator instead of ":". This aligns with changes in 'mini.pick' and makes line/position more easily visible.

### Expand

- Update `oldfiles` picker to have `current_dir` option which if `true` shows files only from picker's working directory. By @abeldekat, PR #997.

- Update `git_hunks`, `list`, and `lsp` pickers to show icons. Scopes `document_symbol` and `workspace_symbol` in `lsp` picker show icon based on LSP kind (requires set up 'mini.icons'), others - based on path data.

- Update `buf_lines` and `oldfiles` pickers to have `preserve_order` local option, similar to `visit_paths` picker. Other possible candidates for this option are intentionally not updated to not increase maintenance (manually override `match` source method to call `MiniPick.default_match()` with `{ preserve_order = true }` options).

- Update `buf_lines` picker to pad line numbers to achieve more aligned look.

## mini.git

### Expand

- Update `show_at_cursor()` to include commit's statistics when showing commit.

- Update `show_at_cursor()` to show relevant at cursor commit data inside 'mini.deps' confirmation buffer.

## mini.hipatterns

### Evolve

- Update `compute_hex_color_group()` to compute based on combination of `hex_color` and `style`, opposed to just `hex_color`. This allows simultaneous usage of several styles in user's custom highlighters.

## mini.hues

### Expand

- Implement `apply_palette()` (to compliment `make_palette()`) providing a way to tweak applied palette before applying it.

- Add 'kevinhwang91/nvim-bqf' plugin integration.

## mini.files

### Evolve

### Refine

- Update how confirmation lines are computed:
    - Show create actions in the group directory where text manipulation took place. This matters during creating nested entries and is usually a more intuitive representation.
    - For delete show its type after the file name ("permanently" or "to trash") as an additional visual indication of delete type.
    - For create, copy and move prefer showing its "to" path relative to group directory.
    - Separate action name and paths with "│" (instead of ":") for better visual separation.
    - Don't enclose paths in quotes. Initially it was done to reliably show possible whitespace in paths, but inferring it from overall line structure should be good enough.

- Soft deprecate `get_target_window()` in favor of `get_explorer_state().target_window`. Will be completely removed after the next release.

### Expand

- Prefer using 'mini.icons' as icon provider.

- Implement bookmarks. With default config:
    - Type `m` followed by a single character `<char>` to set directory path of focused window as a bookmark with id `<char>`.
    - Type `'` followed by a bookmark id to make bookmark's path focused in explorer.
    - Use `MiniFiles.set_bookmark()` inside `MiniFilesExplorerOpen` event to set custom bookmarks.

- Make data for `MiniFilesActionDelete` contain `to` field in case of not permanent delete.

- Make file manipulation work better for special complex/overlapping cases (like delete 'file-a' and copy 'file-b' as 'file-a'). It is **still** a better idea to split overlapping manipulations into smaller and not related steps, as there *are* cases which won't work.

- Add `get_explorer_state()` to allow more reliable user customizations.

- Add `set_branch()` to allow to set what paths should be displayed and focused.

## mini.icons

### Expand

- Introduction of a new module.

## mini.misc

### Expand

- Implement `setup_termbg_sync()` to set up terminal background synchronization (removes possible "frame" around current Neovim instance). Works only on Neovim>=0.10.

## mini.pick

### Evolve

### Refine

- Update `default_match()` to have table `opts` as fourth argument (instead of boolean `do_sync`). Use `{ sync = true }` to run synchronously. The new design is more aligned with other functions and is more forward compatible.

- Encoding line or position in string items has changed:
    - Use "\0" (null character; use "\000" form if it is in a string before digit) instead of ":" as delimiter. This makes it work with files similar to ":" position encoding (like "time_12:34:56"). This only matters for custom sources which provide line or position in string items.
    - Update `default_show()` to display "│" character instead of "\0" in item's string representation (previously was ":"). In particular, this changes how line/position is displayed in `grep` and `grep_live` built-in pickers. This change was done because "│" is more visible as separator.

### Expand

- Prefer using 'mini.icons' as icon provider.

- Add `preserve_order` option to `default_match()` to allow asynchronous matching which preserves order (i.e. doesn't do sort step of fuzzy matching).

- Explicitly hide cursor when picker is active (instead of putting it in command line).

## mini.starter

### Refine

- Change filetype of Starter buffer from 'starter' to 'ministarter'. This is a more robust value and more aligned with other modules.

## mini.statusline

### Refine

- Update `section_fileinfo()` to show non-empty filetype even in not normal buffers (like plugin's scratch buffers, help, quickfix, etc.). Previously it showed nothing, which was a mistake as filetype can be a valuable information.

- The default `set_vim_settings` config value now does not affect `laststatus = 3` (aka global statusline).

### Expand

- Prefer using 'mini.icons' as icon provider for `section_fileinfo()`.

## mini.surround

### Refine

- Adding surrounding in linewise mode now also ignores trailing whitespace on the last line (same as it ignores indent on the first line).

## mini.tabline

### Expand

- Prefer using 'mini.icons' as icon provider.

## mini.test

### Expand

- Make it work on Windows. By @cameronr, PR #1101.


# Version 0.13.0

## mini.comment

### Refine

- Blank lines are now completely ignored when deciding the toggling action. In practice this means that if target block consists only from commented and/or blank lines, it will be uncommented rather than commented.

- Whitespace in comment parts is now treated more explicitly. In particular:
    - Default `options.pad_comment_parts = true` now more explicitly means that any value of 'commentstring' is transformed so that comment parts have exactly single space inner padding.

      Example: any `/*%s*/`, ` /* %s */ `, or `/*  %s  */` is equivalent to having `/* %s */`.

    - Detection of whether consecutive lines are commented or not does not depend on whitespace in comment parts. Uncommenting is first attempted with exact comment parts and falls back on trying its trimmed parts.

      Example of toggling comment on single line with `/* %s */` 'commentstring' value:
        - `/* this is commented */` -> `this is commented`.
        - `/*this is also commented */` -> `this is also commented ` (notice trailing space).

    - Commenting blank lines is done with trimmed comments parts, while uncommenting explicitly results into empty lines.

### Expand

- Support dot-repeat after initial commenting is done for visual selection; repeating is done for same relative range.

## mini.deps

### Expand

- Add `MiniDepsMsgBreaking` highlight group for messages indicating a breaking change in a conventional commit style.

## mini.diff

### Expand

- Introduction of a new module.

## mini.files

### Expand

- Add new `MiniFilesExplorerOpen` and `MiniFilesExplorerClose` events.

## mini.git

### Expand

- Introduction of a new module.

## mini.hues

### Refine

- Update some highlight groups for better usability:
    - `DiffChange` and `DiffText` - make changed diff lines have colored background.
    - `Folded` - make folds differ from `CursorLine`.
    - `QuickFixLine` - make current quickfix item differ from `CursorLine`.

## mini.map

### Expand

- Add `gen_integration.diff()` which highlights general diff hunks from 'mini.diff'.

## mini.pick

### Evolve

### Refine

- Stop trying to parse path for special format ("path:row" and "path:row:col") if supplied inside a table item. This made impossible working with paths containing ":".

- Update `builtin.files()` to use table items when string item might be ambiguous.

### Expand

- Respect general URI format for paths inside table items.

## mini.starter

### Refine

- Explicitly block all events in `open()` during startup for a better performance.

## mini.statusline

### Evolve

- Update `section_git()` to prefer using data from 'mini.git' with fallback on pure HEAD data from 'lewis6991/gistigns.nvim'.

- Update default active content:
    - Add `section_diff()` (shows diff data near  icon) following refactor of `section_git()`.
    - Add `section_lsp()` (shows number of attached LSP servers near 󰰎 icon) following refactor of `section_diagnostics()`.

### Refine

- Update `section_diagnostics()` to depend only on defined diagnostic. This means:
    - Something is shown **only** if there is any diagnostic actually present in the buffer. No diagnostic entries - nothing is shown. Previously it did not show if there was no LSP servers attached (as initially diagnostics came only from LSP) or buffer was not normal.
    - Fallback icon is "Diag" instead of "LSP".

### Expand

- Update `section_diagnostics()` to support `signs` table option to customize signs for severity levels.

- Add `section_diff()` to show data from 'mini.diff' with fallback on diff data from 'lewis6991/gistigns.nvim'.

- Add `section_lsp()` to show indicator of LSP servers attached to the buffer.

## mini.tabline

### Expand

- Implement `config.format` for custom label formatting.

## mini.test

### Refine

- Child process is now created with extra `--headless --cmd "set lines=24 columns=80"` arguments making it headless but still reasonably similar to fully functioning Neovim during interactive usage. This change should generally not break a lot of things, while enabling a faster and more robust test execution.


# Version 0.12.0

## mini.basics

### Refine

- Remove `<C-z>` mapping, as it is more useful in most terminal emulators for suspending Neovim process (to later resume with `fg` command). To correct latest misspelled word, use mappings like this:

    ```lua
    vim.keymap.set('n', '<C-z>', '[s1z=',                     { desc = 'Correct latest misspelled word' })
    vim.keymap.set('i', '<C-z>', '<C-g>u<Esc>[s1z=`]a<C-g>u', { desc = 'Correct latest misspelled word' })
    ```

### Expand

- Add `tab:> ` to 'listchars' option when `options.extra_ui` is set. This prevents showing `^I` instead of a tab and actual value comes from Neovim's default.

- Set `termguicolors` only on Neovim<0.10, as later versions should have it on by default (if terminal emulator supports it).

## mini.comment

### Expand

- Hooks are now called with data about commenting action.

## mini.deps

### Expand

- Introduction of a new module.

## mini.doc

### Refine

- Stop using `:echo` to display messages and warnings in favor of `vim.notify()`.

- Update default `write_post` hook to not display current time in success message.

- Update to include space before `~` in generated section headings.

## mini.files

### Expand

- Update `go_in()` to have `close_on_file` option.

- Show warning if action is set to override existing path.

## mini.hues

### Refine

- Update verbatim text (`@text.literal` and `@markup.raw`) color to be distinctive instead of dimmed.

### Expand

- Add support for new standard tree-sitter captures on Neovim>=0.10 (see https://github.com/neovim/neovim/pull/27067).

## mini.misc

### Refine

- Update `bench_time()` to use `vim.loop.hrtime()` (as better designed for benchmarking) instead of `vim.loop.gettimeofday()`.

## mini.notify

### Expand

- Introduction of a new module.

## mini.pick

### Expand

- Implement `window.prompt_cursor` and `window.prompt_prefix` config options.

- Update `builtin.help()` to use tree-sitter highlighting (if there is any).

## mini.sessions

### Refine

- Update `read()` to first `write()` current session (if there is any).

## mini.starter

### Expand

- Add `sections.pick()` with 'mini.pick' pickers.

## mini.statusline

### Evolve

- Add `search_count` section to default active content.

## mini.visits

### Expand

- Introduction of a new module.


# Version 0.11.0

## mini.base16

### Refine

- Stop supporting deprecated 'HiPhish/nvim-ts-rainbow2'.

## mini.bufremove

### Evolve

- Applying `delete()` and `wipeout()` without `force` in a modified buffer now asks for confirmation instead of declining and showing message.

## mini.clue

### Expand

- Value of `config.window.config` now can be callable returning window config.

## mini.comment

### Expand

- Implement `config.mappings.comment_visual` to configure mapped keys in Visual mode.

## mini.completion

### Evolve

- Start adding `C` flag to `shortmess` option on Neovim>=0.9. By @yamin-shihab, PR #554.

## mini.extra

### Expand

- Introduction of a new module.

## mini.files

### Refine

- Opening file which is present in unlisted buffer now makes the buffer listed.

- Highlight in preview now is not enabled if file is sufficiently large.

### Expand

- Explorer now tracks if focus is lost and properly closes on detection.

- Implement `MiniFilesCursorLine` highlight group.

## mini.hipatterns

### Refine

- Field `priority` in highlighter definitions is soft deprecated in favor of `extmark_opts = { priority = <value> }`.

### Expand

- Allow `pattern` in highlighter definitions to be an array to highlight several patterns under the same highlighter name.

- Implement `extmark_opts` in highlighter definitions for a more control over extmarks placed at matches.

- Update `compute_hex_color_group()` to allow `style = 'fg'`.

- Update `gen_highlighter.hex_color()` to allow `style = 'inline'` (requires Neovim>=0.10 with support of inline extmarks).

- Implement `get_matches()` to get buffer matches.

## mini.hues

### Refine

- Stop supporting deprecated 'HiPhish/nvim-ts-rainbow2'.

## mini.map

### Expand

- Implement `config.window.zindex` to configure z-index of map window.

## mini.misc

### Expand

- Update `setup_auto_root()` and `find_root()` to now have `fallback` argument to be applied when no root is found with `vim.fn.find()`.

## mini.pick

### Expand

- Introduction of a new module.

## mini.starter

### Expand

- Value of `show_path` in `sections.recent_files()` can now be callable for more control on how full path is displayed.

## mini.test

### Evolve

- Update `child.get_screenshot()` to now by default call `:redraw` prior to computing screenshot. Can be disabled by new `opts.redraw` argument.

### Refine

- Error in any "pre" hook now leads to test case not being executed (with note).

### Expand

- New method `child.lua_func()` can execute simple functions inside child process and return the result (stasjok, #437).

- Update `expect.reference_screenshot()` to now have `ignore_lines` option allowing to ignore specified lines during screenshot compare.


# Version 0.10.0

## mini.ai

### Expand

- Allow `vis_mode` field in custom texobject region to force Visual mode with which textobject is selected.

## mini.animate

### Expand

- Add `MiniAnimateNormalFloat` highlight group to tweak highlighting of `open` and `close` animations.

## mini.base16

### Expand

- Add 'HiPhish/rainbow-delimiters.nvim' integration.

## mini.basics

### Refine

- Remove `<C-w>` mapping in Terminal mode, as it is more useful inside terminal emulator itself.

## mini.bracketed

### Expand

- Add `add_to_jumplist` option to relevant targets (which move cursor and don't already add to jumplist).

## mini.bufremove

### Refine

- Create normal buffer instead of scratch when there is no reasonable target to focus (#394).

## mini.clue

### Expand

- Introduction of a new module.

## mini.files

### Expand

- Introduction of a new module.

## mini.hues

### Expand

- Add 'HiPhish/rainbow-delimiters.nvim' integration.

## mini.jump2d

### Expand

- Add `gen_union_spotter()` to allow combining separate spotters into one.

## mini.operators

### Expand

- Introduction of a new module.

## mini.pairs

### Expand

- Allow `false` in `config.mappings` to not map the key.

## mini.surround

### Expand

- Update `add` (`sa`) with ability to replicate left and right parts by respecting `[count]`. In Normal mode two kinds of `[count]` is respected: one for operator (replicates left and right parts) and one for textobject/motion. In Visual mode `[count]` replicates parts.


# Version 0.9.0

## All

### Evolve

- Use Lua API to create autocommands. Stop exporting functions only related to autocommands.

- Use `vim.keymap` to deal with mappings. Stop exporting functions only related to mappings.

### Refine

- Stop official support of Neovim 0.6.

### Expand

- Add 'randomhue' color scheme.

## mini.base16

### Evolve

- Stop supporting archived 'p00f/nvim-ts-rainbow' in favor of 'HiPhish/nvim-ts-rainbow2'.

### Expand

- Add new integrations:
    - Lsp semantic tokens.
    - 'folke/lazy.nvim'.
    - 'folke/noice.nvim'.
    - 'kevinhwang91/nvim-ufo'.

## mini.basics

### Expand

- Add dot-repeat support for adding empty lines (`go` and `gO` mappings).

## mini.colors

### Expand

- Introduction of a new module.

## mini.comment

### Expand

- Use tree-sitter information about locally active language to infer 'commentstring' option value.

- Add `options.custom_commentstring` option for a more granular customization of comment structure.

- Add `get_commentstring()` function representing built-in logic of computing relevant 'commentstring'.

## mini.hipatterns

### Expand

- Introduction of a new module.

## mini.hues

### Expand

- Introduction of a new module.


# Version 0.8.0

## All

### Expand

- Add and implement design principle for silencing module by setting `config.silent = true`. It is now present in modules capable of showing non-error feedback:
    - mini.ai
    - mini.align
    - mini.basics
    - mini.bufremove
    - mini.doc
    - mini.jump
    - mini.jump2d
    - mini.starter
    - mini.surround
    - mini.test

## mini.bracketed

### Expand

- Introduction of a new module.

## mini.comment

### Expand

- Add `options.start_of_line` option which controls whether to recognize as comment only lines without indent.

- Add `options.ignore_blank_line` option which controls whether to ignore blank lines.

- Add `options.pad_comment_parts` option which controls whether to ensure single space pad for comment leaders.

## mini.doc

### Expand

- Add `config.hooks.write_pre` hook to be executed before writing to a file.

## mini.indentscope

### Expand

- Add `MiniIndentscopeSymbolOff` highlight group to be used if scope's indent is not multiple of 'shiftwidth'.

- Add `draw.priority` option to control priority of scope line draw.

## mini.jump2d

### Expand

- Add `view.n_steps_ahead` option which controls how many steps ahead to show. Appearance is controlled by new `MiniJump2dSpotAhead` highlight group.

- Add `view.dim` option which controls whether to dim lines with at least one jump spot. Appearance is controlled by new `MiniJump2dDim` highlight group.

- Add `MiniJump2dSpotUnique` highlight group to be used for spots with unique label for next step.

## mini.pairs

### Expand

- Both `MiniPairs.br()` and `MiniPairs.cr()` can now take a key which will be used instead of default `<BS>` and `<CR>`.

## mini.sessions

### Expand

- Update `setup()` to now create global directory at path `config.directory` if it doesn't exist.

- All actions now keep list of detected sessions up to date.

## mini.splitjoin

### Expand

- Introduction of a new module.

## mini.surround

### Expand

- Add `respect_selection_type` option which, when enabled, makes adding and deleting surrounding respect selection type:
    - Linewise adding places surrounding parts on separate lines while indenting surrounded lines once.
    - Deleting surrounding which looks like a result of linewise adding will act to revert it: delete lines with surrounding parts and dedent surrounded lines once.
    - Blockwise adding places surrounding parts on whole edges, not only start and end of selection.


# Version 0.7.0

## All

### Expand

- Start dual distribution. Every module is now distributed both as part of 'mini.nvim' library and as standalone plugin (in separate git repository).

## mini.ai

### Refine

- In `MiniAi.gen_spec.argument()` option `separators` (plural; array of characters) is soft deprecated in favor of `separator` (singular; Lua pattern) option.

## mini.animate

### Expand

- Introduction of a new module.

## mini.basics

### Expand

- Introduction of a new module.

## mini.completion

### Refine

- Rename `MiniCompletion.config.window_dimensions` to `MiniCompletion.config.window` to be able to handle more general configuration.

### Expand

- Add `MiniCompletion.config.window.info.border` and `MiniCompletion.config.window.signature.border` which can be used to define border of info and signature floating windows respectively.

## mini.indentscope

### Refine

- Stop using (deprecate) `MiniIndentscopePrefix` highlight groups. It was initially introduced as a way to properly show scope indicator on empty lines. It had a drawback of overshadowing 'listchars' symbols (see #125) and vertical guides from 'lukas-reineke/indent-blankline.nvim'. As the other implementation approach was found by @mivort (see #161), `MiniIndentscopePrefix` is no longer needed and no overshadowing is done.

- Update `MiniIndentscope.gen_animation` to now be a table (for consistency with other `gen_*` functions in 'mini.nvim'). See "Migrate from function type" section of `:h MiniIndentscope.gen_animation`. Calling it as function will be available until next release.

## mini.misc

### Expand

- Add `MiniMisc.setup_auto_root()` and `MiniMisc.find_root()` for root finding functionality. NOTE: requires Neovim>=0.8.

- Add `MiniMisc.setup_restore_cursor()` for automatically restoring latest cursor position on file reopen. By @cryptomilk, PR #198.

## mini.move

### Expand

- Introduction of a new module.


# Version 0.6.0

## All

### Refine

- Stop official support of Neovim 0.5.

### Expand

- Make all messages use colors and not cause hit-enter-prompt.

## mini.align

### Expand

- Introduction of a new module.

## mini.base16

### Refine

- Change some 'mini.nvim' highlights:
    - `MiniCompletionActiveParameter` now highlights with background instead of underline.
    - `MiniJump2dSpot` now explicitly defined to use plugin's palette.
    - `MiniStarterItemPrefix` and `MiniStarterQuery` are now bold for better visibility.

- Update highlight for changed git diff to be more visible and to comply more with general guidelines.

### Expand

- Add support for many plugin integrations.

- Implement `MiniBase16.config.plugins` for configuring plugin integrations.

## mini.jump

### Refine

- Allow cursor to be positioned past the end of previous/current line (#113).

## mini.map

### Expand

- Introduction of a new module.

## mini.starter

### Refine

- Item evaluation is now prepended with query reset, as it is rarely needed any more (#105).

- All hooks are now called with `(content, buf_id)` signature allowing them properly use current window layout.

## mini.surround

### Evolve

- Update 'mini.surround' to share as much with 'mini.ai' as possible. This provides more integrated experience while enabling more useful features. Details:
    - Custom surrounding specification for input action has changed. Instead of `{ find = <string>, extract = <string> }` it is now `{ <function or composed pattern> }`. Previous format will work until the next release. See more in help file.
    - Algorithm for finding surrounding is now more powerful. It allows searching for more complex surroundings (via composed patterns or array of region pairs) and respects `v:count`.
    - Multiline input and output surroundings are now supported.
    - Opening brackets (`(`, `[`, `{`, `<`) now include whitespace in surrounding: input surrounding selects all inner edge whitespace, output surrounding is padded with single space.
    - Surrounding identifier `i` ("interactive") is soft deprecated in favor of `?` ("user prompt").
    - New surrounding aliases:
        - `b` for "brackets". Input - any of balanced `()`, `[]` `{}`. Output - `()`.
        - `q` for "quotes". Input - any of `"`, `'`, `` ` ``. Output - `""`.
    - Three new search methods `'prev'`, `'next'`, and `'nearest'` for finding non-covering previous and next surrounding.

- Implement "last"/"next" extended mappings which force `'prev'` or `'next'` search method. Controlled with `config.mappings.suffix_last` and `config.mappings.suffix_next`respectively. This also means that custom surroundings with identifier equal to "last"/"next" mappings suffixes (defaults to 'l' and 'n') will work only with long enough delay after typing action mapping.

### Expand

- Implement `MiniSurround.gen_spec` with generators of common surrounding specifications (like `MiniSurround.gen_spec.input.treesitter` for tree-sitter based input surrounding).


# Version 0.5.0

## All

### Refine

- Update all tests to use new 'mini.test' module.

### Expand

- Implement buffer local configuration. This is done with `vim.b.mini*_config` buffer variables.

- Add new `minicyan` color scheme.

## mini.ai

- Introduction of a new module.

## mini.comment

### Expand

- Now hooks can be used to terminate further actions by returning `false` (#108).

## mini.indentscope

### Refine

- Soft deprecate `vim.b.miniindentscope_options` in favor of using `options` field of `miniindentscope_config`.

## mini.sessions

### Expand

- Hooks are now called with active session data as argument.

## mini.starter

### Evolve

### Refine

- Deprecate `MiniStarter.content` in favor of `MiniStarter.get_content()`.

### Expand

- Make it possible to open multiple Starter buffers at the same time (#82).

- All functions dealing with Starter buffer now have `buf_id` as argument.

## mini.statusline

### Expand

- Implement `config.use_icons` which controls whether to use icons by default.

## mini.test

- Introduction of a new module.

## mini.trailspace

### Expand

- Implement `MiniTrailspace.trim_last_lines()`.


# Version 0.4.0

## All

### Expand

- Update all modules to supply mapping description for Neovim>=0.7.

- Cover all modules with extensive tests.

## mini.comment

### Expand

- Implement `config.hooks` with `pre` and `post` hooks (executed before and after successful commenting). Fixes #50, #59.

## mini.completion

### Expand

- Implement support for `additionalTextEdits` (issue #61).

## mini.jump

### Refine

- Soft deprecate `config.highlight_delay` in favor of `config.delay.highlight`.

### Expand

- Implement idle timeout to stop jumping automatically (@annenpolka, #56).

- Implement `MiniJump.state`: table with useful model-related information.

- Update process of querying target symbol: show help message after delay, allow `<C-c>` to stop selecting target.

## mini.jump2d

- Introduction of a new module.

## mini.pairs

### Refine

- Create mappings for `<BS>` and `<CR>` in certain mode only after some pair is registered in that mode.

## mini.sessions

### Refine

- All feedback about incorrect behavior is now an error instead of message notifications.

### Expand

- Implement `MiniSessions.select()` to select session interactively and perform action on it.

- Implement `config.hooks` to execute hook functions before and after successful action.

## mini.starter

### Expand

- Allow `config.header` and `config.footer` be any value, which will be converted to string via `tostring()`.

- Update query logic to not allow queries which result into no items.

- Add `<C-n>` and `<C-p>` to default mappings.

## mini.statusline

### Refine

- Change default icon for `MiniStatusline.section_diagnostics()` from ﯭ to  due to former having issues in some terminal emulators.

## mini.surround

### Evolve

### Refine

- Deprecate `config.funname_pattern` option in favor of manually modifying `f` surrounding.

- Always move cursor to the right of left surrounding in `add()`, `delete()`, and `replace()` (instead of moving only if it was on the same line as left surrounding).

### Expand

- Implement `config.search_method`.

- Implement custom surroundings via `config.custom_surroundings`.

- Implement `MiniSurround.user_input()`.

- Update process of getting user input: allow `<C-c>` to cancel and make empty string a valid input.

## mini.tabline

### Refine

- Show listed buffers also in case of multiple tabpages (instead of using builtin behavior).

### Expand

- Implement `config.tabpage_section`.

- Show quickfix/loclist buffers with special `*quickfix*` label.


# Version 0.3.0

## All

### Expand

- Update all modules to have annotations formatted for 'mini.doc'.

## mini.cursorword

### Expand

- Current word under cursor now can be highlighted differently.

## mini.doc

### Expand

- Introduction of a new module.

## mini.indentscope

### Expand

- Introduction of a new module.

## mini.starter

### Expand

- Implement `MiniStarter.set_query()` and make `<Esc>` mapping for resetting query.


# Version 0.2.0

## mini.base16

### Expand

- Use new `Diagnostic*` highlight groups in Neovim 0.6.0.

## mini.comment

### Expand

- Respect tab indentation (#20).

## mini.jump

### Expand

- Introduction of a new module.

## mini.pairs

### Expand

- Implement pair registration with custom mapping functions:
    - Implement `MiniPairs.map()`, `MiniPairs.map_buf()`, `MiniPairs.unmap()`, `MiniPairs.unmap_buf()` to (un)make mappings for pairs which automatically register them for `<BS>` and `<CR>`. Note, that this has a minor break of previous behavior: now `MiniPairs.bs()` and `MiniPairs.cr()` don't have any input argument. But default behavior didn't change.
    - Allow setting global pair mappings inside `config` of `MiniPairs.setup()`.

## mini.sessions

### Expand

- Introduction of a new module.

## mini.starter

### Expand

- Introduction of a new module.

## mini.statusline

### Expand

- Implement new section `MiniStatusline.section_searchcount()`.

- Update `section_diagnostics` to use `vim.diagnostic` in Neovim 0.6.0.


# Version 0.1.0

## All

### Expand

- Initial stable version.
