flexprompt_modules.lua

--------------------------------------------------------------------------------
-- Built in modules for flexprompt.

if ((clink and clink.version_encoded) or 0) < 10020010 then
    return
end

--------------------------------------------------------------------------------
-- Internals.

-- luacheck: no max line length
-- luacheck: globals console os
-- luacheck: globals flexprompt

if not flexprompt or not flexprompt.add_module or not settings.get("flexprompt.enable") then
    return
end

-- Is reset to {} at each onbeginedit.
local _cached_state = {}

local mod_brightcyan = { fg="96", bg="106", extfg="38;5;44", extbg="48;5;44" }
local mod_cyan = { fg="36", bg="46", extfg="38;5;6", extbg="48;5;6", lean=mod_brightcyan, classic=mod_brightcyan }
flexprompt.add_color("mod_cyan", mod_cyan)

local keymap_bright = { fg="94", bg="104", extfg="38;5;111", extbg="48;5;111" }
local keymap_color = { fg="34", bg="44", extfg="38;5;26", extbg="48;5;26", lean=keymap_bright, classic=keymap_bright }
flexprompt.add_color("keymap", keymap_color)

--------------------------------------------------------------------------------
-- Helpers.

-- Expects the colors arg to follow this scheme:
-- All elements are by index:
--  1 = token
--  2 = alttoken
--  3 = color
--  4 = altcolor
--  5 = extended color
--  6 = extended altcolor
local function parse_color_token(args, colors)
    local parsed_colors = flexprompt.parse_arg_token(args, colors[1], colors[2])
    local color = flexprompt.use_best_color(colors[3], colors[5] or colors[3])
    local altcolor = flexprompt.use_best_color(colors[4], colors[6] or colors[4])
    color, altcolor = flexprompt.parse_colors(parsed_colors, color, altcolor)
    return color, altcolor
end

--------------------------------------------------------------------------------
-- ADMIN MODULE:  {admin:always:forcetext:text_options:icon_options:color_options}
--  - 'always' shows the module even when not running as an Administrator.
--  - 'forcetext' shows text even if an icon is shown.
--  - 'admintext=abc' sets admin mode text to 'abc' ('admintext=' for none).
--  - 'normaltext=xyz' sets normal mode text to 'xyz' ('normaltext=' for none).
--  - 'adminicon=X' sets the admin mode icon to 'X'.
--  - 'normalicon=Y' sets the normal mode icon to 'Y'.
--  - color_options override status colors as follows:
--      - normal=color_name,alt_color_name      When not running as an Administrator.
--      - admin=color_name,alt_color_name       When running as an Administrator.
--
-- By default, it uses just an icon if icons are enabled and the font supports
-- powerline characters.
--
-- NOTES:
--  - The ADMIN module requires at least Clink v1.4.17 or higher.
--  - The admintext and normaltext options currently don't support text that
--    contains a colon character ':'.

local admin_color_list =
{
    default = {
        -- NOTE:  Weird...  Using "38;2;0;102;0" here makes Windows Terminal
        -- fail to draw color emoji later on in the prompt line.  And yet it
        -- doesn't cause a problem when the style is "rainbow".
        no_admin    = { "n", "normal",  "green",     nil,            "38;5;28",      nil },
        admin       = { "a", "admin",   "brightred", nil,            "38;5;203",     nil },
    },
    rainbow = {
        no_admin    = { "n", "normal",  "green",     "white",        "38;2;0;48;12", "38;5;252" },
        admin       = { "a", "admin",   "red",       "brightyellow", "38;2;64;0;0",  "38;5;203" },
    },
}

local admin_text_list =
{
    no_admin    = "normal",
    admin       = "ADMIN",
}

local function render_admin(args)
    local is_admin = _cached_state.is_admin or os.isuseradmin()
    local mode = is_admin and "admin" or "no_admin"

    if not is_admin then
        local always = flexprompt.parse_arg_keyword(args, "always")
        if not always then
            return
        end
    end

    local forcetext = flexprompt.parse_arg_keyword(args, "forcetext")
    local colorlist = admin_color_list[flexprompt.get_style()] or admin_color_list.default
    local colors = colorlist[mode]

    local fallbacksymbol
    local icon = flexprompt.parse_arg_token(args, is_admin and "ai" or "ni", is_admin and "adminicon" or "normalicon") or ""
    if icon == "" then
        icon = flexprompt.get_symbol(mode) or ""
        fallbacksymbol = true
    end

    local text = ""
    if forcetext or icon == "" then
        text = flexprompt.parse_arg_token(args, is_admin and "at" or "nt", is_admin and "admintext" or "normaltext") or ""
        if text == "" then
            text = admin_text_list[mode]
        end
    end

    if text ~= "" and fallbacksymbol then
        icon = flexprompt.get_icon(mode) or ""
    end

    text = flexprompt.append_text(icon, text)

    local color, altcolor = parse_color_token(args, colors)
    return text, color, altcolor
end

local admin_registered_oninputlinechanged

local function admin_onbeginedit()
    -- Optimization to minimize processing while typing.
    _cached_state.has_admin_module = flexprompt.is_module_in_prompt("admin")
    if not admin_registered_oninputlinechanged and _cached_state.has_admin_module then
        if clink.oninputlinechanged then
            local function oninputlinechanged(line)
                if _cached_state.has_admin_module then
                    local is_admin
                    for _,entry in ipairs(clink.parseline(line)) do
                        local line_state = entry.line_state
                        local cwi = line_state:getcommandwordindex()
                        local cw = cwi and line_state:getword(cwi)
                        if cw == "sudo" or cw == "gsudo" then
                            is_admin = true
                            break
                        end
                    end
                    if is_admin ~= _cached_state.is_admin then
                        _cached_state.is_admin = is_admin
                        flexprompt.refilter_module("admin")
                        clink.refilterprompt()
                    end
                end
            end

            admin_registered_oninputlinechanged = true
            clink.oninputlinechanged(oninputlinechanged)
        end
    end
end

--------------------------------------------------------------------------------
-- ANYCONNECT MODULE:  {anyconnect:novars:forcetext:text=conn,noconn,unknown:color_options}
--
-- Shows whether Cisco AnyConnect VPN is currently connected as well as the
-- relationship to the HTTP_PROXY and HTTPS_PROXY environment variables.
--
-- The module shows a VPN connected or disconnected icon.  The color is chosen
-- depending on the connection status and proxy environment variables (see below
-- for details).
--
--  - 'novars' omits checking the environment variables.
--  - 'forcetext' forces show connection status text even when icons are
--    enabled.  The 'text=' argument can override what text is used.
--  - 'text=conn,noconn,unknown' overrides the text for the connection status,
--    which is shown when icons are disabled.
--      - conn = Text to show when connected (default "Connected").
--      - noconn = Text to show when disconnected (default "Disconnected").
--      - unknown = Text to show when unknown or error (default "AnyConnect").
--  - color_options override status colors as follows:
--      - connected=color_name,alt_color_name       When connected and env vars are set.
--      - disconnected=color_name,alt_color_name    When disconnected and env vars are not set.
--      - partial=color_name,alt_color_name         When one env var is set, and one env var is not.
--      - mismatch=color_name,alt_color_name        When connected but env vars are not set, or disconnected but env vars are set.
--      - unknown=color_name,alt_color_name         When connection status is unknown yet.

local anyconnect_cached_info = {}

local anyconnect_colors =
{
    connected       = { "c",   "connected",     fg="94",    bg="104",   extfg="38;5;12",    extbg="48;5;12",    },
    disconnected    = { "d",   "disconnected",  fg="92",    bg="102",   extfg="38;5;2",     extbg="48;5;2",     },
    mismatch        = { "m",   "mismatch",      fg="91",    bg="101",   extfg="38;5;9",     extbg="48;5;9",     },
    partial         = { "p",   "partial",       fg="93",    bg="103",   extfg="38;5;11",    extbg="48;5;11",    },
    unknown         = { "u",   "unknown",       fg="37",    bg="47",    extfg="38;5;7",     extbg="48;5;7",     },
}

local function parse_inline_color(args, colors)
    local parsed_colors = flexprompt.parse_arg_token(args, colors[1], colors[2])
    local color = flexprompt.use_best_color(colors.fg, colors.extfg or colors.fg)
    local altcolor = flexprompt.use_best_color(colors.bg, colors.extbg or colors.bg)
    return flexprompt.parse_colors(parsed_colors, color, altcolor)
end

-- Collects connection info.
--
-- Uses async coroutine calls.
local function collect_anyconnect_info()
    -- We may want to let the user provide a command to run
    -- but then how do we parse the output ?
    -- they could give us the pattern to search for as well
    local file, pclose = flexprompt.popenyield("vpncli state 2>nul")
    if not file then return end

    local conns = {}
    for line in file:lines() do
        -- Strip the lines of any whitespaces
        line = line:match( "^%s*(.-)%s*$" )
        -- If we have something left add it
        if line ~= "" and #line > 0 then
          table.insert(conns, line)
        end
    end

    local ok, msg, code -- luacheck: no unused
    if type(pclose) == "function" then
        ok, msg, code = pclose()
        ok = ok and #conns > 0
    else
        file:close()
        ok = #conns > 0
    end
    if not ok then
        return { failed=true, finished=true }
    end

    -- Check all entries for a given string.  It's better to search for
    -- Disconnected, since connected is present in both.
    --
    -- TODO: Apparently Cisco AnyConnect vpncli.exe doesn't have a way to show
    -- what you are connected to??
    local connected = false
    for _,candidate in ipairs(conns) do
        -- VPN messages we care about have state in the string, e.g.:
        --  >> state: Disconnected
        --  >> state: Disconnected
        --  >> state: Disconnected
        --  >> notice: Ready to connect.
        if candidate and #candidate > 0 and candidate:find("state") and
                not candidate:find("Disconnected") and not candidate:find("Unknown") then
            -- If at least one "state" line doesn't say "Disconnected" or
            -- "Unknown", then consider it to be connected.
            connected = true
        end
    end

    local tmp = os.getenv("HTTP_PROXY")
    local proxy = tmp and #tmp > 0
    tmp = os.getenv("HTTPS_PROXY")
    local proxys = tmp and #tmp > 0

    -- Save connection status as well as information about the HTTP_PROXY and
    -- HTTPS_PROXY env variables (if defined and filled in or not).
    return { connection=connected, proxy=proxy, proxys=proxys, finished=true }
end

