<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>docs/config/key-tables.md - fork/wezterm @ termwiz-0.23.3</title>
<meta name="description" content="docs/config/key-tables.md in fork/wezterm at termwiz-0.23.3.">
<meta property="og:title" content="docs/config/key-tables.md - fork/wezterm @ termwiz-0.23.3">
<meta property="og:description" content="docs/config/key-tables.md in fork/wezterm at termwiz-0.23.3.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="termwiz-0.23.3" data-tip="4bf28e253c0167102f07bfc7e7199c13eed98012">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/wezterm</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/wezterm</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Wez Furlong</span><span class="commit-message" data-commit="40081cb5737da32058a3c87e14b84d8f2bfefdc4">docs: update a bunch of since lines to new macro</span><span class="snapshot-sha sha" data-commit="40081cb5737da32058a3c87e14b84d8f2bfefdc4">40081cb57</span><time datetime="2023-03-20T22:01:24-07:00" title="2023-03-20 22:01:24 -0700">2023-03-20</time></p>
<header class="topbar"><details class="switcher"><summary>termwiz-0.23.3</summary><div class="menu"><strong>branches</strong><a href="/fork/wezterm/ref/main/">main</a><strong>tags</strong><a href="/fork/wezterm/ref/termiz-0.23.1/">termiz-0.23.1</a><a href="/fork/wezterm/ref/termiz-0.23.2/">termiz-0.23.2</a><a href="/fork/wezterm/ref/termiz-0.23.3/">termiz-0.23.3</a><a href="/fork/wezterm/ref/termwiz-0.23.0/">termwiz-0.23.0</a><a href="/fork/wezterm/ref/termwiz-0.23.1/">termwiz-0.23.1</a><a href="/fork/wezterm/ref/termwiz-0.23.2/">termwiz-0.23.2</a><a class="current" href="/fork/wezterm/ref/termwiz-0.23.3/">termwiz-0.23.3</a><a href="/fork/wezterm/ref/vtparse-0.7.0/">vtparse-0.7.0</a><a class="all" href="/fork/wezterm/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/wezterm/">wezterm</a> / <a href="/fork/wezterm/ref/termwiz-0.23.3/tree/docs/">docs</a> / <a href="/fork/wezterm/ref/termwiz-0.23.3/tree/docs/config/">config</a> / <span class="cur">key-tables.md</span></nav>
<span class="view-stats"><span>4.8 KiB</span><span>133 lines</span></span><span class="actions"><a class="raw" href="/fork/wezterm/raw/164c786e9d3cf48b02d7afe76f440a92fab843d1/docs/config/key-tables.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><p>{{since('20220408-101518-b908e2dd')}}</p>
<p>In addition to the default key table defined by the <code>keys</code> configuration
option, <code>wezterm</code> supports defining additional named key tables using the
<code>key_tables</code> configuration option.</p>
<p>On its own, a named table doesn't do anything, but when paired with the
<code>ActivateKeyTable</code> action, some powerful keyboard customization is possible.</p>
<p>As a motivating example, let's consider working with panes. In the default
config <code>CTRL+SHIFT+ArrowKey</code> will activate a pane in the direction of the arrow
key, while <code>CTRL+SHIFT+ALT+ArrowKey</code> will resize a pane in the direction of the
arrow key.  Our goal is to avoid holding down so many keys at once, or even
having to remember so many key combinations, so what we'd like to do is use
<code>CTRL-SHIFT-SPACE</code> as a leader prefix to select between resize and activation
modes, using <code>r</code> for resize and <code>a</code> for activation:</p>
<pre class="language-lua"><a-k>local</a-k> <a-v>wezterm</a-v> = <a-f>require</a-f> <a-s>&#39;wezterm&#39;</a-s>
<a-k>local</a-k> <a-v>act</a-v> = <a-v>wezterm</a-v><a-p>.</a-p><a-v>action</a-v>
<a-k>local</a-k> <a-v>config</a-v> = <a-cr>{}</a-cr>

