Releases: nvim-mini/mini.nvim
Version 0.16.0
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.
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_settingsconfig setting. Instead set them automatically insetup(). 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/itextobjects 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 ascustom_textobjectskeys. 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 haveadjust_lightnessoption 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_lineoption. 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.snippeton Neovim>=0.10. See "Snippets" section in:h MiniCompletionfor more details.
This affect existing functionality because items withSnippetkind are no longer filtered out by default. -
Rework how LSP completion items are converted to Neovim's completion items:
- Show
detailhighlighted as buffer's language at the start of info window, but only ifdetailprovides information not already present indocumentation. It was previously used as extra text in the popup menu (viamenufield), but this doesn't quite follow LSP specification:detailanddocumentationfields can be delayed up untilcompletionItem/resolverequest which implies they should be treated similarly. - Show
labelDetailsas a part of the popup menu viamenucompletion item field.
- Show
-
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
MiniCompletionInfoBorderOutdatedimmediately 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.
- Do not close the window immediately after the move. Instead highlight border with
-
Update behavior and capabilities of
default_process_items():- Add
filtersortoption 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_priorityoption to allow arranging items by completion item kind (like "Variable", "Snippet", "Text", etc.) after applyingfiltersort. This allows finer filter and/or sort based on kind, like "put Variable on top, Snippet on bottom, remove Text". - Use
filterTextandlabelitem fields during matching (instead oftextEdit.newText,insertText, andlabelas before). This is more aligned with LSP specification.
- Add
Refine
-
Prefer in some cases to use
nilas 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(usedefault_process_itemsas fallback) andfallback_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.borderandwindow.signature.border(use non-empty 'winborder' and'single'as fallback).
-
Change default value of
MiniCompletionActiveParameterhighlight group to link toLspSignatureActiveParameter(instead of forcing underline). -
Call
lsp_completion.process_itemswith 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 viamappings.scroll_downandmappings.scroll_upconfig options. -
Respect
isIncompletein 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
CompletionListresponse. -
Add
get_lsp_capabilities()that returns data about which part of LSP specification is supported in 'mini.completion'. -
Input items for
lsp_completion.process_itemsnow haveclient_idfield with the identifier of the server that item came from. Usevim.lsp.get_client_by_id()to get an actual data about the server.
mini.diff
Expand
-
The
config.sourcecan now be array of sources, which will be attempted to attach in order. Important for source'sattachto either returnfalseor callMiniDiff.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 usedMiniDiffOverChange(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 usefilterTextandlabelitem fields during fuzzy matching (instead oftextEdit.newText,insertText, andlabelas before). This is more aligned with LSP specification. -
Treat empty
wordas 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...
Version 0.15.0
mini.align
- FEATURE: add built-in modifier for "|" character with aligning Markdown-like tables in mind.
mini.animate
- BREAKING FEATURE: add
max_output_stepsoption togen_path.line()andgen_path.angle()to limit the number of steps the return. Default is 1000 to improve performance on large cursor jumps which also is set forconfig.cursor.path.
mini.files
- FEATURE: 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).
- FEATURE: confirming file system actions in
synchronize()now can cancel synchronization (by pressingc) while keeping buffer contents the same.synchronize()also returns a boolean representing whether synchronization was done.
mini.git
- FEATURE: 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
- BREAKING FEATURE: make
MiniHipatterns{Fixme,Hack,Todo,Note}highlight groups by default be reverse and bold variant ofDiagnostic{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
- FEATURE: add
'lowmedium'and'mediumhigh'saturation levels.
mini.icons
- FEATURE: add distinctive glyphs and highlighting for special Neovim directories (from
:h 'runtimepath').
mini.indentscope
- BREAKING FEATURE: add
options.n_linesoption to limit the scope computation (for better performance). It is breaking because the default value is 10000 while previous behavior had no restriction (as withn_lines = math.huge) which should matter only in very big scopes. - BREAKING FEATURE: add
draw.predicateconfiguration to customize whether the scope should be autodrawn. It is breaking because the default value does not draw scope with incomplete computation (i.e. interrupted due tooptions.n_linesvalue), which should matter only in very big scopes.
mini.notify
- FEATURE:
setup()now also can be used to clean history (for example, likeMiniNotify.setup(MiniNotify.config)).
mini.pick
- BREAKING FEATURE: 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 pathspawn_opts.cwdagainst picker'scwd(and not against global current directory as was done previously).
- Calling
- FEATURE: update
grepandgrep_livepickers to allowglobslocal 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). Thegrep_livepicker also has custom<C-o>mapping to add globs interactively after picker is opened. - FEATURE: update
helppicker to havedefault_splitlocal option which customizes split direction ofchooseaction (<CR>by default). - FEATURE: update
ui_select()to allow fourth argumentstart_optsto customizeMiniPick.start()call. - FEATURE: add
MiniPickMatchevent triggered after updating query matches or setting items. Can be used, for example, to adjust window height based on current matches.
mini.snippets
- Introduction of a new module.
mini.surround
- BREAKING: created mappings for
find,find_left, andhighlightare 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
- FEATURE: add
n_retrytest set property. When set, each case will be tried that at most that many times until first success (if any). - FEATURE: add
hooks.pre_sourceandhooks.post_sourcefields to collected cases. They can be either'once'or'case'and allow a more granular control over case execution. - FEATURE:
finally()now can be called several times inside a single function with callbacks executed in order of how they were registered. - BREAKING FEATURE: now calling
skip()in set'spre_casehook 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, useadd_note()followed byreturn. - FEATURE: update
expect.reference_screenshot()to allowdirectoryoption pointing to a directory where automatically constructed reference path is located.
Version 0.14.0
- Stop official support of Neovim 0.7.
- 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'.
- 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
- FEATURE: add 'kevinhwang91/nvim-bqf' plugin integration.
mini.completion
- FEATURE: 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
- BREAKING FEATURE: update
afterlines_to_code()to result into Lua code block in help file by using>luaat the start instead of>. NOTE: users need enabledhelptree-sitter parser (which is default on Neovim>=0.9) for code blocks to have proper highlighting.
mini.extra
- FEATURE: update
oldfilespicker to havecurrent_diroption which iftrueshows files only from picker's working directory. By @abeldekat, PR #997. - FEATURE: make
git_hunks,list, andlsppickers show icons. Scopesdocument_symbolandworkspace_symbolinlsppicker show icon based on LSP kind (requires set up 'mini.icons'), others - based on path data. - FEATURE: update
buf_linesandoldfilespickers to havepreserve_orderlocal option, similar tovisit_pathspicker. Other possible candidates for this option are intentionally not updated to not increase maintenance (manually overridematchsource method to callMiniPick.default_match()with{ preserve_order = true }options). - FEATURE: update
buf_linespicker to pad line numbers to achieve more aligned look. - BREAKING FEATURE: use "│" as line/position separator instead of ":". This aligns with changes in 'mini.pick' and makes line/position more easily visible.
mini.git
- FEATURE: update
show_at_cursor()to include commit's statistics when showing commit. - FEATURE: update
show_at_cursor()to show relevant at cursor commit data inside 'mini.deps' confirmation buffer.
mini.hipatterns
- BREAKING FEATURE: update
compute_hex_color_group()to compute based on combination ofhex_colorandstyle, opposed to justhex_color. This allows simultaneous usage of several styles in user's custom highlighters.
mini.hues
- FEATURE: implement
apply_palette()(to complimentmake_palette()) providing a way to tweak applied palette before applying it. - FEATURE: add 'kevinhwang91/nvim-bqf' plugin integration.
mini.files
- FEATURE: prefer using 'mini.icons' as icon provider.
- FEATURE: implement bookmarks. With default config:
- Type
mfollowed 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()insideMiniFilesExplorerOpenevent to set custom bookmarks.
- Type
- FEATURE: make data for
MiniFilesActionDeletecontaintofield in case of not permanent delete. - FEATURE: 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.
- FEATURE: add
get_explorer_state()to allow more reliable user customizations. - FEATURE: add
set_branch()to allow to set what paths should be displayed and focused. - BREAKING: soft deprecate
get_target_window()in favor ofget_explorer_state().target_window. Will be completely removed after the next release. - BREAKING: 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.
mini.icons
- Introduction of a new module.
mini.misc
- FEATURE: 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
- FEATURE: prefer using 'mini.icons' as icon provider.
- BREAKING: update
default_match()to have tableoptsas fourth argument (instead of booleando_sync). Use{ sync = true }to run synchronously. The new design is more aligned with other functions and is more forward compatible. - FEATURE: add
preserve_orderoption todefault_match()to allow asynchronous matching which preserves order (i.e. doesn't do sort step of fuzzy matching). - BREAKING: 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 ingrepandgrep_livebuilt-in pickers. This change was done because "│" is more visible as separator.
- FEATURE: explicitly hide cursor when picker is active (instead of putting it in command line).
mini.starter
- BREAKING: change filetype of Starter buffer from 'starter' to 'ministarter'. This is a more robust value and more aligned with other modules.
mini.statusline
- BREAKING FEATURE: 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. - BREAKING FEATURE: the default
set_vim_settingsconfig value now does not affectlaststatus = 3(aka global statusline). - FEATURE: prefer using 'mini.icons' as icon provider for
section_fileinfo().
mini.surround
- BREAKING FEATURE: 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
- FEATURE: prefer using 'mini.icons' as icon provider.
mini.test
Version 0.13.0
mini.comment
-
BREAKING FEATURE: 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.
-
BREAKING: Whitespace in comment parts is now treated more explicitly. In particular:
-
Default
options.pad_comment_parts = truenow 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.
-
-
FEATURE: Support dot-repeat after initial commenting is done for visual selection; repeating is done for same relative range.
mini.deps
- FEATURE: add
MiniDepsMsgBreakinghighlight group for messages indicating a breaking change in a conventional commit style.
mini.diff
- Introduction of a new module.
mini.files
- FEATURE: add new
MiniFilesExplorerOpenandMiniFilesExplorerCloseevents.
mini.git
- Introduction of a new module.
mini.hues
- BREAKING FEATURE: update some highlight groups for better usability:
DiffChangeandDiffText- make changed diff lines have colored background.Folded- make folds differ fromCursorLine.QuickFixLine- make current quickfix item differ fromCursorLine.
mini.map
- FEATURE: add
gen_integration.diff()which highlights general diff hunks from 'mini.diff'.
mini.pick
- BREAKING: 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 ":".
- FEATURE: respect general URI format for paths inside table items.
- Update
builtin.files()to use table items when string item might be ambiguous.
mini.starter
- Explicitly block all events in
open()during startup for a better performance.
mini.statusline
- BREAKING:
section_diagnostics()now depends 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".
- Something is shown only if there is any diagnostic actually present in the buffer. No diagnostic entries - nothing is shown.
- FEATURE:
section_diagnostics()now supportssignstable option to customize signs for severity levels. - BREAKING FEATURE:
section_git()now prefers using data from 'mini.git' with fallback on pure HEAD data from 'lewis6991/gistigns.nvim'. - FEATURE: add
section_diff()to show data from 'mini.diff' with fallback on diff data from 'lewis6991/gistigns.nvim'. - FEATURE: add
section_lsp()to show indicator of LSP servers attached to the buffer. - BREAKING FEATURE: update default active content:
- Add
section_diff()(shows diff data near icon) following refactor ofsection_git(). - Add
section_lsp()(shows number of attached LSP servers near icon) following refactor ofsection_diagnostics().
- Add
mini.tabline
- FEATURE: Implement
config.formatfor custom label formatting.
mini.test
- BREAKING FEATURE: 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
- BREAKING: Remove
<C-z>mapping, as it is more useful in most terminal emulators for suspending Neovim process (to later resume withfgcommand). To correct latest misspelled word, use mappings like this:
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' })- FEATURE: Add
tab:>to 'listchars' option whenoptions.extra_uiis set. This prevents showing^Iinstead of a tab and actual value comes from Neovim's default. - FEATURE: Set
termguicolorsonly on Neovim<0.10, as later versions should have it on by default (if terminal emulator supports it).
mini.comment
- FEATURE: Hooks are now called with data about commenting action.
mini.deps
Introduction of a new module.
mini.doc
- BREAKING: Stop using
:echoto display messages and warnings in favor ofvim.notify(). - BREAKING: Update default
write_posthook to not display current time in success message. - Update to include space before
~in generated section headings.
mini.files
- FEATURE: Update
go_in()to haveclose_on_fileoption. - Show warning if action is set to override existing path.
mini.hues
- BREAKING FEATURE: Update verbatim text (
@text.literaland@markup.raw) color to be distinctive instead of dimmed. - FEATURE: Add support for new standard tree-sitter captures on Neovim>=0.10 (see neovim/neovim#27067).
mini.misc
- Update
bench_time()to usevim.loop.hrtime()(as better designed for benchmarking) instead ofvim.loop.gettimeofday().
mini.notify
Introduction of a new module.
mini.pick
- FEATURE: Implement
window.prompt_cursorandwindow.prompt_prefixconfig options. - FEATURE: Update
builtin.help()to use tree-sitter highlighting (if there is any).
mini.sessions
- FEATURE: Update
read()to firstwrite()current session (if there is any).
mini.starter
- FEATURE: Add
sections.pick()with 'mini.pick' pickers.
mini.statusline
- BREAKING FEATURE: Add
search_countsection to default active content.
mini.visits
Introduction of a new module.
Version 0.11.0
mini.base16
- BREAKING: Stop supporting deprecated 'HiPhish/nvim-ts-rainbow2'.
mini.bufremove
- BREAKING FEATURE: Applying
delete()andwipeout()withoutforcein a modified buffer now asks for confirmation instead of declining and showing message.
mini.clue
- FEATURE:
config.window.confignow can be callable returning window config.
mini.comment
- FEATURE: Implement
config.mappings.comment_visualto configure mapped keys in Visual mode.
mini.completion
- FEATURE: Start adding
Cflag toshortmessoption on Neovim>=0.9. By @yamin-shihab, PR #554.
mini.extra
Introduction of a new module.
mini.files
- BREAKING: Opening file which is present in unlisted buffer now makes the buffer listed.
- BREAKING: Highlight in preview now is not enabled if file is sufficiently large.
- FEATURE: Explorer now tracks if focus is lost and properly closes on detection.
- FEATURE: Implement
MiniFilesCursorLinehighlight group.
mini.hipatterns
- FEATURE: Allow
patternin highlighter definitions to be an array to highlight several patterns under the same highlighter name. - FEATURE: Implement
extmark_optsin highlighter definitions for a more control over extmarks placed at matches. - BREAKING: Field
priorityin highlighter definitions is soft deprecated in favor ofextmark_opts = { priority = <value> }. - FEATURE: Update
compute_hex_color_group()to allowstyle = 'fg'. - FEATURE: Update
gen_highlighter.hex_color()to allowstyle = 'inline'(requires Neovim>=0.10 with support of inline extmarks). - FEATURE: Implement
get_matches()to get buffer matches.
mini.hues
- BREAKING: Stop supporting deprecated 'HiPhish/nvim-ts-rainbow2'.
mini.map
- FEATURE: Implement
config.window.zindexto configure z-index of map window.
mini.misc
- FEATURE:
setup_auto_root()andfind_root()now havefallbackargument to be applied when no root is found withvim.fn.find().
mini.pick
Introduction of a new module.
mini.starter
- FEATURE:
show_pathinsections.recent_files()can now be callable for more control on how full path is displayed.
mini.test
- BREAKING: Error in any "pre" hook now leads to test case not being executed (with note).
- BREAKING FEATURE:
child.get_screenshot()now by default calls:redrawprior to computing screenshot. Can be disabled by newopts.redrawargument. - FEATURE: New method
child.lua_func()can execute simple functions inside child process and return the result (stasjok, #437). - FEATURE:
expect.reference_screenshot()now hasignore_linesoption allowing to ignore specified lines during screenshot compare.
Version 0.10.0
mini.ai
- FEATURE: Allow
vis_modefield in custom texobject region to force Visual mode with which textobject is selected.
mini.animate
- FEATURE: Add
MiniAnimateNormalFloathighlight group to tweak highlighting ofopenandcloseanimations.
mini.base16
- FEATURE: Add 'HiPhish/rainbow-delimiters.nvim' integration.
mini.basics
- BREAKING: Remove
<C-w>mapping in Terminal mode, as it is more useful inside terminal emulator itself.
mini.bracketed
- FEATURE: Add
add_to_jumplistoption to relevant targets (which move cursor and don't already add to jumplist).
mini.bufremove
- BREAKING: Create normal buffer instead of scratch when there is no reasonable target to focus (#394).
mini.clue
Introduction of a new module.
mini.files
Introduction of a new module.
mini.hues
- FEATURE: Add 'HiPhish/rainbow-delimiters.nvim' integration.
mini.jump2d
- FEATURE: Add
gen_union_spotter()to allow combining separate spotters into one.
mini.operators
Introduction of a new module.
mini.pairs
- FEATURE: Allow
falseinconfig.mappingsto not map the key.
mini.surround
- FEATURE: 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
- Stop official support of Neovim 0.6.
- Use Lua API to create autocommands. Stop exporting functions only related to autocommands.
- Use Lua API to create default highlight groups.
- Use
vim.keymapto deal with mappings. Stop exporting functions only related to mappings. - Add 'randomhue' color scheme.
mini.base16
- FEATURE: Add new integrations:
- Lsp semantic tokens.
- 'folke/lazy.nvim'.
- 'folke/noice.nvim'.
- 'kevinhwang91/nvim-ufo'.
- BREAKING FEATURE: Stop supporting archived 'p00f/nvim-ts-rainbow' in favor of 'HiPhish/nvim-ts-rainbow2'.
mini.basics
- Add dot-repeat support for adding empty lines (
goandgOmappings).
mini.colors
Introduction of a new module.
mini.comment
- FEATURE: Use tree-sitter information about locally active language to infer 'commentstring' option value.
- FEATURE: Add
options.custom_commentstringoption for a more granular customization of comment structure. - FEATURE: Add
get_commentstring()function representing built-in logic of computing relevant 'commentstring'.
mini.hipatterns
Introduction of a new module.
mini.hues
Introduction of a new module.
Version 0.8.0
- 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
Introduction of a new module.
mini.comment
- FEATURE: Add
options.start_of_lineoption which controls whether to recognize as comment only lines without indent. - FEATURE: Add
options.ignore_blank_lineoption which controls whether to ignore blank lines. - FEATURE: Add
options.pad_comment_partsoption which controls whether to ensure single space pad for comment leaders.
mini.doc
- FEATURE: Add
config.hooks.write_prehook to be executed before writing to a file.
mini.indentscope
- FEATURE: Add
MiniIndentscopeSymbolOffhighlight group to be used if scope's indent is not multiple of 'shiftwidth'. - FEATURE: Add
draw.priorityoption to control priority of scope line draw.
mini.jump2d
- FEATURE: Add
view.n_steps_aheadoption which controls how many steps ahead to show. Appearance is controlled by newMiniJump2dSpotAheadhighlight group. - FEATURE: Add
view.dimoption which controls whether to dim lines with at least one jump spot. Appearance is controlled by newMiniJump2dDimhighlight group. - FEATURE: Add
MiniJump2dSpotUniquehighlight group to be used for spots with unique label for next step.
mini.pairs
- FEATURE: Both
MiniPairs.br()andMiniPairs.cr()can now take a key which will be used instead of default<BS>and<CR>.
mini.sessions
- FEATURE:
setup()now creates global directory at pathconfig.directoryif it doesn't exist. - All actions now keep list of detected sessions up to date.
mini.splitjoin
Introduction of a new module.
mini.surround
- FEATURE: Add
respect_selection_typeoption 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
- 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
- BREAKING FEATURE: In
MiniAi.gen_spec.argument()optionseparators(plural; array of characters) is soft deprecated in favor ofseparator(singular; Lua pattern) option.
mini.animate
Introduction of new module.
mini.basics
Introduction of a new module.
mini.completion
- BREAKING:
MiniCompletion.config.window_dimensionsis renamed toMiniCompletion.config.windowto be able to handle more general configuration. - FEATURE: Add
MiniCompletion.config.window.info.borderandMiniCompletion.config.window.signature.borderwhich can be used to define border of info and signature floating windows respectively.
mini.indentscope
- BREAKING:
MiniIndentscopePrefixis now not used (deprecated). 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),MiniIndentscopePrefixis no longer needed and no overshadowing is done. - BREAKING:
MiniIndentscope.gen_animationis now a table (for consistency with othergen_*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
- FEATURE: Add
MiniMisc.setup_auto_root()andMiniMisc.find_root()for root finding functionality. NOTE: requires Neovim>=0.8. - FEATURE: Add
MiniMisc.setup_restore_cursor()for automatically restoring latest cursor position on file reopen. By @cryptomilk, PR #198.
mini.move
Introduction of new module.