local function render_anyconnect(args)
    local info
    local refreshing
    local wizard = flexprompt.get_wizard_state()

    if wizard then
        info = { connection=false, proxy=true, proxys=false, finished=true }
    else
        -- Get connection status.
        info, refreshing = flexprompt.prompt_info(anyconnect_cached_info, nil, nil, collect_anyconnect_info)
    end

    -- Decide on the colors based on the VPN connection state and proxy env vars
    -- One bad state env variable results in yellow, both result in red
    -- Green for no vpn and no proxy defined, blue for vpn and both proxies defined
    local color, altcolor
    local novars = flexprompt.parse_arg_keyword(args, "n", "novars")
    if not info.finished or info.failed then
        color, altcolor = parse_inline_color(args, anyconnect_colors.unknown)
    elseif info.connection then
        if novars or (info.proxy and info.proxys) then
            -- Connected and both vars = CONNECTED (blue).
            color, altcolor = parse_inline_color(args, anyconnect_colors.connected)
        elseif not info.proxy and not info.proxys then
            -- Connected and neither vars = MISMATCHED (red).
            color, altcolor = parse_inline_color(args, anyconnect_colors.mismatch)
        else
            -- Connected and one var = PARTIAL (yellow).
            color, altcolor = parse_inline_color(args, anyconnect_colors.partial)
        end
    else
        if novars or (not info.proxy and not info.proxys) then
            -- Disconnected and neither vars = DISCONNECTED (green).
            color, altcolor = parse_inline_color(args, anyconnect_colors.disconnected)
        elseif info.proxy and info.proxys then
            -- Disconnected and both vars = MISMATCH (red).
            color, altcolor = parse_inline_color(args, anyconnect_colors.mismatch)
        else
            -- Disconnected and one var = PARTIAL (yellow).
            color, altcolor = parse_inline_color(args, anyconnect_colors.partial)
        end
    end

    local icon = refreshing and flexprompt.get_icon("refresh") or nil
    if not icon then
        icon = flexprompt.get_icon(info.connection and "vpn" or "no_vpn")
        if icon == "" then
            icon = nil
        end
    end

    local text
    if not icon or flexprompt.parse_arg_keyword(args, "f", "forcetext") then
        local strings = string.explode(flexprompt.parse_arg_token(args, "t", "text") or "", ",;")
        if not info.finished or info.failed then
            text = strings[3] or "AnyConnect"
        elseif info.connection then
            text = strings[1] or "Connected"
        else
            text = strings[2] or "Disconnected"
        end
    end

    text = flexprompt.append_text(icon, text)

    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- BATTERY MODULE:  {battery:show=show_level:breakleft:breakright:levelicon:onlyicon}
--  - show_level shows the battery module unless the battery level is greater
--    than show_level.
--  - 'breakleft' adds an empty segment to left of battery in rainbow style.
--  - 'breakright' adds an empty segment to right of battery in rainbow style.
--  - 'levelicon' shows the battery level inside the icon.
--  - 'onlyicon' shows only an icon.
--
-- The 'breakleft' and 'breakright' options may look better than having battery
-- segment colors adjacent to other similarly colored segments in rainbow style.

local rainbow_battery_colors =
{
    {
        fg = "38;2;239;65;54",
        bg = "48;2;239;65;54"
    },
    {
        fg = "38;2;252;176;64",
        bg = "48;2;252;176;64"
    },
    {
        fg = "38;2;248;237;50",
        bg = "48;2;248;237;50"
    },
    {
        fg = "38;2;142;198;64",
        bg = "48;2;142;198;64"
    },
    {
        fg = "38;2;1;148;68",
        bg = "48;2;1;148;68"
    }
}

local battery_icon_series =
{
    [true] =    -- Charging.
    {
        nerdfonts2 = { "","","","","","","" },
        nerdfonts3 = { "󰢟","󰢜","󰂆","󰂇","󰂈","󰢝","󰂉","󰢞","󰂊","󰂋","󰂅" },
    },
    [false] =   -- Not charging.
    {
        nerdfonts2 = { "","","","","","","","","","","" },
        nerdfonts3 = { "󰂎","󰁺","󰁻","󰁼","󰁽","󰁾","󰁿","󰂀","󰂁","󰂂","󰁹" },
    },
}

