retrovim 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (218) hide show
  1. package/.conda/retrovim.yaml +259 -0
  2. package/.conda/terax.icns +0 -0
  3. package/.conda/terax.ico +0 -0
  4. package/.conda/terax.png +0 -0
  5. package/.github/workflows/release.yml +95 -0
  6. package/.gitmodules +3 -0
  7. package/.npm/kanata_touchcursor.js +28 -0
  8. package/.npm/nvim.js +26 -0
  9. package/.npm/yazi.js +26 -0
  10. package/.npm/zsh.js +17 -0
  11. package/.pip/kanata_touchcursor/__init__.py +28 -0
  12. package/.pip/nvim/__init__.py +31 -0
  13. package/.pip/yazi/__init__.py +31 -0
  14. package/.pip/zsh/__init__.py +22 -0
  15. package/CHANGELOG.md +26 -0
  16. package/LICENSE +674 -0
  17. package/README.md +336 -0
  18. package/kanata/touchcursor.kbd +164 -0
  19. package/nvim/init.lua +813 -0
  20. package/nvim/plugins/mini.nvim/.github/DISCUSSION_TEMPLATE/q-a.yml +72 -0
  21. package/nvim/plugins/mini.nvim/.github/ISSUE_TEMPLATE/bug-report.yml +136 -0
  22. package/nvim/plugins/mini.nvim/.github/ISSUE_TEMPLATE/config.yml +5 -0
  23. package/nvim/plugins/mini.nvim/.github/ISSUE_TEMPLATE/feature-request.yml +75 -0
  24. package/nvim/plugins/mini.nvim/.github/PULL_REQUEST_TEMPLATE.md +2 -0
  25. package/nvim/plugins/mini.nvim/.github/workflows/quality-control.yml +150 -0
  26. package/nvim/plugins/mini.nvim/.pre-commit-config.yaml +20 -0
  27. package/nvim/plugins/mini.nvim/.stylua.toml +7 -0
  28. package/nvim/plugins/mini.nvim/.styluaignore +1 -0
  29. package/nvim/plugins/mini.nvim/CHANGELOG.md +1894 -0
  30. package/nvim/plugins/mini.nvim/CODE_OF_CONDUCT.md +132 -0
  31. package/nvim/plugins/mini.nvim/CONTRIBUTING.md +331 -0
  32. package/nvim/plugins/mini.nvim/LICENSE +21 -0
  33. package/nvim/plugins/mini.nvim/MAINTAINING.md +330 -0
  34. package/nvim/plugins/mini.nvim/Makefile +51 -0
  35. package/nvim/plugins/mini.nvim/README.md +261 -0
  36. package/nvim/plugins/mini.nvim/TESTING.md +1011 -0
  37. package/nvim/plugins/mini.nvim/benchmarks/starter/README.md +35 -0
  38. package/nvim/plugins/mini.nvim/benchmarks/starter/benchmark.sh +56 -0
  39. package/nvim/plugins/mini.nvim/benchmarks/starter/init-files/init_dashboard-alpha.lua +21 -0
  40. package/nvim/plugins/mini.nvim/benchmarks/starter/init-files/init_dashboard-original.lua +17 -0
  41. package/nvim/plugins/mini.nvim/benchmarks/starter/init-files/init_dashboard-starter.lua +18 -0
  42. package/nvim/plugins/mini.nvim/benchmarks/starter/init-files/init_empty.lua +4 -0
  43. package/nvim/plugins/mini.nvim/benchmarks/starter/init-files/init_starter-default.lua +7 -0
  44. package/nvim/plugins/mini.nvim/benchmarks/starter/init-files/init_startify-alpha.lua +10 -0
  45. package/nvim/plugins/mini.nvim/benchmarks/starter/init-files/init_startify-original.lua +7 -0
  46. package/nvim/plugins/mini.nvim/benchmarks/starter/init-files/init_startify-starter.lua +20 -0
  47. package/nvim/plugins/mini.nvim/benchmarks/starter/install.sh +10 -0
  48. package/nvim/plugins/mini.nvim/benchmarks/starter/make_summary.py +68 -0
  49. package/nvim/plugins/mini.nvim/benchmarks/starter/startup-summary.md +10 -0
  50. package/nvim/plugins/mini.nvim/colors/miniautumn.lua +55 -0
  51. package/nvim/plugins/mini.nvim/colors/minicyan.lua +95 -0
  52. package/nvim/plugins/mini.nvim/colors/minischeme.lua +95 -0
  53. package/nvim/plugins/mini.nvim/colors/minispring.lua +53 -0
  54. package/nvim/plugins/mini.nvim/colors/minisummer.lua +49 -0
  55. package/nvim/plugins/mini.nvim/colors/miniwinter.lua +51 -0
  56. package/nvim/plugins/mini.nvim/colors/randomhue.lua +16 -0
  57. package/nvim/plugins/mini.nvim/doc/mini-ai.txt +889 -0
  58. package/nvim/plugins/mini.nvim/doc/mini-align.txt +923 -0
  59. package/nvim/plugins/mini.nvim/doc/mini-animate.txt +937 -0
  60. package/nvim/plugins/mini.nvim/doc/mini-base16.txt +285 -0
  61. package/nvim/plugins/mini.nvim/doc/mini-basics.txt +359 -0
  62. package/nvim/plugins/mini.nvim/doc/mini-bracketed.txt +622 -0
  63. package/nvim/plugins/mini.nvim/doc/mini-bufremove.txt +123 -0
  64. package/nvim/plugins/mini.nvim/doc/mini-clue.txt +760 -0
  65. package/nvim/plugins/mini.nvim/doc/mini-cmdline.txt +392 -0
  66. package/nvim/plugins/mini.nvim/doc/mini-colors.txt +880 -0
  67. package/nvim/plugins/mini.nvim/doc/mini-comment.txt +230 -0
  68. package/nvim/plugins/mini.nvim/doc/mini-completion.txt +477 -0
  69. package/nvim/plugins/mini.nvim/doc/mini-cursorword.txt +105 -0
  70. package/nvim/plugins/mini.nvim/doc/mini-deps.txt +590 -0
  71. package/nvim/plugins/mini.nvim/doc/mini-diff.txt +661 -0
  72. package/nvim/plugins/mini.nvim/doc/mini-doc.txt +434 -0
  73. package/nvim/plugins/mini.nvim/doc/mini-extra.txt +856 -0
  74. package/nvim/plugins/mini.nvim/doc/mini-files.txt +1018 -0
  75. package/nvim/plugins/mini.nvim/doc/mini-fuzzy.txt +160 -0
  76. package/nvim/plugins/mini.nvim/doc/mini-git.txt +425 -0
  77. package/nvim/plugins/mini.nvim/doc/mini-hipatterns.txt +489 -0
  78. package/nvim/plugins/mini.nvim/doc/mini-hues.txt +420 -0
  79. package/nvim/plugins/mini.nvim/doc/mini-icons.txt +508 -0
  80. package/nvim/plugins/mini.nvim/doc/mini-indentscope.txt +485 -0
  81. package/nvim/plugins/mini.nvim/doc/mini-input.txt +932 -0
  82. package/nvim/plugins/mini.nvim/doc/mini-jump.txt +202 -0
  83. package/nvim/plugins/mini.nvim/doc/mini-jump2d.txt +525 -0
  84. package/nvim/plugins/mini.nvim/doc/mini-keymap.txt +449 -0
  85. package/nvim/plugins/mini.nvim/doc/mini-map.txt +717 -0
  86. package/nvim/plugins/mini.nvim/doc/mini-misc.txt +431 -0
  87. package/nvim/plugins/mini.nvim/doc/mini-move.txt +181 -0
  88. package/nvim/plugins/mini.nvim/doc/mini-notify.txt +434 -0
  89. package/nvim/plugins/mini.nvim/doc/mini-nvim.txt +431 -0
  90. package/nvim/plugins/mini.nvim/doc/mini-operators.txt +472 -0
  91. package/nvim/plugins/mini.nvim/doc/mini-pairs.txt +346 -0
  92. package/nvim/plugins/mini.nvim/doc/mini-pick.txt +1535 -0
  93. package/nvim/plugins/mini.nvim/doc/mini-sessions.txt +239 -0
  94. package/nvim/plugins/mini.nvim/doc/mini-snippets.txt +1291 -0
  95. package/nvim/plugins/mini.nvim/doc/mini-splitjoin.txt +536 -0
  96. package/nvim/plugins/mini.nvim/doc/mini-starter.txt +618 -0
  97. package/nvim/plugins/mini.nvim/doc/mini-statusline.txt +361 -0
  98. package/nvim/plugins/mini.nvim/doc/mini-surround.txt +863 -0
  99. package/nvim/plugins/mini.nvim/doc/mini-tabline.txt +151 -0
  100. package/nvim/plugins/mini.nvim/doc/mini-test.txt +966 -0
  101. package/nvim/plugins/mini.nvim/doc/mini-trailspace.txt +91 -0
  102. package/nvim/plugins/mini.nvim/doc/mini-visits.txt +937 -0
  103. package/nvim/plugins/mini.nvim/logo.png +0 -0
  104. package/nvim/plugins/mini.nvim/lua/mini/ai.lua +2244 -0
  105. package/nvim/plugins/mini.nvim/lua/mini/align.lua +2076 -0
  106. package/nvim/plugins/mini.nvim/lua/mini/animate.lua +2127 -0
  107. package/nvim/plugins/mini.nvim/lua/mini/base16.lua +1752 -0
  108. package/nvim/plugins/mini.nvim/lua/mini/basics.lua +772 -0
  109. package/nvim/plugins/mini.nvim/lua/mini/bracketed.lua +2013 -0
  110. package/nvim/plugins/mini.nvim/lua/mini/bufremove.lua +283 -0
  111. package/nvim/plugins/mini.nvim/lua/mini/clue.lua +2096 -0
  112. package/nvim/plugins/mini.nvim/lua/mini/cmdline.lua +1182 -0
  113. package/nvim/plugins/mini.nvim/lua/mini/colors.lua +2483 -0
  114. package/nvim/plugins/mini.nvim/lua/mini/comment.lua +586 -0
  115. package/nvim/plugins/mini.nvim/lua/mini/completion.lua +2094 -0
  116. package/nvim/plugins/mini.nvim/lua/mini/cursorword.lua +311 -0
  117. package/nvim/plugins/mini.nvim/lua/mini/deps.lua +1660 -0
  118. package/nvim/plugins/mini.nvim/lua/mini/diff.lua +1938 -0
  119. package/nvim/plugins/mini.nvim/lua/mini/doc.lua +1371 -0
  120. package/nvim/plugins/mini.nvim/lua/mini/extra.lua +2290 -0
  121. package/nvim/plugins/mini.nvim/lua/mini/files.lua +3145 -0
  122. package/nvim/plugins/mini.nvim/lua/mini/fuzzy.lua +356 -0
  123. package/nvim/plugins/mini.nvim/lua/mini/git.lua +1737 -0
  124. package/nvim/plugins/mini.nvim/lua/mini/hipatterns.lua +1042 -0
  125. package/nvim/plugins/mini.nvim/lua/mini/hues.lua +2088 -0
  126. package/nvim/plugins/mini.nvim/lua/mini/icons.lua +2254 -0
  127. package/nvim/plugins/mini.nvim/lua/mini/indentscope.lua +1158 -0
  128. package/nvim/plugins/mini.nvim/lua/mini/init.lua +427 -0
  129. package/nvim/plugins/mini.nvim/lua/mini/input.lua +2183 -0
  130. package/nvim/plugins/mini.nvim/lua/mini/jump.lua +609 -0
  131. package/nvim/plugins/mini.nvim/lua/mini/jump2d.lua +1244 -0
  132. package/nvim/plugins/mini.nvim/lua/mini/keymap.lua +880 -0
  133. package/nvim/plugins/mini.nvim/lua/mini/map.lua +1709 -0
  134. package/nvim/plugins/mini.nvim/lua/mini/misc.lua +969 -0
  135. package/nvim/plugins/mini.nvim/lua/mini/move.lua +509 -0
  136. package/nvim/plugins/mini.nvim/lua/mini/notify.lua +938 -0
  137. package/nvim/plugins/mini.nvim/lua/mini/operators.lua +1349 -0
  138. package/nvim/plugins/mini.nvim/lua/mini/pairs.lua +657 -0
  139. package/nvim/plugins/mini.nvim/lua/mini/pick.lua +3876 -0
  140. package/nvim/plugins/mini.nvim/lua/mini/sessions.lua +689 -0
  141. package/nvim/plugins/mini.nvim/lua/mini/snippets.lua +2828 -0
  142. package/nvim/plugins/mini.nvim/lua/mini/splitjoin.lua +1132 -0
  143. package/nvim/plugins/mini.nvim/lua/mini/starter.lua +1599 -0
  144. package/nvim/plugins/mini.nvim/lua/mini/statusline.lua +686 -0
  145. package/nvim/plugins/mini.nvim/lua/mini/surround.lua +2388 -0
  146. package/nvim/plugins/mini.nvim/lua/mini/tabline.lua +564 -0
  147. package/nvim/plugins/mini.nvim/lua/mini/test.lua +2516 -0
  148. package/nvim/plugins/mini.nvim/lua/mini/trailspace.lua +215 -0
  149. package/nvim/plugins/mini.nvim/lua/mini/visits.lua +1577 -0
  150. package/nvim/plugins/mini.nvim/readmes/mini-ai.md +190 -0
  151. package/nvim/plugins/mini.nvim/readmes/mini-align.md +203 -0
  152. package/nvim/plugins/mini.nvim/readmes/mini-animate.md +214 -0
  153. package/nvim/plugins/mini.nvim/readmes/mini-base16.md +198 -0
  154. package/nvim/plugins/mini.nvim/readmes/mini-basics.md +184 -0
  155. package/nvim/plugins/mini.nvim/readmes/mini-bracketed.md +193 -0
  156. package/nvim/plugins/mini.nvim/readmes/mini-bufremove.md +139 -0
  157. package/nvim/plugins/mini.nvim/readmes/mini-clue.md +260 -0
  158. package/nvim/plugins/mini.nvim/readmes/mini-cmdline.md +183 -0
  159. package/nvim/plugins/mini.nvim/readmes/mini-colors.md +169 -0
  160. package/nvim/plugins/mini.nvim/readmes/mini-comment.md +183 -0
  161. package/nvim/plugins/mini.nvim/readmes/mini-completion.md +217 -0
  162. package/nvim/plugins/mini.nvim/readmes/mini-cursorword.md +137 -0
  163. package/nvim/plugins/mini.nvim/readmes/mini-deps.md +271 -0
  164. package/nvim/plugins/mini.nvim/readmes/mini-diff.md +289 -0
  165. package/nvim/plugins/mini.nvim/readmes/mini-doc.md +198 -0
  166. package/nvim/plugins/mini.nvim/readmes/mini-extra.md +158 -0
  167. package/nvim/plugins/mini.nvim/readmes/mini-files.md +247 -0
  168. package/nvim/plugins/mini.nvim/readmes/mini-fuzzy.md +134 -0
  169. package/nvim/plugins/mini.nvim/readmes/mini-git.md +168 -0
  170. package/nvim/plugins/mini.nvim/readmes/mini-hipatterns.md +176 -0
  171. package/nvim/plugins/mini.nvim/readmes/mini-hues.md +285 -0
  172. package/nvim/plugins/mini.nvim/readmes/mini-icons.md +183 -0
  173. package/nvim/plugins/mini.nvim/readmes/mini-indentscope.md +191 -0
  174. package/nvim/plugins/mini.nvim/readmes/mini-input.md +163 -0
  175. package/nvim/plugins/mini.nvim/readmes/mini-jump.md +161 -0
  176. package/nvim/plugins/mini.nvim/readmes/mini-jump2d.md +197 -0
  177. package/nvim/plugins/mini.nvim/readmes/mini-keymap.md +205 -0
  178. package/nvim/plugins/mini.nvim/readmes/mini-map.md +191 -0
  179. package/nvim/plugins/mini.nvim/readmes/mini-misc.md +145 -0
  180. package/nvim/plugins/mini.nvim/readmes/mini-move.md +163 -0
  181. package/nvim/plugins/mini.nvim/readmes/mini-notify.md +175 -0
  182. package/nvim/plugins/mini.nvim/readmes/mini-operators.md +193 -0
  183. package/nvim/plugins/mini.nvim/readmes/mini-pairs.md +158 -0
  184. package/nvim/plugins/mini.nvim/readmes/mini-pick.md +340 -0
  185. package/nvim/plugins/mini.nvim/readmes/mini-sessions.md +164 -0
  186. package/nvim/plugins/mini.nvim/readmes/mini-snippets.md +373 -0
  187. package/nvim/plugins/mini.nvim/readmes/mini-splitjoin.md +194 -0
  188. package/nvim/plugins/mini.nvim/readmes/mini-starter.md +176 -0
  189. package/nvim/plugins/mini.nvim/readmes/mini-statusline.md +155 -0
  190. package/nvim/plugins/mini.nvim/readmes/mini-surround.md +190 -0
  191. package/nvim/plugins/mini.nvim/readmes/mini-tabline.md +156 -0
  192. package/nvim/plugins/mini.nvim/readmes/mini-test.md +175 -0
  193. package/nvim/plugins/mini.nvim/readmes/mini-trailspace.md +137 -0
  194. package/nvim/plugins/mini.nvim/readmes/mini-visits.md +243 -0
  195. package/nvim/plugins/mini.nvim/scripts/dual_log.sh +13 -0
  196. package/nvim/plugins/mini.nvim/scripts/dual_push.sh +15 -0
  197. package/nvim/plugins/mini.nvim/scripts/dual_release.sh +102 -0
  198. package/nvim/plugins/mini.nvim/scripts/dual_sync.sh +115 -0
  199. package/nvim/plugins/mini.nvim/scripts/init-deps-example.lua +59 -0
  200. package/nvim/plugins/mini.nvim/scripts/lint-filename-length.sh +16 -0
  201. package/nvim/plugins/mini.nvim/scripts/lintcommit-ci.sh +18 -0
  202. package/nvim/plugins/mini.nvim/scripts/lintcommit.lua +393 -0
  203. package/nvim/plugins/mini.nvim/scripts/minidoc.lua +57 -0
  204. package/nvim/plugins/mini.nvim/scripts/minimal_init.lua +28 -0
  205. package/nvim/plugins/mini.nvim/scripts/minitest.lua +4 -0
  206. package/package.json +16 -0
  207. package/pyproject.toml +43 -0
  208. package/yazi/init.lua +12 -0
  209. package/yazi/keymap.toml +114 -0
  210. package/yazi/lesskey +5 -0
  211. package/yazi/plugins/bookmarks.yazi/main.lua +86 -0
  212. package/yazi/plugins/cd-git-root.yazi/main.lua +31 -0
  213. package/yazi/plugins/smart-enter.yazi/main.lua +11 -0
  214. package/yazi/theme.toml +26 -0
  215. package/yazi/yazi.toml +15 -0
  216. package/zsh/.zshrc +145 -0
  217. package/zsh/starship.toml +20 -0
  218. package/zsh/zsh-patina.toml +2 -0
