{
  "fredrikaverpil/godoc.nvim",
  version = "*",
  dependencies = {
    { "nvim-telescope/telescope.nvim" }, -- optional
    { "folke/snacks.nvim" }, -- optional
    { "echasnovski/mini.pick" }, -- optional
    { "ibhagwan/fzf-lua" }, -- optional
  },
  build = "go install github.com/lotusirous/gostdsym/stdsym@latest", -- optional
  cmd = { "GoDoc" }, -- optional
  ft = "godoc", -- optional
  opts = {}, -- see Configuration
}

vim.pack.add({
  {
    src = "https://github.com/fredrikaverpil/godoc.nvim",
    -- Follow any tagged release. Omit `version` to track the default
    -- branch (every commit, not just releases).
    version = vim.version.range("*"),
  },

  -- Optional picker dependencies — pick whichever you prefer:
  { src = "https://github.com/nvim-telescope/telescope.nvim" },
  { src = "https://github.com/folke/snacks.nvim" },
  { src = "https://github.com/echasnovski/mini.pick" },
  { src = "https://github.com/ibhagwan/fzf-lua" },
})

-- Initialize the plugin (required), see Configuration
require("godoc").setup()

vim.api.nvim_create_autocmd("PackChanged", {
  callback = function(ev)
    if
      ev.data.spec.name == "godoc.nvim"
      and (ev.data.kind == "install" or ev.data.kind == "update")
    then
      vim.system({
        "go",
        "install",
        "github.com/lotusirous/gostdsym/stdsym@latest",
      }):wait()
    end
  end,
})

require("godoc").setup({
  adapters = {
    {
      name = "go",
      opts = {
        command = "GoDoc", -- the vim command to invoke Go documentation
        get_syntax_info = function()
          return {
            filetype = "godoc", -- filetype of the documentation buffer
            language = "",      -- tree-sitter parser, for syntax highlighting
          }
        end,
      },
    },
  },
  window = {
    type = "split", -- split | vsplit
  },
  picker = {
    type = "native", -- native (vim.ui.select) | telescope | snacks | mini | fzf_lua

    -- per-picker options (see lua/godoc/pickers/<name>.lua for available fields)
    native = {},
    telescope = {},
    snacks = {},
    mini = {},
    fzf_lua = {},
  },
})

local godoc_parser = {
  install_info = {
    url = "https://github.com/fredrikaverpil/tree-sitter-godoc",
    files = { "src/parser.c" },
    version = "*",
  },
  filetype = "godoc",
}

require("nvim-treesitter.parsers").godoc = godoc_parser

-- Map godoc filetype to the godoc parser
vim.treesitter.language.register("godoc", "godoc")

-- Re-register after :TSUpdate so the parser survives parser-list reloads
vim.api.nvim_create_autocmd("User", {
  pattern = "TSUpdate",
  callback = function()
    require("nvim-treesitter.parsers").godoc = godoc_parser
  end,
})

-- Optional: also use the godoc filetype for `.godoc` files
vim.api.nvim_create_autocmd({ "BufRead", "BufNewFile" }, {
  pattern = "*.godoc",
  callback = function()
    vim.bo.filetype = "godoc"
  end,
})

require("godoc").setup({
  adapters = {
    {
      name = "go",
      opts = {
        get_syntax_info = function()
          return {
            filetype = "godoc",
            language = "godoc",
          }
        end,
      },
    },
  },
})

require("godoc").setup({
  adapters = {
    -- Built-in, default options
    { name = "go" },

    -- Built-in with user override (rename command)
    { name = "go", opts = { command = "GoDocs" } },

    -- User-defined (no `name` field)
    {
      command = "MyDoc",
      get_items = function()
        return vim.fn.systemlist("mylang doc --list")
      end,
      get_content = function(choice)
        return vim.fn.systemlist("mylang doc " .. choice)
      end,
      get_syntax_info = function()
        return { filetype = "mydoc", language = "mylang" }
      end,
      goto_definition = function() end,
    },

    -- User-defined, purely for fun
    {
      command = "DadJokes",
      get_items = function()
        return { "coffee", "pasta" }
      end,
      get_content = function(choice)
        local db = {
          coffee = { "What did the coffee report to the police?", "A mugging!" },
          pasta  = { "What do you call a fake noodle?",            "An impasta!" },
        }
        return db[choice]
      end,
      get_syntax_info = function()
        return { filetype = "text", language = "text" }
      end,
      goto_definition = function() end,
    },

    -- Third-party
    {
      setup = function()
        return require("pydoc.nvim").setup({ --[[ third-party opts ]] })
      end,
    },

    -- Third-party with override
    {
      setup = function()
        return require("pydoc.nvim").setup({ --[[ third-party opts ]] })
      end,
      opts = { command = "PyDocs" },
    },
  },
})

--- @class GoDocAdapter
--- @field command string The vim command name to register
--- @field get_items fun(): string[] Function that returns a list of available items
--- @field get_content fun(choice: string): string[] Function that returns the content
--- @field get_syntax_info fun(): GoDocSyntaxInfo Function that returns syntax info
--- @field goto_definition? fun(choice: string, picker_gotodef_fun: fun()?): nil Function that returns the definition location
--- @field health? fun(): GoDocHealthCheck[] Optional health check function

--- @class GoDocAdapterOpts
--- @field command? string Override the command name
--- @field get_items? fun(): string[] Override the get_items function
--- @field get_content? fun(choice: string): string[] Override the get_content function
--- @field get_syntax_info? fun(): GoDocSyntaxInfo Override the get_syntax_info function
--- @field goto_definition? fun(choice: string, picker_gotodef_fun: fun()?): nil Override the get_definition function
--- @field health? fun(): GoDocHealthCheck[] Override the health check function
--- @field [string] any Other adapter-specific options