local function get_battery_status(levelicon, onlyicon)
    local level, acpower, charging
    local wizard = flexprompt.get_wizard_state()

    local status = wizard and wizard.battery or os.getbatterystatus()
    level = status.level
    acpower = status.acpower
    charging = status.charging

    if not level or level < 0 then
        return "", 0
    end

    local batt_symbol
    if charging then
        batt_symbol = flexprompt.get_symbol("charging")
    elseif acpower then
        batt_symbol = flexprompt.get_symbol("smartcharging")
    end
    if not batt_symbol or batt_symbol == "" then
        batt_symbol = flexprompt.get_symbol("battery")
    end

    if levelicon then
        local series = battery_icon_series[charging]
        if series then
            series = series[flexprompt.get_nerdfonts_version()]
            if series then
                batt_symbol = series[math.floor(level * (#series - 1) / 100) + 1]
                if flexprompt.get_nerdfonts_width() == 2 then
                    batt_symbol = batt_symbol .. " "
                end
            end
        end
    end

    if not onlyicon then
        batt_symbol = level..batt_symbol
    end

    return batt_symbol, level
end

local function get_battery_status_color(level)
    if flexprompt.can_use_extended_colors() then
        local index = ((((level > 0) and level or 1) - 1) / 20) + 1
        index = math.modf(index)
        return rainbow_battery_colors[index], index == 1
    elseif level > 50 then
        return "green"
    elseif level > 30 then
        return "yellow"
    end
    return "red", true
end

local prev_battery_status, prev_battery_level
local function update_battery_prompt(levelicon, onlyicon)
    while true do
        local status,level = get_battery_status(levelicon, onlyicon)
        if prev_battery_status ~= status or prev_battery_level ~= level then
            flexprompt.refilter_module("battery")
            clink.refilterprompt()
        end
        coroutine.yield()
    end
end

local function render_battery(args)
    if not os.getbatterystatus then return end

    local show = tonumber(flexprompt.parse_arg_token(args, "s", "show") or "100")
    local onlyicon = flexprompt.parse_arg_keyword(args, "oi", "onlyicon")
    local levelicon = flexprompt.parse_arg_keyword(args, "li", "levelicon")
    local batteryStatus,level = get_battery_status(levelicon, onlyicon)
    prev_battery_status = batteryStatus
    prev_battery_level = level

    if clink.addcoroutine and flexprompt.settings.battery_idle_refresh ~= false and not _cached_state.battery_coroutine then
        local t = coroutine.create(function ()
            update_battery_prompt(levelicon, onlyicon)
        end)
        _cached_state.battery_coroutine = t
        clink.addcoroutine(t, flexprompt.settings.battery_refresh_interval or 15)
    end

    -- Hide when on AC power and fully charged, or when level is less than or
    -- equal to the specified 'show=level' ({battery:show=75} means "show at 75
    -- or lower").
    if not batteryStatus or batteryStatus == "" or level > (show or 80) then
        return
    end

    local style = flexprompt.get_style()

    -- The 'breakleft' and 'breakright' args add blank segments to force a color
    -- break between rainbow segments, in case adjacent colors are too similar.
    local bl, br
    if style == "rainbow" then
        bl = flexprompt.parse_arg_keyword(args, "bl", "breakleft")
        br = flexprompt.parse_arg_keyword(args, "br", "breakright")
    end

    local color, warning = get_battery_status_color(level)

    if warning and style == "classic" then
        -- batteryStatus = flexprompt.make_fluent_text(sgr(color.bg .. ";30") .. batteryStatus)
        -- The "22;" defeats the color parsing that would normally generate
        -- corresponding fg and bg colors even though only an explicit bg color
        -- was provided (versus a usual {fg=x,bg=y} color table).
        local c = flexprompt.lookup_color(color)
        color = "22;" .. c.bg .. ";30"
    end

    local segments = {}
    if bl then table.insert(segments, { "", "realblack" }) end
    table.insert(segments, { batteryStatus, color, "realblack" })
    if br then table.insert(segments, { "", "realblack" }) end

    return segments
end

--------------------------------------------------------------------------------
-- BREAK MODULE:  {break:color=color_name}
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--
-- Inserts a break between segments.  If there is no visible segment to the left
-- or right of the break, then the break is discarded.

local function render_break(args)
    local colors = flexprompt.parse_arg_token(args, "c", "color")
    local color = flexprompt.colors.default
    color = flexprompt.parse_colors(colors, color)
    return { "", color, isbreak=true }
end

--------------------------------------------------------------------------------
-- CONDA MODULE:  {conda:color=color_name,alt_color_name}
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.
--  - truncate is optional; if the conda environment is longer than this many
--    directory levels, only the rightmost names are kept (the default is 1,
--    and 0 means don't truncate).
--
-- Shows the current Conda environment, if %CONDA_DEFAULT_ENV% is set.

local function render_conda(args)
    local conda = os.getenv("CONDA_DEFAULT_ENV")
    if not conda or conda == "" then
        return
    end

    local colors = flexprompt.parse_arg_token(args, "c", "color")
    local color, altcolor
    local style = flexprompt.get_style()
    if style == "rainbow" then
        color = flexprompt.use_best_color("green", "38;5;40")
        altcolor = "realblack"
    elseif style == "classic" then
        color = flexprompt.use_best_color("green", "38;5;40")
    else
        color = flexprompt.use_best_color("green", "38;5;40")
    end
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor) -- luacheck: ignore 321

    local text = ""
    local truncate = flexprompt.parse_arg_token(args, "t", "truncate") or 1
    truncate = tonumber(truncate)
    if truncate > 0 then
        while truncate > 0 do
            truncate = truncate - 1
            local last = conda:match("([/\\][^/\\]+)$") or conda
            text = last .. text
            conda = conda:sub(1, #conda - #last)
        end
        text = text:gsub("^[/\\]+", "")
    else
        text = conda
    end

    text = "(" .. text .. ")"
    text = flexprompt.append_text(flexprompt.get_module_symbol(), text)

    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- CWD MODULE:  {cwd:color=color_name,alt_color_name:rootcolor=rootcolor_name:type=type_name:shorten}
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.
--  - rootcolor_name overrides the repo parent color when using "rootsmart".
--  - type_name is the format to use:
--      - "full" is the full path.
--      - "folder" is just the folder name.
--      - "smart" is the git repo\subdir, or the full path.
--      - "rootsmart" is the full path, with parent of git repo not colored.
--
-- The 'shorten' option can abbreviate parent directories to the shortest string
-- that uniquely identifies the directory.  The first and last directories in
-- the string are never abbreviated, and git repo or workspace directories are
-- never abbreviated.  Abbreviation occurs when the cwd string is longer than 80
-- columns (2 line style) or longer than half the terminal width (1 line style),
-- or when the terminal width is not wide enough for the left and right prompts
-- to fit on a single line.
-- The 'shorten' option may optionally be followed by "=rootsmart" to abbreviate
-- only the repo's parent directories when in a git repo (otherwise abbreviate
-- all the parent directories), or by "=32" or other number to only use
-- abbreviation when the path is longer than the specified number of columns.
--
-- The default type is "rootsmart" if not specified.

-- Returns the folder name of the specified directory.
--  - For c:\foo\bar it yields bar
--  - For c:\ it yields c:\
--  - For \\server\share\subdir it yields subdir
--  - For \\server\share it yields \\server\share
local function get_folder_name(dir)
    local parent, child = path.toparent(dir)
    return child == "" and parent or child
end

local function abbreviate_parents(dir, all)
    return flexprompt.abbrev_path(dir, true, all)
end

local function process_cwd_string(cwd, git_wks, args)
    local shorten = flexprompt.parse_arg_keyword(args, "s", "shorten") and "all"
    if not shorten then
        shorten = flexprompt.parse_arg_token(args, "s", "shorten")
        local threshold = tonumber(shorten)
        if threshold and threshold > 0 then
            shorten = threshold
        end
    end
    if not shorten then
        if flexprompt.get_lines() == 1 then
            shorten = console.getwidth() / 2
        else
            shorten = 80
        end
    end

    local real_git_dir -- luacheck: no unused

    local sym
    local ptype = flexprompt.parse_arg_token(args, "t", "type") or "rootsmart"
    if ptype == "folder" then
        return get_folder_name(cwd)
    end

    local tilde -- luacheck: no unused
    local orig_cwd = cwd
    cwd, tilde = flexprompt.maybe_apply_tilde(cwd)

    if ptype == "smart" or ptype == "rootsmart" then
        if git_wks == nil then -- Don't double-hunt for it!
            real_git_dir, git_wks = flexprompt.get_git_dir(orig_cwd)
        end

        if git_wks then
            -- Get the git workspace folder name and reappend any part
            -- of the directory that comes after.
            -- Ex: C:\Users\username\some-repo\innerdir -> some-repo\innerdir
            git_wks = flexprompt.maybe_apply_tilde(git_wks)
            local git_wks_parent = path.toparent(git_wks) -- Don't use get_parent() here!
            local appended_dir = string.sub(cwd, string.len(git_wks_parent) + 1)
            local smart_dir = get_folder_name(git_wks_parent) .. appended_dir
            if ptype == "rootsmart" then
                local rootcolor = flexprompt.parse_arg_token(args, "rc", "rootcolor")
                local parent = cwd:sub(1, #cwd - #smart_dir)
                if shorten and (type(shorten) ~= "number" or console.cellcount(cwd) > shorten) then
                    parent = abbreviate_parents(parent, true--[[all]])
                    if shorten ~= "smartroot" and shorten ~= "rootsmart" then
                        smart_dir = abbreviate_parents(smart_dir)
                    end
                    shorten = nil
                end
                cwd = flexprompt.make_fluent_text(parent, rootcolor or true) .. smart_dir
            else
                cwd = smart_dir
            end
            local tmp = flexprompt.get_icon("cwd_git_symbol")
            sym = (tmp ~= "") and tmp or nil
        end
    end

    if shorten and (type(shorten) ~= "number" or console.cellcount(cwd) > shorten) then
        cwd = abbreviate_parents(cwd)
        shorten = nil
    end

    return cwd, sym, not shorten
end

local function render_cwd(args)
    local colors = flexprompt.parse_arg_token(args, "c", "color")
    local color, altcolor
    local style = flexprompt.get_style()
    if style == "rainbow" then
        color = flexprompt.use_best_color("blue", "38;5;19")
    elseif style == "classic" then
        color = flexprompt.use_best_color("cyan", "38;5;39")
    else
        color = flexprompt.use_best_color("blue", "38;5;33")
    end
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor) -- luacheck: ignore 321

    local wizard = flexprompt.get_wizard_state()
    local cwd = wizard and wizard.cwd or os.getcwd()
    local git_wks = wizard and (wizard.git_dir or false)

    local text, sym, shortened = process_cwd_string(cwd, git_wks, args)
    sym = sym or flexprompt.get_module_symbol()

    text = flexprompt.append_text(flexprompt.get_dir_stack_depth(), text)
    text = flexprompt.append_text(sym, text)

    local results = {
        text=text,
        color=color,
        altcolor=altcolor,
    }

    if not shortened then
        results.condense_callback = function ()
            return {
                text=flexprompt.append_text(sym, flexprompt.abbrev_path(cwd, true)),
                color=color,
                altcolor=altcolor,
            }
        end
    end

    return results
end

--------------------------------------------------------------------------------
-- DISKSPACE MODULE:  {diskspace:when=threshold_percent:breakleft:breakright}
--  - threshold_percent is the percentage above which to show used disk space
--    (defaults to 0, which always shows the diskspace segment).
--  - 'breakleft' adds an empty segment to left of battery in rainbow style.
--  - 'breakright' adds an empty segment to right of battery in rainbow style.
--
-- The 'breakleft' and 'breakright' options may look better than having
-- diskspace segment colors adjacent to other similarly colored segments in
-- rainbow style.
--
-- This shows percentage of disk space used on the drive containing the current
-- working directory.
--
-- Requires Clink v1.8.5 or newer, otherwise the module does nothing.

local diskspace_used_colors =
{
    ["90"] = {
        fg = "38;2;239;65;54",
        bg = "48;2;239;65;54"
    },
    ["80"] = {
        fg = "38;2;252;176;64",
        bg = "48;2;252;176;64"
    },
    ["70"] = {
        fg = "38;2;248;237;50",
        bg = "48;2;248;237;50"
    },
    ["60"] = {
        fg = "38;2;142;198;64",
        bg = "48;2;142;198;64"
    },
    ["50"] = {
        fg = "38;2;1;148;68",
        bg = "48;2;1;148;68"
    },
}

local function render_diskspace(args)
    -- Get the disk free space details.
    local free, total
    if os.getdiskfreespace then
        free, total = os.getdiskfreespace()
    end
    if not free or not total or total == 0 or free > total then
        return
    end

    -- The 'when' arg overrides when to show the diskspace segment.
    local when = flexprompt.parse_arg_token(args, "w", "when") or "0"
    when = tonumber(when) / 100

    -- Show nothing if the used percentage is below the threshold.
    local used_percent = (total - free) / total
    if used_percent < when then
        return
    end

    -- Choose the color based on the used percentage.
    local color
    if used_percent > 0.9 then      color = diskspace_used_colors["90"]
    elseif used_percent > 0.8 then  color = diskspace_used_colors["80"]
    elseif used_percent > 0.7 then  color = diskspace_used_colors["70"]
    elseif used_percent > 0.6 then  color = diskspace_used_colors["60"]
    else                            color = diskspace_used_colors["50"]
    end

    -- Use the used disk space percentage as the text.
    local text
    used_percent = used_percent * 100
    used_percent = math.min(used_percent, 100)
    used_percent = math.max(used_percent, 0)
    text = string.format("%.1f%%", used_percent)

    -- Add icon or fluent text.
    local icon
    local flow = flexprompt.get_flow()
    if flow ~= "fluent" then
        icon = flexprompt.get_symbol("diskspace_module")
    end
    if icon == "" or flow == "fluent" then
        icon = flexprompt.make_fluent_text("disk used")
    end
    text = flexprompt.append_text(icon, text)

    -- The 'breakleft' and 'breakright' args add blank segments to force a color
    -- break between rainbow segments, in case adjacent colors are too similar.
    local bl, br
    local style = flexprompt.get_style()
    if style == "rainbow" then
        bl = flexprompt.parse_arg_keyword(args, "bl", "breakleft")
        br = flexprompt.parse_arg_keyword(args, "br", "breakright")
    end

    -- Return the segment(s).
    local segments = {}
    if bl then table.insert(segments, { "", "realblack" }) end
    table.insert(segments, { text, color, "realblack" })
    if br then table.insert(segments, { "", "realblack" }) end

    return segments
end

--------------------------------------------------------------------------------
-- DURATION MODULE:  {duration:format=format_name:tenths:color=color_name,alt_color_name}
--  - format_name is the format to use:
--      - "colons" is "H:M:S" format.
--      - "letters" is "Hh Mm Ss" format (the default).
--  - tenths includes tenths of seconds.
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.
--
-- Use the "luafunc:flexprompt_toggle_tenths" command to toggle displaying
-- tenths of seconds.  By default it is bound to Ctrl+Alt+T.

if rl.setbinding then
    if not rl.getbinding([["\e\C-T"]]) then
        rl.setbinding([["\e\C-T"]], [["luafunc:flexprompt_toggle_tenths"]])
    end
    if rl.describemacro then
        rl.describemacro([["luafunc:flexprompt_toggle_tenths"]], "Toggle displaying tenths of seconds for duration in the prompt")
    end
end

function flexprompt_toggle_tenths(rl_buffer) -- luacheck: no global, no unused
    local modules = flexprompt.get_duration_modules()
    if modules then
        flexprompt.settings.force_duration = true
        flexprompt.settings.duration_invert_tenths = not flexprompt.settings.duration_invert_tenths
        for module in pairs(modules) do
            flexprompt.refilter_module(module)
        end
        clink.refilterprompt()
    end
end

local function render_duration(args)
    local wizard = flexprompt.get_wizard_state()
    local duration = flexprompt.get_duration()
    if not flexprompt.settings.force_duration and duration < (flexprompt.settings.duration_threshold or 3) then return end

    local colors = flexprompt.parse_arg_token(args, "c", "color")
    local color, altcolor
    if flexprompt.get_style() == "rainbow" then
        color = flexprompt.use_best_color("yellow", "38;5;136")
        altcolor = "realblack"
    else
        color = flexprompt.use_best_color("darkyellow", "38;5;214")
    end
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor)

    local h, m, s
    local t = math.floor(duration * 10) % 10
    duration = math.floor(duration)
    s = (duration % 60)
    duration = math.floor(duration / 60)
    if duration > 0 then
        m = (duration % 60)
        duration = math.floor(duration / 60)
        if duration > 0 then
            h = duration
        end
    end

    local tenths = flexprompt.parse_arg_keyword(args, "t", "tenths")
    if wizard then
        tenths = wizard.duration_tenths
    elseif flexprompt.settings.invert_tenths then
        tenths = not tenths
    end

    local text
    local format = flexprompt.parse_arg_token(args, "f", "format")
    if format and format == "colons" then
        if h then
            text = string.format("%u:%02u:%02u", h, m, s)
        else
            text = string.format("%u:%02u", (m or 0), s)
        end
        if tenths then
            text = text .. "." .. t
        end
    else
        if tenths then
            s = s .. "." .. t
        end
        text = s .. "s"
        if m then
            text = flexprompt.append_text(m .. "m", text)
            if h then
                text = flexprompt.append_text(h .. "h", text)
            end
        end
    end

    if flexprompt.get_flow() == "fluent" then
        text = flexprompt.append_text(flexprompt.make_fluent_text("took"), text)
    end
    text = flexprompt.append_text(text, flexprompt.get_module_symbol())

    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- ENV MODULE:  {env:var=var_name,color=color_name,alt_color_name:label=label_text:fluent=fluent_text}
--  - var_name can be any environment variable name.
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.
--  - label_text is optional text to use as a label prefix before the
--    environment variable's value.
--  - fluent_text is optional text to use as a prefix when "fluent" mode is
--    enabled.

local function render_env(args)
    local name = flexprompt.parse_arg_token(args, "v", "var") or ""
    if name == "" then
        return
    end

    local text = os.getenv(name) or ""
    if text == "" then
        return
    end

    local label = flexprompt.parse_arg_token(args, "l", "label") or ""
    if label ~= "" then
        text = flexprompt.append_text(label, text)
    end

    local fluent = flexprompt.parse_arg_token(args, "f", "fluent") or ""
    if fluent ~= "" then
        text = flexprompt.append_text(flexprompt.make_fluent_text(fluent), text)
    end

    local colors = flexprompt.parse_arg_token(args, "c", "color")
    local color, altcolor
    local style = flexprompt.get_style()
    if style == "rainbow" then
        color = flexprompt.use_best_color("green", "38;5;22")
    elseif style == "classic" then
        color = flexprompt.use_best_color("green", "38;5;35")
    else
        color = flexprompt.use_best_color("green", "38;5;28")
    end
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor) -- luacheck: ignore 321

    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- EXIT MODULE:  {exit:always:color=color_name,alt_color_name:hex}
--  - 'always' always shows the exit code even when 0.
--  - color_name is used when the exit code is 0, and is a name like "green", or
--    an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style when the
--    exit code is 0.
--  - 'hex' forces hex display for values > 255 or < -255.  Otherwise hex
--    display is used for values > 32767 or < -32767.

local function render_exit(args)
    if not os.geterrorlevel then return end

    local text
    local value = flexprompt.get_errorlevel()

    local always = flexprompt.parse_arg_keyword(args, "a", "always")
    if not always and value == 0 then return end

    local hex = flexprompt.parse_arg_keyword(args, "h", "hex")

    if math.abs(value) > (hex and 255 or 32767) then
        local lo = bit32.band(value, 0xffff)
        local hi = bit32.rshift(value, 16)
        if hi > 0 then
            hex = string.format("%x", hi) .. string.format("%04.4x", lo)
        else
            hex = string.format("%x", lo)
        end
        text = "0x" .. hex
    else
        text = value
    end

    local colors = flexprompt.parse_arg_token(args, "c", "color")
    local color, altcolor
    color = value ~= 0 and "exit_nonzero" or "exit_zero"
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor) -- luacheck: ignore 321

    local sym = flexprompt.get_module_symbol()
    if sym == "" then
        sym = flexprompt.get_icon(value ~= 0 and "exit_nonzero" or "exit_zero")
    end
    text = flexprompt.append_text(sym, text)

    if flexprompt.get_flow() == "fluent" then
        text = flexprompt.append_text(flexprompt.make_fluent_text("exit"), text)
    end

    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- GIT MODULE:  {git:nostaged:noaheadbehind:nostashes:counts:color_options}
--  - 'nountracked' omits untracked files.
--  - 'nostaged' omits the staged details.
--  - 'noaheadbehind' omits the ahead/behind details.
--  - 'nostashes' omits the count of stashes.
--  - 'showremote' shows the branch and its remote.
--  - 'submodules' includes status for submodules.
--  - 'counts' shows the count of added/modified/etc files.
--  - color_options override status colors as follows:
--      - clean=color_name,alt_color_name           When status is clean.
--      - conflict=color_name,alt_color_name        When a conflict exists.
--      - dirty=color_name,alt_color_name           When status is dirty.
--      - remote=color_name,alt_color_name          For ahead/behind details.
--      - staged=color_name,alt_color_name          For staged details.
--      - stashcount=color_name,alt_color_name      For count of stashes.
--      - unknown=color_name,alt_color_name         When status is unknown.
--      - unpublished=color_name,alt_color_name     When status is clean but branch is not published.

-- luacheck: globals flexprompt_git
flexprompt_git = flexprompt_git or {}
--  .postprocess_branch = function(string), returns string, can modify the branch name string.

local git_info = {}
local fetched_repos = {}

-- Add status details to the segment text.
--
-- Synchronous call.
local function add_details(text, details, include_counts)
    local add = details.add or 0
    local modify = details.modify or 0
    local delete = details.delete or 0
    local rename = details.rename or 0
    local untracked = details.untracked or 0
    if include_counts then
        if add > 0 then
            text = flexprompt.append_text(text, flexprompt.get_symbol("addcount") .. add)
        end
        if modify > 0 then
            text = flexprompt.append_text(text, flexprompt.get_symbol("modifycount") .. modify)
        end
        if delete > 0 then
            text = flexprompt.append_text(text, flexprompt.get_symbol("deletecount") .. delete)
        end
        if rename > 0 then
            text = flexprompt.append_text(text, flexprompt.get_symbol("renamecount") .. rename)
        end
    elseif (add + modify + delete + rename) > 0 then
        text = flexprompt.append_text(text, flexprompt.get_symbol("summarycount") .. (add + modify + delete + rename))
    end
    if untracked > 0 then
        text = flexprompt.append_text(text, flexprompt.get_symbol("untrackedcount") .. untracked)
    end
    return text
end

local function maybe_git_fetch(info)
    if info.type == "git" and flexprompt.settings.git_fetch_interval then
        local when = fetched_repos[info.root]
        if not when or os.clock() - when > flexprompt.settings.git_fetch_interval * 60 then
            local file = flexprompt.popenyield(flexprompt.git_command("fetch"))
            if file then
                file:close()
            end
            fetched_repos[info.root] = os.clock()
        end
    end
end

local function get_git_detached_info(info, commit)
    if commit then
        local refname, reftype
        do
            local cmd = flexprompt.git_command('branch --no-color --format "%(refname)" --points-at=' .. commit)
            local file = flexprompt.popenyield(cmd)
            if file then
                for line in file:lines() do
                    local n = line:match("^%(?HEAD detached at.-([^%s]*[^%s)])%)?")
                    if n then
                        local minlen = math.min(#n, #commit)
                        if minlen >= 7 then
                            local a = n:sub(1, minlen)
                            local b = commit:sub(1, minlen)
                            if a:lower() ~= b:lower() then
                                refname = n
                                break
                            end
                        end
                    else
                        refname = line:match("^refs/heads/(.*)$")
                        if refname then
                            reftype = "branch"
                            break
                        end
                    end
                end
                file:close()
            end
        end
        if not refname then
            local cmd = flexprompt.git_command('tag --no-color --format "%(refname)" --points-at=' .. commit)
            local file = flexprompt.popenyield(cmd)
            if file then
                for line in file:lines() do
                    refname = line:match("^refs/tags/(.*)$")
                    if refname then
                        reftype = "tag"
                        break
                    end
                end
                file:close()
            end
        end
        info.detached = true
        info.detached_commit = commit
        info.detached_refname = refname
        info.detached_reftype = reftype
    end
end

-- Collects git status info.
--
-- Uses async coroutine calls.
local function collect_git_info(no_untracked, no_stashes, includeSubmodules)
    local git_dir, wks_dir = flexprompt.get_git_dir()
    git_dir = git_dir and git_dir:lower()
    wks_dir = wks_dir and wks_dir:lower()

    local submodule = git_dir and git_dir:find(path.join(wks_dir, "modules\\"), 1, true) == 1

    maybe_git_fetch({ type="git", root=git_dir })

    local status = flexprompt.get_git_status(no_untracked, includeSubmodules)
    local conflict = flexprompt.get_git_conflict()
    local ahead, behind = flexprompt.get_git_ahead_behind()
    local info = { status=status, conflict=conflict, ahead=ahead, behind=behind, submodule=submodule, finished=true }
    if not no_stashes and git.getstashcount then
        local count = git.getstashcount()
        if count and count > 0 then
            info.stashcount = count
        end
    end

    local branch, detached, commit = flexprompt.get_git_branch()
    info.branch = branch
    if detached and commit then
        get_git_detached_info(info, commit)
    end
    return info
end

local git_colors =
{
    clean       = { "c",   "clean",        "vcs_clean",         },
    conflict    = { "!",   "conflict",     "vcs_conflict",      },
    dirty       = { "d",   "dirty",        "vcs_dirty",         },
    remote      = { "r",   "remote",       "vcs_remote",        },
    staged      = { "s",   "staged",       "vcs_staged",        },
    stashcount  = { "sc",  "stashcount",   "vcs_stashcount",    },
    unknown     = { "u",   "unknown",      "vcs_unknown",       },
    unpublished = { "up",  "unpublished",  "vcs_unpublished",   },
}

local function render_git(args)
    local git_dir, wks -- luacheck: no unused
    local branch
    local info
    local refreshing
    local wizard = flexprompt.get_wizard_state()

    if wizard then
        git_dir = true -- luacheck: no unused
        branch = wizard.branch or "main"
        -- Copy values so .finished can be added without altering the contents
        -- of the wizard table.
        info = {}
        if wizard.git then
            for key, value in pairs(wizard.git) do
                info[key] = value
            end
        end
        info.finished = true
    else
        git_dir, wks = flexprompt.get_git_dir()
        if not git_dir then return end

        branch = flexprompt.get_git_branch(git_dir, true)
        if not branch then return end

        -- Collect or retrieve cached info.
        local noUntracked = flexprompt.parse_arg_keyword(args, "nu", "nountracked")
        local noStashes = flexprompt.parse_arg_keyword(args, "ns", "nostashes")
        local includeSubmodules = flexprompt.parse_arg_keyword(args, "sm", "submodules")
        info, refreshing = flexprompt.prompt_info(git_info, git_dir, branch, function ()
            return collect_git_info(noUntracked, noStashes, includeSubmodules)
        end)

        -- Show friendly text if git has a reftable (which makes it impossible
        -- to efficiently find the branch name).
        if branch == ".invalid" then
            branch = "Loading..."
        end
        branch = info.branch or branch

        if flexprompt_git and type(flexprompt_git.postprocess_branch) == "function" then
            local modified = flexprompt_git.postprocess_branch(branch)
            if modified then
                branch = modified
            end
        end

        -- Add remote to branch name if requested.
        if flexprompt.parse_arg_keyword(args, "sr", "showremote") then
            local remote = flexprompt.get_git_remote(git_dir)
            if remote then
                branch = branch .. flexprompt.make_fluent_text("->") .. remote
            end
        end
    end

    -- Segments.
    local segments = {}

    -- Local status.
    local gitStatus = info.status
    local gitConflict = info.conflict
    local gitUnknown = not info.finished
    local gitUnpublished = not info.detached and gitStatus and gitStatus.unpublished
    local gitError = gitStatus and gitStatus.errmsg
    local colors = git_colors.clean
    local color, altcolor
    local icon_name = "branch"
    local include_counts = flexprompt.parse_arg_keyword(args, "num", "counts")
    if gitUnpublished then
        icon_name = "unpublished"
        colors = git_colors.unpublished
    end
    if gitError then
        colors = git_colors.unknown
    elseif gitConflict then
        colors = git_colors.conflict
    elseif gitStatus and gitStatus.working then
        colors = git_colors.dirty
    elseif gitUnknown then
        colors = git_colors.unknown
    end
    color, altcolor = parse_color_token(args, colors)

    local function make_text(b)
        local text = flexprompt.format_branch_name(b, icon_name, refreshing, info.submodule)
        if gitError then
            text = flexprompt.append_text(text, gitError)
        elseif gitConflict then
            text = flexprompt.append_text(text, flexprompt.get_symbol("conflict"))
        elseif gitStatus and gitStatus.working then
            text = add_details(text, gitStatus.working, include_counts)
        end
        return text
    end

    if info.detached_refname then
        branch = "HEAD detached at " .. info.detached_refname
    end

    local text = make_text(branch)
    local segment = { text, color, altcolor }
    local condensed_segment = { color=color, altcolor=altcolor }
    segment.condense_callback = function ()
        local b = branch
        local target = math.max(console.getwidth() / 4, 20)
        if console.cellcount(branch) > target then
            b = b:sub(1, target - 3 - 4) .. flexprompt.make_fluent_text("...") .. b:sub(-4)
        end
        condensed_segment.text = make_text(b)
        return condensed_segment
    end
    table.insert(segments, segment)

    -- Staged status.
    local noStaged = flexprompt.parse_arg_keyword(args, "ns", "nostaged")
    if not noStaged and gitStatus and gitStatus.staged then
        text = flexprompt.append_text("", flexprompt.get_symbol("staged"))
        colors = git_colors.staged
        text = add_details(text, gitStatus.staged, include_counts)
        color, altcolor = parse_color_token(args, colors)
        table.insert(segments, { text, color, altcolor })
    end

    -- Remote status (ahead/behind).
    local noAheadBehind = flexprompt.parse_arg_keyword(args, "nab", "noaheadbehind")
    if not noAheadBehind then
        local ahead = info.ahead or "0"
        local behind = info.behind or "0"
        if ahead ~= "0" or behind ~= "0" then
            text = flexprompt.append_text("", flexprompt.get_symbol("aheadbehind"))
            colors = git_colors.remote
            if ahead ~= "0" then
                text = flexprompt.append_text(text, flexprompt.get_symbol("aheadcount") .. ahead)
            end
            if behind ~= "0" then
                text = flexprompt.append_text(text, flexprompt.get_symbol("behindcount") .. behind)
            end
            color, altcolor = parse_color_token(args, colors)
            table.insert(segments, { text, color, altcolor })
        end
    end

    -- Count of stashes.
    if info and info.stashcount then
        text = flexprompt.append_text("", flexprompt.get_symbol("stashcount") .. info.stashcount)
        colors = git_colors.stashcount
        color, altcolor = parse_color_token(args, colors)
        table.insert(segments, { text, color, altcolor })
    end

    return segments
end

--------------------------------------------------------------------------------
-- HG MODULE:  {hg:color_options}
--  - color_options override status colors as follows:
--      - clean=color_name,alt_color_name       When status is clean.
--      - dirty=color_name,alt_color_name       When status is dirty (modified files).

local hg_colors =
{
    clean       = { "c",  "clean",  "vcs_clean" },
    dirty       = { "d",  "dirty",  "vcs_dirty" },
}

local hg = {}

local function collect_hg_info()
    local pipe = flexprompt.popenyield("hg status -amrd 2>&1")
    if not pipe then return end
    local output = pipe:read('*all') or ""
    pipe:close()

    local dirty = output ~= ""
    return { dirty=dirty }
end

local function get_hg_dir(dir)
    return flexprompt.scan_upwards(dir, function (dir) -- luacheck: ignore 432
        -- Return if it's a hg (Mercurial) dir.
        return flexprompt.has_dir(dir, ".hg")
    end)
end

local function render_hg(args)
    local hg_dir = get_hg_dir()
    if not hg_dir then return end

    -- We're inside of hg repo, read branch and status.
    local pipe = io.popen("hg branch 2>&1")
    if not pipe then return end
    local output = pipe:read('*all') or ""
    pipe:close()

    -- Strip the trailing newline from the branch name.
    local n = #output
    while n > 0 and output:find("^%s", n) do n = n - 1 end
    local branch = output:sub(1, n)
    if not branch then return end
    if string.sub(branch,1,7) == "abort: " then return end
    if string.find(branch, "is not recognized") then return end

    -- Collect or retrieve cached info.
    local info, refreshing = flexprompt.prompt_info(hg, hg_dir, branch, collect_hg_info)

    local text = flexprompt.format_branch_name(branch, "branch", refreshing)

    local colors
    if info.dirty then
        text = flexprompt.append_text(text, flexprompt.get_symbol("modifycount"))
        colors = hg_colors.dirty
    else
        colors = hg_colors.clean
    end

    local color, altcolor = parse_color_token(args, colors)
    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- HISTLABEL MODULE:  {histlabel:color=color_name,alt_color_name}
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.
--
-- This shows the name of the current alternative history, if any.
-- Clink can store multiple separate histories by setting CLINK_HISTORY_LABEL.

local function render_histlabel(args)
    local wizard = flexprompt.get_wizard_state()
    local text = os.getenv("clink_history_label")
    if wizard and wizard.histlabel then
        text = wizard.histlabel
    end
    if text then
        text = text:match("^ *([^ ].*)$")
        text = text:match("^(.*[^ ]) *$")
    end
    if not text or #text <= 0 then
        return
    end

    local colors = flexprompt.parse_arg_token(args, "c", "color")
    local color, altcolor
    if flexprompt.get_style() == "rainbow" then
        color = flexprompt.use_best_color("magenta", "38;5;90")
        altcolor = "realblack"
    else
        color = flexprompt.use_best_color("darkyellow", "38;5;169")
    end
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor)

    local symbol = flexprompt.get_module_symbol()
    if symbol and #symbol > 0 then
        text = flexprompt.append_text(symbol, text)
    elseif flexprompt.get_flow() == "fluent" then
        text = flexprompt.make_fluent_text("[") .. text .. flexprompt.make_fluent_text("]")
    end
    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- KEYMAP MODULE:  {keymap:color=color_name,alt_color_name}
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.
--
-- The default keymap names are:
--  - emacs mode is "" (don't show the module).
--  - vi command mode is "vi-CMD".
--  - vi insert mode is "vi-ins".
--
-- You can override the keymap names by setting the following variables in your
-- flexprompt_config.lua file:
--  - flexprompt.settings.emacs_keymap = "emacs"
--  - flexprompt.settings.vicmd_keymap = "vi-command"
--  - flexprompt.settings.viins_keymap = "vi-insert"
--
-- Requires Clink v1.2.50 or higher.

local _keymap

local function keymap_onbeginedit()
    _keymap = rl.getvariable("keymap")

    if flexprompt.is_module_in_prompt("keymap") then
        rl.setvariable("emacs-mode-string", "")
        rl.setvariable("vi-cmd-mode-string", "")
        rl.setvariable("vi-ins-mode-string", "")
    end
end

if clink.onaftercommand then
    local function keymap_aftercommand()
        if rl.getvariable("keymap") ~= _keymap then
            _keymap = rl.getvariable("keymap")
            flexprompt.refilter_module("keymap")
            clink.refilterprompt()
        end
    end

    clink.onaftercommand(keymap_aftercommand)
end

local function render_keymap(args)
    local keymap
    local wizard = flexprompt.get_wizard_state()
    if wizard then
        keymap = wizard.keymap
    else
        keymap = rl.getvariable("keymap")
    end

    if not keymap then
        return
    end

    local text
    if keymap == "vi" then
        text = flexprompt.settings.vicmd_keymap or "vi-CMD"
    elseif keymap == "vi-insert" then
        text = flexprompt.settings.viins_keymap or "vi-ins"
    else
        text = flexprompt.settings.emacs_keymap or ""
    end

    if not text or text == "" then
        return
    end

    local color, altcolor = parse_color_token(args, { "c", "color", "keymap" })
    text = flexprompt.append_text(flexprompt.get_module_symbol(), text)
    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- K8S MODULE:  {k8s:color=color_name,alt_color_name}
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.

local k8s = {}

local function collect_k8s_info()
    local ns = "default"
    local context
    local p

    repeat
        p = flexprompt.popenyield("kubectl.exe config view --minify 2>nul", "rt")
        if not p then
            return { text="(error)" }
        end

        local any_lines
        for line in p:lines() do
            any_lines = true
            local x = line:match(" *namespace: +(.+)$")
            if x then
                ns = x
                break
            end
        end
        p:close()
        if not any_lines then
            return { text="(error)" }
        end

        p = flexprompt.popenyield("kubectl.exe config current-context 2>nul", "rt")
        if not p then
            break
        end

        for line in p:lines() do
            context = line:match("(.+)$")
            if context then
                break
            end
        end
        p:close()
    until true

    return { context=context, namespace=ns }
end

local function render_k8s(args)
    local info = flexprompt.prompt_info(k8s, "", "", collect_k8s_info)
    local text

    if info.text then
        text = info.text
    elseif not info.namespace and not info.context then
        text = flexprompt.make_fluent_text("(kubernetes)")
    else
        text = info.namespace
        if info.context and info.context ~= "" then
            text = info.context .. flexprompt.make_fluent_text(":") .. text
        end
    end

    local sym = flexprompt.get_module_symbol()
    if not sym and flexprompt.get_flow() == "fluent" then
        sym = flexprompt.make_fluent_text("k8s")
    end
    text = flexprompt.append_text(sym, text)

    local color, altcolor
    if flexprompt.get_style() == "rainbow" then
        color = flexprompt.use_best_color("magenta", "38;5;90")
        altcolor = "realblack"
    else
        color = flexprompt.use_best_color("magenta", "38;5;206")
    end

    local colors = flexprompt.parse_arg_token(args, "color")
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor)

    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- MAVEN MODULE:  {maven:color=color_name,alt_color_name}
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.

local mvn = {}

local function collect_mvn_info()
    local handle = flexprompt.popenyield('xmllint --xpath "//*[local-name()=\'project\']/*[local-name()=\'groupId\']/text()" pom.xml 2>NUL')
    if not handle then return end
    local package_group = handle:read("*a") or ""
    handle:close()
    if package_group == "" then
        handle = flexprompt.popenyield('xmllint --xpath "//*[local-name()=\'project\']/*[local-name()=\'parent\']/*[local-name()=\'groupId\']/text()" pom.xml 2>NUL')
        if not handle then return end
        package_group = handle:read("*a") or ""
        handle:close()
    end

    handle = flexprompt.popenyield('xmllint --xpath "//*[local-name()=\'project\']/*[local-name()=\'artifactId\']/text()" pom.xml 2>NUL')
    if not handle then return end
    local package_artifact = handle:read("*a") or ""
    handle:close()

    handle = flexprompt.popenyield('xmllint --xpath "//*[local-name()=\'project\']/*[local-name()=\'version\']/text()" pom.xml 2>NUL')
    if not handle then return end
    local package_version = handle:read("*a") or ""
    handle:close()
    if package_version == "" then
        handle = flexprompt.popenyield('xmllint --xpath "//*[local-name()=\'project\']/*[local-name()=\'parent\']/*[local-name()=\'version\']/text()" pom.xml 2>NUL')
        if not handle then return end
        package_version = handle:read("*a") or ""
        handle:close()
    end

    return { package_group=package_group, package_artifact=package_artifact, package_version=package_version }
end

local function get_pom_xml_dir(dir)
    return flexprompt.scan_upwards(dir, function (dir) -- luacheck: ignore 432
        local pom_file = path.join(dir, "pom.xml")
        -- More efficient than opening the file.
        if os.isfile(pom_file) then return dir end
    end)
end

local function render_maven(args)
    local mvn_dir = get_pom_xml_dir()
    if not mvn_dir then return end

    local info = flexprompt.prompt_info(mvn, mvn_dir, nil, collect_mvn_info)

    local text = (info.package_group or "") .. ":" .. (info.package_artifact or "") .. ":" .. (info.package_version or "")
    text = flexprompt.append_text(flexprompt.get_module_symbol(), text)

    local color, altcolor = parse_color_token(args, { "c", "color", "mod_cyan" })
    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- MODMARK MODULE:  {modmark:color=color_name,alt_color_name:text=modmark_text}
--  - modmark_text provides a string to show when the current line is modified.
--      - The default is '*'.
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.
--
-- If present, the 'text=' option must be last (so that it can contain colons in
-- case that's desired).
--
-- Requires Clink v1.2.51 or higher.

local _modmark
local _modifiedline

if rl.ismodifiedline then
    _modmark = rl.isvariabletrue("mark-modified-lines")
    rl.setvariable("mark-modified-lines", "off")
end

local function modmark_onbeginedit()
    _modifiedline = nil
    if rl.ismodifiedline then
        _modifiedline = rl.ismodifiedline()
    end
end

if clink.onaftercommand and rl.ismodifiedline then
    local function modmark_aftercommand()
        if not _modmark then return end

        if rl.ismodifiedline() ~= _modifiedline then
            _modifiedline = rl.ismodifiedline()
            flexprompt.refilter_module("modmark")
            clink.refilterprompt()
        end
    end

    clink.onaftercommand(modmark_aftercommand)
end

local function render_modmark(args)
    local modmark
    local wizard = flexprompt.get_wizard_state()
    if wizard then
        modmark = wizard.modmark
    else
        modmark = rl.ismodifiedline()
    end

    if not modmark then
        return
    end

    local text = flexprompt.parse_arg_token(args, "t", "text", true) or "*"
    if not text or text == "" then
        return
    end

    local color, altcolor = parse_color_token(args, { "c", "color", "mod_cyan" })
    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- NPM MODULE:  {npm:smartname:color=color_name,alt_color_name}
--  - smartname skips package name if it matches folder name.
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.

local function get_package_json_file(dir)
    return flexprompt.scan_upwards(dir, function (dir) -- luacheck: ignore 432
        local file = io.open(path.join(dir, "package.json"))
        if file then return file end
    end)
end

local function render_npm(args)
    local file = get_package_json_file()
    if not file then return end

    local package_info = file:read('*a')
    file:close()

    local package_name = string.match(package_info, '"name"%s*:%s*"(%g-)"') or ""
    local package_version = string.match(package_info, '"version"%s*:%s*"(.-)"') or ""

    local folder_name = get_folder_name(os.getcwd())
    local smartname = flexprompt.parse_arg_keyword(args, "smartname")
    if smartname and package_name == folder_name then
        package_name = ""
    end

    local text = package_name .. "@" .. package_version
    text = flexprompt.append_text(flexprompt.get_module_symbol(), text)

    local color, altcolor = parse_color_token(args, { "c", "color", "mod_cyan" })
    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- OVERTYPE MODULE:  {overtype:text=overtype_name,insert_name:color=c,a:overtypecolor=c,a:insertcolor=c,a}
--  - text provides strings to show in the is the format to use:
--      - "overtype_name" is shown when overtype mode is on.
--      - "insert_name" is shown when insert mode is on.
--      - An empty text makes the module not show up in the corresponding mode.
--  - color specifies the colors for both overtype and insert mode.
--      - c is a name like "green", or an sgr code like "38;5;60".
--      - a is optional; it is the text color in rainbow style.
--  - overtypecolor specifies the colors for overtype mode.
--      - c is a name like "green", or an sgr code like "38;5;60".
--      - a is optional; it is the text color in rainbow style.
--  - insertcolor specifies the colors for overtype mode.
--      - c is a name like "green", or an sgr code like "38;5;60".
--      - a is optional; it is the text color in rainbow style.
--
-- Requires Clink v1.2.50 or higher.

local function render_overtype(args)
    local overtype
    local wizard = flexprompt.get_wizard_state()
    if wizard then
        overtype = wizard.overtype
    else
        overtype = not rl.insertmode()
    end

    local text
    local name = flexprompt.parse_arg_token(args, "t", "text") or "OVERTYPE"
    local names = name:explode(",")
    text = names[(not overtype) and 2 or 1]
    if not text or text == "" then
        return
    end

    local colors
    if overtype then
        colors = flexprompt.parse_arg_token(args, "o", "overtypecolor")
    else
        colors = flexprompt.parse_arg_token(args, "i", "insertcolor")
    end
    colors = colors or flexprompt.parse_arg_token(args, "c", "color")

    local color, altcolor
    if flexprompt.get_style() == "rainbow" then
        color = flexprompt.use_best_color("yellow", "38;5;214")
        altcolor = "realblack"
    else
        color = flexprompt.use_best_color("darkyellow", "38;5;172")
    end
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor)

    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- PYTHON MODULE:  {python:always:color=color_name,alt_color_name}
--  - 'always' shows the python module even if there are no python files.
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.

local function get_virtual_env(env_var)
    local venv_path = false

    -- Return the folder name of the current virtual env, or false.
    local function get_virtual_env_var(var)
        venv_path = clink.get_env(var)
        return venv_path and string.match(venv_path, "[^\\/:]+$") or false
    end

    local venv = (env_var and get_virtual_env_var(env_var)) or
        get_virtual_env_var("VIRTUAL_ENV") or
        get_virtual_env_var("CONDA_DEFAULT_ENV") or false
    return venv
end

local function has_py_files(dir)
    return flexprompt.scan_upwards(dir, function (dir) -- luacheck: ignore 432
        for _ in pairs(os.globfiles(path.join(dir, "*.py"))) do -- luacheck: ignore 512
            return true
        end
    end)
end

local function render_python(args)
    -- flexprompt.python_virtual_env_variable can be nil.
    local venv = get_virtual_env(flexprompt.python_virtual_env_variable)
    if not venv then return end

    local always = flexprompt.parse_arg_keyword(args, "a", "always")
    if not always and not has_py_files() then return end

    local text = "[" .. venv .. "]"
    text = flexprompt.append_text(flexprompt.get_module_symbol(), text)

    local color, altcolor = parse_color_token(args, { "c", "color", "mod_cyan" })
    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- SCM MODULE:  {scm:nostaged:nostashes:noaheadbehind:counts:color_options}
--  - 'noaheadbehind' omits the ahead/behind details.
--  - 'noconflict' omits conflict info.
--  - 'nostaged' omits the staged details.
--  - 'nostashes' omits the count of stashes.
--  - 'nosubmodules' omits status for submodules.
--  - 'nountracked' omits untracked files.
--  - 'showremote' shows the branch and its remote.
--  - 'counts' shows the count of added/modified/etc files.
--  - color_options override status colors as follows:
--      - clean=color_name,alt_color_name           When status is clean.
--      - conflict=color_name,alt_color_name        When a conflict exists.
--      - dirty=color_name,alt_color_name           When status is dirty.
--      - remote=color_name,alt_color_name          For ahead/behind details.
--      - staged=color_name,alt_color_name          For staged details.
--      - stashcount=color_name,alt_color_name      For count of stashes.
--      - unknown=color_name,alt_color_name         When status is unknown.
--      - unpublished=color_name,alt_color_name     When status is clean but branch is not published.

-- TODO: some way to postprocess the branch name string.

local cached_scm = {}

-- Collects SCM status info.
--
-- Uses async coroutine calls.
local function collect_scm_info(detected_info, flags)
    local info = flexprompt.get_scm_info(detected_info, flags)

    maybe_git_fetch(info)

    info.ready = true
    return info
end

local scm_colors =
{
    clean       = { "c",   "clean",        "vcs_clean",         },
    conflict    = { "!",   "conflict",     "vcs_conflict",      },
    dirty       = { "d",   "dirty",        "vcs_dirty",         },
    remote      = { "r",   "remote",       "vcs_remote",        },
    staged      = { "s",   "staged",       "vcs_staged",        },
    stashcount  = { "sc",  "stashcount",   "vcs_stashcount",    },
    unknown     = { "u",   "unknown",      "vcs_unknown",       },
    unpublished = { "up",  "unpublished",  "vcs_unpublished",   },
}

local function render_scm(args)
    local branch, detached
    local info
    local refreshing
    local wizard = flexprompt.get_wizard_state()

    if wizard then
        branch = wizard.branch or "main"
        -- Copy values so .finished can be added without altering the contents
        -- of the wizard table.
        info = {}
        if wizard.git then
            for key, value in pairs(wizard.git) do
                info[key] = value
            end
        end
        info.type = "git"
        info.ready = true
    else
        local detected = flexprompt.detect_scm()
        if not detected then return end
        if not detected.type then return end

        -- Collect or retrieve cached info.
        local flags = {}
        flags.no_ahead_behind = flexprompt.settings.no_ahead_behind or flexprompt.parse_arg_keyword(args, "nab", "noaheadbehind")
        flags.no_conflict = flexprompt.settings.no_conflict or flexprompt.parse_arg_keyword(args, "nc", "noconflict")
        flags.no_stashes = flexprompt.settings.no_stashes or flexprompt.parse_arg_keyword(args, "nsc", "nostashes")
        flags.no_submodules = flexprompt.settings.no_submodules or flexprompt.parse_arg_keyword(args, "ns", "nosubmodules")
        flags.no_untracked = flexprompt.settings.no_untracked or flexprompt.parse_arg_keyword(args, "nu", "nountracked")
        flags.show_remote = not flexprompt.settings.no_remote and flexprompt.parse_arg_keyword(args, "sr", "showremote")
        info, refreshing = flexprompt.prompt_info(cached_scm, detected.root, detected.branch, function ()
            return collect_scm_info(detected, flags)
        end)

        -- Fill in initial values from detect_scm() until the prompt_info()
        -- coroutine completes.
        info.type = info.type or detected.type
        info.cwd = info.cwd or detected.cwd
        info.root = info.root or detected.root
        info.branch = info.branch or detected.branch
        info.detached = info.detached or detected.detached
        info.commit = info.commit or detected.commit

        branch = info.branch
        detached = info.detached
        if detached and info.commit then
            branch = info.commit:sub(1, 8)
            if info.detached_refname then
                branch = string.format("%s (%s)", branch, info.detached_refname)
            end
        end

        if branch == ".invalid" then
            -- Show friendly text if git has a reftable (which makes it
            -- impossible to efficiently find the branch name).
            branch = "Loading..."
        else
            if flexprompt_git and type(flexprompt_git.postprocess_branch) == "function" then
                local modified = flexprompt_git.postprocess_branch(branch)
                if modified then
                    branch = modified
                end
            end

            -- Add remote to branch name if requested.
            if not info.detached and info.remote and flexprompt.parse_arg_keyword(args, "sr", "showremote") then
                branch = branch .. flexprompt.make_fluent_text("->") .. info.remote
            end
        end
    end

    -- Segments.
    local segments = {}

    -- Local status.
    local ready = info.ready
    local status = info.status
    local conflict = info.conflict
    local unpublished = not detached and status and status.unpublished
    local errmsg = status and status.errmsg
    local colors = scm_colors.clean
    local color, altcolor
    local icon_name = "branch"
    local include_counts = flexprompt.parse_arg_keyword(args, "num", "counts")
    if unpublished then
        icon_name = "unpublished"
        colors = scm_colors.unpublished
    end
    if errmsg then
        colors = scm_colors.unknown
    elseif conflict then
        colors = scm_colors.conflict
    elseif status and status.working then
        colors = scm_colors.dirty
    elseif not ready then
        colors = scm_colors.unknown
    end
    color, altcolor = parse_color_token(args, colors)

    local old_no_graphics = flexprompt.settings.no_graphics
    flexprompt.settings.no_graphics = nil
    local module_sym = flexprompt.get_module_symbol()
    flexprompt.settings.no_graphics = old_no_graphics

    if module_sym and module_sym ~= "" then
        module_sym = flexprompt.get_icon(string.lower(info.type.."_module"))
        if not module_sym or module_sym == "" then
            module_sym = info.type
        elseif refreshing then
            local ref_icon = flexprompt.get_icon(refreshing)
            if ref_icon and ref_icon ~= "" then
                module_sym = ref_icon
            end
        end
    end

    local function make_text(b)
        local text = flexprompt.format_branch_name(b, icon_name, refreshing, info.submodule, module_sym)
        if errmsg then
            text = flexprompt.append_text(text, errmsg)
        elseif conflict then
            text = flexprompt.append_text(text, flexprompt.get_symbol("conflict"))
        elseif status and status.working then
            text = add_details(text, status.working, include_counts)
        end
        return text
    end

    local text = make_text(branch)
    local segment = { text, color, altcolor }
    local condensed_segment = { color=color, altcolor=altcolor }
    segment.condense_callback = function ()
        local b = branch
        local target = math.max(console.getwidth() / 4, 20)
        if console.cellcount(branch) > target then
            b = b:sub(1, target - 3 - 4) .. flexprompt.make_fluent_text("...") .. b:sub(-4)
        end
        condensed_segment.text = make_text(b)
        return condensed_segment
    end
    table.insert(segments, segment)

    -- Staged status.
    local noStaged = flexprompt.parse_arg_keyword(args, "ns", "nostaged")
    if not noStaged and status and status.staged then
        text = flexprompt.append_text("", flexprompt.get_symbol("staged"))
        colors = scm_colors.staged
        text = add_details(text, status.staged, include_counts)
        color, altcolor = parse_color_token(args, colors)
        table.insert(segments, { text, color, altcolor })
    end

    -- Remote status (ahead/behind).
    local noAheadBehind = flexprompt.parse_arg_keyword(args, "nab", "noaheadbehind")
    if not noAheadBehind then
        local ahead = info.ahead or "0"
        local behind = info.behind or "0"
        if ahead ~= "0" or behind ~= "0" then
            text = flexprompt.append_text("", flexprompt.get_symbol("aheadbehind"))
            colors = scm_colors.remote
            if ahead ~= "0" then
                text = flexprompt.append_text(text, flexprompt.get_symbol("aheadcount") .. ahead)
            end
            if behind ~= "0" then
                text = flexprompt.append_text(text, flexprompt.get_symbol("behindcount") .. behind)
            end
            color, altcolor = parse_color_token(args, colors)
            table.insert(segments, { text, color, altcolor })
        end
    end

    -- Count of stashes.
    if info.stashcount then
        text = flexprompt.append_text("", flexprompt.get_symbol("stashcount") .. info.stashcount)
        colors = scm_colors.stashcount
        color, altcolor = parse_color_token(args, colors)
        table.insert(segments, { text, color, altcolor })
    end

    return segments
end

--------------------------------------------------------------------------------
-- SVN MODULE:  {svn:color_options}
--  - color_options override status colors as follows:
--      - clean=color_name,alt_color_name       When status is clean.
--      - dirty=color_name,alt_color_name       When status is dirty (modified files).
--      - unknown=color_name,alt_color_name     When status is unknown.

local svn = {}

local svn_colors =
{
    clean       = { "c",  "clean",    "vcs_clean" },
    dirty       = { "d",  "dirty",    "vcs_conflict" },
    unknown     = { "u",  "unknown",  "vcs_unknown" },
}

local function get_svn_dir(dir)
    return flexprompt.scan_upwards(dir, function (dir) -- luacheck: ignore 432
        -- Return if it's a svn (Subversion) dir.
        local has = flexprompt.has_dir(dir, ".svn")
        if has then return has end
    end)
end

local function get_svn_branch()
    local file = io.popen("svn info 2>nul")
    if not file then return end
    for line in file:lines() do
        local m = line:match("^Relative URL:")
        if m then
            file:close()
            return line:sub(line:find("/")+1,line:len())
        end
    end
    file:close()
end

local function get_svn_status()
    local file = flexprompt.popenyield("svn status -q")
    if not file then return end
    for _ in file:lines() do -- luacheck: ignore 512
        file:close()
        return true
    end
    file:close()
end

local function collect_svn_info()
    local colors = svn_colors.clean
    local dirty
    if get_svn_status() then
        colors = svn_colors.dirty
        dirty = true
    end
    return { colors=colors, dirty=dirty }
end

local function render_svn(args)
    local svn_dir = get_svn_dir()
    if not svn_dir then return end

    local branch = get_svn_branch()
    if not branch then return end

    local text = flexprompt.format_branch_name(branch)

    local info = flexprompt.prompt_info(svn, svn_dir, branch, collect_svn_info)
    local colors = info.colors or svn_colors.unknown
    if info.dirty then
        text = flexprompt.append_text(text, flexprompt.get_symbol("modifycount"))
    end

    local color, altcolor = parse_color_token(args, colors)
    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- TIME MODULE:  {time:dim:color=color_name,alt_color_name:format=format_string}
--  - 'dim' uses dimmer default colors for rainbow style.
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.
--  - format_string uses the rest of the text as a format string for os.date().
--
-- If present, the 'format=' option must be last (otherwise it could never
-- include colons).

local function render_time(args)
    local time = flexprompt.get_time()

    local dim = flexprompt.parse_arg_keyword(args, "d", "dim")
    local colors = flexprompt.parse_arg_token(args, "c", "color")
    local color, altcolor
    if flexprompt.get_style() == "rainbow" then
        color = dim and "realbrightblack" or "realwhite"
        altcolor = dim and "realwhite" or "realblack"
    else
        color = { fg="36", bg="46", extfg="38;5;6", extbg="48;5;6" }
    end
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor)

    local format = flexprompt.parse_arg_token(args, "f", "format", true)
    if not format then
        format = "%a %H:%M"
    end

    local text = os.date(format, time)

    if flexprompt.get_flow() == "fluent" then
        text = flexprompt.append_text(flexprompt.make_fluent_text("at"), text)
    end

    text = flexprompt.append_text(text, flexprompt.get_module_symbol())

    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- USER MODULE:  {user:type=type_name:color=color_name,alt_color_name}
