--- @since 26.9.1 local MODE_DIRECTORY = "directory" local MODE_FILE = "file" local MODE_EITHER = "either" local DIRECTION_FORWARD = "forward" local DIRECTION_BACKWARD = "backward" local CASE_SENSITIVE = "sensitive" local CASE_INSENSITIVE = "insensitive" local CASE_SMART = "smart" local ACTION_ENTER = "enter" local ACTION_OPEN_HOVERED = "open-hovered" local ACTION_NONE = "none" local ACCEPTED_OPTIONS = { previous = true, smart = true, insensitive = true, } local function parse_mode(value) if value == MODE_DIRECTORY or value == MODE_FILE or value == MODE_EITHER then return value end error("yazi-enter: mode must be directory, file, or either", 0) end local function normalize_boolean(name, value) if value == nil or value == false or value == "no" then return false end if value == true or value == "yes" then return true end error(("yazi-enter: option --%s must be true, false, 'yes', or 'no'"):format(name), 0) end local function normalize_options(args) return normalize_boolean("previous", args.previous), normalize_boolean("smart", args.smart), normalize_boolean("insensitive", args.insensitive) end local function validate_argument_keys(args) for key in pairs(args) do local key_type = type(key) if key_type == "number" and key ~= 1 then error(("yazi-enter: unexpected positional argument at index %s"):format(key), 0) elseif key_type == "string" and not ACCEPTED_OPTIONS[key] then error(("yazi-enter: unknown option --%s"):format(key), 0) elseif key_type ~= "number" and key_type ~= "string" then error("yazi-enter: argument keys must be positional indexes or option names", 0) end end end local function derive_direction(previous) if previous then return DIRECTION_BACKWARD end return DIRECTION_FORWARD end local function derive_effective_case(smart, insensitive) if smart then return CASE_SMART end if insensitive then return CASE_INSENSITIVE end return CASE_SENSITIVE end local function parse_invocation_intent(args) local mode = parse_mode(args[1]) local previous, smart, insensitive = normalize_options(args) validate_argument_keys(args) return { mode = mode, previous = previous, smart = smart, insensitive = insensitive, direction = derive_direction(previous), effective_case = derive_effective_case(smart, insensitive), } end local function decide_target(mode, is_dir) if mode == MODE_DIRECTORY then if is_dir then return ACTION_ENTER end return ACTION_NONE end if mode == MODE_FILE then if is_dir then return ACTION_NONE end return ACTION_OPEN_HOVERED end if mode == MODE_EITHER then if is_dir then return ACTION_ENTER end return ACTION_OPEN_HOVERED end return ACTION_NONE end local commit = ya.sync(function() return 0 end) return { entry = function(_, job) return parse_invocation_intent(job.args) end, }