From eb68b8bb952f4f09882c4974287f2299755dce99 Mon Sep 17 00:00:00 2001 From: JuanZoran <1430359574@qq.com> Date: Mon, 24 Jul 2023 22:28:09 +0800 Subject: [PATCH] refactor: rewrite setup and conf module --- lua/Trans/backend/baidu.lua | 42 +++----- lua/Trans/backend/youdao.lua | 41 ++++++-- lua/Trans/core/animation.lua | 8 ++ lua/Trans/core/backend.lua | 66 +++++------- lua/Trans/core/conf.lua | 168 ------------------------------ lua/Trans/core/frontend.lua | 39 +++++-- lua/Trans/core/helper.lua | 19 ++++ lua/Trans/core/loader.lua | 6 -- lua/Trans/core/setup.lua | 71 ++++++------- lua/Trans/core/util.lua | 1 - lua/Trans/frontend/float.lua | 31 ++++++ lua/Trans/frontend/hover/init.lua | 70 ++++++++++++- lua/Trans/init.lua | 21 ++-- 13 files changed, 267 insertions(+), 316 deletions(-) create mode 100644 lua/Trans/core/animation.lua delete mode 100644 lua/Trans/core/conf.lua create mode 100644 lua/Trans/core/helper.lua delete mode 100644 lua/Trans/core/loader.lua diff --git a/lua/Trans/backend/baidu.lua b/lua/Trans/backend/baidu.lua index 3980b21..1ca8281 100644 --- a/lua/Trans/backend/baidu.lua +++ b/lua/Trans/backend/baidu.lua @@ -1,15 +1,11 @@ ----@class Baidu: TransOnlineBackend ----@field uri string api uri ----@field salt string ----@field app_id string ----@field app_passwd string ----@field disable boolean +---@class Baidu: TransBackendOnline +---@field conf { app_id: string, app_passwd: string } local M = { - uri = 'https://fanyi-api.baidu.com/api/trans/vip/translate', - salt = tostring(math.random(bit.lshift(1, 15))), - name = 'baidu', - name_zh = '百度', - method = 'get', + name = 'baidu', + display_text = '百度', + uri = 'https://fanyi-api.baidu.com/api/trans/vip/translate', + salt = tostring(math.random(bit.lshift(1, 15))), + method = 'get', } local Trans = require 'Trans' @@ -25,26 +21,28 @@ local Trans = require 'Trans' ---Get content for query ---@param data TransData ---@return BaiduQuery -local function get_query(data) - local tmp = M.app_id .. data.str .. M.salt .. M.app_passwd +function M.get_query(data) + local m_conf = M.conf + assert(m_conf, 'Load Baidu config failed') + + local tmp = m_conf.app_id .. data.str .. M.salt .. m_conf.app_passwd local sign = Trans.util.md5.sumhexa(tmp) return { q = data.str, from = data.from, to = data.to, - appid = M.app_id, + appid = m_conf.app_id, salt = M.salt, sign = sign, } end - ---@overload fun(body: table, data:TransData): TransResult ---Query Using Baidu API ---@param body table BaiduQuery Response ---@return table|false -local function formatter(body, data) +function M.formatter(body, data) local result = body.trans_result if not result then return false end @@ -57,17 +55,7 @@ local function formatter(body, data) } end - ----@class TransBackendCore ----@field baidu Baidu -return { - name = 'baidu', - display_text = '百度', - uri = 'https://fanyi-api.baidu.com/api/trans/vip/translate', - method = 'get', - get_query = get_query, - formatter = formatter, -} +return M diff --git a/lua/Trans/backend/youdao.lua b/lua/Trans/backend/youdao.lua index 81f0d12..5d5a9f7 100644 --- a/lua/Trans/backend/youdao.lua +++ b/lua/Trans/backend/youdao.lua @@ -1,15 +1,14 @@ ----@class Youdao: TransOnlineBackend +---@class Youdao: TransBackendOnline ---@field uri string api uri ---@field salt string ----@field app_id string ----@field app_passwd string ---@field disable boolean +---@field conf { app_id: string, app_passwd: string } local M = { - uri = 'https://openapi.youdao.com/api', - salt = tostring(math.random(bit.lshift(1, 15))), - name = 'youdao', - name_zh = '有道', - method = 'get', + uri = 'https://openapi.youdao.com/api', + name = 'youdao', + display_text = '有道', + method = 'get', + salt = tostring(math.random(bit.lshift(1, 15))), } ---@class YoudaoQuery @@ -26,7 +25,7 @@ local M = { ---@return YoudaoQuery function M.get_query(data) local str = data.str - local app_id = M.app_id + local m_conf = M.conf local salt = M.salt local curtime = tostring(os.time()) @@ -38,7 +37,7 @@ function M.get_query(data) -- sign=sha256(应用ID+input+salt+curtime+应用密钥)； 一二三四五六七八九十 - local hash = app_id .. input .. salt .. curtime .. M.app_passwd + local hash = m_conf.app_id .. input .. salt .. curtime .. m_conf.app_passwd local sign = vim.fn.sha256(hash) @@ -47,7 +46,7 @@ function M.get_query(data) to = data.from == 'zh' and 'en' or 'zh-CHS', from = 'auto', signType = 'v3', - appKey = app_id, + appKey = m_conf.app_id, salt = M.salt, curtime = curtime, sign = sign, @@ -160,6 +159,26 @@ end ---@class TransBackend ---@field youdao Youdao return M + + + + + + + + + + + + + + + + + + + + -- INFO :Query Result Example -- { diff --git a/lua/Trans/core/animation.lua b/lua/Trans/core/animation.lua new file mode 100644 index 0000000..2da293d --- /dev/null +++ b/lua/Trans/core/animation.lua @@ -0,0 +1,8 @@ +local Trans = require'Trans' + +---@class Trans +local M = {} + + + +return M diff --git a/lua/Trans/core/backend.lua b/lua/Trans/core/backend.lua index 922146c..1074539 100644 --- a/lua/Trans/core/backend.lua +++ b/lua/Trans/core/backend.lua @@ -10,9 +10,11 @@ local Trans = require 'Trans' ---@class TransBackendOnline: TransBackend ---@field uri string @request uri ---@field method 'get' | 'post' @request method ----@field formatter fun(body: table, data: TransData): TransResult|false|nil @formatter +---@field formatter fun(body: table, data: TransData): TransResult|false|nil transform response body to TransResult ---@field get_query fun(data: TransData): table @get query table +---@field error_message? fun(errorCode) @get error message +-- -@field header table|fun(data: TransData): table @request header ---@class TransBackendOffline: TransBackend @@ -22,56 +24,41 @@ local Trans = require 'Trans' ---@class TransBackendCore local M = { - ---@type table + ---@type table backendname -> backend source sources = {}, } local m_util = {} -- INFO :Template method for online query --- ---@param data TransData @data --- ---@param backend TransOnlineBackend @backend --- function M.do_query(data, backend) --- local name = backend.name --- local uri = backend.uri --- local method = backend.method --- local formatter = backend.formatter --- local query = backend.get_query(data) --- local header = type(backend.header) == 'function' and backend.header(data) or backend.header - --- local function handle(output) --- local status, body = pcall(vim.json.decode, output.body) --- if not status or not body then --- if not Trans.conf.debug then --- backend.debug(body) --- data.trace[name] = output --- end - --- data.result[name] = false --- return --- end - --- data.result[name] = formatter(body, data) --- end - --- Trans.curl[method](uri, { --- query = query, --- callback = handle, --- header = header, --- }) --- -- Hook ? --- end - - +---@param data TransData @data +---@param backend TransBackendOnline @backend +function M.do_query(data, backend) + local name = backend.name + local formatter = backend.formatter + -- local header = type(backend.header) == 'function' and backend.header(data) or backend.header + local function handle(output) + local status, body = pcall(vim.json.decode, output.body) + if not status or not body then + data.result[name] = false + return + end + data.result[name] = formatter(body, data) + end + Trans.curl[backend.method](backend.uri, { + query = backend.get_query(data), + callback = handle, + --- FIXME : + header = header, + }) +end -- TODO :Implement all of utility functions - - M.util = m_util -M.random_num = math.random(bit.lshift(1, 15)) + -- INFO :Parse configuration file local path = Trans.conf.dir .. '/Trans.json' @@ -82,6 +69,7 @@ if file then user_conf = vim.json.decode(content) or user_conf file:close() end + -- WARNING : [Breaking change] 'Trans.json' should use json object instead of array ---@class Trans diff --git a/lua/Trans/core/conf.lua b/lua/Trans/core/conf.lua deleted file mode 100644 index c92b5be..0000000 --- a/lua/Trans/core/conf.lua +++ /dev/null @@ -1,168 +0,0 @@ ----@class Trans ----@field conf TransConf - - ----@alias TransMode 'visual' 'input' - ----@class TransConf -return { - ---@type string the directory for database file and password file - dir = require 'Trans'.plugin_dir, - ---@type 'default' | 'dracula' | 'tokyonight' global Trans theme [@see lua/Trans/style/theme.lua] - theme = 'default', -- default | tokyonight | dracula - ---@type table fallback strategy for mode - strategy = { - default = { - frontend = 'hover', - backend = { - 'offline', - -- 'youdao', - -- 'baidu', - } - }, - -- input = { - -- visual = { - -- ... - }, - ---@type table frontend options - frontend = { - ---@class TransFrontendOpts - ---@field keymaps table - default = { - auto_play = true, - query = 'fallback', - border = 'rounded', - title = vim.fn.has 'nvim-0.9' == 1 and { - { '', 'TransTitleRound' }, - { ' Trans', 'TransTitle' }, - { '', 'TransTitleRound' }, - } or nil, -- need nvim-0.9+ - ---@type {open: string | boolean, close: string | boolean, interval: integer} Hover Window Animation - animation = { - open = 'slid', -- 'fold', 'slid' - close = 'slid', - interval = 12, - }, - timeout = 2000, - }, - ---@class TransHoverOpts : TransFrontendOpts - hover = { - ---@type integer Max Width of Hover Window - width = 37, - ---@type integer Max Height of Hover Window - height = 27, - ---@type string -- see: /lua/Trans/style/spinner - spinner = 'dots', - ---@type string - fallback_message = '{{notfound}} {{error_message}}', - auto_resize = true, - split_width = 60, - padding = 10, -- padding for hover window width - keymaps = { - -- pageup = '', - -- pagedown = '', - -- pin = '[', - -- close = ']', - -- toggle_entry = ';', - }, - ---@type string[] auto close events - auto_close_events = { - 'InsertEnter', - 'CursorMoved', - 'BufLeave', - }, - ---@type table order to display translate result - order = { - default = { - 'str', - 'translation', - 'definition', - }, - offline = { - 'title', - 'tag', - 'pos', - 'exchange', - 'translation', - 'definition', - }, - youdao = { - 'title', - 'translation', - 'definition', - 'web', - }, - }, - icon = { - -- or use emoji - list = '●', -- ● | ○ | ◉ | ◯ | ◇ | ◆ | ▪ | ▫ | ⬤ | 🟢 | 🟡 | 🟣 | 🟤 | 🟠| 🟦 | 🟨 | 🟧 | 🟥 | 🟪 | 🟫 | 🟩 | 🟦 - star = '', -- ⭐ | ✴ | ✳ | ✲ | ✱ | ✰ | ★ | ☆ | 🌟 | 🌠 | 🌙 | 🌛 | 🌜 | 🌟 | 🌠 | 🌌 | 🌙 | - notfound = ' ', --❔ | ❓ | ❗ | ❕| - yes = '✔', -- ✅ | ✔️ | ☑ - no = '', -- ❌ | ❎ | ✖ | ✘ | ✗ | - cell = '■', -- ■ | □ | ▇ | ▏ ▎ ▍ ▌ ▋ ▊ ▉ - web = '󰖟', --🌍 | 🌎 | 🌏 | 🌐 | - tag = '', - pos = '', - exchange = '', - definition = '󰗊', - translation = '󰊿', - }, - }, - }, - - - - -- debug = true, -} - - - - - - - - - - - - - - - - - - - - - - --- TODO : --- float = { --- width = 0.8, --- height = 0.8, --- border = 'rounded', --- keymap = { --- quit = 'q', --- }, --- animation = { --- open = 'fold', --- close = 'fold', --- interval = 10, --- }, --- tag = { --- wait = '#519aba', --- fail = '#e46876', --- success = '#10b981', --- }, --- }, - - --- local title = { --- "████████╗██████╗ █████╗ ███╗ ██╗███████╗", --- "╚══██╔══╝██╔══██╗██╔══██╗████╗ ██║██╔════╝", --- " ██║ ██████╔╝███████║██╔██╗ ██║███████╗", --- " ██║ ██╔══██╗██╔══██║██║╚██╗██║╚════██║", --- " ██║ ██║ ██║██║ ██║██║ ╚████║███████║", --- " ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═══╝╚══════╝", ---} diff --git a/lua/Trans/core/frontend.lua b/lua/Trans/core/frontend.lua index 5cd05d1..67f0a09 100644 --- a/lua/Trans/core/frontend.lua +++ b/lua/Trans/core/frontend.lua @@ -1,10 +1,33 @@ -local Trans = require 'Trans' -local frontend_opts = Trans.conf.frontend +local Trans = require 'Trans' + +---@class TransFrontendOpts +local default_frontend = { + auto_play = true, + query = 'fallback', + border = 'rounded', + title = vim.fn.has 'nvim-0.9' == 1 and { + { '', 'TransTitleRound' }, + { ' Trans', 'TransTitle' }, + { '', 'TransTitleRound' }, + } or nil, -- need nvim-0.9+ + ---@type {open: string | boolean, close: string | boolean, interval: integer} Window Animation + animation = { + open = 'slid', -- 'fold', 'slid' + close = 'slid', + interval = 12, + }, + timeout = 2000, -- only for online backend query +} + +if Trans.conf.frontend.default then + default_frontend = vim.tbl_extend('force', default_frontend, Trans.conf.frontend.default) +end + ---@class TransFrontend ----@field opts TransFrontendOpts +---@field opts? TransFrontendOpts options which user can set ---@field get_active_instance fun():TransFrontend? ----@field process fun(self: TransFrontend, data: TransData) +---@field process fun(self: TransFrontend, data: TransData) @render backend result ---@field wait fun(self: TransFrontend): fun(backend: TransBackend): boolean Update wait status ---@field execute fun(action: string) @Execute action for frontend instance ---@field fallback fun() @Fallback method when no result @@ -14,17 +37,17 @@ local frontend_opts = Trans.conf.frontend ---@field frontend TransFrontend return setmetatable({}, { __index = function(self, name) - local opts = vim.tbl_extend('keep', frontend_opts[name] or {}, frontend_opts.default) - ---@type TransFrontend local frontend = require('Trans.frontend.' .. name) - frontend.opts = opts - self[name] = frontend + frontend.opts = + vim.tbl_extend('force', frontend.opts or {}, default_frontend, Trans.conf.frontend[name]) if frontend.setup then frontend.setup() end + + rawset(self, name, frontend) return frontend end, }) diff --git a/lua/Trans/core/helper.lua b/lua/Trans/core/helper.lua new file mode 100644 index 0000000..519f506 --- /dev/null +++ b/lua/Trans/core/helper.lua @@ -0,0 +1,19 @@ +local fn, api = vim.fn, vim.api +local Trans = require 'Trans' + +---@class TransHelper for Trans module dev +local M = {} + + +---Get abs_path of file +---@param path string[] +---@param is_dir boolean? [default]: false +---@return string @Generated path +function M.relative_path(path, is_dir) + return Trans.plugin_dir .. table.concat(path, Trans.separator) .. (is_dir and Trans.separator or '') +end + + + + +return M diff --git a/lua/Trans/core/loader.lua b/lua/Trans/core/loader.lua deleted file mode 100644 index 63c99e3..0000000 --- a/lua/Trans/core/loader.lua +++ /dev/null @@ -1,6 +0,0 @@ -local M = {} - --- TODO : - - -return M diff --git a/lua/Trans/core/setup.lua b/lua/Trans/core/setup.lua index 10e7088..ff997f8 100644 --- a/lua/Trans/core/setup.lua +++ b/lua/Trans/core/setup.lua @@ -1,44 +1,31 @@ +---@class Trans local Trans = require 'Trans' --- local function set_strategy_opts(conf) --- local all_backends = conf.frontend.default.enabled_backend --- local g_strategy = conf.strategy +---@alias TransMode 'visual' 'input' +local default_strategy = { + frontend = 'hover', + backend = { + 'offline', + -- 'youdao', + -- 'baidu', + }, +} --- local function parse_backend(backend) --- if type(backend) == 'string' then --- return backend == '*' and all_backends or { backend } --- end +Trans.conf = { + ---@type string the directory for database file and password file + dir = require 'Trans'.plugin_dir, + ---@type 'default' | 'dracula' | 'tokyonight' global Trans theme [@see lua/Trans/style/theme.lua] + theme = 'default', + ---@type table fallback strategy for mode + -- input = { + -- visual = { + -- ... + strategy = vim.defaulttable(function() + return setmetatable({}, default_strategy) + end), + frontend = {}, +} --- return backend --- end - --- local default_strategy = g_strategy.default --- default_strategy.backend = parse_backend(default_strategy.backend) --- default_strategy.__index = default_strategy - --- g_strategy.default = nil - --- setmetatable(g_strategy, { --- __index = function() --- return default_strategy --- end, --- }) - --- for _, strategy in pairs(g_strategy) do --- strategy.backend = parse_backend(strategy.backend) --- setmetatable(strategy, default_strategy) --- end --- end - - - -local function define_highlights(conf) - local set_hl = vim.api.nvim_set_hl - local highlights = Trans.style.theme[conf.theme] - for hl, opt in pairs(highlights) do - set_hl(0, hl, opt) - end -end ---@class Trans @@ -48,8 +35,12 @@ return function(opts) Trans.conf = vim.tbl_deep_extend('force', Trans.conf, opts) end local conf = Trans.conf - conf.dir = vim.fn.expand(conf.dir) + conf.dir = vim.fn.expand(conf.dir) - -- set_strategy_opts(conf) - define_highlights(conf) + -- INFO : set highlight + local set_hl = vim.api.nvim_set_hl + local highlights = Trans.style.theme[conf.theme] + for hl, opt in pairs(highlights) do + set_hl(0, hl, opt) + end end diff --git a/lua/Trans/core/util.lua b/lua/Trans/core/util.lua index 134ff37..4d50638 100644 --- a/lua/Trans/core/util.lua +++ b/lua/Trans/core/util.lua @@ -3,7 +3,6 @@ local fn, api = vim.fn, vim.api ---@class TransUtil local M = require 'Trans'.metatable 'util' - ---Get selected text ---@return string function M.get_select() diff --git a/lua/Trans/frontend/float.lua b/lua/Trans/frontend/float.lua index e8f3a73..f91e7aa 100644 --- a/lua/Trans/frontend/float.lua +++ b/lua/Trans/frontend/float.lua @@ -121,3 +121,34 @@ return M -- iciba = 'iciba', -- offline = '本地', -- } + + +-- TODO : +-- float = { +-- width = 0.8, +-- height = 0.8, +-- border = 'rounded', +-- keymap = { +-- quit = 'q', +-- }, +-- animation = { +-- open = 'fold', +-- close = 'fold', +-- interval = 10, +-- }, +-- tag = { +-- wait = '#519aba', +-- fail = '#e46876', +-- success = '#10b981', +-- }, +-- }, + + +-- local title = { +-- "████████╗██████╗ █████╗ ███╗ ██╗███████╗", +-- "╚══██╔══╝██╔══██╗██╔══██╗████╗ ██║██╔════╝", +-- " ██║ ██████╔╝███████║██╔██╗ ██║███████╗", +-- " ██║ ██╔══██╗██╔══██║██║╚██╗██║╚════██║", +-- " ██║ ██║ ██║██║ ██║██║ ╚████║███████║", +-- " ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═══╝╚══════╝", +--} diff --git a/lua/Trans/frontend/hover/init.lua b/lua/Trans/frontend/hover/init.lua index 9e477ef..147796b 100644 --- a/lua/Trans/frontend/hover/init.lua +++ b/lua/Trans/frontend/hover/init.lua @@ -10,18 +10,82 @@ local util = Trans.util ---@field window TransWindow @hover window ---@field queue TransHover[] @hover queue for all hover instances ---@field destroy_funcs fun(hover:TransHover)[] @functions to be executed when hover window is closed ----@field opts TransHoverOpts @options for hover window +---@field opts TransHoverOpts @hover window options ---@field pin boolean @whether hover window is pinned local M = Trans.metatable('frontend.hover', { ns = vim.api.nvim_create_namespace 'TransHoverWin', queue = {}, + ---@class TransHoverOpts: TransFrontendOpts + opts = { + ---@type integer Max Width of Hover Window + width = 37, + ---@type integer Max Height of Hover Window + height = 27, + ---@type string -- see: /lua/Trans/style/spinner + spinner = 'dots', + ---@type string + fallback_message = '{{notfound}} {{error_message}}', + auto_resize = true, + split_width = 60, + padding = 10, -- padding for hover window width + keymaps = { + -- pageup = '', + -- pagedown = '', + -- pin = '[', + -- close = ']', + -- toggle_entry = ';', + }, + ---@type string[] auto close events + auto_close_events = { + 'InsertEnter', + 'CursorMoved', + 'BufLeave', + }, + ---@type table order to display translate result + order = { + default = { + 'str', + 'translation', + 'definition', + }, + offline = { + 'title', + 'tag', + 'pos', + 'exchange', + 'translation', + 'definition', + }, + youdao = { + 'title', + 'translation', + 'definition', + 'web', + }, + }, + icon = { + -- or use emoji + list = '●', -- ● | ○ | ◉ | ◯ | ◇ | ◆ | ▪ | ▫ | ⬤ | 🟢 | 🟡 | 🟣 | 🟤 | 🟠| 🟦 | 🟨 | 🟧 | 🟥 | 🟪 | 🟫 | 🟩 | 🟦 + star = '', -- ⭐ | ✴ | ✳ | ✲ | ✱ | ✰ | ★ | ☆ | 🌟 | 🌠 | 🌙 | 🌛 | 🌜 | 🌟 | 🌠 | 🌌 | 🌙 | + notfound = ' ', --❔ | ❓ | ❗ | ❕| + yes = '✔', -- ✅ | ✔️ | ☑ + no = '', -- ❌ | ❎ | ✖ | ✘ | ✗ | + cell = '■', -- ■ | □ | ▇ | ▏ ▎ ▍ ▌ ▋ ▊ ▉ + web = '󰖟', --🌍 | 🌎 | 🌏 | 🌐 | + tag = '', + pos = '', + exchange = '', + definition = '󰗊', + translation = '󰊿', + }, + }, }) M.__index = M + --[[ Set up function which will be invoked when this module is loaded - Because the options are not loaded yet when this module is loaded --]] function M.setup() @@ -146,7 +210,7 @@ function M:wait() local it = util.node.item return function(backend) cur = cur + 1 - buffer[1] = pr(backend.name_zh) + buffer[1] = pr(backend.display_text) buffer[2] = it { spinner[cur % size + 1] .. (cell):rep(cur), 'TransWaitting' } pause(interval) return cur < times diff --git a/lua/Trans/init.lua b/lua/Trans/init.lua index b051b23..0d9b678 100644 --- a/lua/Trans/init.lua +++ b/lua/Trans/init.lua @@ -5,8 +5,8 @@ local function metatable(folder_name, origin) return setmetatable(origin or {}, { __index = function(tbl, key) - local status, result = pcall(require, ('Trans.%s.%s'):format(folder_name, key)) - if status then + local found, result = pcall(require, ('Trans.%s.%s'):format(folder_name, key)) + if found then rawset(tbl, key, result) return result end @@ -18,6 +18,8 @@ end ---@class string ---@field width function @Get string display width ---@field play function @Use tts to play string + + local uname = vim.loop.os_uname().sysname local system = uname == 'Darwin' and 'mac' or @@ -26,7 +28,8 @@ local system = error 'Unknown System, Please Report Issue' -local sep = system == 'win' and '\\\\' or '/' +local separator = system == 'win' and '\\\\' or '/' + ---@class Trans ---@field style table @Style module ---@field cache table @Cache for translated data object @@ -38,20 +41,12 @@ local M = metatable('core', { cache = {}, style = metatable 'style', strategy = metatable 'strategy', - separator = sep, + separator = separator, system = system, - plugin_dir = debug.getinfo(1, 'S').source:sub(2):match('(.-)lua' .. sep .. 'Trans'), + plugin_dir = debug.getinfo(1, 'S').source:sub(2):match('(.-)lua' .. separator .. 'Trans'), }) - M.metatable = metatable ----Get abs_path of file ----@param path string[] ----@param is_dir boolean? ----@return string -function M.relative_path(path, is_dir) - return M.plugin_dir .. table.concat(path, sep) .. (is_dir and sep or '') -end return M