add an option to add the body key to emitted foreign keys

README.md

@@ -57,6 +57,7 @@ If you want to quickly understand the concept, you can watch
     * [`config`](#config)
         * [`exit`](#exit)
         * [`foreign_keys`](#foreign_keys)
+        * [`prepend_body_to_foreign_keys`](#prepend_body_to_foreign_keys)
         * [`color`](#color)
             * [More about colors concept](#more-about-colors-concept)
             * [Amaranth color](#amaranth-color)
@@ -228,6 +229,23 @@ that doesn't belong to any head:
   without running the foreign key.
 - `foreign_keys = "run"` will not stop the hydra state, and try to run the foreign key.
 
+#### `prepend_body_to_foreign_keys`
+`boolean`\
+default: `false`\
+parent table: `config`
+
+This option is only relevant when `foreign_keys` is set to `nil` or `run`.
+
+- `prepend_body_to_foreign_keys = false` (the default) will pass the foreign key so it
+  will do whatever it is supposed to do.
+- `prepend_body_to_foreign_keys = true` will add the body key(s) before the foreign key.
+
+The main use is to make kepmaps with the same leading body, but defined outside of this
+Hydra, reachable. For example, if you have a Hydra with the body `CTRL-W` and 4 heads
+`h`, `j`, `k`, `l`, and nothing else, then, with `prepend_body_to_foreign_keys = false`,
+when you press `v`, Hydra will pass `v` to nvim for process; on the other hand, with
+`prepend_body_to_foreign_keys = true`, Hydra will send `CTRL-W_v`.
+
 #### `color`
 `"red" | "amaranth" | "teal" | "pink"`\
 default: `"red"`\

doc/hydra.txt

@@ -258,6 +258,28 @@ config			table
 		`foreign_keys = "run"`
 			will not stop the hydra state, and try to run the
 			foreign key.
+
+				     *hydra-config.prepend_body_to_foreign_keys*
+	prepend_body_to_foreign_keys	boolean
+					default: `false`
+					parent table: `config`
+
+		This option is only relevant when `foreign_keys=nil`.
+
+		`prepend_body_to_foreign_keys = false` (the default) will pass
+		the foreign key so it will do whatever it is supposed to do.
+
+		`prepend_body_to_foreign_keys = true` will add the body key(s)
+		before the foreign key.
+
+		The main use is to make kepmaps with the same leading body,
+		but defined outside of this Hydra, reachable. For example, if
+		you have a Hydra with the body `CTRL-W` and 4 heads `h`, `j`, `k`, `l`, and
+		nothing else, then, with `prepend_body_to_foreign_keys = false`,
+		when you press `v`, Hydra will pass `v` to nvim for process; on the
+		other hand, with `prepend_body_to_foreign_keys = true`, Hydra will
+		send `CTRL-W_v`.
+
 							    *hydra-config.color*
 	color			`"red"` | `"amaranth"` | `"teal"` | `"pink"`
 				default: `"red"`

lua/hydra/init.lua

@@ -27,6 +27,7 @@ local default_config = {
    debug = false,
    exit = false,
    foreign_keys = nil,
+   prepend_body_to_foreign_keys = false,
    color = 'red',
    timeout = false,
    invoke_on_body = false,
@@ -53,6 +54,7 @@ function Hydra:initialize(input)
             on_enter = { input.config.on_enter, 'function', true },
             on_exit = { input.config.on_exit, 'function', true },
             exit = { input.config.exit, 'boolean', true },
+            prepend_body_to_foreign_keys = { input.config.prepend_body_to_foreign_keys, 'boolean', true },
             timeout = { input.config.timeout, { 'boolean', 'number' }, true },
             buffer = { input.config.buffer, { 'boolean', 'number' }, true },
             hint = { input.config.hint, { 'boolean', 'string', 'table' }, true },
@@ -499,6 +501,9 @@ function Hydra:_leave()
       self:_wait()
       return false
    else
+      if self.config.prepend_body_to_foreign_keys and vim.fn.getchar(1) ~= 0 then
+         api.nvim_feedkeys(termcodes(self.body), 'nix', false)
+      end
       self:exit()
       return true
    end

lua/hydra/lib/types.lua

@@ -8,6 +8,7 @@
 ---@field buffer? integer
 ---@field exit boolean
 ---@field foreign_keys hydra.foreign_keys
+---@field prepend_body_to_foreign_keys boolean
 ---@field color hydra.color
 ---@field on_enter? function  Before entering hydra
 ---@field on_exit? function   After leaving hydra