telekasten.nvim/lua/telekasten.lua

local builtin = require("telescope.builtin")
local actions = require("telescope.actions")
local action_state = require("telescope.actions.state")
local pickers = require("telescope.pickers")
local finders = require("telescope.finders")
local conf = require("telescope.config").values
local scan = require("plenary.scandir")
local utils = require("telescope.utils")
local previewers = require("telescope.previewers")

-- declare locals for the nvim api stuff to avoid more lsp warnings
local vim = vim

-- ----------------------------------------------------------------------------
-- DEFAULT CONFIG
-- ----------------------------------------------------------------------------
local home = vim.fn.expand("~/zettelkasten")
local M = {}

M.Cfg = {
	home = home,
	dailies = home .. "/" .. "daily",
	weeklies = home .. "/" .. "weekly",
	templates = home .. "/" .. "templates",

	-- image subdir for pasting
	-- subdir name
	-- or nil if pasted images shouldn't go into a special subdir
	image_subdir = nil,

	-- markdown file extension
	extension = ".md",

	-- following a link to a non-existing note will create it
	follow_creates_nonexisting = true,
	dailies_create_nonexisting = true,
	weeklies_create_nonexisting = true,

	-- templates for new notes
	template_new_note = home .. "/" .. "templates/new_note.md",
	template_new_daily = home .. "/" .. "templates/daily_tk.md",
	template_new_weekly = home .. "/" .. "templates/weekly_tk.md",

	-- image link style
	-- wiki:     ![[image name]]
	-- markdown: ![](image_subdir/xxxxx.png)
	image_link_style = "markdown",

	-- integrate with calendar-vim
	plug_into_calendar = true,
	calendar_opts = {
		-- calendar week display mode: 1 .. 'WK01', 2 .. 'WK 1', 3 .. 'KW01', 4 .. 'KW 1', 5 .. '1'
		weeknm = 4,
		-- use monday as first day of week: 1 .. true, 0 .. false
		calendar_monday = 1,
		-- calendar mark: where to put mark for marked days: 'left', 'right', 'left-fit'
		calendar_mark = "left-fit",
	},
}

local function file_exists(fname)
	local f = io.open(fname, "r")
	if f ~= nil then
		io.close(f)
		return true
	else
		return false
	end
end

