[{"result":{"data":[{"id":"8906fff3-fbd0-4b5b-9265-5f0c799289b9","title":"fix!: change yanky's telescope default mapping to avoid collision (#137)","text":"fix!: change yanky's telescope default mapping to avoid collision (#137)\n\nTelescope default mapping use `` to go to previous item, it's override by\r\nyanky's default mapping and I think it's not a good idea. I've changed this\r\ndefault mapping with `` as it's not used by telescope.\r\n\r\nRef: #134","type":"breaking-change","createdAt":"2023-09-23T02:10:35.652Z","breakingChange":{"id":52,"postId":"8906fff3-fbd0-4b5b-9265-5f0c799289b9","pluginId":500,"externalUrl":"https://github.com/gbprod/yanky.nvim/commit/f1ed7fea9b00974fb211d489fedcbdea40484e44","sha":"f1ed7fea9b00974fb211d489fedcbdea40484e44","plugin":{"id":500,"owner":"gbprod","name":"yanky.nvim","type":"github","source":"awesome-neovim","category":"editing-support","link":"https://github.com/gbprod/yanky.nvim","shortDescription":"Improved Yank and Put functionalities for Neovim","createdAt":"2023-03-22T19:35:21.659Z","readme":"# 🍃 yanky.nvim\n\n![Lua](https://img.shields.io/badge/Made%20with%20Lua-blueviolet.svg?style=for-the-badge&logo=lua)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/gbprod/yanky.nvim/integration.yml?branch=main&style=for-the-badge)](https://github.com/gbprod/yanky.nvim/actions/workflows/integration.yml)\n\nThe aim of `yanky.nvim` is to improve yank and put functionalities for Neovim.\n\nFrench slogan:\n\n> \"Vas-y Yanky, c'est bon !\" - Yanky Vincent\n\nOr in English:\n\n> \"Yanky-ki-yay, motherf\\*cker\" - John McYanky\n\n## ✨ Features\n\n- 🖇️ Yank-ring\n- 📜 Yank history picker\n- 💡 Highlight put and yanked text\n- ⤵️ Preserve cursor position on yank\n- ⭐ Special put\n- ⚓ Text object\n\n## ⚡️ Requirements\n\nRequires neovim > `0.9.0`.\n\n## 📦 Installation\n\nInstall the plugin with your preferred package manager:\n\n### [lazy.nvim](https://github.com/folke/lazy.nvim)\n\n```lua\n{\n \"gbprod/yanky.nvim\",\n opts = {\n -- your configuration comes here\n -- or leave it empty to use the default settings\n -- refer to the configuration section below\n },\n}\n```\n\n

More complete setup

\n\n```lua\n{\n \"gbprod/yanky.nvim\",\n dependencies = {\n { \"kkharji/sqlite.lua\" }\n },\n opts = {\n ring = { storage = \"sqlite\" },\n },\n keys = {\n { \"p\", function() require(\"telescope\").extensions.yank_history.yank_history({ }) end, desc = \"Open Yank History\" },\n { \"y\", \"(YankyYank)\", mode = { \"n\", \"x\" }, desc = \"Yank text\" },\n { \"p\", \"(YankyPutAfter)\", mode = { \"n\", \"x\" }, desc = \"Put yanked text after cursor\" },\n { \"P\", \"(YankyPutBefore)\", mode = { \"n\", \"x\" }, desc = \"Put yanked text before cursor\" },\n { \"gp\", \"(YankyGPutAfter)\", mode = { \"n\", \"x\" }, desc = \"Put yanked text after selection\" },\n { \"gP\", \"(YankyGPutBefore)\", mode = { \"n\", \"x\" }, desc = \"Put yanked text before selection\" },\n { \"\", \"(YankyPreviousEntry)\", desc = \"Select previous entry through yank history\" },\n { \"\", \"(YankyNextEntry)\", desc = \"Select next entry through yank history\" },\n { \"]p\", \"(YankyPutIndentAfterLinewise)\", desc = \"Put indented after cursor (linewise)\" },\n { \"[p\", \"(YankyPutIndentBeforeLinewise)\", desc = \"Put indented before cursor (linewise)\" },\n { \"]P\", \"(YankyPutIndentAfterLinewise)\", desc = \"Put indented after cursor (linewise)\" },\n { \"[P\", \"(YankyPutIndentBeforeLinewise)\", desc = \"Put indented before cursor (linewise)\" },\n { \">p\", \"(YankyPutIndentAfterShiftRight)\", desc = \"Put and indent right\" },\n { \"(YankyPutIndentAfterShiftLeft)\", desc = \"Put and indent left\" },\n { \">P\", \"(YankyPutIndentBeforeShiftRight)\", desc = \"Put before and indent right\" },\n { \"(YankyPutIndentBeforeShiftLeft)\", desc = \"Put before and indent left\" },\n { \"=p\", \"(YankyPutAfterFilter)\", desc = \"Put after applying a filter\" },\n { \"=P\", \"(YankyPutBeforeFilter)\", desc = \"Put before applying a filter\" },\n },\n}\n```\n\n

\n\n### [packer](https://github.com/wbthomason/packer.nvim)\n\n```lua\n-- Lua\nuse(\"gbprod/yanky.nvim\")\nrequire(\"yanky\").setup({\n -- your configuration comes here\n -- or leave it empty to use the default settings\n -- refer to the configuration section below\n})\n```\n\n## ⚙️ Configuration\n\nYanky comes with the following defaults:\n\n```lua\n{\n ring = {\n history_length = 100,\n storage = \"shada\",\n storage_path = vim.fn.stdpath(\"data\") .. \"/databases/yanky.db\", -- Only for sqlite storage\n sync_with_numbered_registers = true,\n cancel_event = \"update\",\n ignore_registers = { \"_\" },\n update_register_on_cycle = false,\n },\n picker = {\n select = {\n action = nil, -- nil to use default put action\n },\n telescope = {\n use_default_mappings = true, -- if default mappings should be used\n mappings = nil, -- nil to use default mappings or no mappings (see `use_default_mappings`)\n },\n },\n system_clipboard = {\n sync_with_ring = true,\n },\n highlight = {\n on_put = true,\n on_yank = true,\n timer = 500,\n },\n preserve_cursor_position = {\n enabled = true,\n },\n textobj = {\n enabled = true,\n },\n}\n```\n\n### ⌨️ Mappings\n\n**This plugin contains no default mappings and will have no effect until you add your own maps to it.**\nYou should at least set those keymaps for yank ring usage:\n\n```lua\nvim.keymap.set({\"n\",\"x\"}, \"p\", \"(YankyPutAfter)\")\nvim.keymap.set({\"n\",\"x\"}, \"P\", \"(YankyPutBefore)\")\nvim.keymap.set({\"n\",\"x\"}, \"gp\", \"(YankyGPutAfter)\")\nvim.keymap.set({\"n\",\"x\"}, \"gP\", \"(YankyGPutBefore)\")\n\nvim.keymap.set(\"n\", \"\", \"(YankyPreviousEntry)\")\nvim.keymap.set(\"n\", \"\", \"(YankyNextEntry)\")\n```\n\nAnd those keymaps for `tpope/vim-unimpaired` like usage:\n\n```lua\nvim.keymap.set(\"n\", \"]p\", \"(YankyPutIndentAfterLinewise)\")\nvim.keymap.set(\"n\", \"[p\", \"(YankyPutIndentBeforeLinewise)\")\nvim.keymap.set(\"n\", \"]P\", \"(YankyPutIndentAfterLinewise)\")\nvim.keymap.set(\"n\", \"[P\", \"(YankyPutIndentBeforeLinewise)\")\n\nvim.keymap.set(\"n\", \">p\", \"(YankyPutIndentAfterShiftRight)\")\nvim.keymap.set(\"n\", \"(YankyPutIndentAfterShiftLeft)\")\nvim.keymap.set(\"n\", \">P\", \"(YankyPutIndentBeforeShiftRight)\")\nvim.keymap.set(\"n\", \"(YankyPutIndentBeforeShiftLeft)\")\n\nvim.keymap.set(\"n\", \"=p\", \"(YankyPutAfterFilter)\")\nvim.keymap.set(\"n\", \"=P\", \"(YankyPutBeforeFilter)\")\n```\n\nSome features requires specific mappings, refer to feature documentation section.\n\n## 🖇️ Yank-ring\n\nYank-ring allows cycling throught yank history when putting text (like the Emacs\n\"kill-ring\" feature). Yanky automatically maintain a history of yanks that you\ncan choose between when pasting.\n\n### ⌨️ Mappings\n\n```lua\nvim.keymap.set(\"n\", \"\", \"(YankyPreviousEntry)\")\nvim.keymap.set(\"n\", \"\", \"(YankyNextEntry)\")\n```\n\nWith these mappings, after performing a paste, you can cycle through the history\nby hitting `` and ``. Any modifications done after pasting will cancel\nthe possibility to cycle.\n\nNote that the swap operations above will only affect the current paste and the\nhistory will be unchanged.\n\n### ⚙️ Configuration\n\n```lua\nrequire(\"yanky\").setup({\n ring = {\n history_length = 100,\n storage = \"shada\",\n sync_with_numbered_registers = true,\n cancel_event = \"update\",\n ignore_registers = { \"_\" },\n update_register_on_cycle = false,\n },\n system_clipboard = {\n sync_with_ring = true,\n },\n})\n```\n\n#### `ring.history_length`\n\nDefault : `100`\n\nDefine the number of yanked items that will be saved and used for ring.\n\n#### `ring.storage`\n\nDefault : `shada`\n\nAvailable : `shada`, `sqlite` or `memory`\n\nDefine the storage mode for ring values.\n\nUsing `shada`, this will save pesistantly using Neovim ShaDa feature. This means\nthat history will be persisted between each session of Neovim.\n\nYou can also use this feature to sync the yank history across multiple running instances\nof Neovim by updating shada file. If you execute `:wshada` in the first instance\nand then `:rshada` in the second instance, the second instance will be synced with\nthe yank history in the first instance.\n\nUsing `memory`, each Neovim instance will have his own history and il will be\nlost between sessions.\n\nIf you want to use `sqlite` as storage, you must add [`kkharji/sqlite.lua`](https://github.com/kkharji/sqlite.lua) as dependency:\n\n```lua\nuse({\n \"gbprod/yanky.nvim\",\n requires = { \"kkharji/sqlite.lua\" }\n})\n```\n\nSqlite is more reliable than ShaDa but requires more dependencies. You can\nchange the storage path using `ring.storage_path` option.\n\n### `ring.sync_with_numbered_registers`\n\nDefault : `true`\n\nHistory can also be synchronized with numbered registers. Every time the yank\nhistory changes the numbered registers 1 - 9 will be updated to sync with the\nfirst 9 entries in the yank history. See [here](http://vimcasts.org/blog/2013/11/registers-the-good-the-bad-and-the-ugly-parts/)\nfor an explanation of why we would want do do this.\n\n### `ring.cancel_event`\n\nDefault: `update`\n\nDefine the event used to cancel ring activation. `update` will cancel ring on\nnext buffer update, `move` will cancel ring when moving cursor or content\nchanged.\n\n### `ring.ignore_registers `\n\nDefault: `{ \"_\" }`\n\nDefine registeres to be ignored. By default the black hole register is ignored.\n\n### `system_clipboard.sync_with_ring`\n\nDefault: `true`\n\nYanky can automatically adds to ring history yanks that occurs outside of Neovim.\nThis works regardless to your `&clipboard` setting.\n\nThis means, if `&clipboard` is set to `unnamed` and/or `unnamedplus`, if you yank\nsomething outside of Neovim, you can put it immediatly using `p` and it will be\nadded to your yank ring.\n\nIf `&clipboard` is empty, if you yank something outside of Neovim, this will be\nthe first value you'll have when cycling through the ring. Basicly, you can do\n`p` and then `` to paste yanked text.\n\n### `ring.update_register_on_cycle`\n\nDefault: `false`\n\nUsing the `update_register_on_cycle` option, when you cycle through the ring,\nthe contents of the register used to update will be updated with the last\ncontent cycled.\n\n### Commands\n\nYou can clear yank history using `YankyClearHistory` command.\n\n## 📜 Yank history picker\n\nThis allows you to select an entry in your recorded yank history using default\n`vim.ui.select` neovim prompt (you can use [stevearc/dressing.nvim](https://github.com/stevearc/dressing.nvim/)\nto customize this) or the awesome [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim).\n\nIt uses the same history as yank ring, so, if you want to increase history size,\njust use [`ring.history_length` option](#ringhistory_length).\n\nSee [Integrations](#-integrations) to have a completion with [nvim-cmp](https://github.com/hrsh7th/nvim-cmp).\n\n### Yank history completions\n\nUsing [nvim-cmp](https://github.com/hrsh7th/nvim-cmp) and [cmp_yanky](https://github.com/chrisgrieser/cmp_yanky), you can also get suggestions from your yank history as you type in insert mode.\n\n

demonstration

\n $\"showcasing$ \n

\n\n### ⚙️ Configuration\n\nTo use `vim.ui.select` picker, just call `YankyRingHistory` command.\n\nTo use the `yank_history` Telescope picker, register `yank_history` as a\nTelescope extension in your Neovim config file.\n\n```lua\n:lua require(\"telescope\").load_extension(\"yank_history\")\n```\n\nAfter loading the extension, you can access the picker by running:\n\n```vim\n:Telescope yank_history\n```\n\nOr:\n\n```lua\n:lua require(\"telescope\").extensions.yank_history.yank_history()\n```\n\nSet the Telescope option [`dynamic_preview_title`](https://github.com/nvim-telescope/telescope.nvim/blob/master/doc/telescope.txt)\nto `true` if you want your Telescope preview window to have a\ndynamic title showing the register's type.\n\nDefault configuration :\n\n```lua\nrequire(\"yanky\").setup({\n picker = {\n select = {\n action = nil, -- nil to use default put action\n },\n telescope = {\n mappings = nil, -- nil to use default mappings\n },\n },\n})\n```\n\n#### `picker.select.acion`\n\nDefault : `nil`\n\nThis define the action that should be done when selecting an item in the\n`vim.ui.select` prompt. If you let this option to `nil`, this will use the\ndefault action : put selected item after cursor.\n\nAvailable actions:\n\n```lua\nrequire(\"yanky.picker\").actions.put(\"p\") -- put after cursor\nrequire(\"yanky.picker\").actions.put(\"P\") -- put before cursor\nrequire(\"yanky.picker\").actions.put(\"gp\") -- put after cursor and leave the cursor after\nrequire(\"yanky.picker\").actions.put(\"gP\") -- put before cursor and leave the cursor after\nrequire(\"yanky.picker\").actions.delete() -- delete entry from yank history\nrequire(\"yanky.picker\").actions.set_register(regname) -- fill register with selected value\nrequire(\"yanky.picker\").actions.put_and_set_register(\"p\", regname) -- put and fill register with selected value\n```\n\n#### `picker.telescope.use_default_mappings`\n\nDefault : `true`\n\nThis define if default Telescope mappings should be use.\n\nIf you let this option to `true`, this will use the default mappings :\n\n```lua\nlocal utils = require(\"yanky.utils\")\nlocal mapping = require(\"yanky.telescope.mapping\")\n\nrequire(\"yanky\").setup({\n picker = {\n telescope = {\n mappings = {\n default = mapping.put(\"p\"),\n i = {\n [\"\"] = mapping.put(\"p\"),\n [\"\"] = mapping.put(\"P\"),\n [\"\"] = mapping.delete(),\n [\"\"] = mapping.set_register(utils.get_default_register()),\n },\n n = {\n p = mapping.put(\"p\"),\n P = mapping.put(\"P\"),\n d = mapping.delete(),\n r = mapping.set_register(utils.get_default_register())\n },\n }\n }\n }\n})\n```\n\n#### `picker.telescope.mappings`\n\nDefault : `nil`\n\nThis define or overrides the mappings available in Telescope.\n\nIf you set `use_default_mappings` to `true`, mappings will be merged with default mappings.\n\n**Available actions:**\n\n```lua\nrequire(\"yanky.telescope.mapping\").put(\"p\") -- put after cursor\nrequire(\"yanky.telescope.mapping\").put(\"P\") -- put before cursor\nrequire(\"yanky.telescope.mapping\").put(\"gp\") -- put after cursor and leave the cursor after\nrequire(\"yanky.telescope.mapping\").put(\"gP\") -- put before cursor and leave the cursor after\nrequire(\"yanky.telescope.mapping\").delete() -- delete entry from yank history\nrequire(\"yanky.telescope.mapping\").set_register(regname) -- fill register {regname} with selected value\n```\n\nYou can also use any of available [special puts](https://github.com/gbprod/yanky.nvim#%EF%B8%8F-special-put) like this:\n\n```lua\nrequire(\"yanky.telescope.mapping\").special_put(\"{{ name of the special put }}\")\n\n-- eg.\nrequire(\"yanky.telescope.mapping\").special_put(\"YankyPutAfterCharwiseJoined\")\n```\n\n## 💡 Highlight put and yanked text\n\nThis will give you a visual feedback on put and yank text\nby highlighting this.\n\n### Configuration\n\n```lua\nrequire(\"yanky\").setup({\n highlight = {\n on_put = true,\n on_yank = true,\n timer = 500,\n },\n})\n```\n\nYou can override `YankyPut` highlight to change colors.\n\n#### `highlight.on_put`\n\nDefault : `true`\n\nDefine if highlight put text feature is enabled.\n\n#### `highlight.on_yank`\n\nDefault : `true`\n\nDefine if highlight yanked text feature is enabled.\n\n#### `highlight.timer`\n\nDefault : `500`\n\nDefine the duration of highlight.\n\n## ⤵️ Preserve cursor position on yank\n\nBy default in Neovim, when yanking text, cursor moves to the start of the yanked\ntext. Could be annoying especially when yanking a large text object such as a\nparagraph or a large text object.\n\nWith this feature, yank will function exactly the same as previously with the one\ndifference being that the cursor position will not change after performing a yank.\n\n### ⌨️ Mappings\n\n```lua\nvim.keymap.set({\"n\",\"x\"}, \"y\", \"(YankyYank)\")\n```\n\n### ⚙️ Configuration\n\n```lua\nrequire(\"yanky\").setup({\n preserve_cursor_position = {\n enabled = true,\n },\n})\n```\n\n#### `preserve_cursor_position.enabled`\n\nDefault : `true`\n\nDefine if cursor position should be preserved on yank. This works only if mappings\nhas been defined.\n\n## ⭐ Special put\n\nYanky comes with special put moves (inspired by\n[tpope/vim-unimpaired](https://github.com/tpope/vim-unimpaired/blob/master/doc/unimpaired.txt#L100)):\n\n- Linewise put: this will force put above or below the current line ;\n- Shift right/left put: will put above or below the current line and increasing\n or decreasing indent ;\n- Filter put: will put above or below the current line and reindenting.\n\n### ⌨️ Mappings\n\nFor basic usage (like with [tpope/vim-unimpaired](https://github.com/tpope/vim-unimpaired/blob/master/doc/unimpaired.txt#L100)),\nyou can use those bindings:\n\n```lua\nvim.keymap.set(\"n\", \"]p\", \"(YankyPutIndentAfterLinewise)\")\nvim.keymap.set(\"n\", \"[p\", \"(YankyPutIndentBeforeLinewise)\")\nvim.keymap.set(\"n\", \"]P\", \"(YankyPutIndentAfterLinewise)\")\nvim.keymap.set(\"n\", \"[P\", \"(YankyPutIndentBeforeLinewise)\")\n\nvim.keymap.set(\"n\", \">p\", \"(YankyPutIndentAfterShiftRight)\")\nvim.keymap.set(\"n\", \"(YankyPutIndentAfterShiftLeft)\")\nvim.keymap.set(\"n\", \">P\", \"(YankyPutIndentBeforeShiftRight)\")\nvim.keymap.set(\"n\", \"(YankyPutIndentBeforeShiftLeft)\")\n\nvim.keymap.set(\"n\", \"=p\", \"(YankyPutAfterFilter)\")\nvim.keymap.set(\"n\", \"=P\", \"(YankyPutBeforeFilter)\")\n```\n\nTo go further, Plug mappings are constructed like this: `Yanky(put-type)(modifier)(rewriter)`.\n\n`put-type` can be:\n\n- `PutAfter`: put after your cursor (as [`p`](https://neovim.io/doc/user/change.html#put) key) ;\n- `PutBefore`: put before your cursor (as [`P`](https://neovim.io/doc/user/change.html#P) key) ;\n- `GPutAfter`: like `PutAfter` but leave the cursor after the new text (as [`gp`](https://neovim.io/doc/user/change.html#gp) key) ;\n- `GPutBefore`: like `PutBefore` but leave the cursor after the new text (as [`gP`](https://neovim.io/doc/user/change.html#gP) key) ;\n- `PutIndentAfter`: like `PutAfter` but adjust the indent to the current line (as [`]p`](https://neovim.io/doc/user/change.html#]p) key) ;\n- `PutIndentBefore`: like `PutBefore` but adjust the indent to the current line (as [`[p`](https://neovim.io/doc/user/change.html#[p) key) ;\n\n`modifier` (optional) can be:\n\n- `Linewise`: put in linewise mode ;\n- `Charwise`: put in charwise mode ;\n- `Blockwise`: put in blockwise mode ;\n- `ShiftRight`: increase indent ;\n- `ShiftLeft`: decrease indent.\n\n`rewriter` (optional) can be:\n\n- `Joined`: put lines trimed and joined.\n\n

All special puts

\n\n```vim\n(YankyPutAfter)\n(YankyPutAfterBlockwise)\n(YankyPutAfterBlockwiseJoined)\n(YankyPutAfterCharwise)\n(YankyPutAfterCharwiseJoined)\n(YankyPutAfterFilter)\n(YankyPutAfterFilterJoined)\n(YankyPutAfterJoined)\n(YankyPutAfterLinewise)\n(YankyPutAfterLinewiseJoined)\n(YankyPutAfterShiftLeft)\n(YankyPutAfterShiftLeftJoined)\n(YankyPutAfterShiftRight)\n(YankyPutAfterShiftRightJoined)\n(YankyPutBefore)\n(YankyPutBeforeBlockwise)\n(YankyPutBeforeBlockwiseJoined)\n(YankyPutBeforeCharwise)\n(YankyPutBeforeCharwiseJoined)\n(YankyPutBeforeFilter)\n(YankyPutBeforeFilterJoined)\n(YankyPutBeforeJoined)\n(YankyPutBeforeLinewise)\n(YankyPutBeforeLinewiseJoined)\n(YankyPutBeforeShiftLeft)\n(YankyPutBeforeShiftLeftJoined)\n(YankyPutBeforeShiftRight)\n(YankyPutBeforeShiftRightJoined)\n(YankyGPutAfter)\n(YankyGPutAfterBlockwise)\n(YankyGPutAfterBlockwiseJoined)\n(YankyGPutAfterCharwise)\n(YankyGPutAfterCharwiseJoined)\n(YankyGPutAfterFilter)\n(YankyGPutAfterFilterJoined)\n(YankyGPutAfterJoined)\n(YankyGPutAfterLinewise)\n(YankyGPutAfterLinewiseJoined)\n(YankyGPutAfterShiftLeft)\n(YankyGPutAfterShiftLeftJoined)\n(YankyGPutAfterShiftRight)\n(YankyGPutAfterShiftRightJoined)\n(YankyGPutBefore)\n(YankyGPutBeforeBlockwise)\n(YankyGPutBeforeBlockwiseJoined)\n(YankyGPutBeforeCharwise)\n(YankyGPutBeforeCharwiseJoined)\n(YankyGPutBeforeFilter)\n(YankyGPutBeforeFilterJoined)\n(YankyGPutBeforeJoined)\n(YankyGPutBeforeLinewise)\n(YankyGPutBeforeLinewiseJoined)\n(YankyGPutBeforeShiftLeft)\n(YankyGPutBeforeShiftLeftJoined)\n(YankyGPutBeforeShiftRight)\n(YankyGPutBeforeShiftRightJoined)\n(YankyPutIndentAfter)\n(YankyPutIndentAfterBlockwise)\n(YankyPutIndentAfterBlockwiseJoined)\n(YankyPutIndentAfterCharwise)\n(YankyPutIndentAfterCharwiseJoined)\n(YankyPutIndentAfterFilter)\n(YankyPutIndentAfterFilterJoined)\n(YankyPutIndentAfterJoined)\n(YankyPutIndentAfterLinewise)\n(YankyPutIndentAfterLinewiseJoined)\n(YankyPutIndentAfterShiftLeft)\n(YankyPutIndentAfterShiftLeftJoined)\n(YankyPutIndentAfterShiftRight)\n(YankyPutIndentAfterShiftRightJoined)\n(YankyPutIndentBefore)\n(YankyPutIndentBeforeBlockwise)\n(YankyPutIndentBeforeBlockwiseJoined)\n(YankyPutIndentBeforeCharwise)\n(YankyPutIndentBeforeCharwiseJoined)\n(YankyPutIndentBeforeFilter)\n(YankyPutIndentBeforeFilterJoined)\n(YankyPutIndentBeforeJoined)\n(YankyPutIndentBeforeLinewise)\n(YankyPutIndentBeforeLinewiseJoined)\n(YankyPutIndentBeforeShiftLeft)\n(YankyPutIndentBeforeShiftLeftJoined)\n(YankyPutIndentBeforeShiftRight)\n(YankyPutIndentBeforeShiftRightJoined)\n```\n\n

\n\n## ⚓ Text object\n\nYanky comes with a text object corresponding to last put text. To use it, you\nhave to enable it in settings and set a keymap.\n\n### ⚙️ Configuration\n\n```lua\nrequire(\"yanky\").setup({\n textobj = {\n enabled = true,\n },\n})\n```\n\n### ⌨️ Mappings\n\n```lua\nvim.keymap.set({ \"o\", \"x\" }, \"lp\", function()\n require(\"yanky.textobj\").last_put()\nend, {})\n```\n\n## 🎨 Colors\n\n| Description | Group | Default |\n| ------------------------------- | ----------- | -------------- |\n| Highlight color for put text | YankyPut | link to Search |\n| Highlight color for yanked text | YankyYanked | link to Search |\n\n## 🤝 Integrations\n\n

gbprod/substitute.nvim

\n\nTo enable [gbprod/substitute.nvim](https://github.com/gbprod/substitute.nvim)\nswap when performing a substitution, you can add this to your setup:\n\n```lua\nrequire(\"substitute\").setup({\n on_substitute = require(\"yanky.integration\").substitute(),\n})\n```\n\n

\n\n

hrsh7th/nvim-cmp

\n\nUsing [hrsh7th/nvim-cmp](https://github.com/hrsh7th/nvim-cmp) and [chrisgrieser/cmp_yanky](https://github.com/chrisgrieser/cmp_yanky), you can also get suggestions from your yank history as you type in insert mode.\n\n $\"showcasing$ \n

\n\n

anuvyklack/hydra.nvim

\n\nTo work with [anuvyklack/hydra.nvim](https://github.com/anuvyklack/hydra.nvim)\nonly setup / mapping when yanky is activated, you can add this to your setup:\n\n```lua\nlocal Hydra = require(\"hydra\")\n\nlocal function t(str)\n return api.nvim_replace_termcodes(str, true, true, true)\nend\n\nlocal yanky_hydra = Hydra({\n name = \"Yank ring\",\n mode = \"n\",\n heads = {\n { \"p\", \"(YankyPutAfter)\", { desc = \"After\" } },\n { \"P\", \"(YankyPutBefore)\", { desc = \"Before\" } },\n { \"\", \"(YankyPreviousEntry)\", { private = true, desc = \"↑\" } },\n { \"\", \"(YankyNextEntry)\", { private = true, desc = \"↓\" } },\n },\n})\n\n-- choose/change the mappings if you want\nfor key, putAction in pairs({\n [\"p\"] = \"(YankyPutAfter)\",\n [\"P\"] = \"(YankyPutBefore)\",\n [\"gp\"] = \"(YankyGPutAfter)\",\n [\"gP\"] = \"(YankyGPutBefore)\",\n}) do\n vim.keymap.set({ \"n\", \"x\" }, key, function()\n vim.fn.feedkeys(t(putAction))\n yanky_hydra:activate()\n end)\nend\n\n-- choose/change the mappings if you want\nfor key, putAction in pairs({\n [\"]p\"] = \"(YankyPutIndentAfterLinewise)\",\n [\"[p\"] = \"(YankyPutIndentBeforeLinewise)\",\n [\"]P\"] = \"(YankyPutIndentAfterLinewise)\",\n [\"[P\"] = \"(YankyPutIndentBeforeLinewise)\",\n\n [\">p\"] = \"(YankyPutIndentAfterShiftRight)\",\n [\"(YankyPutIndentAfterShiftLeft)\",\n [\">P\"] = \"(YankyPutIndentBeforeShiftRight)\",\n [\"(YankyPutIndentBeforeShiftLeft)\",\n\n [\"=p\"] = \"(YankyPutAfterFilter)\",\n [\"=P\"] = \"(YankyPutBeforeFilter)\",\n}) do\n vim.keymap.set(\"n\", key, function()\n vim.fn.feedkeys(t(putAction))\n yanky_hydra:activate()\n end)\nend\n```\n\n

\n\n## 🎉 Credits\n\nThis plugin is mostly a lua version of [svermeulen/vim-yoink](https://github.com/svermeulen/vim-yoink)\nawesome plugin.\n\nOther inspiration :\n\n- [bfredl/nvim-miniyank](https://github.com/bfredl/nvim-miniyank)\n- [maxbrunsfeld/vim-yankstack](https://github.com/maxbrunsfeld/vim-yankstack)\n- [svermeulen/vim-easyclip](https://github.com/svermeulen/vim-easyclip)\n- [bkoropoff/yankee.vim](https://github.com/bkoropoff/yankee.vim)\n- [svban/YankAssassin.vim](https://github.com/svban/YankAssassin.vim)\n- [tpope/vim-unimpaired](https://github.com/tpope/vim-unimpaired)\n- [inkarkat/vim-UnconditionalPaste](https://github.com/inkarkat/vim-UnconditionalPaste)\n","dotfyleShieldAddedAt":null,"stars":601,"lastSyncedAt":"2023-12-01T02:25:30.788Z","addedLastWeek":4}}}]}}]