nvim-config/lua/user/keymaps.lua

-- changed silent to false, b/c for now I have the space for it,
-- and prefer verbosity!
  local opts = { noremap = true, silent = false }

-- Terminal options for.
  local term_opts = { silent = true }

-- Shorten function name.
  local keymap = vim.api.nvim_set_keymap

--Re-map space as leader key.
--I already did this on vim & neovim(init.vim).
  keymap("", "<Space>", "<Nop>", opts)
  vim.g.mapleader = " "
  vim.g.maplocalleader = " "

-- Modes:
--  normal_mode = "n",
--  insert_mode = "i",
--  visual_mode = "v",
--  visual_block_mode = "x",
--  term_mode = "t",
--  command_mode = "c",

-- Normal --
-- Better window navigation
-- Exactly what I would have done...
  keymap("n", "<C-h>", "<C-w>h", opts)
  keymap("n", "<C-j>", "<C-w>j", opts)
  keymap("n", "<C-k>", "<C-w>k", opts)
  keymap("n", "<C-l>", "<C-w>l", opts)

-- Toggle NetRW Plugin for now...
  keymap("n", "<leader>e", ":Lex 30<cr>", opts)

-- Resize with with Ctrl-Up/Down/Left/Right.
-- Tweaked slightly like on the Video-series.
  keymap("n", "<C-Up>", ":resize +2<CR>", opts)
  keymap("n", "<C-Down>", ":resize -2<CR>", opts)
  keymap("n", "<C-Left>", ":vertical resize +2<CR>", opts)
  keymap("n", "<C-Right>", ":vertical resize -2<CR>", opts)

-- Navigate buffers.
-- I like changing buffers this way,
-- b/c I was running into problems w/ Ctrl-f/b.
  keymap("n", "<S-l>", ":bnext<CR>", opts)
  keymap("n", "<S-h>", ":bprevious<CR>", opts)

-- Insert --
-- Press jk fast to enter Normal-mode, from Insert-mode.
keymap("i", "jk", "<ESC>", opts)

-- Visual --
-- Stay in indent mode.
-- I like this idea.
  keymap("v", "<", "<gv", opts)
  keymap("v", ">", ">gv", opts)

-- Move text highlights up & down.
  keymap("v", "<A-j>", ":m .+1<CR>==", opts)
  keymap("v", "<A-k>", ":m .-2<CR>==", opts)
  keymap("v", "p", '"_dP', opts)
-- Subltle change, but if you paste over a visual selection;
-- Now it won't put what you pasted over into the 2-be-pasted-next buffer. 

-- Visual Block --
-- Move full lines Up/Down.
  keymap("x", "J", ":move '>+1<CR>gv-gv", opts)
  keymap("x", "K", ":move '<-2<CR>gv-gv", opts)
  keymap("x", "<A-j>", ":move '>+1<CR>gv-gv", opts)
  keymap("x", "<A-k>", ":move '<-2<CR>gv-gv", opts)

-- "############################
-- "# leader-mappings section: #
-- "############################
  keymap("n", "<leader>top", ":set paste<CR>", opts)  -- Turn special pasting on ONLY when needed.

-- "################################################################
-- "# Toggle highlight searching.                                  #
-- "# Map nh to toggle off the search highlighting in Normal mode. #
-- "################################################################
  keymap("n", "<leader>nh", ":nohl<CR>", opts)

-- "#########################################################
-- "# Map nn, to toggle regular line-numberings on,          #
-- "# to check for which specific line of the file your on. #
-- "#########################################################
  keymap("n", "<leader>lno", ":set nonu<CR>", opts) -- Turn line-numbers OFF.
  keymap("n", "<leader>ln", ":set nu<CR>", opts)    -- Turn line-numbers back on.

-- "##################################################################
-- "# Map nr to toggle off the relative line numbers in Normal mode. #
-- "##################################################################
  keymap("n", "<leader>nno", ":set nornu<CR>", opts) -- Turn relative line-numbers OFF.
  keymap("n", "<leader>rn", ":set rnu<CR>", opts)  -- Turn relative line-numbers back on.

-- "##########################################################################
-- "#I'm mapping comma{,} + lower-case 'l' to disable special char listings. #
-- "##########################################################################
  keymap("n", "<leader>nls", ":set nolist<CR>", opts) -- Turn special hidden chars OFF.
  keymap("n", "<leader>ls", ":set list<CR>", opts)    -- Turn List(ls) mode back on.

-- "##############################################################################
-- "# cm == copy-mode. disables special characters($) and relative-line-numbers. #
-- "##############################################################################
 keymap("n", "<leader>cm", ":set nolist <CR> <bar> :set nornu <CR> <bar> :set nonu <CR>", opts)

-- "#############################################################
-- "# Spell check set to sc(Spell-Check)/es(Switch 2 ESpañol.). #
-- "#############################################################
  keymap("n", "<leader>sc", ":setlocal spell! spelllang=en_us<CR>", opts)
  keymap("n", "<leader>es", ":set spelllang=es<CR>", opts)

-- "########################################################################
-- "# hotkey mappings for jumps, marks, buffer-LiSting, and changes lists. #
-- "########################################################################
  keymap("n", "<leader>mm", ":marks<CR>", opts)     -- This will open up the Marks-list.
  keymap("n", "<leader>jj", ":jumps<CR>", opts)     -- This will open up the Jumps-list.
  keymap("n", "<leader>ll", ":ls<CR>", opts)        -- This opens up the buffers-list.
  keymap("n", "<leader>cc", ":changes<CR>", opts)   -- This will open up the Changes-list.
  keymap("n", "<leader>rr", ":registers<Cr>", opts) -- This will open up the Registers-list.

-- "#################################################
-- "# I'm mapping vc to reload the .vimrc,          #
-- "# without closing and re-opening he vim config. #
-- "#################################################
-- keymap("n", "<leader>vc", ":source ~/.config/nvim/init.lua<CR> <bar> :nohl <CR>", opts)
-- TODO attempt to put this in vim.cmd later.

-- Terminal --
-- Better terminal navigation... ???
-- This is the ONLY block I am not sure if I want to include in my config,
-- b/c I don't understand what it does; so I'll disable it for now...
-- keymap("t", "<C-h>", "<C-\\><C-N><C-w>h", term_opts)
-- keymap("t", "<C-j>", "<C-\\><C-N><C-w>j", term_opts)
-- keymap("t", "<C-k>", "<C-\\><C-N><C-w>k", term_opts)
-- keymap("t", "<C-l>", "<C-\\><C-N><C-w>l", term_opts)