-- ----------------------------------------------------------------------------
-- image stuff
local function imgFromClipboard()
	if vim.fn.executable("xclip") == 0 then
		vim.api.nvim_err_write("No xclip installed!\n")
		return
	end

	-- TODO: check `xclip -selection clipboard -t TARGETS -o` for the occurence of `image/png`

	-- using plenary.job::new():sync() with on_stdout(_, data) unfortunately did some weird ASCII translation on the
	-- data, so the PNGs were invalid. It seems like 0d 0a and single 0a bytes were stripped by the plenary job:
	--
	-- plenary job version:
	-- $ hexdump -C /tmp/x.png|head
	-- 00000000  89 50 4e 47 1a 00 00 00  49 48 44 52 00 00 03 19  |.PNG....IHDR....|
	-- 00000010  00 00 01 c1 08 02 00 00  00 8a 73 e1 c3 00 00 00  |..........s.....|
	-- 00000020  09 70 48 59 73 00 00 0e  c4 00 00 0e c4 01 95 2b  |.pHYs..........+|
	-- 00000030  0e 1b 00 00 20 00 49 44  41 54 78 9c ec dd 77 58  |.... .IDATx...wX|
	-- 00000040  14 d7 fa 07 f0 33 bb b3  4b af 0b 2c 08 22 1d 04  |.....3..K..,."..|
	-- 00000050  05 11 10 1b a2 54 c5 1e  bb b1 c6 98 c4 68 72 4d  |.....T.......hrM|
	-- 00000060  e2 cd 35 37 26 b9 49 6e  6e 7e f7 a6 98 98 a8 29  |..57&.Inn~.....)|
	-- 00000070  26 6a 8c 51 63 8b bd 00  8a 58 40 b0 81 08 2a 45  |&j.Qc....X@...*E|
	-- 00000080  69 52 17 58 ca ee b2 f5  f7 c7 ea 4a 10 66 d7 01  |iR.X.......J.f..|
	-- 00000090  b1 e4 fb 79 7c f2 2c e7  cc 39 e7 3d 67 66 b3 2f  |...y|.,..9.=gf./|
	--
	-- OK version
	-- $ hexdump -C /tmp/x2.png|head
	-- 00000000  89 50 4e 47 0d 0a 1a 0a  00 00 00 0d 49 48 44 52  |.PNG........IHDR|
	-- 00000010  00 00 03 19 00 00 01 c1  08 02 00 00 00 8a 73 e1  |..............s.|
	-- 00000020  c3 00 00 00 09 70 48 59  73 00 00 0e c4 00 00 0e  |.....pHYs.......|
	-- 00000030  c4 01 95 2b 0e 1b 00 00  20 00 49 44 41 54 78 9c  |...+.... .IDATx.|
	-- 00000040  ec dd 77 58 14 d7 fa 07  f0 33 bb b3 4b af 0b 2c  |..wX.....3..K..,|
	-- 00000050  08 22 1d 04 05 11 10 1b  a2 54 c5 1e bb b1 c6 98  |.".......T......|
	-- 00000060  c4 68 72 4d e2 cd 35 37  26 b9 49 6e 6e 7e f7 a6  |.hrM..57&.Inn~..|
	-- 00000070  98 98 a8 29 26 6a 8c 51  63 8b bd 00 8a 58 40 b0  |...)&j.Qc....X@.|
	-- 00000080  81 08 2a 45 69 52 17 58  ca ee b2 f5 f7 c7 ea 4a  |..*EiR.X.......J|
	-- 00000090  10 66 d7 01 b1 e4 fb 79  7c f2 2c e7 cc 39 e7 3d  |.f.....y|.,..9.=|

	local pngname = "pasted_img_" .. os.date("%Y%m%d%H%M%S") .. ".png"
	local pngpath = M.Cfg.home
	local relpath = pngname

	if M.Cfg.image_subdir then
		relpath = M.Cfg.image_subdir .. "/" .. pngname
	end
	pngpath = pngpath .. "/" .. pngname

	os.execute("xclip -selection clipboard -t image/png -o > " .. pngpath)
	if file_exists(pngpath) then
		if M.Cfg.image_link_style == "markdown" then
			vim.api.nvim_put({ "![](" .. relpath .. ")" }, "", false, true)
		else
			vim.api.nvim_put({ "![[" .. pngname .. "]]" }, "", false, true)
		end
	end
end
-- end of image stuff

M.note_type_templates = {
	normal = M.Cfg.template_new_note,
	daily = M.Cfg.template_new_daily,
	weekly = M.Cfg.template_new_weekly,
}

local function daysuffix(day)
	if (day == "1") or (day == "21") or (day == "31") then
		return "st"
	end
	if (day == "2") or (day == "22") then
		return "nd"
	end
	if (day == "3") or (day == "33") then
		return "rd"
	end
	return "th"
end

local daymap = { "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" }
local monthmap = {
	"January",
	"February",
	"March",
	"April",
	"May",
	"June",
	"July",
	"August",
	"September",
	"October",
	"November",
	"December",
}

local function calenderinfo_today()
	local dinfo = os.date("*t")
	local opts = {}
	opts.date = os.date("%Y-%m-%d")
	local wday = dinfo.wday - 1
	if wday == 0 then
		wday = 7
	end
	if wday == 6 then
		wday = 1
	end
	opts.hdate = daymap[wday]
		.. ", "
		.. monthmap[dinfo.month]
		.. " "
		.. dinfo.day
		.. daysuffix(dinfo.day)
		.. ", "
		.. dinfo.year
	opts.week = os.date("%V")
	opts.month = dinfo.month
	opts.year = dinfo.year
	opts.day = dinfo.day
	return opts
end

local function linesubst(line, title, calendar_info)
	local cinfo = calendar_info or calenderinfo_today()
	local substs = {
		date = cinfo.date,
		hdate = cinfo.hdate,
		week = cinfo.week,
		year = cinfo.year,
		title = title,
	}
	for k, v in pairs(substs) do
		line = line:gsub("{{" .. k .. "}}", v)
	end

	return line
end

