import run, { executableToString } from "package-run";
 
run({
  command: "babel",
  args: [
    "./src",
    {
      "out-dir": "./build",
      "config-file": "./babel.config.json",
      "watch": true
    }
  ]
}, {
  slient: false // If true, will not output from yarn/npm/npx.
});
 
// Equivalent of:
// yarn run babel ./src --out-dir ./build --config-file ./babel.config.json --watch
// npx --no-install babel ./src --out-dir ./build --config-file ./babel.config.json --watch
// pnpm run babel ./src --out-dir ./build --config-file ./babel.config.json --watch
 
executableToString({
  command: "babel",
  args: [
    "./src"
    {
      "out-dir": "./build",
      "config-file": "./babel.config.json",
      "watch": true
    }
  ]
});
 
// "yarn run babel ./src --out-dir ./build --config-file ./babel.config.json --watch"

function run(executable: Executable, options?: RunOptions): Promise<ExecResult>;
 
function getString(executable: Executable, options?: RunOptions): Promise<string>;
 
type Executable = {
  command: string;
  args?: Args;
  cwd?: string;
  env?: NodeJS.ProcessEnv;
  silent?: boolean;
}
 
type Args = Arg | Arg[];
 
type Arg = string | Flags;
 
type Flags = {
  [flag: string]: string | number | boolean  | string[] | undefined;
}
 
type ExecResult = {
  output: string;
  error: string;
  textOutput: string; // output stripped on ANSI colors
  textError: string; // error stripped on ANSI colors
  jsonOutput: () => JSONObject | JSONArray | undefined; // First JSON object or array in output
  jsonError: () => JSONObject | JSONArray | undefined; // First JSON object or array in error
}
 
type RunOptions = {
  silent?: boolean | undefined;
}