--  - type_name is any of 'computer', 'user', or 'both' (the default).
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.

local function render_user(args)
    local colors = flexprompt.parse_arg_token(args, "c", "color")
    local color, altcolor
    local style = flexprompt.get_style()
    if style == "rainbow" then
        color = flexprompt.use_best_color("magenta", "38;5;90")
    elseif style == "classic" then
        color = flexprompt.use_best_color("magenta", "38;5;171")
    else
        color = flexprompt.use_best_color("magenta", "38;5;135")
    end
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor) -- luacheck: ignore 321

    local type = flexprompt.parse_arg_token(args, "t", "type") or "both"
    local user = (type ~= "computer") and os.getenv("username") or ""
    local computer = (type ~= "user") and os.getenv("computername") or ""
    if #computer > 0 then
        local prefix = "@"
        -- if #user == 0 then prefix = "\\\\" end
        computer = prefix .. computer
    end

    local text = user..computer
    if text and #text > 0 then
        text = flexprompt.append_text(flexprompt.get_module_symbol(), text)
    end
    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- VPN MODULE:  {color=color_name,alt_color_name}
--  - color_name is a name like "green", or an sgr code like "38;5;60".
--  - alt_color_name is optional; it is the text color in rainbow style.

local vpn_cached_info = {}

-- Collects connection info.
--
-- Uses async coroutine calls.
local function collect_vpn_info()
    -- Run the VPN detectors to find connections.
    local conns = flexprompt.get_vpn_info()
    if not conns or not conns[1] then
        return {}
    end

    -- Concatenate connection names.
    local line = ""
    local count = 0
    for _,c in ipairs(conns) do
        if count > 0 then
            line = line .. ","
        end
        count = count + 1
        if count > 2 then
            line = line .. "..."
            break
        end
        line = line .. c.name
    end
    return { connection=line }