@@ -0,0 +1,158 @@
1
+ <p align="center"> <img src="https://github.com/nvim-mini/assets/blob/main/logo-2/logo-pairs_readme.png?raw=true" alt="mini.pairs" style="max-width:100%;border:solid 2px"/> </p>
2
+
3
+ ### Minimal and fast autopairs
4
+
5
+ See more details in [Features](#features) and [Documentation](../doc/mini-pairs.txt).
6
+
7
+ ---
8
+
9
+ > [!NOTE]
10
+ > This was previously hosted at a personal `echasnovski` GitHub account. It was transferred to a dedicated organization to improve long term project stability. See more details [here](https://github.com/nvim-mini/mini.nvim/discussions/1970).
11
+
12
+ ⦿ This is a part of [mini.nvim](https://nvim-mini.org/mini.nvim) library. Please use [this link](https://nvim-mini.org/mini.nvim/readmes/mini-pairs) if you want to mention this module.
13
+
14
+ ⦿ All contributions (issues, pull requests, discussions, etc.) are done inside of 'mini.nvim'.
15
+
16
+ ⦿ See [whole library documentation](https://nvim-mini.org/mini.nvim/doc/mini-nvim) to learn about general design principles, disable/configuration recipes, and more.
17
+
18
+ ⦿ See [MiniMax](https://nvim-mini.org/MiniMax) for a full config example that uses this module.
19
+
20
+ ---
21
+
22
+ If you want to help this project grow but don't know where to start, check out [contributing guides of 'mini.nvim'](https://nvim-mini.org/mini.nvim/CONTRIBUTING) or leave a Github star for 'mini.nvim' project and/or any its standalone Git repositories.
23
+
24
+ ## Demo
25
+
26
+ <!-- Demo source: https://github.com/nvim-mini/assets/blob/main/demo/demo-pairs.mp4 -->
27
+ https://user-images.githubusercontent.com/24854248/173044991-18653715-9b4e-444e-a4ba-14eb80bc4e38.mp4
28
+
29
+ ## Features
30
+
31
+ - Functionality to work with two "paired" characters conditional on cursor's neighborhood (character to its left and character to its right).
32
+ - Usage should be through making appropriate mappings using `MiniPairs.map()` or in `MiniPairs.setup()` (for global mapping), `MiniPairs.map_buf()` (for buffer mapping).
33
+ - Pairs get automatically registered for special `<BS>` (all configured modes) and `<CR>` (only Insert mode) mappings. Pressing the key inside pair will delete whole pair and insert extra blank line inside pair respectively. Note: these mappings are autocreated if they do not override existing ones.
34
+
35
+ ## Installation
36
+
37
+ This plugin can be installed as part of 'mini.nvim' library (**recommended**) or as a standalone Git repository.
38
+
39
+ There are two branches to install from:
40
+
41
+ - `main` (default, **recommended**) will have latest development version of plugin. All changes since last stable release should be perceived as being in beta testing phase (meaning they already passed alpha-testing and are moderately settled).
42
+ - `stable` will be updated only upon releases with code tested during public beta-testing phase in `main` branch.
43
+
44
+ Here are code snippets for some common installation methods (use only one):
45
+
46
+ <details>
47
+ <summary><b>(Recommended)</b> With <a href="https://neovim.io/doc/user/helptag.html?tag=vim.pack">vim.pack</a> (on Neovim 0.12 and newer)</summary>
48
+
49
+ **Full library**
50
+
51
+ Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
52
+
53
+ **Standalone plugin**
54
+
55
+ Main branch:
56
+
57
+ ```lua
58
+ vim.pack.add({ 'https://github.com/nvim-mini/mini.pairs' })
59
+ ```
60
+
61
+ Stable branch:
62
+
63
+ ```lua
64
+ vim.pack.add({
65
+ { src = 'https://github.com/nvim-mini/mini.pairs', version = 'stable' },
66
+ })
67
+ ```
68
+
69
+ </details>
70
+
71
+ <details>
72
+ <summary>With <a href="https://nvim-mini.org/mini.nvim/readmes/mini-deps">mini.deps</a> (before Neovim 0.12)</summary>
73
+
74
+ **Full library**
75
+
76
+ Follow [recommended 'mini.deps' installation](https://nvim-mini.org/mini.nvim/readmes/mini-deps#installation).
77
+
78
+ **Standalone plugin**:
79
+
80
+ Main branch:
81
+
82
+ ```lua
83
+ add('nvim-mini/mini.pairs')
84
+ ```
85
+
86
+ Stable branch:
87
+
88
+ ```lua
89
+ add({ source = 'nvim-mini/mini.pairs', checkout = 'stable' })
90
+ ```
91
+
92
+ </details>
93
+
94
+ <details>
95
+ <summary>With <a href="https://github.com/folke/lazy.nvim">folke/lazy.nvim</a></summary>
96
+
97
+ **Full library**
98
+
99
+ Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
100
+
101
+ **Standalone plugin**
102
+
103
+ Main branch:
104
+
105
+ ```lua
106
+ { 'nvim-mini/mini.pairs', version = false },
107
+ ```
108
+
109
+ Stable branch:
110
+
111
+ ```lua
112
+ { 'nvim-mini/mini.pairs', version = '*' },
113
+ ```
114
+
115
+ </details>
116
+
117
+ **Important**: don't forget to call `require('mini.pairs').setup()` to enable its functionality.
118
+
119
+ **Note**: if you are on Windows, there might be problems with too long file paths (like `error: unable to create file <some file name>: Filename too long`). Try doing one of the following:
120
+
121
+ - Enable corresponding git global config value: `git config --system core.longpaths true`. Then try to reinstall.
122
+ - Install plugin in other place with shorter path.
123
+
124
+ ## Default config
125
+
126
+ ```lua
127
+ -- No need to copy this inside `setup()`. Will be used automatically.
128
+ {
129
+ -- In which modes mappings from this `config` should be created
130
+ modes = { insert = true, command = false, terminal = false },
131
+
132
+ -- Global mappings. Each right hand side should be a pair information, a
133
+ -- table with at least these fields (see more in |MiniPairs.map|):
134
+ -- - <action> - one of 'open', 'close', 'closeopen'.
135
+ -- - <pair> - two character string for pair to be used.
136
+ -- By default pair is not inserted after `\`, quotes are not recognized by
137
+ -- <CR>, `'` does not insert the pair after a letter.
138
+ -- Only parts of tables can be tweaked (others will use these defaults).
139
+ mappings = {
140
+ ['('] = { action = 'open', pair = '()', neigh_pattern = '^[^\\]' },
141
+ ['['] = { action = 'open', pair = '[]', neigh_pattern = '^[^\\]' },
142
+ ['{'] = { action = 'open', pair = '{}', neigh_pattern = '^[^\\]' },
143
+
144
+ [')'] = { action = 'close', pair = '()', neigh_pattern = '^[^\\]' },
145
+ [']'] = { action = 'close', pair = '[]', neigh_pattern = '^[^\\]' },
146
+ ['}'] = { action = 'close', pair = '{}', neigh_pattern = '^[^\\]' },
147
+
148
+ ['"'] = { action = 'closeopen', pair = '""', neigh_pattern = '^[^\\]', register = { cr = false } },
149
+ ["'"] = { action = 'closeopen', pair = "''", neigh_pattern = '^[^%a\\]', register = { cr = false } },
150
+ ['`'] = { action = 'closeopen', pair = '``', neigh_pattern = '^[^\\]', register = { cr = false } },
151
+ },
152
+ }
153
+ ```
154
+
155
+ ## Similar plugins
156
+
157
+ - [windwp/nvim-autopairs](https://github.com/windwp/nvim-autopairs)
158
+ - [jiangmiao/auto-pairs](https://github.com/jiangmiao/auto-pairs)
@@ -0,0 +1,340 @@
1
+ <p align="center"> <img src="https://github.com/nvim-mini/assets/blob/main/logo-2/logo-pick_readme.png?raw=true" alt="mini.pick" style="max-width:100%;border:solid 2px"/> </p>
2
+
3
+ ### Pick anything
4
+
5
+ See more details in [Features](#features) and [Documentation](../doc/mini-pick.txt).
6
+
7
+ ---
8
+
9
+ > [!NOTE]
10
+ > This was previously hosted at a personal `echasnovski` GitHub account. It was transferred to a dedicated organization to improve long term project stability. See more details [here](https://github.com/nvim-mini/mini.nvim/discussions/1970).
11
+
12
+ ⦿ This is a part of [mini.nvim](https://nvim-mini.org/mini.nvim) library. Please use [this link](https://nvim-mini.org/mini.nvim/readmes/mini-pick) if you want to mention this module.
13
+
14
+ ⦿ All contributions (issues, pull requests, discussions, etc.) are done inside of 'mini.nvim'.
15
+
16
+ ⦿ See [whole library documentation](https://nvim-mini.org/mini.nvim/doc/mini-nvim) to learn about general design principles, disable/configuration recipes, and more.
17
+
18
+ ⦿ See [MiniMax](https://nvim-mini.org/MiniMax) for a full config example that uses this module.
19
+
20
+ ---
21
+
22
+ If you want to help this project grow but don't know where to start, check out [contributing guides of 'mini.nvim'](https://nvim-mini.org/mini.nvim/CONTRIBUTING) or leave a Github star for 'mini.nvim' project and/or any its standalone Git repositories.
23
+
24
+ ## Demo
25
+
26
+ <!-- Demo source: https://github.com/nvim-mini/assets/blob/main/demo/demo-pick.mp4 -->
27
+ https://github.com/nvim-mini/mini.nvim/assets/24854248/65849d1e-3f96-4085-a4cf-f9962cfdbdfd
28
+
29
+ ## Features
30
+
31
+ - Single window general purpose interface for picking element from any array.
32
+
33
+ - On demand toggleable preview and info views.
34
+
35
+ - Interactive query matching (filter+sort) with fast non-blocking default which does fuzzy matching and allows other modes.
36
+
37
+ - Built-in pickers:
38
+ - Files.
39
+ - Pattern match (for fixed pattern or with live feedback; both allow file filtering via glob patterns).
40
+ - Buffers.
41
+ - Help tags.
42
+ - CLI output.
43
+ - Resume latest picker.
44
+
45
+ - `:Pick` command to work with extensible `MiniPick.registry`.
46
+
47
+ - `vim.ui.select()` implementation. To adjust, use `MiniPick.ui_select()` or save-restore `vim.ui.select` manually after calling `MiniPick.setup()`.
48
+
49
+ - Rich and customizable built-in actions when picker is active:
50
+ - Manually change currently focused item.
51
+ - Scroll vertically and horizontally.
52
+ - Toggle preview or info view.
53
+ - Mark/unmark items to choose later.
54
+ - Refine current matches (make them part of a new picker).
55
+ - And many more.
56
+
57
+ - Minimal yet flexible source specification with:
58
+ - Items (array, callable, or manually set later).
59
+ - Source name.
60
+ - Working directory.
61
+ - Matching algorithm.
62
+ - Way matches are shown in main window.
63
+ - Item preview.
64
+ - "On choice" action for current and marked items.
65
+
66
+ - Custom actions/keys can be configured globally, per buffer, or per picker.
67
+
68
+ - Out of the box support for 'ignorecase' and 'smartcase'.
69
+
70
+ - Match caching to increase responsiveness on repeated prompts.
71
+
72
+ Notes:
73
+
74
+ - Works on all supported versions but Neovim>=0.10 will give more visual feedback in floating window footer.
75
+
76
+ - For more pickers see ['mini.extra'](https://nvim-mini.org/mini.nvim/readmes/mini-extra).
77
+
78
+ - CLI tools are called only with basic arguments needed to get items. To customize the output, use their respective configuration approaches. Here are some examples of where to start:
79
+ - [ripgrep](https://github.com/BurntSushi/ripgrep/blob/master/GUIDE.md#configuration-file)
80
+ - [fd](https://github.com/sharkdp/fd#excluding-specific-files-or-directories)
81
+ - [git](https://git-scm.com/docs/gitignore)
82
+
83
+ For more information see these parts of help:
84
+
85
+ - `:h MiniPick-overview`
86
+ - `:h MiniPick-source`
87
+ - `:h MiniPick-actions`
88
+ - `:h MiniPick-examples`
89
+ - `:h MiniPick.builtin`
90
+ - `:h MiniPick-in-other-plugins` (for plugin authors)
91
+
92
+ ## Dependencies
93
+
94
+ For full experience needs (still works without any of suggestions):
95
+
96
+ - Enabled ['mini.icons'](https://nvim-mini.org/mini.nvim/readmes/mini-icons) module for icons near the items representing actual paths. Can fall back to using [nvim-tree/nvim-web-devicons](https://github.com/nvim-tree/nvim-web-devicons) plugin.
97
+
98
+ - Executable [BurntSushi/ripgrep](https://github.com/BurntSushi/ripgrep) CLI tool for faster file and pattern search on disk.
99
+
100
+ ## Overview
101
+
102
+ General idea is to take array of objects, display them with interactive filter/sort/navigate/preview, and allow to choose one or more items.
103
+
104
+ ### How to start a picker
105
+
106
+ - Use `MiniPick.start()` with `opts.source` defining source.
107
+
108
+ Example: `MiniPick.start({ source = { items = vim.fn.readdir('.') } })`
109
+
110
+ - Use any of `MiniPick.builtin` pickers directly.
111
+
112
+ Example: `MiniPick.builtin.files({ tool = 'git' })`
113
+
114
+ - Use `:Pick` command which uses customizable pickers from `MiniPick.registry`.
115
+
116
+ Example: `:Pick files tool='git'`
117
+
118
+ ### User interface
119
+
120
+ UI consists from a single window capable of displaying three different views:
121
+
122
+ - "Main" - where current query matches are shown.
123
+ - "Preview" - preview of current item (toggle with `<Tab>`).
124
+ - "Info" - general info about picker and its state (toggle with `<S-Tab>`).
125
+
126
+ Current prompt is displayed at the top left of the window border with vertical line indicating caret (current input position).
127
+
128
+ Bottom part of window border displays (in Neovim>=0.10) extra visual feedback:
129
+
130
+ - Left part is a picker name.
131
+ - Right part contains information in the format:
132
+
133
+ `<current index in matches> | <match count> | <marked count> / <total count>`
134
+
135
+ When picker is busy (like if there are no items yet set or matching is active) window border changes color to be `MiniPickBorderBusy` after `config.delay.busy` milliseconds of idle time.
136
+
137
+ ### Life cycle
138
+
139
+ - Type characters to filter and sort matches. It uses `MiniPick.default_match()` with `query` being an array of pressed characters. Overview of how it matches:
140
+ - If query starts with `'`, the match is exact.
141
+ - If query starts with `^`, the match is exact at start.
142
+ - If query ends with `$`, the match is exact at end.
143
+ - If query starts with `*`, the match is forced to be fuzzy.
144
+ - Otherwise match is fuzzy.
145
+ - Sorting is done to first minimize match width and then match start.
146
+ Nothing more: no favoring certain places in string, etc.
147
+
148
+ - Type special keys to perform actions. Here are some basic ones:
149
+ - `<C-n>` / `<Down>` moves down; `<C-p>` / `<Up>` moves up.
150
+ - `<Left>` / `<Right>` moves prompt caret left / right.
151
+ - `<S-Tab>` toggles information window with all available mappings.
152
+ - `<Tab>` toggles preview.
153
+ - `<C-x>` / `<C-a>` toggles current / all item(s) as (un)marked.
154
+ - `<C-Space>` / `<M-Space>` makes all matches or marked items as new picker.
155
+ - `<CR>` / `<M-CR>` chooses current/marked item(s).
156
+ - `<Esc>` / `<C-c>` stops picker.
157
+
158
+ ## Installation
159
+
160
+ This plugin can be installed as part of 'mini.nvim' library (**recommended**) or as a standalone Git repository.
161
+
162
+ There are two branches to install from:
163
+
164
+ - `main` (default, **recommended**) will have latest development version of plugin. All changes since last stable release should be perceived as being in beta testing phase (meaning they already passed alpha-testing and are moderately settled).
165
+ - `stable` will be updated only upon releases with code tested during public beta-testing phase in `main` branch.
166
+
167
+ Here are code snippets for some common installation methods (use only one):
168
+
169
+ <details>
170
+ <summary><b>(Recommended)</b> With <a href="https://neovim.io/doc/user/helptag.html?tag=vim.pack">vim.pack</a> (on Neovim 0.12 and newer)</summary>
171
+
172
+ **Full library**
173
+
174
+ Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
175
+
176
+ **Standalone plugin**
177
+
178
+ Main branch:
179
+
180
+ ```lua
181
+ vim.pack.add({ 'https://github.com/nvim-mini/mini.pick' })
182
+ ```
183
+
184
+ Stable branch:
185
+
186
+ ```lua
187
+ vim.pack.add({
188
+ { src = 'https://github.com/nvim-mini/mini.pick', version = 'stable' },
189
+ })
190
+ ```
191
+
192
+ </details>
193
+
194
+ <details>
195
+ <summary>With <a href="https://nvim-mini.org/mini.nvim/readmes/mini-deps">mini.deps</a> (before Neovim 0.12)</summary>
196
+
197
+ **Full library**
198
+
199
+ Follow [recommended 'mini.deps' installation](https://nvim-mini.org/mini.nvim/readmes/mini-deps#installation).
200
+
201
+ **Standalone plugin**:
202
+
203
+ Main branch:
204
+
205
+ ```lua
206
+ add('nvim-mini/mini.pick')
207
+ ```
208
+
209
+ Stable branch:
210
+
211
+ ```lua
212
+ add({ source = 'nvim-mini/mini.pick', checkout = 'stable' })
213
+ ```
214
+
215
+ </details>
216
+
217
+ <details>
218
+ <summary>With <a href="https://github.com/folke/lazy.nvim">folke/lazy.nvim</a></summary>
219
+
220
+ **Full library**
221
+
222
+ Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
223
+
224
+ **Standalone plugin**
225
+
226
+ Main branch:
227
+
228
+ ```lua
229
+ { 'nvim-mini/mini.pick', version = false },
230
+ ```
231
+
232
+ Stable branch:
233
+
234
+ ```lua
235
+ { 'nvim-mini/mini.pick', version = '*' },
236
+ ```
237
+
238
+ </details>
239
+
240
+ **Important**: don't forget to call `require('mini.pick').setup()` to enable its functionality.
241
+
242
+ **Note**: if you are on Windows, there might be problems with too long file paths (like `error: unable to create file <some file name>: Filename too long`). Try doing one of the following:
243
+
244
+ - Enable corresponding git global config value: `git config --system core.longpaths true`. Then try to reinstall.
245
+ - Install plugin in other place with shorter path.
246
+
247
+ ## Default config
248
+
249
+ ```lua
250
+ -- No need to copy this inside `setup()`. Will be used automatically.
251
+ {
252
+ -- Delays (in ms; should be at least 1)
253
+ delay = {
254
+ -- Delay between forcing asynchronous behavior
255
+ async = 10,
256
+
257
+ -- Delay between computation start and visual feedback about it
258
+ busy = 50,
259
+ },
260
+
261
+ -- Keys for performing actions. See `:h MiniPick-actions`.
262
+ mappings = {
263
+ caret_left = '<Left>',
264
+ caret_right = '<Right>',
265
+
266
+ choose = '<CR>',
267
+ choose_in_split = '<C-s>',
268
+ choose_in_tabpage = '<C-t>',
269
+ choose_in_vsplit = '<C-v>',
270
+ choose_marked = '<M-CR>',
271
+
272
+ delete_char = '<BS>',
273
+ delete_char_right = '<Del>',
274
+ delete_left = '<C-u>',
275
+ delete_word = '<C-w>',
276
+
277
+ mark = '<C-x>',
278
+ mark_all = '<C-a>',
279
+
280
+ move_down = '<C-n>',
281
+ move_start = '<C-g>',
282
+ move_up = '<C-p>',
283
+
284
+ paste = '<C-r>',
285
+
286
+ refine = '<C-Space>',
287
+ refine_marked = '<M-Space>',
288
+
289
+ scroll_down = '<C-f>',
290
+ scroll_left = '<C-h>',
291
+ scroll_right = '<C-l>',
292
+ scroll_up = '<C-b>',
293
+
294
+ stop = '<Esc>',
295
+
296
+ toggle_info = '<S-Tab>',
297
+ toggle_preview = '<Tab>',
298
+ },
299
+
300
+ -- General options
301
+ options = {
302
+ -- Whether to show content from bottom to top
303
+ content_from_bottom = false,
304
+
305
+ -- Whether to cache matches (more speed and memory on repeated prompts)
306
+ use_cache = false,
307
+ },
308
+
309
+ -- Source definition. See `:h MiniPick-source`.
310
+ source = {
311
+ items = nil,
312
+ name = nil,
313
+ cwd = nil,
314
+
315
+ match = nil,
316
+ show = nil,
317
+ preview = nil,
318
+
319
+ choose = nil,
320
+ choose_marked = nil,
321
+ },
322
+
323
+ -- Window related options
324
+ window = {
325
+ -- Float window config (table or callable returning it)
326
+ config = nil,
327
+
328
+ -- String to use as caret in prompt
329
+ prompt_caret = '▏',
330
+
331
+ -- String to use as prefix in prompt
332
+ prompt_prefix = '> ',
333
+ },
334
+ }
335
+ ```
336
+
337
+ ## Similar plugins
338
+
339
+ - [nvim-telescope/telescope.nvim](https://github.com/nvim-telescope/telescope.nvim)
340
+ - [ibhagwan/fzf-lua](https://github.com/ibhagwan/fzf-lua)
@@ -0,0 +1,164 @@
1
+ <p align="center"> <img src="https://github.com/nvim-mini/assets/blob/main/logo-2/logo-sessions_readme.png?raw=true" alt="mini.sessions" style="max-width:100%;border:solid 2px"/> </p>
2
+
3
+ ### Session management (read, write, delete)
4
+
5
+ See more details in [Features](#features) and [Documentation](../doc/mini-sessions.txt).
6
+
7
+ ---
8
+
9
+ > [!NOTE]
10
+ > This was previously hosted at a personal `echasnovski` GitHub account. It was transferred to a dedicated organization to improve long term project stability. See more details [here](https://github.com/nvim-mini/mini.nvim/discussions/1970).
11
+
12
+ ⦿ This is a part of [mini.nvim](https://nvim-mini.org/mini.nvim) library. Please use [this link](https://nvim-mini.org/mini.nvim/readmes/mini-sessions) if you want to mention this module.
13
+
14
+ ⦿ All contributions (issues, pull requests, discussions, etc.) are done inside of 'mini.nvim'.
15
+
16
+ ⦿ See [whole library documentation](https://nvim-mini.org/mini.nvim/doc/mini-nvim) to learn about general design principles, disable/configuration recipes, and more.
17
+
18
+ ⦿ See [MiniMax](https://nvim-mini.org/MiniMax) for a full config example that uses this module.
19
+
20
+ ---
21
+
22
+ If you want to help this project grow but don't know where to start, check out [contributing guides of 'mini.nvim'](https://nvim-mini.org/mini.nvim/CONTRIBUTING) or leave a Github star for 'mini.nvim' project and/or any its standalone Git repositories.
23
+
24
+ ## Demo
25
+
26
+ <!-- Demo source: https://github.com/nvim-mini/assets/blob/main/demo/demo-sessions.mp4 -->
27
+ https://user-images.githubusercontent.com/24854248/173045087-3d18affc-c76f-4d22-8afc-fef687166ef0.mp4
28
+
29
+ ## Features
30
+
31
+ - Works using `:mksession` (`'sessionoptions'` is fully respected).
32
+ - Implements both global (from configured directory) and local (from current directory) sessions.
33
+ - No automated new session creation. Use `MiniSessions.write()` manually.
34
+ - Autoread default session (local if detected, else latest written global) if Neovim was called without intention to show something else.
35
+ - Autowrite currently read session before quitting Neovim.
36
+ - Restart Neovim preserving current session (requires Neovim>=0.12).
37
+ - Configurable severity level of all actions.
38
+
39
+ ## Installation
40
+
41
+ This plugin can be installed as part of 'mini.nvim' library (**recommended**) or as a standalone Git repository.
42
+
43
+ There are two branches to install from:
44
+
45
+ - `main` (default, **recommended**) will have latest development version of plugin. All changes since last stable release should be perceived as being in beta testing phase (meaning they already passed alpha-testing and are moderately settled).
46
+ - `stable` will be updated only upon releases with code tested during public beta-testing phase in `main` branch.
47
+
48
+ Here are code snippets for some common installation methods (use only one):
49
+
50
+ <details>
51
+ <summary><b>(Recommended)</b> With <a href="https://neovim.io/doc/user/helptag.html?tag=vim.pack">vim.pack</a> (on Neovim 0.12 and newer)</summary>
52
+
53
+ **Full library**
54
+
55
+ Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
56
+
57
+ **Standalone plugin**
58
+
59
+ Main branch:
60
+
61
+ ```lua
62
+ vim.pack.add({ 'https://github.com/nvim-mini/mini.sessions' })
63
+ ```
64
+
65
+ Stable branch:
66
+
67
+ ```lua
68
+ vim.pack.add({
69
+ { src = 'https://github.com/nvim-mini/mini.sessions', version = 'stable' },
70
+ })
71
+ ```
72
+
73
+ </details>
74
+
75
+ <details>
76
+ <summary>With <a href="https://nvim-mini.org/mini.nvim/readmes/mini-deps">mini.deps</a> (before Neovim 0.12)</summary>
77
+
78
+ **Full library**
79
+
80
+ Follow [recommended 'mini.deps' installation](https://nvim-mini.org/mini.nvim/readmes/mini-deps#installation).
81
+
82
+ **Standalone plugin**:
83
+
84
+ Main branch:
85
+
86
+ ```lua
87
+ add('nvim-mini/mini.sessions')
88
+ ```
89
+
90
+ Stable branch:
91
+
92
+ ```lua
93
+ add({ source = 'nvim-mini/mini.sessions', checkout = 'stable' })
94
+ ```
95
+
96
+ </details>
97
+
98
+ <details>
99
+ <summary>With <a href="https://github.com/folke/lazy.nvim">folke/lazy.nvim</a></summary>
100
+
101
+ **Full library**
102
+
103
+ Follow ['mini.nvim' installation](https://nvim-mini.org/mini.nvim#installation).
104
+
105
+ **Standalone plugin**
106
+
107
+ Main branch:
108
+
109
+ ```lua
110
+ { 'nvim-mini/mini.sessions', version = false },
111
+ ```
112
+
113
+ Stable branch:
114
+
115
+ ```lua
116
+ { 'nvim-mini/mini.sessions', version = '*' },
117
+ ```
118
+
119
+ </details>
120
+
121
+ **Important**: don't forget to call `require('mini.sessions').setup()` to enable its functionality.
122
+
123
+ **Note**: if you are on Windows, there might be problems with too long file paths (like `error: unable to create file <some file name>: Filename too long`). Try doing one of the following:
124
+
125
+ - Enable corresponding git global config value: `git config --system core.longpaths true`. Then try to reinstall.
126
+ - Install plugin in other place with shorter path.
127
+
128
+ ## Default config
129
+
130
+ ```lua
131
+ -- No need to copy this inside `setup()`. Will be used automatically.
132
+ {
133
+ -- Whether to read default session if Neovim opened without file arguments
134
+ autoread = false,
135
+
136
+ -- Whether to write currently read session before leaving it
137
+ autowrite = true,
138
+
139
+ -- Directory where global sessions are stored (use `''` to disable)
140
+ directory = --<"session" subdir of user data directory from |stdpath()|>,
141
+
142
+ -- File for local session (use `''` to disable)
143
+ file = 'Session.vim',
144
+
145
+ -- Whether to force possibly harmful actions (meaning depends on function)
146
+ force = { read = false, write = true, delete = false },
147
+
148
+ -- Hook functions for actions. Default `nil` means 'do nothing'.
149
+ hooks = {
150
+ -- Before successful action
151
+ pre = { read = nil, write = nil, delete = nil },
152
+ -- After successful action
153
+ post = { read = nil, write = nil, delete = nil },
154
+ },
155
+
156
+ -- Whether to print session path after action
157
+ verbose = { read = false, write = true, delete = true },
158
+ }
159
+ ```
160
+
161
+ ## Similar plugins
162
+
163
+ - [mhinz/vim-startify](https://github.com/mhinz/vim-startify)
164
+ - [Shatur/neovim-session-manager](https://github.com/Shatur/neovim-session-manager)