[{"result":{"data":[{"id":"96956a04-e5eb-422e-b02d-b04e5e9ab9b5","title":"refactor!: deprecate the \"anchor\" config option (#106)","text":"refactor!: deprecate the \"anchor\" config option (#106)\n\nThis was left over from before we had the \"override\" function. Now, it\ndoesn't make much sense to set the anchor as an option because so much\nof the rest of the layout logic depends on the anchor being the default.\nIf a user wants to customize the layout, the override function is the\nway to do it.","type":"breaking-change","createdAt":"2023-07-30T02:21:41.144Z","breakingChange":{"id":18,"postId":"96956a04-e5eb-422e-b02d-b04e5e9ab9b5","pluginId":330,"externalUrl":"https://github.com/stevearc/dressing.nvim/commit/bcaf0d3d6e5cc6e8ecb8df3a7df7d98c567d36e6","sha":"bcaf0d3d6e5cc6e8ecb8df3a7df7d98c567d36e6","plugin":{"id":330,"owner":"stevearc","name":"dressing.nvim","type":"github","source":"awesome-neovim","category":"utility","link":"https://github.com/stevearc/dressing.nvim","shortDescription":"Neovim plugin to improve the default vim.ui interfaces","createdAt":"2023-03-22T19:35:21.617Z","readme":"# Dressing.nvim\n\nWith the release of Neovim 0.6 we were given the start of extensible core UI\nhooks ([vim.ui.select](https://github.com/neovim/neovim/pull/15771) and\n[vim.ui.input](https://github.com/neovim/neovim/pull/15959)). They exist to\nallow plugin authors to override them with improvements upon the default\nbehavior, so that's exactly what we're going to do.\n\nIt is a goal to match and not extend the core Neovim API. All options that core\nrespects will be respected, and we will not accept any custom parameters or\noptions in the functions. Customization will be done entirely using a separate\n[configuration](#configuration) method.\n\n- [Requirements](#requirements)\n- [Screenshots](#screenshots)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Highlights](#highlights)\n- [Advanced configuration](#advanced-configuration)\n- [Notes for plugin authors](#notes-for-plugin-authors)\n- [Alternative and related projects](#alternative-and-related-projects)\n\n## Requirements\n\nNeovim 0.8.0+ (for earlier versions, use the [nvim-0.7](https://github.com/stevearc/dressing.nvim/tree/nvim-0.7) or [nvim-0.5](https://github.com/stevearc/dressing.nvim/tree/nvim-0.5) branch)\n\n## Screenshots\n\n`vim.input` replacement (handling a LSP rename)\n\n![Screenshot from 2021-12-09 17-36-16](https://user-images.githubusercontent.com/506791/145502533-3dc2f87d-95ea-422d-a318-12c0092f1bdf.png)\n\n`vim.select` (telescope)\n\n![Screenshot from 2021-12-02 19-46-01](https://user-images.githubusercontent.com/506791/144541916-4fa60c50-cadc-4f0f-b3c1-6307310e6e99.png)\n\n`vim.select` (fzf)\n\n![Screenshot from 2021-12-02 19-46-54](https://user-images.githubusercontent.com/506791/144541986-6081b4f8-b3b2-418d-9265-b9dabec2c4c4.png)\n\n`vim.select` (nui)\n\n![Screenshot from 2021-12-02 19-47-56](https://user-images.githubusercontent.com/506791/144542071-1aa66f81-b07c-492e-9884-fdafed1006df.png)\n\n`vim.select` (built-in)\n\n![Screenshot from 2021-12-04 17-14-32](https://user-images.githubusercontent.com/506791/144729527-ede0d7ba-a6e6-41e0-be5a-1a5f16d35b05.png)\n\n## Installation\n\ndressing.nvim supports all the usual plugin managers\n\n

lazy.nvim

\n\n```lua\n{\n 'stevearc/dressing.nvim',\n opts = {},\n}\n```\n\n

\n\n

Packer

\n\n```lua\nrequire('packer').startup(function()\n use {'stevearc/dressing.nvim'}\nend)\n```\n\n

\n\n

Paq

\n\n```lua\nrequire \"paq\" {\n {'stevearc/dressing.nvim'};\n}\n```\n\n

\n\n

vim-plug

\n\n```vim\nPlug 'stevearc/dressing.nvim'\n```\n\n

\n\n

dein

\n\n```vim\ncall dein#add('stevearc/dressing.nvim')\n```\n\n

\n\n

Pathogen

\n\n```sh\ngit clone --depth=1 https://github.com/stevearc/dressing.nvim.git ~/.vim/bundle/\n```\n\n

\n\n

Neovim native package

\n\n```sh\ngit clone --depth=1 https://github.com/stevearc/dressing.nvim.git \\\n \"${XDG_DATA_HOME:-$HOME/.local/share}\"/nvim/site/pack/dressing.nvim/start/dressing.nvim\n```\n\n

\n\n## Configuration\n\nIf you're fine with the defaults, you're good to go after installation. If you\nwant to tweak, call this function:\n\n```lua\nrequire(\"dressing\").setup({\n input = {\n -- Set to false to disable the vim.ui.input implementation\n enabled = true,\n\n -- Default prompt string\n default_prompt = \"Input:\",\n\n -- Can be 'left', 'right', or 'center'\n title_pos = \"left\",\n\n -- When true, will close the modal\n insert_only = true,\n\n -- When true, input will start in insert mode.\n start_in_insert = true,\n\n -- These are passed to nvim_open_win\n border = \"rounded\",\n -- 'editor' and 'win' will default to being centered\n relative = \"cursor\",\n\n -- These can be integers or a float between 0 and 1 (e.g. 0.4 for 40%)\n prefer_width = 40,\n width = nil,\n -- min_width and max_width can be a list of mixed types.\n -- min_width = {20, 0.2} means \"the greater of 20 columns or 20% of total\"\n max_width = { 140, 0.9 },\n min_width = { 20, 0.2 },\n\n buf_options = {},\n win_options = {\n -- Disable line wrapping\n wrap = false,\n -- Indicator for when text exceeds window\n list = true,\n listchars = \"precedes:…,extends:…\",\n -- Increase this for more context when text scrolls off the window\n sidescrolloff = 0,\n },\n\n -- Set to `false` to disable\n mappings = {\n n = {\n [\"\"] = \"Close\",\n [\"\"] = \"Confirm\",\n },\n i = {\n [\"\"] = \"Close\",\n [\"\"] = \"Confirm\",\n [\"\"] = \"HistoryPrev\",\n [\"\"] = \"HistoryNext\",\n },\n },\n\n override = function(conf)\n -- This is the config that will be passed to nvim_open_win.\n -- Change values here to customize the layout\n return conf\n end,\n\n -- see :help dressing_get_config\n get_config = nil,\n },\n select = {\n -- Set to false to disable the vim.ui.select implementation\n enabled = true,\n\n -- Priority list of preferred vim.select implementations\n backend = { \"telescope\", \"fzf_lua\", \"fzf\", \"builtin\", \"nui\" },\n\n -- Trim trailing `:` from prompt\n trim_prompt = true,\n\n -- Options for telescope selector\n -- These are passed into the telescope picker directly. Can be used like:\n -- telescope = require('telescope.themes').get_ivy({...})\n telescope = nil,\n\n -- Options for fzf selector\n fzf = {\n window = {\n width = 0.5,\n height = 0.4,\n },\n },\n\n -- Options for fzf-lua\n fzf_lua = {\n -- winopts = {\n -- height = 0.5,\n -- width = 0.5,\n -- },\n },\n\n -- Options for nui Menu\n nui = {\n position = \"50%\",\n size = nil,\n relative = \"editor\",\n border = {\n style = \"rounded\",\n },\n buf_options = {\n swapfile = false,\n filetype = \"DressingSelect\",\n },\n win_options = {\n winblend = 0,\n },\n max_width = 80,\n max_height = 40,\n min_width = 40,\n min_height = 10,\n },\n\n -- Options for built-in selector\n builtin = {\n -- Display numbers for options and set up keymaps\n show_numbers = true,\n -- These are passed to nvim_open_win\n border = \"rounded\",\n -- 'editor' and 'win' will default to being centered\n relative = \"editor\",\n\n buf_options = {},\n win_options = {\n cursorline = true,\n cursorlineopt = \"both\",\n },\n\n -- These can be integers or a float between 0 and 1 (e.g. 0.4 for 40%)\n -- the min_ and max_ options can be a list of mixed types.\n -- max_width = {140, 0.8} means \"the lesser of 140 columns or 80% of total\"\n width = nil,\n max_width = { 140, 0.8 },\n min_width = { 40, 0.2 },\n height = nil,\n max_height = 0.9,\n min_height = { 10, 0.2 },\n\n -- Set to `false` to disable\n mappings = {\n [\"\"] = \"Close\",\n [\"\"] = \"Close\",\n [\"\"] = \"Confirm\",\n },\n\n override = function(conf)\n -- This is the config that will be passed to nvim_open_win.\n -- Change values here to customize the layout\n return conf\n end,\n },\n\n -- Used to override format_item. See :help dressing-format\n format_item_override = {},\n\n -- see :help dressing_get_config\n get_config = nil,\n },\n})\n```\n\n## Highlights\n\nA common way to adjust the highlighting of just the dressing windows is by\nproviding a `winhighlight` option in the config. See `:help winhighlight`\nfor more details. Example:\n\n```lua\nrequire('dressing').setup({\n input = {\n win_options = {\n winhighlight = 'NormalFloat:DiagnosticError'\n }\n }\n})\n```\n\n## Advanced configuration\n\nFor each of the `input` and `select` configs, there is an option\n`get_config`. This can be a function that accepts the `opts` parameter that\nis passed in to `vim.select` or `vim.input`. It must return either `nil` (to\nno-op) or config values to use in place of the global config values for that\nmodule.\n\nFor example, if you want to use a specific configuration for code actions:\n\n```lua\nrequire('dressing').setup({\n select = {\n get_config = function(opts)\n if opts.kind == 'codeaction' then\n return {\n backend = 'nui',\n nui = {\n relative = 'cursor',\n max_width = 40,\n }\n }\n end\n end\n }\n})\n\n```\n\n## Notes for plugin authors\n\nTL;DR: you can customize the telescope `vim.ui.select` implementation by passing `telescope` into `opts`.\n\nThe `vim.ui` hooks are a great boon for us because we can now assume that users\nwill have a reasonable UI available for simple input operations. We no longer\nhave to build separate implementations for each of fzf, telescope, ctrlp, etc.\nThe tradeoff is that `vim.ui.select` is less customizable than any of these\noptions, so if you wanted to have a preview window (like telescope supports), it\nis no longer an option.\n\nMy solution to this is extending the `opts` that are passed to `vim.ui.select`.\nYou can add a `telescope` field that will be passed directly into the picker,\nallowing you to customize any part of the UI. If a user has both dressing and\ntelescope installed, they will get your custom picker UI. If either of those\nare not true, the selection UI will gracefully degrade to whatever the user has\nconfigured for `vim.ui.select`.\n\nAn example of usage:\n\n```lua\nvim.ui.select({'apple', 'banana', 'mango'}, {\n prompt = \"Title\",\n telescope = require(\"telescope.themes\").get_cursor(),\n}, function(selected) end)\n```\n\nFor now this is available only for the telescope backend, but feel free to request additions.\n\n## Alternative and related projects\n\n- [telescope-ui-select](https://github.com/nvim-telescope/telescope-ui-select.nvim) - provides a `vim.ui.select` implementation for telescope\n- [fzf-lua](https://github.com/ibhagwan/fzf-lua/blob/061a4df40f5238782fdd7b380fe55650fadd9384/README.md?plain=1#L259-L264) - provides a `vim.ui.select` implementation for fzf\n- [nvim-fzy](https://github.com/mfussenegger/nvim-fzy) - fzf alternative that also provides a `vim.ui.select` implementation ([#13](https://github.com/mfussenegger/nvim-fzy/pull/13))\n- [guihua.lua](https://github.com/ray-x/guihua.lua) - multipurpose GUI library that provides `vim.ui.select` and `vim.ui.input` implementations\n- [nvim-notify](https://github.com/rcarriga/nvim-notify) - doing pretty much the\n same thing but for `vim.notify`\n- [nui.nvim](https://github.com/MunifTanjim/nui.nvim) - provides common UI\n components for plugin authors. [The wiki](https://github.com/MunifTanjim/nui.nvim/wiki/vim.ui) has examples of how to build your own `vim.ui` interfaces.\n","dotfyleShieldAddedAt":null,"stars":1317,"lastSyncedAt":"2023-11-30T02:20:18.666Z","addedLastWeek":2}}},{"id":"7864e212-2bd0-4065-8739-36fb3a10bc54","title":"refactor!: drop support for Neovim 0.7","text":"refactor!: drop support for Neovim 0.7","type":"breaking-change","createdAt":"2023-06-22T22:40:03.323Z","breakingChange":{"id":2,"postId":"7864e212-2bd0-4065-8739-36fb3a10bc54","pluginId":330,"externalUrl":"https://github.com/stevearc/dressing.nvim/commit/63cfd55eb2573bd37886866de98ae8b8c4e8604c","sha":"63cfd55eb2573bd37886866de98ae8b8c4e8604c","plugin":{"id":330,"owner":"stevearc","name":"dressing.nvim","type":"github","source":"awesome-neovim","category":"utility","link":"https://github.com/stevearc/dressing.nvim","shortDescription":"Neovim plugin to improve the default vim.ui interfaces","createdAt":"2023-03-22T19:35:21.617Z","readme":"# Dressing.nvim\n\nWith the release of Neovim 0.6 we were given the start of extensible core UI\nhooks ([vim.ui.select](https://github.com/neovim/neovim/pull/15771) and\n[vim.ui.input](https://github.com/neovim/neovim/pull/15959)). They exist to\nallow plugin authors to override them with improvements upon the default\nbehavior, so that's exactly what we're going to do.\n\nIt is a goal to match and not extend the core Neovim API. All options that core\nrespects will be respected, and we will not accept any custom parameters or\noptions in the functions. Customization will be done entirely using a separate\n[configuration](#configuration) method.\n\n- [Requirements](#requirements)\n- [Screenshots](#screenshots)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Highlights](#highlights)\n- [Advanced configuration](#advanced-configuration)\n- [Notes for plugin authors](#notes-for-plugin-authors)\n- [Alternative and related projects](#alternative-and-related-projects)\n\n## Requirements\n\nNeovim 0.8.0+ (for earlier versions, use the [nvim-0.7](https://github.com/stevearc/dressing.nvim/tree/nvim-0.7) or [nvim-0.5](https://github.com/stevearc/dressing.nvim/tree/nvim-0.5) branch)\n\n## Screenshots\n\n`vim.input` replacement (handling a LSP rename)\n\n![Screenshot from 2021-12-09 17-36-16](https://user-images.githubusercontent.com/506791/145502533-3dc2f87d-95ea-422d-a318-12c0092f1bdf.png)\n\n`vim.select` (telescope)\n\n![Screenshot from 2021-12-02 19-46-01](https://user-images.githubusercontent.com/506791/144541916-4fa60c50-cadc-4f0f-b3c1-6307310e6e99.png)\n\n`vim.select` (fzf)\n\n![Screenshot from 2021-12-02 19-46-54](https://user-images.githubusercontent.com/506791/144541986-6081b4f8-b3b2-418d-9265-b9dabec2c4c4.png)\n\n`vim.select` (nui)\n\n![Screenshot from 2021-12-02 19-47-56](https://user-images.githubusercontent.com/506791/144542071-1aa66f81-b07c-492e-9884-fdafed1006df.png)\n\n`vim.select` (built-in)\n\n![Screenshot from 2021-12-04 17-14-32](https://user-images.githubusercontent.com/506791/144729527-ede0d7ba-a6e6-41e0-be5a-1a5f16d35b05.png)\n\n## Installation\n\ndressing.nvim supports all the usual plugin managers\n\n

lazy.nvim

\n\n```lua\n{\n 'stevearc/dressing.nvim',\n opts = {},\n}\n```\n\n

\n\n

Packer

\n\n```lua\nrequire('packer').startup(function()\n use {'stevearc/dressing.nvim'}\nend)\n```\n\n

\n\n

Paq

\n\n```lua\nrequire \"paq\" {\n {'stevearc/dressing.nvim'};\n}\n```\n\n

\n\n

vim-plug

\n\n```vim\nPlug 'stevearc/dressing.nvim'\n```\n\n

\n\n

dein

\n\n```vim\ncall dein#add('stevearc/dressing.nvim')\n```\n\n

\n\n

Pathogen

\n\n```sh\ngit clone --depth=1 https://github.com/stevearc/dressing.nvim.git ~/.vim/bundle/\n```\n\n

\n\n

Neovim native package

\n\n```sh\ngit clone --depth=1 https://github.com/stevearc/dressing.nvim.git \\\n \"${XDG_DATA_HOME:-$HOME/.local/share}\"/nvim/site/pack/dressing.nvim/start/dressing.nvim\n```\n\n