<a-c>-- Show which key table is active in the status area</a-c>
<a-v>wezterm</a-v><a-p>.</a-p><a-f>on</a-f><a-p>(</a-p><a-s>&#39;update-right-status&#39;</a-s><a-p>,</a-p> <a-k>function</a-k><a-p>(</a-p><a-v>window</a-v><a-p>,</a-p> <a-v>pane</a-v><a-p>)</a-p>
  <a-k>local</a-k> <a-v>name</a-v> = <a-v>window</a-v><a-p>:</a-p><a-f>active_key_table</a-f><a-p>()</a-p>
  <a-k>if</a-k> <a-v>name</a-v> <a-k>then</a-k>
    <a-v>name</a-v> = <a-s>&#39;TABLE: &#39;</a-s> <a-o>..</a-o> <a-v>name</a-v>
  <a-k>end</a-k>
  <a-v>window</a-v><a-p>:</a-p><a-f>set_right_status</a-f><a-p>(</a-p><a-v>name</a-v> <a-k>or</a-k> <a-s>&#39;&#39;</a-s><a-p>)</a-p>
<a-k>end</a-k><a-p>)</a-p>

<a-v>config</a-v><a-p>.</a-p><a-v>leader</a-v> = <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;Space&#39;</a-s><a-p>,</a-p> <a-v>mods</a-v> = <a-s>&#39;CTRL|SHIFT&#39;</a-s> <a-cr>}</a-cr>
<a-v>config</a-v><a-p>.</a-p><a-v>keys</a-v> = <a-cr>{</a-cr>
  <a-c>-- CTRL+SHIFT+Space, followed by &#39;r&#39; will put us in resize-pane</a-c>
  <a-c>-- mode until we cancel that mode.</a-c>
  <a-cr>{</a-cr>
    <a-v>key</a-v> = <a-s>&#39;r&#39;</a-s><a-p>,</a-p>
    <a-v>mods</a-v> = <a-s>&#39;LEADER&#39;</a-s><a-p>,</a-p>
    <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>ActivateKeyTable</a-f> <a-cr>{</a-cr>
      <a-v>name</a-v> = <a-s>&#39;resize_pane&#39;</a-s><a-p>,</a-p>
      <a-v>one_shot</a-v> = <a-co>false</a-co><a-p>,</a-p>
    <a-cr>}</a-cr><a-p>,</a-p>
  <a-cr>}</a-cr><a-p>,</a-p>

  <a-c>-- CTRL+SHIFT+Space, followed by &#39;a&#39; will put us in activate-pane</a-c>
  <a-c>-- mode until we press some other key or until 1 second (1000ms)</a-c>
  <a-c>-- of time elapses</a-c>
  <a-cr>{</a-cr>
    <a-v>key</a-v> = <a-s>&#39;a&#39;</a-s><a-p>,</a-p>
    <a-v>mods</a-v> = <a-s>&#39;LEADER&#39;</a-s><a-p>,</a-p>
    <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>ActivateKeyTable</a-f> <a-cr>{</a-cr>
      <a-v>name</a-v> = <a-s>&#39;activate_pane&#39;</a-s><a-p>,</a-p>
      <a-v>timeout_milliseconds</a-v> = <a-n>1000</a-n><a-p>,</a-p>
    <a-cr>}</a-cr><a-p>,</a-p>
  <a-cr>}</a-cr><a-p>,</a-p>
<a-cr>}</a-cr>

<a-v>config</a-v><a-p>.</a-p><a-v>key_tables</a-v> = <a-cr>{</a-cr>
  <a-c>-- Defines the keys that are active in our resize-pane mode.</a-c>
  <a-c>-- Since we&#39;re likely to want to make multiple adjustments,</a-c>
  <a-c>-- we made the activation one_shot=false. We therefore need</a-c>
  <a-c>-- to define a key assignment for getting out of this mode.</a-c>
  <a-c>-- &#39;resize_pane&#39; here corresponds to the name=&quot;resize_pane&quot; in</a-c>
  <a-c>-- the key assignments above.</a-c>
  <a-v>resize_pane</a-v> = <a-cr>{</a-cr>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;LeftArrow&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f> <a-cr>{</a-cr> <a-s>&#39;Left&#39;</a-s><a-p>,</a-p> <a-n>1</a-n> <a-cr>}</a-cr> <a-cr>}</a-cr><a-p>,</a-p>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;h&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f> <a-cr>{</a-cr> <a-s>&#39;Left&#39;</a-s><a-p>,</a-p> <a-n>1</a-n> <a-cr>}</a-cr> <a-cr>}</a-cr><a-p>,</a-p>

    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;RightArrow&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f> <a-cr>{</a-cr> <a-s>&#39;Right&#39;</a-s><a-p>,</a-p> <a-n>1</a-n> <a-cr>}</a-cr> <a-cr>}</a-cr><a-p>,</a-p>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;l&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f> <a-cr>{</a-cr> <a-s>&#39;Right&#39;</a-s><a-p>,</a-p> <a-n>1</a-n> <a-cr>}</a-cr> <a-cr>}</a-cr><a-p>,</a-p>

    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;UpArrow&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f> <a-cr>{</a-cr> <a-s>&#39;Up&#39;</a-s><a-p>,</a-p> <a-n>1</a-n> <a-cr>}</a-cr> <a-cr>}</a-cr><a-p>,</a-p>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;k&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f> <a-cr>{</a-cr> <a-s>&#39;Up&#39;</a-s><a-p>,</a-p> <a-n>1</a-n> <a-cr>}</a-cr> <a-cr>}</a-cr><a-p>,</a-p>

    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;DownArrow&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f> <a-cr>{</a-cr> <a-s>&#39;Down&#39;</a-s><a-p>,</a-p> <a-n>1</a-n> <a-cr>}</a-cr> <a-cr>}</a-cr><a-p>,</a-p>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;j&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f> <a-cr>{</a-cr> <a-s>&#39;Down&#39;</a-s><a-p>,</a-p> <a-n>1</a-n> <a-cr>}</a-cr> <a-cr>}</a-cr><a-p>,</a-p>

    <a-c>-- Cancel the mode by pressing escape</a-c>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;Escape&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-s>&#39;PopKeyTable&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
  <a-cr>}</a-cr><a-p>,</a-p>

  <a-c>-- Defines the keys that are active in our activate-pane mode.</a-c>
  <a-c>-- &#39;activate_pane&#39; here corresponds to the name=&quot;activate_pane&quot; in</a-c>
  <a-c>-- the key assignments above.</a-c>
  <a-v>activate_pane</a-v> = <a-cr>{</a-cr>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;LeftArrow&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f> <a-s>&#39;Left&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;h&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f> <a-s>&#39;Left&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>

    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;RightArrow&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f> <a-s>&#39;Right&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;l&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f> <a-s>&#39;Right&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>

    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;UpArrow&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f> <a-s>&#39;Up&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;k&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f> <a-s>&#39;Up&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>

    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;DownArrow&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f> <a-s>&#39;Down&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
    <a-cr>{</a-cr> <a-v>key</a-v> = <a-s>&#39;j&#39;</a-s><a-p>,</a-p> <a-v>action</a-v> = <a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f> <a-s>&#39;Down&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
  <a-cr>}</a-cr><a-p>,</a-p>
<a-cr>}</a-cr>

<a-k>return</a-k> <a-v>config</a-v></pre>
<h3>Key Table Activation Stack</h3>
<p>Each <code>wezterm</code> GUI window maintains a stack of activations, which allows you to
create complex layering of keyboard customization.</p>
<p>The <a href="/fork/wezterm/ref/termwiz-0.23.3/blob/docs/config/lua/keyassignment/ActivateKeyTable.md">ActivateKeyTable</a> action will push
an entry to the stack, and provides <code>one_shot</code> and <code>timeout_milliseconds</code>
fields to affect when/how it will pop itself from the stack, and
<code>replace_current</code> to implicitly pop the current entry from the stack.</p>
<p>The <a href="/fork/wezterm/ref/termwiz-0.23.3/blob/docs/config/lua/keyassignment/PopKeyTable.md">PopKeyTable</a> action will explicitly pop
an entry from the stack.</p>
<p>The <a href="/fork/wezterm/ref/termwiz-0.23.3/blob/docs/config/lua/keyassignment/ClearKeyTableStack.md">ClearKeyTableStack</a> action will
clear the entire stack.</p>
<p>The stack is also cleared when the configuration is reloaded, so if you're
working on a complex key table setup and get stuck, you may be able to unstick
yourself by re-saving your wezterm configuration to trigger a reload.</p>
<p>{{since('20220624-141144-bd1b7c5d')}}</p>
<p>When resolving a key assignment, the top of stack is first searched for a match,
and if one is not found, the next entry on the stack is searched and so on until a match is found.</p>
<p>In previous releases, only a single lookup was performed on the top of the stack.</p>
<p>The new behavior allows key table activations to effectively layer over the top
of previously activated key assignments, making it a bit easier to compose key
assignments.</p>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text">{{since(&#39;20220408-101518-b908e2dd&#39;)}}</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text">In addition to the default key table defined by the `keys` configuration</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text">option, `wezterm` supports defining additional named key tables using the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text">`key_tables` configuration option.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text">On its own, a named table doesn&#39;t do anything, but when paired with the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text">`ActivateKeyTable` action, some powerful keyboard customization is possible.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text">As a motivating example, let&#39;s consider working with panes. In the default</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text">config `CTRL+SHIFT+ArrowKey` will activate a pane in the direction of the arrow</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text">key, while `CTRL+SHIFT+ALT+ArrowKey` will resize a pane in the direction of the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text">arrow key.  Our goal is to avoid holding down so many keys at once, or even</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text">having to remember so many key combinations, so what we&#39;d like to do is use</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text">`CTRL-SHIFT-SPACE` as a leader prefix to select between resize and activation</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text">modes, using `r` for resize and `a` for activation:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"><a-p>```</a-p><a-tl>lua</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>local </a-p><a-v>wezterm</a-v><a-p> = </a-p><a-f>require</a-f><a-p> </a-p><a-s>&#39;wezterm&#39;</a-s></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"><a-p>local </a-p><a-v>act</a-v><a-p> = </a-p><a-v>wezterm</a-v><a-p>.</a-p><a-v>action</a-v></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>local </a-p><a-v>config</a-v><a-p> = </a-p><a-cr>{}</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-p>-- Show which key table is active in the status area</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>wezterm.</a-p><a-f>on</a-f><a-p>(</a-p><a-s>&#39;update-right-status&#39;</a-s><a-p>, </a-p><a-k>function</a-k><a-p>(</a-p><a-v>window</a-v><a-p>, </a-p><a-v>pane</a-v><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-p>  </a-p><a-k>local</a-k><a-p> </a-p><a-v>name</a-v><a-p> = </a-p><a-v>window</a-v><a-p>:</a-p><a-f>active_key_table</a-f><a-p>()</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>  </a-p><a-k>if</a-k><a-p> </a-p><a-v>name</a-v><a-p> </a-p><a-k>then</a-k></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> = </a-p><a-s>&#39;TABLE: &#39;</a-s><a-p> </a-p><a-o>..</a-o><a-p> </a-p><a-v>name</a-v></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-p>  </a-p><a-k>end</a-k></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"><a-p>  </a-p><a-v>window</a-v><a-p>:</a-p><a-f>set_right_status</a-f><a-p>(</a-p><a-v>name</a-v><a-p> </a-p><a-k>or</a-k><a-p> </a-p><a-s>&#39;&#39;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-p>end)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>config.</a-p><a-v>leader</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;Space&#39;</a-s><a-p>, </a-p><a-v>mods</a-v><a-p> = </a-p><a-s>&#39;CTRL|SHIFT&#39;</a-s><a-p> </a-p><a-cr>}</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"><a-p>config.</a-p><a-v>keys</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"><a-p>  </a-p><a-c>-- CTRL+SHIFT+Space, followed by &#39;r&#39; will put us in resize-pane</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>  </a-p><a-c>-- mode until we cancel that mode.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>  </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>    </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;r&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>    </a-p><a-v>mods</a-v><a-p> = </a-p><a-s>&#39;LEADER&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"><a-p>    </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>ActivateKeyTable</a-f><a-p> </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>      </a-p><a-v>name</a-v><a-p> = </a-p><a-s>&#39;resize_pane&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>      </a-p><a-v>one_shot</a-v><a-p> = </a-p><a-co>false</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>    </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"><a-p>  </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>  </a-p><a-c>-- CTRL+SHIFT+Space, followed by &#39;a&#39; will put us in activate-pane</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>  </a-p><a-c>-- mode until we press some other key or until 1 second (1000ms)</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"><a-p>  </a-p><a-c>-- of time elapses</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>  </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>    </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;a&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>    </a-p><a-v>mods</a-v><a-p> = </a-p><a-s>&#39;LEADER&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-p>    </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>ActivateKeyTable</a-f><a-p> </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>      </a-p><a-v>name</a-v><a-p> = </a-p><a-s>&#39;activate_pane&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"><a-p>      </a-p><a-v>timeout_milliseconds</a-v><a-p> = </a-p><a-n>1000</a-n><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"><a-p>    </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>  </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>config.</a-p><a-v>key_tables</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>  </a-p><a-c>-- Defines the keys that are active in our resize-pane mode.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"><a-p>  </a-p><a-c>-- Since we&#39;re likely to want to make multiple adjustments,</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>  </a-p><a-c>-- we made the activation one_shot=false. We therefore need</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"><a-p>  </a-p><a-c>-- to define a key assignment for getting out of this mode.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p>  </a-p><a-c>-- &#39;resize_pane&#39; here corresponds to the name=&quot;resize_pane&quot; in</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p>  </a-p><a-c>-- the key assignments above.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>  </a-p><a-v>resize_pane</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;LeftArrow&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f><a-p> </a-p><a-cr>{</a-cr><a-p> </a-p><a-s>&#39;Left&#39;</a-s><a-p>, </a-p><a-n>1</a-n><a-p> </a-p><a-cr>}</a-cr><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;h&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f><a-p> </a-p><a-cr>{</a-cr><a-p> </a-p><a-s>&#39;Left&#39;</a-s><a-p>, </a-p><a-n>1</a-n><a-p> </a-p><a-cr>}</a-cr><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;RightArrow&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f><a-p> </a-p><a-cr>{</a-cr><a-p> </a-p><a-s>&#39;Right&#39;</a-s><a-p>, </a-p><a-n>1</a-n><a-p> </a-p><a-cr>}</a-cr><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;l&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f><a-p> </a-p><a-cr>{</a-cr><a-p> </a-p><a-s>&#39;Right&#39;</a-s><a-p>, </a-p><a-n>1</a-n><a-p> </a-p><a-cr>}</a-cr><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;UpArrow&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f><a-p> </a-p><a-cr>{</a-cr><a-p> </a-p><a-s>&#39;Up&#39;</a-s><a-p>, </a-p><a-n>1</a-n><a-p> </a-p><a-cr>}</a-cr><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;k&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f><a-p> </a-p><a-cr>{</a-cr><a-p> </a-p><a-s>&#39;Up&#39;</a-s><a-p>, </a-p><a-n>1</a-n><a-p> </a-p><a-cr>}</a-cr><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;DownArrow&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f><a-p> </a-p><a-cr>{</a-cr><a-p> </a-p><a-s>&#39;Down&#39;</a-s><a-p>, </a-p><a-n>1</a-n><a-p> </a-p><a-cr>}</a-cr><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;j&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>AdjustPaneSize</a-f><a-p> </a-p><a-cr>{</a-cr><a-p> </a-p><a-s>&#39;Down&#39;</a-s><a-p>, </a-p><a-n>1</a-n><a-p> </a-p><a-cr>}</a-cr><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text"><a-p>    </a-p><a-c>-- Cancel the mode by pressing escape</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;Escape&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-s>&#39;PopKeyTable&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"><a-p>  </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"><a-p>  </a-p><a-c>-- Defines the keys that are active in our activate-pane mode.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"><a-p>  </a-p><a-c>-- &#39;activate_pane&#39; here corresponds to the name=&quot;activate_pane&quot; in</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"><a-p>  </a-p><a-c>-- the key assignments above.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"><a-p>  </a-p><a-v>activate_pane</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;LeftArrow&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f><a-p> </a-p><a-s>&#39;Left&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;h&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f><a-p> </a-p><a-s>&#39;Left&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;RightArrow&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f><a-p> </a-p><a-s>&#39;Right&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;l&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f><a-p> </a-p><a-s>&#39;Right&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;UpArrow&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f><a-p> </a-p><a-s>&#39;Up&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;k&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f><a-p> </a-p><a-s>&#39;Up&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;DownArrow&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f><a-p> </a-p><a-s>&#39;Down&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"><a-p>    </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>key</a-v><a-p> = </a-p><a-s>&#39;j&#39;</a-s><a-p>, </a-p><a-v>action</a-v><a-p> = </a-p><a-v>act</a-v><a-p>.</a-p><a-f>ActivatePaneDirection</a-f><a-p> </a-p><a-s>&#39;Down&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text"><a-p>  </a-p><a-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"><a-p>return </a-p><a-v>config</a-v></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text"><a-p>### </a-p><a-tt>Key Table Activation Stack</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text">Each `wezterm` GUI window maintains a stack of activations, which allows you to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text">create complex layering of keyboard customization.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text">The [ActivateKeyTable](lua/keyassignment/ActivateKeyTable.md) action will push</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text">an entry to the stack, and provides `one_shot` and `timeout_milliseconds`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text">fields to affect when/how it will pop itself from the stack, and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text">`replace_current` to implicitly pop the current entry from the stack.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L113" href="#L113">113</a><span class="code-text">The [PopKeyTable](lua/keyassignment/PopKeyTable.md) action will explicitly pop</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L114" href="#L114">114</a><span class="code-text">an entry from the stack.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L115" href="#L115">115</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text">The [ClearKeyTableStack](lua/keyassignment/ClearKeyTableStack.md) action will</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L117" href="#L117">117</a><span class="code-text">clear the entire stack.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L118" href="#L118">118</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L119" href="#L119">119</a><span class="code-text">The stack is also cleared when the configuration is reloaded, so if you&#39;re</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L120" href="#L120">120</a><span class="code-text">working on a complex key table setup and get stuck, you may be able to unstick</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</a><span class="code-text">yourself by re-saving your wezterm configuration to trigger a reload.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L122" href="#L122">122</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L123" href="#L123">123</a><span class="code-text">{{since(&#39;20220624-141144-bd1b7c5d&#39;)}}</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L124" href="#L124">124</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L125" href="#L125">125</a><span class="code-text">When resolving a key assignment, the top of stack is first searched for a match,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L126" href="#L126">126</a><span class="code-text">and if one is not found, the next entry on the stack is searched and so on until a match is found.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L127" href="#L127">127</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L128" href="#L128">128</a><span class="code-text">In previous releases, only a single lookup was performed on the top of the stack.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L129" href="#L129">129</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</a><span class="code-text">The new behavior allows key table activations to effectively layer over the top</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L131" href="#L131">131</a><span class="code-text">of previously activated key assignments, making it a bit easier to compose key</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L132" href="#L132">132</a><span class="code-text">assignments.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L133" href="#L133">133</a><span class="code-text"></span></span></pre></div></div>
</main>
</body>
</html>
