feat(treesitter): add documentation for available treesitter options in AstroCore

Author: mehalter

src/content/docs/configuration/v6_migration.mdx

@@ -122,7 +122,7 @@ A few plugins have been removed due to being replaced with core Neovim functions
 
 #### AstroUI
 
-- TODO
+- No user facing changes, code updated to use new APIs in AstroNvim plugins as well as core Neovim.
 
 ### Other Breaking Changes
 

src/content/docs/recipes/treesitter.mdx

@@ -3,4 +3,80 @@ id: treesitter
 title: Customize Treesitter
 ---
 
-TODO
+AstroCore v3 comes with the ability to help configure `nvim-treesitter` and `nvim-treesitter-textobjects`. These plugins have recently moved to being small utilities and leaving the configuration of features in Neovim up to the users. To alleviate the need for manual configuration for the users, we have added configuration options under a `treesitter` table in AstroCore that align very similarly with the previous configuration options of `nvim-treesitter`. Here is an overview of the available configuration options:
+
+```lua title="lua/plugins/treesitter.lua"
+return {
+  "AstroNvim/astrocore",
+  ---@type AstroCoreOpts
+  opts = {
+    -- Configuration of treesitter features in Neovim
+    treesitter = {
+      -- Globally enable or disable treesitter features
+      -- can be:
+      --   - a boolean
+      --   - a function (`fun(lang: string, bufnr: integer): boolean`)
+      enabled = function(lang, bufnr)
+        return not require("astrocore.buffer").is_large(bufnr)
+      end,
+      -- Enable or disable treesitter based highlighting
+      -- can be:
+      --   - a boolean
+      --   - a function (`fun(lang: string, bufnr: integer): boolean`)
+      highlight = true,
+      -- Enable or disable treesitter based indenting
+      -- can be:
+      --   - a boolean
+      --   - a function (`fun(lang: string, bufnr: integer): boolean`)
+      indent = true,
+      -- List of treesitter parsers that should be installed automatically
+      -- ("all" can be used to install all available parsers)
+      ensure_installed = { "lua", "vim", "vimdoc" },
+      -- Automatically detect missing treesitter parser and install when editing file
+      auto_install = true,
+      -- Configure treesitter based text objects (requires `nvim-treesitter-textobjects`)
+      -- These options set up automatic detection of available queries for a file and creates
+      -- only the available bindings for each buffer.
+      textobjects = {
+        select = {
+          select_textobject = {
+            ["af"] = { query = "@function.outer", desc = "around function" },
+            ["if"] = { query = "@function.inner", desc = "around function" },
+          },
+        },
+        move = {
+          goto_next_start = {
+            ["]f"] = { query = "@function.outer", desc = "Next function start" },
+          },
+          goto_next_end = {
+            ["]F"] = { query = "@function.outer", desc = "Next function end" },
+          },
+          goto_previous_start = {
+            ["[f"] = {
+              query = "@function.outer",
+              desc = "Previous function start",
+            },
+          },
+          goto_previous_end = {
+            ["[F"] = {
+              query = "@function.outer",
+              desc = "Previous function end",
+            },
+          },
+        },
+        swap = {
+          swap_next = {
+            [">F"] = { query = "@function.outer", desc = "Swap next function" },
+          },
+          swap_previous = {
+            ["<F"] = {
+              query = "@function.outer",
+              desc = "Swap previous function",
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```