i[で[ foo ]の両端のスペースを含めた範囲を選択する

mini.aiの標準設定では、vi[だと両端のスペースを含まず、vi]で含みます。

mini.ai導入前にvi[を使っていた人はびっくりしそうですね。

設定は簡単で、setup関数でcustom_textobjectsを以下のように記述します。同様に{、[、<なども設定すると良いでしょう。

require('mini.ai').setup({
  custom_textobjects = {
    ['['] = { '%b[]', '^().().*().()$' }
  },
})

キーの['['] = ...は読みにくいですが、i[およびa[の定義であることを示します。 Luaではテーブルのキーに複雑な文字列を指定する時に'[' = ...とするのではなく、['['] = ...とするのですね。初見では戸惑うかもしれません。

値の{ '%b[]', '^().().*().()$' } は更に独特ですね。 mini.aiでは、Lua Patternsをテーブルに複数記述することで、左から順にマッチする箇所を絞り込めます。更に最後の要素ではキャプチャ（()）を使って、a[やi[の両端の位置を決められます。

今回の場合、%b[]で対となる[]を探しています。 %bの重要性は以下テキストで、|がカーソル位置の場合にどの範囲を選択したいか考えてみると良いでしょう。

[ [ | [ foo ] ] ]

a[期待するのは[ [ foo ] ]です。しかし、馴染み深い .* による最長一致などを使うと想定外の範囲を選択します。

• [.*]: [ [ foo ] ] ]（.*は最長一致）
• [.-]: [ [ foo ] （.-は最短一致）
• %b[]: [ [ foo ] ]

そして、^().().*().()$は、i[とa[の選択範囲を示します。 1番目と4番目の()がa[の選択範囲で2番目と3番目の()がi]の選択範囲です。

今回の例だと、

1. %b[] で [ [ foo ] ] を選択
2. ^().().*().()$で、1で選択された範囲からa[とi[の位置を指定

ということが起きています。

ちなみにa[の両端を示す()は以下のように省略可能です。

require('mini.ai').setup({
  custom_textobjects = {
    ['['] = { '%b[]', '^.().*().$' }
  },
})

a]で[[ foo ]]のような二重カッコを選択する

Lua言語など、一部の言語では二重カッコ（[[]]）が特別な意味を持ちます。

v2a[などとして、重なる回数を明示する手もありますが、よく使うならvi]とできると便利ですね。 i[とi]が同じである必要はありません。

require('mini.ai').setup({
  custom_textobjects = {
    ['['] = { '%b[]', '^.().*().$' }
    [']'] = { '%b[]', '^.%[().*()%].$' }  -- va] で [[ foo ]] 全体を選択できるようになる
  },
})

正規表現の解読は読者にお任せするとして、2a[とa[の違いを考えてみましょう。以下の例で|にカーソルがあるとします。

[[  [ foo | ]  ]]

2a[では、[[の連続性は加味せず[の数だけを見るので、[ [ foo ] ]を選択してしまいます。 a]なら、正しく[[ [ foo ] ]]を選択できます。

aj]で「 foo 」のような日本語のカッコを選択する

私はブログなどもNeovimで書いてますが、この時、日本語のカッコをtextobjectで扱えると便利です。

あいにく、custom_textobjectsはキーに使える文字が一つですが、値にはLua Patternsを返却する関数を記述できます。

この性質を利用して、vijと打ったらgetchar()でもう1文字を入力させ、入力文字に合わせて挙動を変えるといいでしょう。

require('mini.ai').setup({
  custom_textobjects = {
    ['j'] = function()
      -- キーを入力させる
      local char = vim.fn.nr2char(vim.fn.getchar())

      -- 入力が`[`だったら、「」を対象とするLua Patternsを返す
      if char == '[' then
        return {'^「().-()」$'}
      end

      -- 他はエラー
      error('j' .. char .. ' is unsupported')
    end
  },
})

i[の例では%b[]を使いましたが、あいにく非ASCII文字（？）は非対応なようで、%b「」は機能しません。幸い、「あ「い」う」などとネストすることはまずないので、最短一致の^「().-()」$を使います。

関数を使うと途端に自由度が上がるので、たとえばi [でmini.aiのデフォルトのi[のように空白を除去した範囲を選択するなんてこともできます。