end

local function render_vpn(args)
    local info
    local refreshing
    local wizard = flexprompt.get_wizard_state()

    if wizard then
        info = { connection="WORKVPN", finished=true }
    else
        -- Get connection status.
        info, refreshing = flexprompt.prompt_info(vpn_cached_info, nil, nil, collect_vpn_info)
    end

    if not info.connection then
        return
    end

    local colors = flexprompt.parse_arg_token(args, "c", "color")
    local color, altcolor
    local style = flexprompt.get_style()
    if style == "rainbow" then
        color = flexprompt.use_best_color("cyan", "38;5;67")
    elseif style == "classic" then
        color = flexprompt.use_best_color("cyan", "38;5;117")
    else
        color = flexprompt.use_best_color("cyan", "38;5;110")
    end
    color, altcolor = flexprompt.parse_colors(colors, color, altcolor) -- luacheck: ignore 321

    local text = info.connection
    if flexprompt.get_flow() == "fluent" then
        text = flexprompt.append_text(flexprompt.make_fluent_text("over"), text)
    end
    text = flexprompt.append_text(flexprompt.get_module_symbol(refreshing), text)

    return text, color, altcolor
end

--------------------------------------------------------------------------------
-- Built-in SCM detectors.

local function test_git(dir)
    local git_dir, wks_dir = flexprompt.is_git_dir(dir)
    if git_dir then
        local info = {}
        info.git_dir = git_dir
        info.wks_dir = wks_dir
        info.branch, info.detached, info.commit = flexprompt.get_git_branch(git_dir, true)
        return info
    end
