themes.lua

-- Prototype Theme System (WIP)
-- Currently certain designs need a number of parameters.
--
-- local opts = themes.get_dropdown { winblend = 3 }

---@tag telescope.themes

---@brief [[
--- Themes are ways to combine several elements of styling together.
---
--- They are helpful for managing the several differnt UI aspects for telescope and provide
--- a simple interface for users to get a particular "style" of picker.
---@brief ]]

local themes = {}

--- Dropdown style theme.
--- <pre>
---
--- Usage:
---
---     `local builtin = require('telescope.builtin')`
---     `local themes = require('telescope.themes')`
---     `builtin.find_files(themes.get_dropdown())`
--- </pre>
function themes.get_dropdown(opts)
  opts = opts or {}

  local theme_opts = {
    theme = "dropdown",

    results_title = false,
    preview_title = "Preview",

    sorting_strategy = "ascending",
    layout_strategy = "center",
    layout_config = {
      preview_cutoff = 1, -- Preview should always show (unless previewer = false)

      width = function(_, max_columns, _)
        return math.min(max_columns - 3, 80)
      end,

      height = function(_, _, max_lines)
        return math.min(max_lines - 4, 15)
      end,
    },

    border = true,
    borderchars = {
      { "─", "│", "─", "│", "╭", "╮", "╯", "╰"},
      prompt = {"─", "│", " ", "│", "╭", "╮", "│", "│"},
      results = {"─", "│", "─", "│", "├", "┤", "╯", "╰"},
      preview = { "─", "│", "─", "│", "╭", "╮", "╯", "╰"},
    },
  }

  return vim.tbl_deep_extend("force", theme_opts, opts)
end

--- Cursor style theme.
--- <pre>
---
--- Usage:
---
---     `local builtin = require('telescope.builtin')`
---     `local themes = require('telescope.themes')`
---     `builtin.lsp_code_actions(themes.get_cursor())`
--- </pre>
function themes.get_cursor(opts)
  opts = opts or {}

  local theme_opts = {
    theme = 'cursor',

    sorting_strategy = 'ascending',
    results_title = false,
    layout_strategy = 'cursor',
    layout_config = {
      width = function(_, _, _)
        return 80
      end,

      height = function(_, _, _)
        return 6
      end,
    },
    borderchars = {
      { '─', '│', '─', '│', '╭', '╮', '╯', '╰'},
      prompt = {'─', '│', ' ', '│', '╭', '╮', '│', '│'},
      results = {'─', '│', '─', '│', '├', '┤', '╯', '╰'},
      preview = { '─', '│', '─', '│', '╭', '╮', '╯', '╰'},
    },
  }

  return vim.tbl_deep_extend('force', theme_opts, opts)
end

--- Ivy style theme.
--- <pre>
---
--- Usage:
---
---     `local builtin = require('telescope.builtin')`
---     `local themes = require('telescope.themes')`
---     `builtin.find_files(themes.get_ivy())`
--- </pre>
function themes.get_ivy(opts)
  opts = opts or {}

  return vim.tbl_deep_extend("force", {
    theme = "ivy",

    sorting_strategy = "ascending",

    preview_title = "",

    layout_strategy = "bottom_pane",
    layout_config = {
      height = 25,
    },

    border = true,
    borderchars = {
      "z",
      prompt = { "─", " ", " ", " ", "─", "─", " ", " " },
      results = { " " },
      -- results = { "a", "b", "c", "d", "e", "f", "g", "h" },
      preview = { "─", "│", "─", "│", "╭", "╮", "╯", "╰"},
    },
  }, opts)
end

return themes