reorganize packages

config/shared/nvim/docs/keymaps.md

@@ -0,0 +1,119 @@
+#============================================================
+# NEOVIM KEYMAP REFERENCE (CORE & USEFUL)
+#============================================================
+
+
+#============================================================
+# INSERT MODE (Ctrl + ...)
+#============================================================
+Ctrl + h              Delete character before cursor
+Ctrl + w              Delete word before cursor
+Ctrl + j              Insert line break (newline) at cursor
+Ctrl + t              Indent current line one 'shiftwidth' to the right
+Ctrl + d              De-indent current line one 'shiftwidth' to the left
+Ctrl + n              Insert next auto-completion match
+Ctrl + p              Insert previous auto-completion match
+Ctrl + r x            Insert contents of register x
+Ctrl + o {cmd}        Temporarily enter Normal mode to execute {cmd}
+Esc / Ctrl + c        Exit insert mode and return to Normal mode
+
+
+#============================================================
+# NORMAL MODE — WINDOW & TAB MANAGEMENT
+#============================================================
+C-w s                 Split current window horizontally
+C-w v                 Split current window vertically
+C-w c                 Close current window
+C-w q                 Quit  current window (same as close but exit if last)
+C-w w                 Cycle through open windows
+C-w x                 Exchange window with next one
+
+C-w =                 Equalize window sizes
+C-w _                 Maximize height of current window
+C-w |                 Maximize width of current window
+
+C-w h                 Move to window left
+C-w j                 Move to window below
+C-w k                 Move to window above
+C-w l                 Move to window right
+
+C-w H                 Move current window far left
+C-w J                 Move current window to bottom
+C-w K                 Move current window to top
+C-w L                 Move current window far right
+
+C-w t                 Move current split into a new tab
+
+gt                   Go to next tab
+gT                   Go to previous tab
+<n>gt                Go to tab number <n>
+
+
+#============================================================
+# NORMAL MODE — TAGS, JUMPS & MOTIONS
+#============================================================
+Ctrl + ]              Jump to tag under cursor
+gd                    Go to local declaration
+gD                    Go to global declaration
+{                     Jump backward one paragraph/block
+}                     Jump forward one paragraph/block
+;                     Repeat last motion forward
+,                     Repeat last motion backward
+Ctrl + e              Scroll window down (cursor stays put)
+Ctrl + y              Scroll window up (cursor stays put)
+H                     Move cursor to top of screen
+M                     Move cursor to middle of screen
+L                     Move cursor to bottom of screen
+
+
+#============================================================
+# NORMAL MODE — TEXT OBJECTS
+#============================================================
+aw                    "A word" — select word + following space
+ab                    "A block" — select around ()
+aB                    "A Block" — select around {}
+at                    "A tag" — select around XML/HTML tag
+
+ib                    "Inner block" — inside ()
+iB                    "Inner Block" — inside {}
+it                    "Inner tag" — inside tag (no delimiters)
+
+
+#============================================================
+# NORMAL MODE — DIFF / CHANGES
+#============================================================
+do                    Obtain (get) changes from other window
+dp                    Put (send) changes to other window
+
+
+#============================================================
+# REGISTERS & CLIPBOARD
+#============================================================
+"xy                   Yank into register x
+"xp                   Paste contents of register x
+"+y                   Yank into system clipboard
+"+p                   Paste from system clipboard
+
+#--- Common Registers ---
+"0                    Last yank
+"                      Unnamed register (last delete or yank)
+"%                    Current file name
+"#                    Alternate file name
+"*                    X11 primary selection clipboard
+"+                    X11 clipboard register
+"/                    Last search pattern
+":                    Last command-line command
+".                    Last inserted text
+"-                    Last small (less than a line) delete
+"=                    Expression register (evaluate expression)
+"_                    Black hole register (discard output)
+
+
+#============================================================
+# TIPS & NOTES
+#============================================================
+- Ctrl + o in Insert mode is a powerful way to run one Normal-mode command temporarily.
+- Use “aw”, “iw”, “ab”, “ib”, etc. with operators (e.g., ‘daw’, ‘yib’) for precise text manipulation.
+- The system clipboard is “+” (Windows/macOS/Linux), but some X11 systems also use “*”.
+- When in diff mode, ‘do’ and ‘dp’ are complementary: “get” vs. “put” changes.
+