@dev-blinq/cucumber-js 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) Julien Biezemans and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+<h1 align="center">
+  <img src="./docs/images/logo.svg" alt="">
+  <br>
+  Cucumber
+</h1>
+<p align="center">
+  <b>Automated tests in plain language, for Node.js</b>
+</p>
+
+[![#StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://vshymanskyy.github.io/StandWithUkraine)
+[![npm](https://img.shields.io/npm/v/@cucumber/cucumber.svg)](https://www.npmjs.com/package/@cucumber/cucumber)
+[![build](https://github.com/cucumber/cucumber-js/workflows/Build/badge.svg)](https://github.com/cucumber/cucumber-js/actions)
+[![coverage](https://coveralls.io/repos/github/cucumber/cucumber-js/badge.svg?branch=master)](https://coveralls.io/github/cucumber/cucumber-js?branch=master)
+[![backers](https://opencollective.com/cucumber/backers/badge.svg)](https://opencollective.com/cucumber)
+[![sponsors](https://opencollective.com/cucumber/sponsors/badge.svg)](https://opencollective.com/cucumber)
+
+[Cucumber](https://github.com/cucumber) is a tool for running automated tests written in plain language. Because they're
+written in plain language, they can be read by anyone on your team. Because they can be
+read by anyone, you can use them to help improve communication, collaboration and trust on
+your team.
+
+This is the JavaScript implementation of Cucumber. It runs on [maintained versions](https://github.com/nodejs/Release) of Node.js. You can [quickly try it via CodeSandbox](https://codesandbox.io/s/cucumber-js-demo-2p3vrl?file=/features/greeting.feature), or read on to get started locally in a couple of minutes.
+
+Looking to contribute? Read our [code of conduct](https://github.com/cucumber/.github/blob/main/CODE_OF_CONDUCT.md) first, then check the [contributing guide](./CONTRIBUTING.md) to get up and running.
+
+## Install
+
+Cucumber is [available on npm](https://www.npmjs.com/package/@cucumber/cucumber):
+
+```shell
+$ npm install @cucumber/cucumber
+```
+
+## Get Started
+
+Let's take this example of something to test:
+
+
+First, write your main code in `src/index.js`:
+
+```js
+class Greeter {
+  sayHello() {
+    return 'hello'
+  }
+}
+
+module.exports = {
+  Greeter
+}
+```
+
+Then, write your feature in `features/greeting.feature`:
+
+```gherkin
+Feature: Greeting
+
+  Scenario: Say hello
+    When the greeter says hello
+    Then I should have heard "hello"
+```
+
+Next, implement your steps in `features/support/steps.js`:
+
+```js
+const assert = require('assert')
+const { When, Then } = require('@cucumber/cucumber')
+const { Greeter } = require('../../src')
+
+When('the greeter says hello', function () {
+  this.whatIHeard = new Greeter().sayHello()
+});
+
+Then('I should have heard {string}', function (expectedResponse) {
+  assert.equal(this.whatIHeard, expectedResponse)
+});
+```
+
+Finally, run Cucumber:
+
+```shell
+$ npx cucumber-js
+```
+
+And see the output:
+
+![Terminal output showing a successful test run with 1 scenario and 2 steps, all passing](./docs/images/readme-output.png)
+
+If you learn best by example, we have [a repo with several example projects](https://github.com/cucumber/cucumber-js-examples), that might help you get going.
+
+## Documentation
+
+The following documentation is for `main`, which might contain some unreleased features. See [documentation for older versions](./docs/older_versions.md) if you need it.
+
+* [Installation](./docs/installation.md)
+* [CLI](./docs/cli.md)
+* [Configuration](./docs/configuration.md)
+* Support Code
+  * [API Reference](./docs/support_files/api_reference.md)
+  * [Attachments](./docs/support_files/attachments.md)
+  * [Data Tables](./docs/support_files/data_table_interface.md)
+  * [Hooks](./docs/support_files/hooks.md)
+  * [Step Definitions](./docs/support_files/step_definitions.md)
+  * [Timeouts](./docs/support_files/timeouts.md)
+  * [World](./docs/support_files/world.md)
+* Guides
+  * [Debugging](./docs/debugging.md)
+  * [Dry run](./docs/dry_run.md)
+  * [ES Modules](./docs/esm.md)
+  * [Failing fast](./docs/fail_fast.md)
+  * [Filtering which scenarios run](./docs/filtering.md)
+  * [Formatters for feedback and reporting](./docs/formatters.md)
+  * [Parallel running for speed](./docs/parallel.md)
+  * [Profiles for composable configuration](./docs/profiles.md)
+  * [Rerunning just failures](./docs/rerun.md)
+  * [Retrying flaky scenarios](./docs/retry.md)
+  * [JavaScript API for running programmatically](./docs/javascript_api.md)
+  * [Snippets for undefined steps](./docs/snippets.md)
+  * [Transpiling (from TypeScript etc)](./docs/transpiling.md)
+* [FAQ](./docs/faq.md)
+
+## Support
+
+Support is [available from the community](https://cucumber.io/tools/cucumber-open/support/) if you need it.

package/api/index.d.ts

@@ -0,0 +1,6 @@
+/*
+allows TypeScript to see `@cucumber/cucumber/api` where it doesn't yet support
+subpath exports, see <https://github.com/microsoft/TypeScript/issues/33079>
+ */
+
+export * from '../lib/api'

package/bin/cucumber-js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../lib/cli/run.js').default();

package/bin/cucumber.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../lib/cli/run.js').default();

package/lib/api/console_logger.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="node" />
+import { Writable } from 'stream';
+import { ILogger } from '../logger';
+export declare class ConsoleLogger implements ILogger {
+    private stream;
+    private debugEnabled;
+    private console;
+    constructor(stream: Writable, debugEnabled: boolean);
+    debug(...content: any[]): void;
+    error(...content: any[]): void;
+    warn(...content: any[]): void;
+}

package/lib/api/console_logger.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleLogger = void 0;
+const console_1 = require("console");
+class ConsoleLogger {
+    constructor(stream, debugEnabled) {
+        this.stream = stream;
+        this.debugEnabled = debugEnabled;
+        this.console = new console_1.Console(this.stream);
+    }
+    debug(...content) {
+        if (this.debugEnabled) {
+            this.console.debug(...content);
+        }
+    }
+    error(...content) {
+        this.console.error(...content);
+    }
+    warn(...content) {
+        this.console.warn(...content);
+    }
+}
+exports.ConsoleLogger = ConsoleLogger;
+//# sourceMappingURL=console_logger.js.map

package/lib/api/console_logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console_logger.js","sourceRoot":"","sources":["../../src/api/console_logger.ts"],"names":[],"mappings":";;;AAAA,qCAAiC;AAIjC,MAAa,aAAa;IAExB,YAAoB,MAAgB,EAAU,YAAqB;QAA/C,WAAM,GAAN,MAAM,CAAU;QAAU,iBAAY,GAAZ,YAAY,CAAS;QAD3D,YAAO,GAAY,IAAI,iBAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACmB,CAAC;IAEvE,KAAK,CAAC,GAAG,OAAc;QACrB,IAAI,IAAI,CAAC,YAAY,EAAE;YACrB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAA;SAC/B;IACH,CAAC;IAED,KAAK,CAAC,GAAG,OAAc;QACrB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAA;IAChC,CAAC;IAED,IAAI,CAAC,GAAG,OAAc;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAA;IAC/B,CAAC;CACF;AAjBD,sCAiBC","sourcesContent":["import { Console } from 'console'\nimport { Writable } from 'stream'\nimport { ILogger } from '../logger'\n\nexport class ConsoleLogger implements ILogger {\n  private console: Console = new Console(this.stream)\n  constructor(private stream: Writable, private debugEnabled: boolean) {}\n\n  debug(...content: any[]): void {\n    if (this.debugEnabled) {\n      this.console.debug(...content)\n    }\n  }\n\n  error(...content: any[]): void {\n    this.console.error(...content)\n  }\n\n  warn(...content: any[]): void {\n    this.console.warn(...content)\n  }\n}\n"]}

package/lib/api/convert_configuration.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="node" />
+import { IConfiguration } from '../configuration';
+import { IRunConfiguration } from './types';
+export declare function convertConfiguration(flatConfiguration: IConfiguration, env: NodeJS.ProcessEnv): Promise<IRunConfiguration>;

package/lib/api/convert_configuration.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertConfiguration = void 0;
+const configuration_1 = require("../configuration");
+async function convertConfiguration(flatConfiguration, env) {
+    return {
+        sources: {
+            paths: flatConfiguration.paths,
+            defaultDialect: flatConfiguration.language,
+            names: flatConfiguration.name,
+            tagExpression: flatConfiguration.tags,
+            order: flatConfiguration.order,
+        },
+        support: {
+            requireModules: flatConfiguration.requireModule,
+            requirePaths: flatConfiguration.require,
+            importPaths: flatConfiguration.import,
+        },
+        runtime: {
+            dryRun: flatConfiguration.dryRun,
+            failFast: flatConfiguration.failFast,
+            filterStacktraces: !flatConfiguration.backtrace,
+            parallel: flatConfiguration.parallel,
+            retry: flatConfiguration.retry,
+            retryTagFilter: flatConfiguration.retryTagFilter,
+            strict: flatConfiguration.strict,
+            worldParameters: flatConfiguration.worldParameters,
+        },
+        formats: convertFormats(flatConfiguration, env),
+    };
+}
+exports.convertConfiguration = convertConfiguration;
+function convertFormats(flatConfiguration, env) {
+    var _a, _b;
+    const splitFormats = flatConfiguration.format.map((item) => configuration_1.OptionSplitter.split(item));
+    return {
+        stdout: (_b = (_a = [...splitFormats].reverse().find(([, target]) => !target)) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : 'progress',
+        files: splitFormats
+            .filter(([, target]) => !!target)
+            .reduce((mapped, [type, target]) => {
+            return {
+                ...mapped,
+                [target]: type,
+            };
+        }, {}),
+        publish: makePublishConfig(flatConfiguration, env),
+        options: flatConfiguration.formatOptions,
+    };
+}
+function makePublishConfig(flatConfiguration, env) {
+    const enabled = isPublishing(flatConfiguration, env);
+    if (!enabled) {
+        return false;
+    }
+    return {
+        url: env.CUCUMBER_PUBLISH_URL,
+        token: env.CUCUMBER_PUBLISH_TOKEN,
+    };
+}
+function isPublishing(flatConfiguration, env) {
+    return (flatConfiguration.publish ||
+        (0, configuration_1.isTruthyString)(env.CUCUMBER_PUBLISH_ENABLED) ||
+        env.CUCUMBER_PUBLISH_TOKEN !== undefined);
+}
+//# sourceMappingURL=convert_configuration.js.map

package/lib/api/convert_configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert_configuration.js","sourceRoot":"","sources":["../../src/api/convert_configuration.ts"],"names":[],"mappings":";;;AAAA,oDAIyB;AAIlB,KAAK,UAAU,oBAAoB,CACxC,iBAAiC,EACjC,GAAsB;IAEtB,OAAO;QACL,OAAO,EAAE;YACP,KAAK,EAAE,iBAAiB,CAAC,KAAK;YAC9B,cAAc,EAAE,iBAAiB,CAAC,QAAQ;YAC1C,KAAK,EAAE,iBAAiB,CAAC,IAAI;YAC7B,aAAa,EAAE,iBAAiB,CAAC,IAAI;YACrC,KAAK,EAAE,iBAAiB,CAAC,KAAK;SAC/B;QACD,OAAO,EAAE;YACP,cAAc,EAAE,iBAAiB,CAAC,aAAa;YAC/C,YAAY,EAAE,iBAAiB,CAAC,OAAO;YACvC,WAAW,EAAE,iBAAiB,CAAC,MAAM;SACtC;QACD,OAAO,EAAE;YACP,MAAM,EAAE,iBAAiB,CAAC,MAAM;YAChC,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;YACpC,iBAAiB,EAAE,CAAC,iBAAiB,CAAC,SAAS;YAC/C,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;YACpC,KAAK,EAAE,iBAAiB,CAAC,KAAK;YAC9B,cAAc,EAAE,iBAAiB,CAAC,cAAc;YAChD,MAAM,EAAE,iBAAiB,CAAC,MAAM;YAChC,eAAe,EAAE,iBAAiB,CAAC,eAAe;SACnD;QACD,OAAO,EAAE,cAAc,CAAC,iBAAiB,EAAE,GAAG,CAAC;KAChD,CAAA;AACH,CAAC;AA7BD,oDA6BC;AAED,SAAS,cAAc,CACrB,iBAAiC,EACjC,GAAsB;;IAEtB,MAAM,YAAY,GAAe,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACrE,8BAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAC3B,CAAA;IACD,OAAO;QACL,MAAM,EACJ,MAAA,MAAA,CAAC,GAAG,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,0CAAG,CAAC,CAAC,mCAC9D,UAAU;QACZ,KAAK,EAAE,YAAY;aAChB,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;aAChC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;YACjC,OAAO;gBACL,GAAG,MAAM;gBACT,CAAC,MAAM,CAAC,EAAE,IAAI;aACf,CAAA;QACH,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,GAAG,CAAC;QAClD,OAAO,EAAE,iBAAiB,CAAC,aAAa;KACzC,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,iBAAiC,EACjC,GAAsB;IAEtB,MAAM,OAAO,GAAG,YAAY,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAA;IACpD,IAAI,CAAC,OAAO,EAAE;QACZ,OAAO,KAAK,CAAA;KACb;IACD,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,oBAAoB;QAC7B,KAAK,EAAE,GAAG,CAAC,sBAAsB;KAClC,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CACnB,iBAAiC,EACjC,GAAsB;IAEtB,OAAO,CACL,iBAAiB,CAAC,OAAO;QACzB,IAAA,8BAAc,EAAC,GAAG,CAAC,wBAAwB,CAAC;QAC5C,GAAG,CAAC,sBAAsB,KAAK,SAAS,CACzC,CAAA;AACH,CAAC","sourcesContent":["import {\n  IConfiguration,\n  isTruthyString,\n  OptionSplitter,\n} from '../configuration'\nimport { IPublishConfig } from '../formatter'\nimport { IRunConfiguration } from './types'\n\nexport async function convertConfiguration(\n  flatConfiguration: IConfiguration,\n  env: NodeJS.ProcessEnv\n): Promise<IRunConfiguration> {\n  return {\n    sources: {\n      paths: flatConfiguration.paths,\n      defaultDialect: flatConfiguration.language,\n      names: flatConfiguration.name,\n      tagExpression: flatConfiguration.tags,\n      order: flatConfiguration.order,\n    },\n    support: {\n      requireModules: flatConfiguration.requireModule,\n      requirePaths: flatConfiguration.require,\n      importPaths: flatConfiguration.import,\n    },\n    runtime: {\n      dryRun: flatConfiguration.dryRun,\n      failFast: flatConfiguration.failFast,\n      filterStacktraces: !flatConfiguration.backtrace,\n      parallel: flatConfiguration.parallel,\n      retry: flatConfiguration.retry,\n      retryTagFilter: flatConfiguration.retryTagFilter,\n      strict: flatConfiguration.strict,\n      worldParameters: flatConfiguration.worldParameters,\n    },\n    formats: convertFormats(flatConfiguration, env),\n  }\n}\n\nfunction convertFormats(\n  flatConfiguration: IConfiguration,\n  env: NodeJS.ProcessEnv\n) {\n  const splitFormats: string[][] = flatConfiguration.format.map((item) =>\n    OptionSplitter.split(item)\n  )\n  return {\n    stdout:\n      [...splitFormats].reverse().find(([, target]) => !target)?.[0] ??\n      'progress',\n    files: splitFormats\n      .filter(([, target]) => !!target)\n      .reduce((mapped, [type, target]) => {\n        return {\n          ...mapped,\n          [target]: type,\n        }\n      }, {}),\n    publish: makePublishConfig(flatConfiguration, env),\n    options: flatConfiguration.formatOptions,\n  }\n}\n\nfunction makePublishConfig(\n  flatConfiguration: IConfiguration,\n  env: NodeJS.ProcessEnv\n): IPublishConfig | false {\n  const enabled = isPublishing(flatConfiguration, env)\n  if (!enabled) {\n    return false\n  }\n  return {\n    url: env.CUCUMBER_PUBLISH_URL,\n    token: env.CUCUMBER_PUBLISH_TOKEN,\n  }\n}\n\nfunction isPublishing(\n  flatConfiguration: IConfiguration,\n  env: NodeJS.ProcessEnv\n): boolean {\n  return (\n    flatConfiguration.publish ||\n    isTruthyString(env.CUCUMBER_PUBLISH_ENABLED) ||\n    env.CUCUMBER_PUBLISH_TOKEN !== undefined\n  )\n}\n"]}

package/lib/api/environment.d.ts

@@ -0,0 +1,2 @@
+import { IRunEnvironment } from './types';
+export declare function mergeEnvironment(provided: IRunEnvironment): Required<IRunEnvironment>;

package/lib/api/environment.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeEnvironment = void 0;
+function mergeEnvironment(provided) {
+    return Object.assign({}, {
+        cwd: process.cwd(),
+        stdout: process.stdout,
+        stderr: process.stderr,
+        env: process.env,
+        debug: false,
+    }, provided);
+}
+exports.mergeEnvironment = mergeEnvironment;
+//# sourceMappingURL=environment.js.map

package/lib/api/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/api/environment.ts"],"names":[],"mappings":";;;AAEA,SAAgB,gBAAgB,CAC9B,QAAyB;IAEzB,OAAO,MAAM,CAAC,MAAM,CAClB,EAAE,EACF;QACE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,KAAK;KACb,EACD,QAAQ,CACT,CAAA;AACH,CAAC;AAdD,4CAcC","sourcesContent":["import { IRunEnvironment } from './types'\n\nexport function mergeEnvironment(\n  provided: IRunEnvironment\n): Required<IRunEnvironment> {\n  return Object.assign(\n    {},\n    {\n      cwd: process.cwd(),\n      stdout: process.stdout,\n      stderr: process.stderr,\n      env: process.env,\n      debug: false,\n    },\n    provided\n  )\n}\n"]}

package/lib/api/formatters.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { IFormatterStream } from '../formatter';
+import { EventEmitter } from 'events';
+import { EventDataCollector } from '../formatter/helpers';
+import { ISupportCodeLibrary } from '../support_code_library_builder/types';
+import { IRunOptionsFormats } from './types';
+import { ILogger } from '../logger';
+export declare function initializeFormatters({ env, cwd, stdout, logger, onStreamError, eventBroadcaster, eventDataCollector, configuration, supportCodeLibrary, }: {
+    env: NodeJS.ProcessEnv;
+    cwd: string;
+    stdout: IFormatterStream;
+    stderr: IFormatterStream;
+    logger: ILogger;
+    onStreamError: () => void;
+    eventBroadcaster: EventEmitter;
+    eventDataCollector: EventDataCollector;
+    configuration: IRunOptionsFormats;
+    supportCodeLibrary: ISupportCodeLibrary;
+}): Promise<() => Promise<void>>;

package/lib/api/formatters.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeFormatters = void 0;
+const util_1 = require("util");
+const builder_1 = __importDefault(require("../formatter/builder"));
+const fs_1 = __importDefault(require("mz/fs"));
+const path_1 = __importDefault(require("path"));
+const mkdirp_1 = require("mkdirp");
+async function initializeFormatters({ env, cwd, stdout, logger, onStreamError, eventBroadcaster, eventDataCollector, configuration, supportCodeLibrary, }) {
+    async function initializeFormatter(stream, target, type) {
+        stream.on('error', (error) => {
+            logger.error(error.message);
+            onStreamError();
+        });
+        const typeOptions = {
+            env,
+            cwd,
+            eventBroadcaster,
+            eventDataCollector,
+            log: stream.write.bind(stream),
+            parsedArgvOptions: configuration.options,
+            stream,
+            cleanup: stream === stdout
+                ? async () => await Promise.resolve()
+                : (0, util_1.promisify)(stream.end.bind(stream)),
+            supportCodeLibrary,
+        };
+        if (type === 'progress-bar' && !stream.isTTY) {
+            logger.warn(`Cannot use 'progress-bar' formatter for output to '${target}' as not a TTY. Switching to 'progress' formatter.`);
+            type = 'progress';
+        }
+        return await builder_1.default.build(type, typeOptions);
+    }
+    const formatters = [];
+    formatters.push(await initializeFormatter(stdout, 'stdout', configuration.stdout));
+    const streamPromises = [];
+    Object.entries(configuration.files).forEach(([target, type]) => {
+        streamPromises.push((async (target, type) => {
+            const absoluteTarget = path_1.default.resolve(cwd, target);
+            try {
+                await (0, mkdirp_1.mkdirp)(path_1.default.dirname(absoluteTarget));
+            }
+            catch (error) {
+                logger.warn('Failed to ensure directory for formatter target exists');
+            }
+            const stream = fs_1.default.createWriteStream(null, {
+                fd: await fs_1.default.open(absoluteTarget, 'w'),
+            });
+            formatters.push(await initializeFormatter(stream, target, type));
+        })(target, type));
+    });
+    await Promise.all(streamPromises);
+    return async function () {
+        await Promise.all(formatters.map(async (f) => await f.finished()));
+    };
+}
+exports.initializeFormatters = initializeFormatters;
+//# sourceMappingURL=formatters.js.map

package/lib/api/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/api/formatters.ts"],"names":[],"mappings":"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","sourcesContent":["import Formatter, { IFormatterStream } from '../formatter'\nimport { EventEmitter } from 'events'\nimport { EventDataCollector } from '../formatter/helpers'\nimport { ISupportCodeLibrary } from '../support_code_library_builder/types'\nimport { promisify } from 'util'\nimport { WriteStream as TtyWriteStream } from 'tty'\nimport FormatterBuilder from '../formatter/builder'\nimport fs from 'mz/fs'\nimport path from 'path'\nimport { IRunOptionsFormats } from './types'\nimport { ILogger } from '../logger'\nimport { mkdirp } from 'mkdirp'\n\nexport async function initializeFormatters({\n  env,\n  cwd,\n  stdout,\n  logger,\n  onStreamError,\n  eventBroadcaster,\n  eventDataCollector,\n  configuration,\n  supportCodeLibrary,\n}: {\n  env: NodeJS.ProcessEnv\n  cwd: string\n  stdout: IFormatterStream\n  stderr: IFormatterStream\n  logger: ILogger\n  onStreamError: () => void\n  eventBroadcaster: EventEmitter\n  eventDataCollector: EventDataCollector\n  configuration: IRunOptionsFormats\n  supportCodeLibrary: ISupportCodeLibrary\n}): Promise<() => Promise<void>> {\n  async function initializeFormatter(\n    stream: IFormatterStream,\n    target: string,\n    type: string\n  ): Promise<Formatter> {\n    stream.on('error', (error: Error) => {\n      logger.error(error.message)\n      onStreamError()\n    })\n    const typeOptions = {\n      env,\n      cwd,\n      eventBroadcaster,\n      eventDataCollector,\n      log: stream.write.bind(stream),\n      parsedArgvOptions: configuration.options,\n      stream,\n      cleanup:\n        stream === stdout\n          ? async () => await Promise.resolve()\n          : promisify<any>(stream.end.bind(stream)),\n      supportCodeLibrary,\n    }\n    if (type === 'progress-bar' && !(stream as TtyWriteStream).isTTY) {\n      logger.warn(\n        `Cannot use 'progress-bar' formatter for output to '${target}' as not a TTY. Switching to 'progress' formatter.`\n      )\n      type = 'progress'\n    }\n    return await FormatterBuilder.build(type, typeOptions)\n  }\n\n  const formatters: Formatter[] = []\n\n  formatters.push(\n    await initializeFormatter(stdout, 'stdout', configuration.stdout)\n  )\n\n  const streamPromises: Promise<void>[] = []\n\n  Object.entries(configuration.files).forEach(([target, type]) => {\n    streamPromises.push(\n      (async (target, type) => {\n        const absoluteTarget = path.resolve(cwd, target)\n\n        try {\n          await mkdirp(path.dirname(absoluteTarget))\n        } catch (error) {\n          logger.warn('Failed to ensure directory for formatter target exists')\n        }\n\n        const stream: IFormatterStream = fs.createWriteStream(null, {\n          fd: await fs.open(absoluteTarget, 'w'),\n        })\n        formatters.push(await initializeFormatter(stream, target, type))\n      })(target, type)\n    )\n  })\n\n  await Promise.all(streamPromises)\n\n  return async function () {\n    await Promise.all(formatters.map(async (f) => await f.finished()))\n  }\n}\n"]}

package/lib/api/gherkin.d.ts

@@ -0,0 +1,21 @@
+import { Envelope, GherkinDocument, IdGenerator, Location, ParseError, Pickle } from '@cucumber/messages';
+import { ISourcesCoordinates } from './types';
+import { ILogger } from '../logger';
+interface PickleWithDocument {
+    gherkinDocument: GherkinDocument;
+    location: Location;
+    pickle: Pickle;
+}
+export declare function getFilteredPicklesAndErrors({ newId, cwd, logger, unexpandedFeaturePaths, featurePaths, coordinates, onEnvelope, }: {
+    newId: IdGenerator.NewId;
+    cwd: string;
+    logger: ILogger;
+    unexpandedFeaturePaths: string[];
+    featurePaths: string[];
+    coordinates: ISourcesCoordinates;
+    onEnvelope?: (envelope: Envelope) => void;
+}): Promise<{
+    filteredPickles: PickleWithDocument[];
+    parseErrors: ParseError[];
+}>;
+export {};

package/lib/api/gherkin.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFilteredPicklesAndErrors = void 0;
+const gherkin_streams_1 = require("@cucumber/gherkin-streams");
+const gherkin_utils_1 = require("@cucumber/gherkin-utils");
+const pickle_filter_1 = __importDefault(require("../pickle_filter"));
+const helpers_1 = require("../cli/helpers");
+async function getFilteredPicklesAndErrors({ newId, cwd, logger, unexpandedFeaturePaths, featurePaths, coordinates, onEnvelope, }) {
+    const gherkinQuery = new gherkin_utils_1.Query();
+    const parseErrors = [];
+    await gherkinFromPaths(featurePaths, {
+        newId,
+        relativeTo: cwd,
+        defaultDialect: coordinates.defaultDialect,
+    }, (envelope) => {
+        gherkinQuery.update(envelope);
+        if (envelope.parseError) {
+            parseErrors.push(envelope.parseError);
+        }
+        onEnvelope === null || onEnvelope === void 0 ? void 0 : onEnvelope(envelope);
+    });
+    const pickleFilter = new pickle_filter_1.default({
+        cwd,
+        featurePaths: unexpandedFeaturePaths,
+        names: coordinates.names,
+        tagExpression: coordinates.tagExpression,
+    });
+    const filteredPickles = gherkinQuery
+        .getPickles()
+        .filter((pickle) => {
+        const gherkinDocument = gherkinQuery
+            .getGherkinDocuments()
+            .find((doc) => doc.uri === pickle.uri);
+        return pickleFilter.matches({ gherkinDocument, pickle });
+    })
+        .map((pickle) => {
+        const gherkinDocument = gherkinQuery
+            .getGherkinDocuments()
+            .find((doc) => doc.uri === pickle.uri);
+        const location = gherkinQuery.getLocation(pickle.astNodeIds[pickle.astNodeIds.length - 1]);
+        return {
+            gherkinDocument,
+            location,
+            pickle,
+        };
+    });
+    (0, helpers_1.orderPickles)(filteredPickles, coordinates.order, logger);
+    return {
+        filteredPickles,
+        parseErrors,
+    };
+}
+exports.getFilteredPicklesAndErrors = getFilteredPicklesAndErrors;
+async function gherkinFromPaths(paths, options, onEnvelope) {
+    return new Promise((resolve, reject) => {
+        const gherkinMessageStream = gherkin_streams_1.GherkinStreams.fromPaths(paths, options);
+        gherkinMessageStream.on('data', onEnvelope);
+        gherkinMessageStream.on('end', resolve);
+        gherkinMessageStream.on('error', reject);
+    });
+}
+//# sourceMappingURL=gherkin.js.map

package/lib/api/gherkin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gherkin.js","sourceRoot":"","sources":["../../src/api/gherkin.ts"],"names":[],"mappings":";;;;;;AAAA,+DAGkC;AASlC,2DAA+D;AAC/D,qEAA2C;AAC3C,4CAA6C;AAUtC,KAAK,UAAU,2BAA2B,CAAC,EAChD,KAAK,EACL,GAAG,EACH,MAAM,EACN,sBAAsB,EACtB,YAAY,EACZ,WAAW,EACX,UAAU,GASX;IAIC,MAAM,YAAY,GAAG,IAAI,qBAAY,EAAE,CAAA;IACvC,MAAM,WAAW,GAAiB,EAAE,CAAA;IACpC,MAAM,gBAAgB,CACpB,YAAY,EACZ;QACE,KAAK;QACL,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,WAAW,CAAC,cAAc;KAC3C,EACD,CAAC,QAAQ,EAAE,EAAE;QACX,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC7B,IAAI,QAAQ,CAAC,UAAU,EAAE;YACvB,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;SACtC;QACD,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,QAAQ,CAAC,CAAA;IACxB,CAAC,CACF,CAAA;IACD,MAAM,YAAY,GAAG,IAAI,uBAAY,CAAC;QACpC,GAAG;QACH,YAAY,EAAE,sBAAsB;QACpC,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,aAAa,EAAE,WAAW,CAAC,aAAa;KACzC,CAAC,CAAA;IACF,MAAM,eAAe,GAAyB,YAAY;SACvD,UAAU,EAAE;SACZ,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,eAAe,GAAG,YAAY;aACjC,mBAAmB,EAAE;aACrB,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,CAAC,CAAA;QACxC,OAAO,YAAY,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAA;IAC1D,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,eAAe,GAAG,YAAY;aACjC,mBAAmB,EAAE;aACrB,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,CAAC,CAAA;QACxC,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,CACvC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAChD,CAAA;QACD,OAAO;YACL,eAAe;YACf,QAAQ;YACR,MAAM;SACP,CAAA;IACH,CAAC,CAAC,CAAA;IACJ,IAAA,sBAAY,EAAC,eAAe,EAAE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACxD,OAAO;QACL,eAAe;QACf,WAAW;KACZ,CAAA;AACH,CAAC;AArED,kEAqEC;AAED,KAAK,UAAU,gBAAgB,CAC7B,KAAe,EACf,OAA8B,EAC9B,UAAwC;IAExC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,oBAAoB,GAAG,gCAAc,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACrE,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;QAC3C,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACvC,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import {\n  GherkinStreams,\n  IGherkinStreamOptions,\n} from '@cucumber/gherkin-streams'\nimport {\n  Envelope,\n  GherkinDocument,\n  IdGenerator,\n  Location,\n  ParseError,\n  Pickle,\n} from '@cucumber/messages'\nimport { Query as GherkinQuery } from '@cucumber/gherkin-utils'\nimport PickleFilter from '../pickle_filter'\nimport { orderPickles } from '../cli/helpers'\nimport { ISourcesCoordinates } from './types'\nimport { ILogger } from '../logger'\n\ninterface PickleWithDocument {\n  gherkinDocument: GherkinDocument\n  location: Location\n  pickle: Pickle\n}\n\nexport async function getFilteredPicklesAndErrors({\n  newId,\n  cwd,\n  logger,\n  unexpandedFeaturePaths,\n  featurePaths,\n  coordinates,\n  onEnvelope,\n}: {\n  newId: IdGenerator.NewId\n  cwd: string\n  logger: ILogger\n  unexpandedFeaturePaths: string[]\n  featurePaths: string[]\n  coordinates: ISourcesCoordinates\n  onEnvelope?: (envelope: Envelope) => void\n}): Promise<{\n  filteredPickles: PickleWithDocument[]\n  parseErrors: ParseError[]\n}> {\n  const gherkinQuery = new GherkinQuery()\n  const parseErrors: ParseError[] = []\n  await gherkinFromPaths(\n    featurePaths,\n    {\n      newId,\n      relativeTo: cwd,\n      defaultDialect: coordinates.defaultDialect,\n    },\n    (envelope) => {\n      gherkinQuery.update(envelope)\n      if (envelope.parseError) {\n        parseErrors.push(envelope.parseError)\n      }\n      onEnvelope?.(envelope)\n    }\n  )\n  const pickleFilter = new PickleFilter({\n    cwd,\n    featurePaths: unexpandedFeaturePaths,\n    names: coordinates.names,\n    tagExpression: coordinates.tagExpression,\n  })\n  const filteredPickles: PickleWithDocument[] = gherkinQuery\n    .getPickles()\n    .filter((pickle) => {\n      const gherkinDocument = gherkinQuery\n        .getGherkinDocuments()\n        .find((doc) => doc.uri === pickle.uri)\n      return pickleFilter.matches({ gherkinDocument, pickle })\n    })\n    .map((pickle) => {\n      const gherkinDocument = gherkinQuery\n        .getGherkinDocuments()\n        .find((doc) => doc.uri === pickle.uri)\n      const location = gherkinQuery.getLocation(\n        pickle.astNodeIds[pickle.astNodeIds.length - 1]\n      )\n      return {\n        gherkinDocument,\n        location,\n        pickle,\n      }\n    })\n  orderPickles(filteredPickles, coordinates.order, logger)\n  return {\n    filteredPickles,\n    parseErrors,\n  }\n}\n\nasync function gherkinFromPaths(\n  paths: string[],\n  options: IGherkinStreamOptions,\n  onEnvelope: (envelope: Envelope) => void\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const gherkinMessageStream = GherkinStreams.fromPaths(paths, options)\n    gherkinMessageStream.on('data', onEnvelope)\n    gherkinMessageStream.on('end', resolve)\n    gherkinMessageStream.on('error', reject)\n  })\n}\n"]}

package/lib/api/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Cucumber for JavaScript
+ *
+ * @remarks These docs cover the API used for running Cucumber programmatically. The entry point is `@cucumber/cucumber/api`.
+ * @packageDocumentation
+ */
+export { IConfiguration } from '../configuration';
+export * from './load_configuration';
+export * from './load_sources';
+export * from './load_support';
+export * from './run_cucumber';
+export * from './types';

package/lib/api/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Cucumber for JavaScript
+ *
+ * @remarks These docs cover the API used for running Cucumber programmatically. The entry point is `@cucumber/cucumber/api`.
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./load_configuration"), exports);
+__exportStar(require("./load_sources"), exports);
+__exportStar(require("./load_support"), exports);
+__exportStar(require("./run_cucumber"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/lib/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAGH,uDAAoC;AACpC,iDAA8B;AAC9B,iDAA8B;AAC9B,iDAA8B;AAC9B,0CAAuB","sourcesContent":["/**\n * Cucumber for JavaScript\n *\n * @remarks These docs cover the API used for running Cucumber programmatically. The entry point is `@cucumber/cucumber/api`.\n * @packageDocumentation\n */\n\nexport { IConfiguration } from '../configuration'\nexport * from './load_configuration'\nexport * from './load_sources'\nexport * from './load_support'\nexport * from './run_cucumber'\nexport * from './types'\n"]}

package/lib/api/load_configuration.d.ts

@@ -0,0 +1,9 @@
+import { IRunEnvironment, IResolvedConfiguration, ILoadConfigurationOptions } from './types';
+/**
+ * Load user-authored configuration to be used in a test run.
+ *
+ * @public
+ * @param options - Coordinates required to find configuration.
+ * @param environment - Project environment.
+ */
+export declare function loadConfiguration(options?: ILoadConfigurationOptions, environment?: IRunEnvironment): Promise<IResolvedConfiguration>;

package/lib/api/load_configuration.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfiguration = void 0;
+const locate_file_1 = require("../configuration/locate_file");
+const configuration_1 = require("../configuration");
+const validate_configuration_1 = require("../configuration/validate_configuration");
+const convert_configuration_1 = require("./convert_configuration");
+const environment_1 = require("./environment");
+const console_logger_1 = require("./console_logger");
+/**
+ * Load user-authored configuration to be used in a test run.
+ *
+ * @public
+ * @param options - Coordinates required to find configuration.
+ * @param environment - Project environment.
+ */
+async function loadConfiguration(options = {}, environment = {}) {
+    var _a;
+    const { cwd, stderr, env, debug } = (0, environment_1.mergeEnvironment)(environment);
+    const logger = new console_logger_1.ConsoleLogger(stderr, debug);
+    const configFile = (_a = options.file) !== null && _a !== void 0 ? _a : (0, locate_file_1.locateFile)(cwd);
+    if (configFile) {
+        logger.debug(`Configuration will be loaded from "${configFile}"`);
+    }
+    else {
+        logger.debug('No configuration file found');
+    }
+    const profileConfiguration = configFile
+        ? await (0, configuration_1.fromFile)(logger, cwd, configFile, options.profiles)
+        : {};
+    const original = (0, configuration_1.mergeConfigurations)(configuration_1.DEFAULT_CONFIGURATION, profileConfiguration, options.provided);
+    logger.debug('Resolved configuration:', original);
+    (0, validate_configuration_1.validateConfiguration)(original, logger);
+    const runnable = await (0, convert_configuration_1.convertConfiguration)(original, env);
+    return {
+        useConfiguration: original,
+        runConfiguration: runnable,
+    };
+}
+exports.loadConfiguration = loadConfiguration;
+//# sourceMappingURL=load_configuration.js.map

package/lib/api/load_configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_configuration.js","sourceRoot":"","sources":["../../src/api/load_configuration.ts"],"names":[],"mappings":";;;AAKA,8DAAyD;AACzD,oDAIyB;AACzB,oFAA+E;AAC/E,mEAA8D;AAC9D,+CAAgD;AAEhD,qDAAgD;AAEhD;;;;;;GAMG;AACI,KAAK,UAAU,iBAAiB,CACrC,UAAqC,EAAE,EACvC,cAA+B,EAAE;;IAEjC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAA,8BAAgB,EAAC,WAAW,CAAC,CAAA;IACjE,MAAM,MAAM,GAAY,IAAI,8BAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACxD,MAAM,UAAU,GAAG,MAAA,OAAO,CAAC,IAAI,mCAAI,IAAA,wBAAU,EAAC,GAAG,CAAC,CAAA;IAClD,IAAI,UAAU,EAAE;QACd,MAAM,CAAC,KAAK,CAAC,sCAAsC,UAAU,GAAG,CAAC,CAAA;KAClE;SAAM;QACL,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAA;KAC5C;IACD,MAAM,oBAAoB,GAAG,UAAU;QACrC,CAAC,CAAC,MAAM,IAAA,wBAAQ,EAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC;QAC3D,CAAC,CAAC,EAAE,CAAA;IACN,MAAM,QAAQ,GAAG,IAAA,mCAAmB,EAClC,qCAAqB,EACrB,oBAAoB,EACpB,OAAO,CAAC,QAAQ,CACjB,CAAA;IACD,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAA;IACjD,IAAA,8CAAqB,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACvC,MAAM,QAAQ,GAAG,MAAM,IAAA,4CAAoB,EAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IAC1D,OAAO;QACL,gBAAgB,EAAE,QAAQ;QAC1B,gBAAgB,EAAE,QAAQ;KAC3B,CAAA;AACH,CAAC;AA3BD,8CA2BC","sourcesContent":["import {\n  IRunEnvironment,\n  IResolvedConfiguration,\n  ILoadConfigurationOptions,\n} from './types'\nimport { locateFile } from '../configuration/locate_file'\nimport {\n  DEFAULT_CONFIGURATION,\n  fromFile,\n  mergeConfigurations,\n} from '../configuration'\nimport { validateConfiguration } from '../configuration/validate_configuration'\nimport { convertConfiguration } from './convert_configuration'\nimport { mergeEnvironment } from './environment'\nimport { ILogger } from '../logger'\nimport { ConsoleLogger } from './console_logger'\n\n/**\n * Load user-authored configuration to be used in a test run.\n *\n * @public\n * @param options - Coordinates required to find configuration.\n * @param environment - Project environment.\n */\nexport async function loadConfiguration(\n  options: ILoadConfigurationOptions = {},\n  environment: IRunEnvironment = {}\n): Promise<IResolvedConfiguration> {\n  const { cwd, stderr, env, debug } = mergeEnvironment(environment)\n  const logger: ILogger = new ConsoleLogger(stderr, debug)\n  const configFile = options.file ?? locateFile(cwd)\n  if (configFile) {\n    logger.debug(`Configuration will be loaded from \"${configFile}\"`)\n  } else {\n    logger.debug('No configuration file found')\n  }\n  const profileConfiguration = configFile\n    ? await fromFile(logger, cwd, configFile, options.profiles)\n    : {}\n  const original = mergeConfigurations(\n    DEFAULT_CONFIGURATION,\n    profileConfiguration,\n    options.provided\n  )\n  logger.debug('Resolved configuration:', original)\n  validateConfiguration(original, logger)\n  const runnable = await convertConfiguration(original, env)\n  return {\n    useConfiguration: original,\n    runConfiguration: runnable,\n  }\n}\n"]}

package/lib/api/load_sources.d.ts

@@ -0,0 +1,9 @@
+import { ILoadSourcesResult, IRunEnvironment, ISourcesCoordinates } from './types';
+/**
+ * Load and parse features, produce a filtered and ordered test plan and/or parse errors.
+ *
+ * @public
+ * @param coordinates - Coordinates required to find features
+ * @param environment - Project environment.
+ */
+export declare function loadSources(coordinates: ISourcesCoordinates, environment?: IRunEnvironment): Promise<ILoadSourcesResult>;