end

local function info_git(dir, tested_info, flags) -- luacheck: no unused
    -- REVIEW:  Oops, 'dir' isn't really used.
    local info = {}
    flags = flags or {}
    if tested_info and tested_info.branch and tested_info.branch ~= ".invalid" then
        info.branch, info.detached, info.commit = tested_info.branch, tested_info.detached, tested_info.commit
    else
        info.branch, info.detached, info.commit = flexprompt.get_git_branch()
    end
    info.status = flexprompt.get_git_status(flags.no_untracked, not flags.no_submodules)
    if info.status and info.status.errmsg then
        info._error = true
    else
        info.branch = info.status and info.status.branch or info.branch
        if not flags.no_ahead_behind then
            info.ahead, info.behind = flexprompt.get_git_ahead_behind()
        end
        if not flags.no_stashes and git and git.getstashcount then
            local count = git.getstashcount()
            info.stashcount = count and count > 0 and count or nil
        end
        if not flags.no_conflict then
            info.conflict = flexprompt.get_git_conflict()
        end
        if not flags.no_remote then
            info.remote = flexprompt.get_git_remote()
        end
        if not flags.no_submodules then
            info.submodule = info.git_dir and info.git_dir:find(path.join(info.wks_dir, "modules\\"), 1, true) == 1
        end
        if info.detached then
            get_git_detached_info(info, info.commit)
        end
    end
    info.type = "git"
    return info
