pub(all) suberror CliError {
  HelpRequested
  MissingSpec
  MissingUninstallName
  UnknownFlag(String)
  MissingFlagValue(String)
  InvalidTarget(String)
  UnexpectedArg(String)
}

pub(all) suberror ExecError {
  CommandFailed(String, Int)
}

pub(all) suberror InstallError {
  MissingHome
  InvalidSpec(String)
  InvalidArgs(String)
  IoError(String)
  CommandFailed(String, Int)
  ArtifactNotFound(String)
  RegistryIndexNotFound(String)
  RegistryIndexInvalid(String)
  UnsupportedTarget(String)
}

pub(all) suberror RegistryIndexError {
  InvalidJson
  MissingVersion
}

pub(all) suberror SpecError {
  MissingOwner
  MissingRepo
  MissingVersion
  MissingPackagePath
  InvalidFormat(String)
}

pub(all) suberror VersionSelectError {
  InvalidLatest(String)
  InvalidRequested(String)
}

pub enum Command {
  Install(InstallArgs)
  Uninstall(String)
}

pub struct InstallArgs {
  spec : String
  name : String?
  target : Target
}

pub struct Spec {
  owner : String
  repo : String
  version : String?
  package_path : String
  package_name : String
}

pub enum Target {
  Native
  Js
}

fn artifact_path(repo_dir : String, package_path : String, target : Target) -> String

fn ensure_dir_recursive(path : String) -> Unit raise 
@moonbitlang/x/fs.IOError
IOError

fn install(spec : Spec, name : String, target : Target) -> Result[Unit, InstallError]

fn join_path(lhs : String, rhs : String) -> String

fn parse_cli_args(args : Array[String]) -> Result[Command, CliError]

fn parse_registry_latest_version(content : String) -> Result[String, RegistryIndexError]

fn parse_spec(input : String) -> Result[Spec, SpecError]

fn remove_dir_recursive(path : String) -> Unit raise 
@moonbitlang/x/fs.IOError
IOError

fn run_cli() -> Unit

fn run_shell(cmd : String) -> Result[Unit, ExecError]

fn run_shell_in_dir(dir : String, args : Array[String]) -> Result[Unit, ExecError]

fn select_version(requested : String?, latest : String) -> Result[String, VersionSelectError]

fn shell_escape(s : String) -> String

fn shell_join(args : Array[String]) -> String

fn uninstall(name : String) -> Result[Unit, InstallError]

fn usage() -> String