local function create_note_from_template(title, filepath, templatefn, calendar_info)
	-- first, read the template file
	local lines = {}
	for line in io.lines(templatefn) do
		lines[#lines + 1] = line
	end

	-- now write the output file, substituting vars line by line
	local ofile = io.open(filepath, "a")
	for _, line in pairs(lines) do
		ofile:write(linesubst(line, title, calendar_info) .. "\n")
	end

	ofile:close()
end

local function path_to_linkname(p)
	local fn = vim.split(p, "/")
	fn = fn[#fn]
	fn = vim.split(fn, M.Cfg.extension)
	fn = fn[1]
	return fn
end

local function order_numeric(a, b)
	return a > b
end

-- local function endswith(s, ending)
-- 	return ending == "" or s:sub(-#ending) == ending
-- end

local function file_extension(fname)
	return fname:match("^.+(%..+)$")
end

local function filter_filetypes(flist, ftypes)
	local new_fl = {}
	ftypes = ftypes or { M.Cfg.extension }

	local ftypeok = {}
	for _, ft in pairs(ftypes) do
		ftypeok[ft] = true
	end

	for _, fn in pairs(flist) do
		if ftypeok[file_extension(fn)] then
			table.insert(new_fl, fn)
		end
	end
	return new_fl
end

local media_files_base_directory = "../telescope-media-files.nvim"
local defaulter = utils.make_default_callable
local media_preview = defaulter(function(opts)
	local preview_cmd = media_files_base_directory .. "/scripts/vimg"
	if vim.fn.executable(preview_cmd) == 0 then
		return conf.file_previewer(opts)
	end
	return previewers.new_termopen_previewer({
		get_command = opts.get_command or function(entry)
			local tmp_table = vim.split(entry.value, "\t")
			local preview = opts.get_preview_window()
			opts.cwd = opts.cwd and vim.fn.expand(opts.cwd) or vim.loop.cwd()
			if vim.tbl_isempty(tmp_table) then
				return { "echo", "" }
			end
			return {
				preview_cmd,
				tmp_table[1],
				preview.col,
				preview.line + 1,
				preview.width,
				preview.height,
			}
		end,
	})
end, {})

-- find_files_sorted(opts)
-- like builtin.find_files, but:
--     - uses plenary.scan_dir synchronously instead of external jobs
--     - pre-sorts the file list in descending order (nice for dates, most recent first)
--     - filters for allowed file types by extension
--     - (also supports devicons)
--     - displays subdirs if necessary
--         - e.g. when searching for daily notes, no subdirs are displayed
--         - but when entering a date in find_notes, the daily/ and weekly/ subdirs are displayed
--     - optionally previews media (pdf, images, mp4, webm)
--         - this requires the telescope-media-files.nvim extension
local function find_files_sorted(opts)
	opts = opts or {}

	local file_list = scan.scan_dir(opts.cwd, {})
	local filter_extensions = opts.filter_extensions or M.Cfg.filter_extensions
	file_list = filter_filetypes(file_list, filter_extensions)
	table.sort(file_list, order_numeric)

	-- display with devicons
	local function iconic_display(display_entry)
		local display_opts = {
			path_display = function(_, e)
				return e:gsub(opts.cwd .. "/", "")
			end,
		}

		local hl_group
		local display = utils.transform_path(display_opts, display_entry.value)

		display, hl_group = utils.transform_devicons(display_entry.value, display, false)

		if hl_group then
			return display, { { { 1, 3 }, hl_group } }
		else
			return display
		end
	end

	-- for media_files
	local popup_opts = {}
	opts.get_preview_window = function()
		return popup_opts.preview
	end

	local function make_entry(entry)
		local iconic_entry = {}
		iconic_entry.value = entry
		iconic_entry.ordinal = entry
		iconic_entry.display = iconic_display
		return iconic_entry
	end

	local previewer = conf.file_previewer(opts)
	if opts.preview_type == "media" then
		previewer = media_preview.new(opts)
	end

	local picker = pickers.new(opts, {
		finder = finders.new_table({
			results = file_list,
			entry_maker = make_entry,
		}),
		sorter = conf.generic_sorter(opts),

		previewer = previewer,
	})

	-- for media_files:
	local line_count = vim.o.lines - vim.o.cmdheight
	if vim.o.laststatus ~= 0 then
		line_count = line_count - 1
	end
	popup_opts = picker:get_window_options(vim.o.columns, line_count)

	picker:find()
end

--
-- FindDailyNotes:
-- ---------------
--
-- Select from daily notes
--
local function FindDailyNotes(opts)
	opts = opts or {}

	local today = os.date("%Y-%m-%d")
	local fname = M.Cfg.dailies .. "/" .. today .. M.Cfg.extension
	local fexists = file_exists(fname)
	if
		(fexists ~= true) and ((opts.dailies_create_nonexisting == true) or M.Cfg.dailies_create_nonexisting == true)
	then
		create_note_from_template(today, fname, M.note_type_templates.daily)
	end

	find_files_sorted({
		prompt_title = "Find daily note",
		cwd = M.Cfg.dailies,
		find_command = M.Cfg.find_command,
	})
end

--
-- FindWeeklyNotes:
-- ---------------
--
-- Select from daily notes
--
local function FindWeeklyNotes(opts)
	opts = opts or {}

	local title = os.date("%Y-W%V")
	local fname = M.Cfg.weeklies .. "/" .. title .. M.Cfg.extension
	local fexists = file_exists(fname)
	if
		(fexists ~= true)
		and ((opts.weeklies_create_nonexisting == true) or M.Cfg.weeklies_create_nonexisting == true)
	then
		create_note_from_template(title, fname, M.note_type_templates.weekly)
	end

	find_files_sorted({
		prompt_title = "Find weekly note",
		cwd = M.Cfg.weeklies,
		find_command = M.Cfg.find_command,
	})
end

--
-- InsertLink:
-- -----------
--
-- Select from all notes and put a link in the current buffer
--
local function InsertLink(opts)
	opts = opts or {}
	find_files_sorted({
		prompt_title = "Insert link to note",
		cwd = M.Cfg.home,
		attach_mappings = function(prompt_bufnr, _)
			actions.select_default:replace(function()
				actions.close(prompt_bufnr)
				local selection = action_state.get_selected_entry()
				local fn = path_to_linkname(selection.value)
				vim.api.nvim_put({ "[[" .. fn .. "]]" }, "", false, true)
				if opts.i then
					vim.api.nvim_feedkeys("A", "m", false)
				end
			end)
			return true
		end,
		find_command = M.Cfg.find_command,
	})
end

--
-- FollowLink:
-- -----------
--
-- find the file linked to by the word under the cursor
--
local function FollowLink(opts)
	opts = opts or {}
	vim.cmd("normal yi]")
	local title = vim.fn.getreg('"0')

	-- check if fname exists anywhere
	local fexists = file_exists(M.Cfg.weeklies .. "/" .. title .. M.Cfg.extension)
	fexists = fexists or file_exists(M.Cfg.dailies .. "/" .. title .. M.Cfg.extension)
	fexists = fexists or file_exists(M.Cfg.home .. "/" .. title .. M.Cfg.extension)

	if
		(fexists ~= true) and ((opts.follow_creates_nonexisting == true) or M.Cfg.follow_creates_nonexisting == true)
	then
		local fname = M.Cfg.home .. "/" .. title .. M.Cfg.extension
		create_note_from_template(title, fname, M.note_type_templates.normal)
	end

	find_files_sorted({
		prompt_title = "Follow link to note...",
		cwd = M.Cfg.home,
		default_text = title,
		find_command = M.Cfg.find_command,
	})
end

--
-- PreviewImg:
-- -----------
--
-- preview media
--
local function PreviewImg(_)
	vim.cmd("normal yi)")
	local fname = vim.fn.getreg('"0')

	-- check if fname exists anywhere
	local fexists = file_exists(M.Cfg.home .. "/" .. fname)

	if fexists == true then
		find_files_sorted({
			prompt_title = "Preview image/media",
			cwd = M.Cfg.home,
			default_text = fname,
			find_command = M.Cfg.find_command,
			filter_extensions = { ".png", ".jpg", ".bmp", ".gif", ".pdf", ".mp4", ".webm" },
			preview_type = "media",

			attach_mappings = function(prompt_bufnr, _)
				actions.select_default:replace(function()
					actions.close(prompt_bufnr)
				end)
				return true
			end,
		})
	else
		print("File not found: " .. M.Cfg.home .. "/" .. fname)
	end
end

--
-- FindFriends:
-- -----------
--
-- Find notes also linking to the link under cursor
--
local function FindFriends()
	vim.cmd("normal yi]")
	local title = vim.fn.getreg('"0')

	builtin.live_grep({
		prompt_title = "Notes referencing `" .. title .. "`",
		cwd = M.Cfg.home,
		default_text = "\\[\\[" .. title .. "\\]\\]",
		find_command = M.Cfg.find_command,
	})
end

--
-- YankLink:
-- -----------
--
-- Create and yank a [[link]] from the current note.
--
local function YankLink()
	local title = "[[" .. path_to_linkname(vim.fn.expand("%")) .. "]]"
	vim.fn.setreg('"', title)
	print("yanked " .. title)
end

--
-- GotoToday:
-- ----------
--
-- find today's daily note and create it if necessary.
--
local function GotoToday(opts)
	opts = opts or calenderinfo_today()
	local word = opts.date or os.date("%Y-%m-%d")

	local fname = M.Cfg.dailies .. "/" .. word .. M.Cfg.extension
	local fexists = file_exists(fname)
	if
		(fexists ~= true) and ((opts.follow_creates_nonexisting == true) or M.Cfg.follow_creates_nonexisting == true)
	then
		create_note_from_template(word, fname, M.note_type_templates.daily, opts)
	end

	find_files_sorted({
		prompt_title = "Goto day",
		cwd = M.Cfg.home,
		default_text = word,
		find_command = M.Cfg.find_command,
		attach_mappings = function(prompt_bufnr, _)
			actions.select_default:replace(function()
				actions.close(prompt_bufnr)

				-- open the new note
				if opts.calendar == true then
					vim.cmd("wincmd w")
				end
				vim.cmd("e " .. fname)
			end)
			return true
		end,
	})
end

--
-- FindNotes:
-- ----------
--
-- Select from notes
--
local function FindNotes(_)
	find_files_sorted({
		prompt_title = "Find notes by name",
		cwd = M.Cfg.home,
		find_command = M.Cfg.find_command,
	})
end

--
-- InsertImgLink:
-- --------------
--
-- Insert link to image / media, with optional preview
--
local function InsertImgLink(opts)
	opts = opts or {}
	find_files_sorted({
		prompt_title = "Find image/media",
		cwd = M.Cfg.home,
		find_command = M.Cfg.find_command,
		filter_extensions = { ".png", ".jpg", ".bmp", ".gif", ".pdf", ".mp4", ".webm" },
		preview_type = "media",

		attach_mappings = function(prompt_bufnr, _)
			actions.select_default:replace(function()
				actions.close(prompt_bufnr)
				local selection = action_state.get_selected_entry()
				local fn = selection.value
				fn = fn:gsub(M.Cfg.home .. "/", "")
				vim.api.nvim_put({ "![](" .. fn .. ")" }, "", false, true)
				if opts.i then
					vim.api.nvim_feedkeys("A", "m", false)
				end
			end)
			return true
		end,
	})
end

--
-- SearchNotes:
-- ------------
--
-- find the file linked to by the word under the cursor
--
local function SearchNotes(_)
	builtin.live_grep({
		prompt_title = "Search in notes",
		cwd = M.Cfg.home,
		search_dirs = { M.Cfg.home },
		default_text = vim.fn.expand("<cword>"),
		find_command = M.Cfg.find_command,
	})
end

--
-- ShowBacklinks:
-- ------------
--
-- Find all notes linking to this one
--
local function ShowBacklinks(_)
	local title = path_to_linkname(vim.fn.expand("%"))
	-- or vim.api.nvim_buf_get_name(0)
	builtin.live_grep({
		results_title = "Backlinks to " .. title,
		prompt_title = "Search",
		cwd = M.Cfg.home,
		search_dirs = { M.Cfg.home },
		default_text = "\\[\\[" .. title .. "\\]\\]",
		find_command = M.Cfg.find_command,
	})
end

--
-- CreateNote:
-- ------------
--
-- Prompts for title and creates note with default template
--
local function on_create(title)
	if title == nil then
		return
	end

	local fname = M.Cfg.home .. "/" .. title .. M.Cfg.extension
	local fexists = file_exists(fname)
	if fexists ~= true then
		create_note_from_template(title, fname, M.note_type_templates.normal)
	end

	find_files_sorted({
		prompt_title = "Created note...",
		cwd = M.Cfg.home,
		default_text = title,
		find_command = M.Cfg.find_command,
	})
end

local function CreateNote(_)
	-- vim.ui.input causes ppl problems - see issue #4
	-- vim.ui.input({ prompt = "Title: " }, on_create)
	local title = vim.fn.input("Title: ")
	if #title > 0 then
		on_create(title)
	end
end

--
-- CreateNoteSelectTemplate()
-- --------------------------
--
-- Prompts for title, then pops up telescope for template selection,
-- creates the new note by template and opens it

local function on_create_with_template(title)
	if title == nil then
		return
	end

	local fname = M.Cfg.home .. "/" .. title .. M.Cfg.extension
	local fexists = file_exists(fname)
	if fexists == true then
		-- open the new note
		vim.cmd("e " .. fname)
		return
	end

	find_files_sorted({
		prompt_title = "Select template...",
		cwd = M.Cfg.templates,
		find_command = M.Cfg.find_command,
		attach_mappings = function(prompt_bufnr, _)
			actions.select_default:replace(function()
				actions.close(prompt_bufnr)
				-- local template = M.Cfg.templates .. "/" .. action_state.get_selected_entry().value
				local template = action_state.get_selected_entry().value
				create_note_from_template(title, fname, template)
				-- open the new note
				vim.cmd("e " .. fname)
			end)
			return true
		end,
	})
end

local function CreateNoteSelectTemplate(_)
	-- vim.ui.input causes ppl problems - see issue #4
	-- vim.ui.input({ prompt = "Title: " }, on_create_with_template)
	local title = vim.fn.input("Title: ")
	if #title > 0 then
		on_create_with_template(title)
	end
end

--
-- GotoThisWeek:
-- -------------
--
-- find this week's weekly note and create it if necessary.
--
local function GotoThisWeek(opts)
	opts = opts or {}

	local title = os.date("%Y-W%V")
	local fname = M.Cfg.weeklies .. "/" .. title .. M.Cfg.extension
	local fexists = file_exists(fname)
	if
		(fexists ~= true)
		and ((opts.weeklies_create_nonexisting == true) or M.Cfg.weeklies_create_nonexisting == true)
	then
		create_note_from_template(title, fname, M.note_type_templates.weekly)
	end

	find_files_sorted({
		prompt_title = "Goto this week:",
		cwd = M.Cfg.weeklies,
		default_text = title,
		find_command = M.Cfg.find_command,
	})
end

--
-- Calendar Stuff
-- --------------

-- return if a daily 'note exists' indicator (sign) should be displayed for a particular day
local function CalendarSignDay(day, month, year)
	local fn = M.Cfg.dailies .. "/" .. string.format("%04d-%02d-%02d", year, month, day) .. M.Cfg.extension
	if file_exists(fn) then
		return 1
	end
	return 0
end

-- action on enter on a specific day:
-- preview in telescope, stay in calendar on cancel, open note in other window on accept
local function CalendarAction(day, month, year, weekday, _)
	local today = string.format("%04d-%02d-%02d", year, month, day)
	local opts = {}
	opts.date = today
	opts.hdate = daymap[weekday] .. ", " .. monthmap[tonumber(month)] .. " " .. day .. daysuffix(day) .. ", " .. year
	opts.week = "n/a" -- TODO: calculate the week somehow
	opts.month = month
	opts.year = year
	opts.day = day
	opts.calendar = true
	GotoToday(opts)
end

local function ShowCalendar(opts)
	local defaults = {}
	defaults.cmd = "CalendarVR"
	defaults.vertical_resize = 1

	opts = opts or defaults
	vim.cmd(opts.cmd)
	if opts.vertical_resize then
		vim.cmd("vertical resize +" .. opts.vertical_resize)
	end
end

-- set up calendar integration: forward to our lua functions
local function SetupCalendar(opts)
	local defaults = M.Cfg.calendar_opts
	opts = opts or defaults

	local cmd = [[
        function! MyCalSign(day, month, year)
            return luaeval('require("telekasten").CalendarSignDay(_A[1], _A[2], _A[3])', [a:day, a:month, a:year])
        endfunction

        function! MyCalAction(day, month, year, weekday, dir)
            " day : day
            " month : month
            " year year
            " weekday : day of week (monday=1)
            " dir : direction of calendar
            return luaeval('require("telekasten").CalendarAction(_A[1], _A[2], _A[3], _A[4], _A[5])',
                                                                 \ [a:day, a:month, a:year, a:weekday, a:dir])
        endfunction

        function! MyCalBegin()
            " too early, windown doesn't exist yet
            " cannot resize
        endfunction

        let g:calendar_sign = 'MyCalSign'
        let g:calendar_action = 'MyCalAction'
        " let g:calendar_begin = 'MyCalBegin'

        let g:calendar_monday = {{calendar_monday}}
        let g:calendar_mark = '{{calendar_mark}}'
        let g:calendar_weeknm = {{weeknm}}
    ]]

	for k, v in pairs(opts) do
		cmd = cmd:gsub("{{" .. k .. "}}", v)
	end
	vim.cmd(cmd)
end

local function ToggleTodo(opts)
	-- replace
	--       by -
	-- -     by - [ ]
	-- - [ ] by - [x]
	-- - [x] by -
	-- enter insert mode if opts.i == true
	opts = opts or {}
	local linenr = vim.api.nvim_win_get_cursor(0)[1]
	local curline = vim.api.nvim_buf_get_lines(0, linenr - 1, linenr, false)[1]
	local stripped = vim.trim(curline)
	local repline
	if vim.startswith(stripped, "- ") and not vim.startswith(stripped, "- [") then
		repline = curline:gsub("- ", "- [ ] ", 1)
	else
		if vim.startswith(stripped, "- [ ]") then
			repline = curline:gsub("- %[ %]", "- [x]", 1)
		else
			if vim.startswith(stripped, "- [x]") then
				repline = curline:gsub("- %[x%]", "-", 1)
			else
				repline = curline:gsub("(%S)", "- [ ] %1", 1)
			end
		end
	end
	vim.api.nvim_buf_set_lines(0, linenr - 1, linenr, false, { repline })
	if opts.i then
		vim.api.nvim_feedkeys("A", "m", false)
	end
end

-- Setup(cfg)
--
-- Overrides config with elements from cfg. See top of file for defaults.
--
local function Setup(cfg)
	cfg = cfg or {}
	local debug = cfg.debug
	for k, v in pairs(cfg) do
		-- merge everything but calendar opts
		-- they will be merged later
		if k ~= "calendar_opts" then
			M.Cfg[k] = v
			if debug then
				print("Setup() setting `" .. k .. "`   ->   `" .. tostring(v) .. "`")
			end
		end
	end

	-- TODO: this is obsolete:
	if vim.fn.executable("rg") == 1 then
		M.Cfg.find_command = { "rg", "--files", "--sortr", "created" }
	else
		M.Cfg.find_command = nil
	end

	-- refresh templates
	M.note_type_templates = {
		normal = M.Cfg.template_new_note,
		daily = M.Cfg.template_new_daily,
		weekly = M.Cfg.template_new_weekly,
	}

	-- this looks a little messy
	if M.Cfg.plug_into_calendar then
		cfg.calendar_opts = cfg.calendar_opts or {}
		M.Cfg.calendar_opts = M.Cfg.calendar_opts or {}
		M.Cfg.calendar_opts.weeknm = cfg.calendar_opts.weeknm or M.Cfg.calendar_opts.weeknm or 1
		M.Cfg.calendar_opts.calendar_monday = cfg.calendar_opts.calendar_monday
			or M.Cfg.calendar_opts.calendar_monday
			or 1
		M.Cfg.calendar_opts.calendar_mark = cfg.calendar_opts.calendar_mark
			or M.Cfg.calendar_opts.calendar_mark
			or "left-fit"
		SetupCalendar(M.Cfg.calendar_opts)
	end

	-- setup extensions to filter for
	M.Cfg.filter_extensions = cfg.filter_extensions or { M.Cfg.extension }

	if debug then
		print("Resulting config:")
		print("-----------------")
		print(vim.inspect(M.Cfg))
	end
end

M.find_notes = FindNotes
M.find_daily_notes = FindDailyNotes
M.search_notes = SearchNotes
M.insert_link = InsertLink
M.follow_link = FollowLink
M.setup = Setup
M.goto_today = GotoToday
M.new_note = CreateNote
M.goto_thisweek = GotoThisWeek
M.find_weekly_notes = FindWeeklyNotes
M.yank_notelink = YankLink
M.create_note_sel_template = CreateNoteSelectTemplate -- documented wrongly, let's keep it for the moment
M.new_templated_note = CreateNoteSelectTemplate
M.show_calendar = ShowCalendar
M.CalendarSignDay = CalendarSignDay
M.CalendarAction = CalendarAction
M.paste_img_and_link = imgFromClipboard
M.toggle_todo = ToggleTodo
M.show_backlinks = ShowBacklinks
M.find_friends = FindFriends
M.insert_img_link = InsertImgLink
M.preview_img = PreviewImg

return M