end

local function test_hg(dir)
    return flexprompt.has_dir(dir, ".hg")
end

local function info_hg(dir, tested_info, flags) -- luacheck: no unused
    local info = {}
    flags = flags or {}
    info.type = "hg"
    -- Get summary info from Mercurial.
    do
        -- Using `hg summary` is reported as a little faster than `hg status`.
        -- But the latter is machine readable, and the former is human readable.
        -- So set LC_MESSAGES=C to force English output, so that parsing can
        -- work reliably.
        local pipe = io.popenyield("set LC_MESSAGES=C& 2>&1 hg summary")
        if pipe then
            local working = { add=0, modify=0, delete=0, conflict=0, untracked=0 }
            for line in pipe:lines() do
                local m = line:match("^branch:%s+(.*)")
                if m then
                    info.branch = m
                elseif line:match("^commit:%s") then
                    m = line:match("(%d+) modified")
                    if m then
                        working.modify = tonumber(m)
                    end
                    m = line:match("(%d+) added")
                    if m then
                        working.add = tonumber(m)
                    end
                    m = line:match("(%d+) deleted")
                    if m then
                        working.delete = tonumber(m)
                    end
                    m = line:match("(%d+) renamed")
                    if m then
                        working.add = working.add + tonumber(m)
                        working.delete = working.delete + tonumber(m)
                    end
                    m = line:match("(%d+) unknown")
                    if m then
                        working.untracked = tonumber(m)
                    end
                    m = line:match("(%d+) unresolved")
                    if m then
                        working.conflict = tonumber(m)
                    end
                end
            end
            pipe:close()
            if working then
                if working.conflict > 0 then
                    info.unresolved = working.conflict
                end
                if flags.no_untracked then
                    working.untracked = 0
                end
            end
            for _,v in pairs(working) do
                if v > 0 then
                    info.status = info.status or {}
                    info.status.working = working
                    break
                end
            end
        else
            info._error = true
        end
    end
    return info
