Feature: add target folder parameter to def command (codeceptjs#1689)

* add parameter 'to' to def command

* update doc for def command

* change name of def param to output

bin/codecept.js

@@ -36,6 +36,7 @@ program.command('list [path]')
 program.command('def [path]')
   .description('Generates TypeScript definitions for all I actions.')
   .option('-c, --config [file]', 'configuration file to be used')
+  .option('-o, --output [folder]', 'target folder to paste definitions')
   .action(require('../lib/command/definitions'));
 
 program.command('gherkin:init [path]')

docs/commands.md

@@ -155,6 +155,13 @@ Feature('My new test');
 
 After doing that IDE should provide autocompletion for `I` object inside `Scenario` and `within` blocks.
 
+Add optional parameter `output` (or shortcat `-o`), if you want to place your definition file in specific folder:
+
+```sh
+codeceptjs def --output ./tests/typings
+codeceptjs def -o ./tests/typings
+```
+
 ## List Commands
 
 Prints all available methods of `I` to console

lib/command/definitions.js

@@ -154,6 +154,8 @@ module.exports = function (genPath, options) {
   const config = getConfig(configFile);
   if (!config) return;
 
+  const targetFolderPath = options.output && getTestRoot(options.output) || testsPath;
+
   const codecept = new Codecept(config, {});
   codecept.init(testsPath);
 
@@ -188,7 +190,7 @@ module.exports = function (genPath, options) {
     definitionsTemplate = definitionsTemplate.replace(/\{\{I\}\}/g, translations.I);
   }
 
-  fs.writeFileSync(path.join(testsPath, 'steps.d.ts'), definitionsTemplate);
+  fs.writeFileSync(path.join(targetFolderPath, 'steps.d.ts'), definitionsTemplate);
   output.print('TypeScript Definitions provide autocompletion in Visual Studio Code and other IDEs');
   output.print('Definitions were generated in steps.d.ts');
   output.print('Load them by adding at the top of a test file:');