end

local function test_svn(dir)
    return flexprompt.has_dir(dir, ".svn")
end

local function info_svn(dir, tested_info, flags) -- luacheck: no unused
    local info = {}
    flags = flags or {}
    info.type = "svn"
    -- Get branch name.
    if not info._error then
        local pipe = io.popenyield("2>nul svn info")
        if pipe then
            for line in pipe:lines() do
                local m = line:match("^Relative URL:")
                if m then
                    info.branch = line:sub(line:find("/") + 1, #line)
                    break
                end
            end
            pipe:close()
        else
            info._error = true
        end
    end
    -- Get file status.
    if not info._error then
        local command = "2>nul svn status"
        if flags.no_untracked then
            command = command .. " -q"
        end
        local pipe = io.popenyield(command)
        if pipe then
            local working = { add=0, modify=0, delete=0, conflict=0, untracked=0 }
            for line in pipe:lines() do
                local s = line:match("^([AMDCR?!~])")
                if s then
                    if s == "A" then
                        working.add = working.add + 1
                    elseif s == "M" then
                        working.modify = working.modify + 1
                    elseif s == "D" then
                        working.delete = working.delete + 1
                    elseif s == "C" then
                        working.conflict = working.conflict + 1
                    elseif s == "R" then
                        working.add = working.add + 1
                        working.delete = working.delete + 1
                    elseif s == "?" then
                        working.untracked = working.untracked + 1
                    elseif s == "!" then
                        working.delete = working.delete + 1
                    elseif s == "~" then
                        working.modify = working.modify + 1
                    end
                end
            end
            pipe:close()
            if working and working.conflict > 0 then
                info.unresolved = working.conflict
            end
            for _,v in pairs(working) do
                if v > 0 then
                    info.status = info.status or {}
                    info.status.working = working
                    break
                end
            end
        else
            info._error = true
        end
    end
    return info
end

--------------------------------------------------------------------------------
-- Built-in VPN detectors.

local function vpn_rasdial()
    local pipe = io.popenyield("2>nul rasdial")
    if not pipe then
        return
    end

    -- Skip first line, which is always either a header line or reports that
    -- there are no completions.
    local line = pipe:read("*l") or ""
    if line == "" then
        pipe:close()
        return
    end

    -- Read the rest of the lines.
    local conns = {}
    while true do
        line = pipe:read("*l")
        if not line then
            break
        end
        table.insert(conns, line)
    end
    pipe:close()

    -- Discard the last line, which says the command completed successfully.
    table.remove(conns)
    if #conns == 0 then
        return
    end

    return conns
end

--------------------------------------------------------------------------------
-- Event handlers.  Since this file contains multiple modules, let them all
-- share one event handler per event type, rather than adding separate handlers
-- for separate modules.

local function builtin_modules_onbeginedit()
    _cached_state = {}
    admin_onbeginedit()
    keymap_onbeginedit()
    modmark_onbeginedit()
end

clink.onbeginedit(builtin_modules_onbeginedit)

--------------------------------------------------------------------------------
-- Initialize the built-in modules.

flexprompt.add_module( "anyconnect",    render_anyconnect                   )
flexprompt.add_module( "battery",       render_battery                      )
flexprompt.add_module( "break",         render_break                        )
flexprompt.add_module( "conda",         render_conda,       { nerdfonts2={"🅒","🅒"}, nerdfonts3={"🅒","🅒"} } )
flexprompt.add_module( "cwd",           render_cwd,         { coloremoji="📁", nerdfonts2={""," "}, nerdfonts3={""," "} } )
flexprompt.add_module( "diskspace",     render_diskspace,   { nerdfonts2={"", " "}, nerdfonts3={"", " "} } )
flexprompt.add_module( "duration",      render_duration,    { coloremoji="⌛", nerdfonts2={""," "}, nerdfonts3={""," "} } )
flexprompt.add_module( "env",           render_env                          )
flexprompt.add_module( "exit",          render_exit                         )
flexprompt.add_module( "git",           render_git,         { nerdfonts2={""," "}, nerdfonts3={""," "} } )
flexprompt.add_module( "hg",            render_hg                           )
flexprompt.add_module( "histlabel",     render_histlabel,   { nerdfonts2={""," "}, nerdfonts3={""," "} } )
flexprompt.add_module( "k8s",           render_k8s,         { nerdfonts2={"ﴱ","ﴱ "}, nerdfonts3={"󰠳","󰠳 "} } )
flexprompt.add_module( "maven",         render_maven                        )
flexprompt.add_module( "npm",           render_npm                          )
flexprompt.add_module( "python",        render_python,      { nerdfonts2={""," "}, nerdfonts3={"󰌠","󰌠 "} } )
flexprompt.add_module( "scm",           render_scm,         { "scm" }       ) -- Placeholder to check icon config.
flexprompt.add_module( "svn",           render_svn                          )
flexprompt.add_module( "time",          render_time,        { coloremoji="🕒", nerdfonts2={"",""}, nerdfonts3={"",""} } ) -- Note: nerdfonts are always mono width for this.
flexprompt.add_module( "user",          render_user,        { coloremoji="🙍", nerdfonts2={""," "}, nerdfonts3={""," "} } )
flexprompt.add_module( "vpn",           render_vpn,         { coloremoji="☁️", nerdfonts2={""," "}, nerdfonts3={""," "} } )

if os.isuseradmin then
flexprompt.add_module( "admin",         render_admin                        )
end

if clink.onaftercommand then
flexprompt.add_module( "keymap",        render_keymap,      { nerdfonts2={""," "}, nerdfonts3={""," "} } )
end

if rl.insertmode then
flexprompt.add_module( "overtype",      render_overtype                     )
end

if rl.ismodifiedline then
flexprompt.add_module( "modmark",       render_modmark                      )
end

flexprompt.register_scm("git", { test=test_git, info=info_git }, 20)
flexprompt.register_scm("hg",  { test=test_hg,  info=info_hg  }, 40)
flexprompt.register_scm("svn", { test=test_svn, info=info_svn }, 41)

flexprompt.register_vpn("rasdial", vpn_rasdial, 60)

_flexprompt_test_process_cwd_string = process_cwd_string -- luacheck: no global