@lynxwall/cucumber-tsflow 7.4.1 → 7.5.5

package/bin/cucumber-tsflow

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

package/lib/api/convert-configuration.d.ts

@@ -4,4 +4,4 @@ import { ITsFlowRunConfiguration } from '../runtime/types';
 export interface IConfigurationExt extends IConfiguration {
     experimentalDecorators: boolean;
 }
-export declare function convertConfiguration(logger: ILogger, flatConfiguration: IConfigurationExt, env: NodeJS.ProcessEnv): Promise<ITsFlowRunConfiguration>;
+export declare function convertConfiguration(cucumberLogger: ILogger, flatConfiguration: IConfigurationExt, env: typeof process.env): Promise<ITsFlowRunConfiguration>;

package/lib/api/convert-configuration.js

@@ -2,22 +2,37 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.convertConfiguration = convertConfiguration;
 const index_1 = require("@cucumber/cucumber/lib/configuration/index");
-async function convertConfiguration(logger, flatConfiguration, env) {
-    return {
-        sources: {
+const tsflow_logger_1 = require("../utils/tsflow-logger");
+const logger = (0, tsflow_logger_1.createLogger)('convert');
+async function convertConfiguration(cucumberLogger, flatConfiguration, env) {
+    logger.checkpoint('convertConfiguration() started');
+    try {
+        logger.checkpoint('Building sources config', {
+            pathCount: flatConfiguration.paths?.length,
+            language: flatConfiguration.language
+        });
+        const sources = {
             paths: flatConfiguration.paths,
             defaultDialect: flatConfiguration.language,
             names: flatConfiguration.name,
             tagExpression: flatConfiguration.tags,
             order: flatConfiguration.order
-        },
-        support: {
+        };
+        logger.checkpoint('Building support config', {
+            requireModules: flatConfiguration.requireModule,
+            loaders: flatConfiguration.loader
+        });
+        const support = {
             requireModules: flatConfiguration.requireModule,
             requirePaths: flatConfiguration.require,
             importPaths: flatConfiguration.import,
             loaders: flatConfiguration.loader
-        },
-        runtime: {
+        };
+        logger.checkpoint('Building runtime config', {
+            parallel: flatConfiguration.parallel,
+            experimentalDecorators: flatConfiguration.experimentalDecorators
+        });
+        const runtime = {
             dryRun: flatConfiguration.dryRun,
             experimentalDecorators: flatConfiguration.experimentalDecorators,
             failFast: flatConfiguration.failFast,
@@ -27,25 +42,53 @@ async function convertConfiguration(logger, flatConfiguration, env) {
             retryTagFilter: flatConfiguration.retryTagFilter,
             strict: flatConfiguration.strict,
             worldParameters: flatConfiguration.worldParameters
-        },
-        formats: convertFormats(logger, flatConfiguration, env)
-    };
+        };
+        logger.checkpoint('Building formats config');
+        const formats = convertFormats(cucumberLogger, flatConfiguration, env);
+        logger.checkpoint('convertConfiguration() completed');
+        return {
+            sources,
+            support,
+            runtime,
+            formats
+        };
+    }
+    catch (error) {
+        logger.error('convertConfiguration() failed', error);
+        throw new Error(`Failed to convert configuration: ${error.message}`, { cause: error });
+    }
 }
-function convertFormats(logger, flatConfiguration, env) {
-    const splitFormats = flatConfiguration.format.map(item => Array.isArray(item) ? item : (0, index_1.splitFormatDescriptor)(logger, item));
-    return {
-        stdout: [...splitFormats].reverse().find(([, target]) => !target)?.[0] ?? 'progress',
-        files: splitFormats
+function convertFormats(cucumberLogger, flatConfiguration, env) {
+    logger.checkpoint('convertFormats() started', { formatCount: flatConfiguration.format?.length });
+    try {
+        const splitFormats = flatConfiguration.format.map((item, index) => {
+            const result = Array.isArray(item) ? item : (0, index_1.splitFormatDescriptor)(cucumberLogger, item);
+            logger.checkpoint(`Format[${index}] processed`, { input: item, output: result });
+            return result;
+        });
+        const stdout = [...splitFormats].reverse().find(([, target]) => !target)?.[0] ?? 'progress';
+        logger.checkpoint('Stdout format', { stdout });
+        const files = splitFormats
             .filter(([, target]) => !!target)
             .reduce((mapped, [type, target]) => {
             return {
                 ...mapped,
                 [target]: type
             };
-        }, {}),
-        publish: makePublishConfig(flatConfiguration, env),
-        options: flatConfiguration.formatOptions
-    };
+        }, {});
+        logger.checkpoint('File formats', { files });
+        const publish = makePublishConfig(flatConfiguration, env);
+        return {
+            stdout,
+            files,
+            publish,
+            options: flatConfiguration.formatOptions
+        };
+    }
+    catch (error) {
+        logger.error('convertFormats() failed', error);
+        throw new Error(`Failed to convert formats: ${error.message}`, { cause: error });
+    }
 }
 function makePublishConfig(flatConfiguration, env) {
     const enabled = isPublishing(flatConfiguration, env);

package/lib/api/convert-configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"convert-configuration.js","sourceRoot":"","sources":["../../src/api/convert-configuration.ts"],"names":[],"mappings":"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","sourcesContent":["import { IConfiguration, isTruthyString, splitFormatDescriptor } from '@cucumber/cucumber/lib/configuration/index';\r\nimport { IPublishConfig } from '@cucumber/cucumber/lib/publish/index';\r\nimport { ILogger } from '@cucumber/cucumber/lib/environment/index';\r\n\r\n// imports the namespace needed for NodeJS - keeps eslint happy\r\nimport NodeJS from 'node:process';\r\nimport { ITsFlowRunConfiguration } from '../runtime/types';\r\n\r\nexport interface IConfigurationExt extends IConfiguration {\r\n\texperimentalDecorators: boolean;\r\n}\r\n\r\nexport async function convertConfiguration(\r\n\tlogger: ILogger,\r\n\tflatConfiguration: IConfigurationExt,\r\n\tenv: NodeJS.ProcessEnv\r\n): Promise<ITsFlowRunConfiguration> {\r\n\treturn {\r\n\t\tsources: {\r\n\t\t\tpaths: flatConfiguration.paths,\r\n\t\t\tdefaultDialect: flatConfiguration.language,\r\n\t\t\tnames: flatConfiguration.name,\r\n\t\t\ttagExpression: flatConfiguration.tags,\r\n\t\t\torder: flatConfiguration.order\r\n\t\t},\r\n\t\tsupport: {\r\n\t\t\trequireModules: flatConfiguration.requireModule,\r\n\t\t\trequirePaths: flatConfiguration.require,\r\n\t\t\timportPaths: flatConfiguration.import,\r\n\t\t\tloaders: flatConfiguration.loader\r\n\t\t},\r\n\t\truntime: {\r\n\t\t\tdryRun: flatConfiguration.dryRun,\r\n\t\t\texperimentalDecorators: flatConfiguration.experimentalDecorators,\r\n\t\t\tfailFast: flatConfiguration.failFast,\r\n\t\t\tfilterStacktraces: !flatConfiguration.backtrace,\r\n\t\t\tparallel: flatConfiguration.parallel,\r\n\t\t\tretry: flatConfiguration.retry,\r\n\t\t\tretryTagFilter: flatConfiguration.retryTagFilter,\r\n\t\t\tstrict: flatConfiguration.strict,\r\n\t\t\tworldParameters: flatConfiguration.worldParameters\r\n\t\t},\r\n\t\tformats: convertFormats(logger, flatConfiguration, env)\r\n\t};\r\n}\r\n\r\nfunction convertFormats(logger: ILogger, flatConfiguration: IConfiguration, env: NodeJS.ProcessEnv) {\r\n\tconst splitFormats: string[][] = flatConfiguration.format.map(item =>\r\n\t\tArray.isArray(item) ? item : splitFormatDescriptor(logger, item)\r\n\t);\r\n\treturn {\r\n\t\tstdout: [...splitFormats].reverse().find(([, target]) => !target)?.[0] ?? 'progress',\r\n\t\tfiles: splitFormats\r\n\t\t\t.filter(([, target]) => !!target)\r\n\t\t\t.reduce((mapped, [type, target]) => {\r\n\t\t\t\treturn {\r\n\t\t\t\t\t...mapped,\r\n\t\t\t\t\t[target]: type\r\n\t\t\t\t};\r\n\t\t\t}, {}),\r\n\t\tpublish: makePublishConfig(flatConfiguration, env),\r\n\t\toptions: flatConfiguration.formatOptions\r\n\t};\r\n}\r\n\r\nfunction makePublishConfig(flatConfiguration: IConfiguration, env: NodeJS.ProcessEnv): IPublishConfig | false {\r\n\tconst enabled = isPublishing(flatConfiguration, env);\r\n\tif (!enabled) {\r\n\t\treturn false;\r\n\t}\r\n\treturn {\r\n\t\turl: env.CUCUMBER_PUBLISH_URL,\r\n\t\ttoken: env.CUCUMBER_PUBLISH_TOKEN\r\n\t};\r\n}\r\n\r\nfunction isPublishing(flatConfiguration: IConfiguration, env: NodeJS.ProcessEnv): boolean {\r\n\treturn (\r\n\t\tflatConfiguration.publish ||\r\n\t\tisTruthyString(env.CUCUMBER_PUBLISH_ENABLED) ||\r\n\t\tenv.CUCUMBER_PUBLISH_TOKEN !== undefined\r\n\t);\r\n}\r\n"]}
+{"version":3,"file":"convert-configuration.js","sourceRoot":"","sources":["../../src/api/convert-configuration.ts"],"names":[],"mappings":"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","sourcesContent":["import { IConfiguration, isTruthyString, splitFormatDescriptor } from '@cucumber/cucumber/lib/configuration/index';\r\nimport { IPublishConfig } from '@cucumber/cucumber/lib/publish/index';\r\nimport { ILogger } from '@cucumber/cucumber/lib/environment/index';\r\nimport { ITsFlowRunConfiguration } from '../runtime/types';\r\nimport { createLogger } from '../utils/tsflow-logger';\r\n\r\nconst logger = createLogger('convert');\r\n\r\nexport interface IConfigurationExt extends IConfiguration {\r\n\texperimentalDecorators: boolean;\r\n}\r\n\r\nexport async function convertConfiguration(\r\n\tcucumberLogger: ILogger,\r\n\tflatConfiguration: IConfigurationExt,\r\n\tenv: typeof process.env\r\n): Promise<ITsFlowRunConfiguration> {\r\n\tlogger.checkpoint('convertConfiguration() started');\r\n\r\n\ttry {\r\n\t\tlogger.checkpoint('Building sources config', {\r\n\t\t\tpathCount: flatConfiguration.paths?.length,\r\n\t\t\tlanguage: flatConfiguration.language\r\n\t\t});\r\n\t\tconst sources = {\r\n\t\t\tpaths: flatConfiguration.paths,\r\n\t\t\tdefaultDialect: flatConfiguration.language,\r\n\t\t\tnames: flatConfiguration.name,\r\n\t\t\ttagExpression: flatConfiguration.tags,\r\n\t\t\torder: flatConfiguration.order\r\n\t\t};\r\n\r\n\t\tlogger.checkpoint('Building support config', {\r\n\t\t\trequireModules: flatConfiguration.requireModule,\r\n\t\t\tloaders: flatConfiguration.loader\r\n\t\t});\r\n\t\tconst support = {\r\n\t\t\trequireModules: flatConfiguration.requireModule,\r\n\t\t\trequirePaths: flatConfiguration.require,\r\n\t\t\timportPaths: flatConfiguration.import,\r\n\t\t\tloaders: flatConfiguration.loader\r\n\t\t};\r\n\r\n\t\tlogger.checkpoint('Building runtime config', {\r\n\t\t\tparallel: flatConfiguration.parallel,\r\n\t\t\texperimentalDecorators: flatConfiguration.experimentalDecorators\r\n\t\t});\r\n\t\tconst runtime = {\r\n\t\t\tdryRun: flatConfiguration.dryRun,\r\n\t\t\texperimentalDecorators: flatConfiguration.experimentalDecorators,\r\n\t\t\tfailFast: flatConfiguration.failFast,\r\n\t\t\tfilterStacktraces: !flatConfiguration.backtrace,\r\n\t\t\tparallel: flatConfiguration.parallel,\r\n\t\t\tretry: flatConfiguration.retry,\r\n\t\t\tretryTagFilter: flatConfiguration.retryTagFilter,\r\n\t\t\tstrict: flatConfiguration.strict,\r\n\t\t\tworldParameters: flatConfiguration.worldParameters\r\n\t\t};\r\n\r\n\t\tlogger.checkpoint('Building formats config');\r\n\t\tconst formats = convertFormats(cucumberLogger, flatConfiguration, env);\r\n\r\n\t\tlogger.checkpoint('convertConfiguration() completed');\r\n\r\n\t\treturn {\r\n\t\t\tsources,\r\n\t\t\tsupport,\r\n\t\t\truntime,\r\n\t\t\tformats\r\n\t\t};\r\n\t} catch (error: any) {\r\n\t\tlogger.error('convertConfiguration() failed', error);\r\n\t\tthrow new Error(`Failed to convert configuration: ${error.message}`, { cause: error });\r\n\t}\r\n}\r\n\r\nfunction convertFormats(cucumberLogger: ILogger, flatConfiguration: IConfiguration, env: typeof process.env) {\r\n\tlogger.checkpoint('convertFormats() started', { formatCount: flatConfiguration.format?.length });\r\n\r\n\ttry {\r\n\t\tconst splitFormats: string[][] = flatConfiguration.format.map((item, index) => {\r\n\t\t\tconst result = Array.isArray(item) ? item : splitFormatDescriptor(cucumberLogger, item);\r\n\t\t\tlogger.checkpoint(`Format[${index}] processed`, { input: item, output: result });\r\n\t\t\treturn result;\r\n\t\t});\r\n\r\n\t\tconst stdout = [...splitFormats].reverse().find(([, target]) => !target)?.[0] ?? 'progress';\r\n\t\tlogger.checkpoint('Stdout format', { stdout });\r\n\r\n\t\tconst files = splitFormats\r\n\t\t\t.filter(([, target]) => !!target)\r\n\t\t\t.reduce((mapped, [type, target]) => {\r\n\t\t\t\treturn {\r\n\t\t\t\t\t...mapped,\r\n\t\t\t\t\t[target]: type\r\n\t\t\t\t};\r\n\t\t\t}, {});\r\n\t\tlogger.checkpoint('File formats', { files });\r\n\r\n\t\tconst publish = makePublishConfig(flatConfiguration, env);\r\n\r\n\t\treturn {\r\n\t\t\tstdout,\r\n\t\t\tfiles,\r\n\t\t\tpublish,\r\n\t\t\toptions: flatConfiguration.formatOptions\r\n\t\t};\r\n\t} catch (error: any) {\r\n\t\tlogger.error('convertFormats() failed', error);\r\n\t\tthrow new Error(`Failed to convert formats: ${error.message}`, { cause: error });\r\n\t}\r\n}\r\n\r\nfunction makePublishConfig(flatConfiguration: IConfiguration, env: typeof process.env): IPublishConfig | false {\r\n\tconst enabled = isPublishing(flatConfiguration, env);\r\n\tif (!enabled) {\r\n\t\treturn false;\r\n\t}\r\n\treturn {\r\n\t\turl: env.CUCUMBER_PUBLISH_URL,\r\n\t\ttoken: env.CUCUMBER_PUBLISH_TOKEN\r\n\t};\r\n}\r\n\r\nfunction isPublishing(flatConfiguration: IConfiguration, env: typeof process.env): boolean {\r\n\treturn (\r\n\t\tflatConfiguration.publish ||\r\n\t\tisTruthyString(env.CUCUMBER_PUBLISH_ENABLED) ||\r\n\t\tenv.CUCUMBER_PUBLISH_TOKEN !== undefined\r\n\t);\r\n}\r\n"]}

package/lib/api/load-configuration.js

@@ -14,6 +14,8 @@ const gherkin_manager_1 = __importDefault(require("../gherkin/gherkin-manager"))
 const ansis_1 = __importDefault(require("ansis"));
 const console_1 = require("console");
 const path_1 = require("path");
+const tsflow_logger_1 = require("../utils/tsflow-logger");
+const logger = (0, tsflow_logger_1.createLogger)('config');
 /**
  * Load user-authored configuration to be used in a test run.
  *
@@ -22,8 +24,36 @@ const path_1 = require("path");
  * @param environment - Project environment.
  */
 const loadConfiguration = async (options = {}, environment = {}) => {
-    const { cwd, env, logger } = (0, index_2.makeEnvironment)(environment);
-    const configFile = options.file ?? (0, locate_file_1.locateFile)(cwd);
+    logger.checkpoint('loadConfiguration() started', {
+        optionsFile: options.file,
+        optionsProfiles: options.profiles
+    });
+    let cwd;
+    let env;
+    let cucumberLogger;
+    try {
+        logger.checkpoint('Creating environment');
+        const made = (0, index_2.makeEnvironment)(environment);
+        cwd = made.cwd;
+        env = made.env;
+        cucumberLogger = made.logger;
+        logger.checkpoint('Environment created', { cwd });
+    }
+    catch (error) {
+        logger.error('Failed to create environment', error);
+        throw new Error(`Failed to create environment: ${error.message}`, { cause: error });
+    }
+    // Locate config file
+    let configFile;
+    try {
+        logger.checkpoint('Locating config file', { providedFile: options.file });
+        configFile = options.file ?? (0, locate_file_1.locateFile)(cwd);
+        logger.checkpoint('Config file resolved', { configFile });
+    }
+    catch (error) {
+        logger.error('Failed to locate config file', error);
+        throw new Error(`Failed to locate configuration file: ${error.message}`, { cause: error });
+    }
     let msg = '';
     if (configFile) {
         msg = `Loading configuration from "${configFile}".`;
@@ -34,150 +64,245 @@ const loadConfiguration = async (options = {}, environment = {}) => {
     else {
         msg = 'No configuration file found';
     }
-    // log this to debug and console
     const consoleLogger = new console_1.Console(environment.stdout, environment.stderr);
-    logger.debug(msg);
+    cucumberLogger.debug(msg);
     consoleLogger.log(ansis_1.default.cyanBright(msg));
-    const profileConfiguration = configFile ? await (0, index_1.fromFile)(logger, cwd, configFile, options.profiles) : {};
-    // if a feature was passed in on command line it's added
-    // to the provided configuration as paths. We need to clear
-    // any paths from configuration so that only the feature passed
-    // in is executed.
-    const paths = options.provided.paths;
+    // Load profile configuration from file
+    let profileConfiguration = {};
+    if (configFile) {
+        try {
+            logger.checkpoint('Loading configuration from file', {
+                configFile,
+                profiles: options.profiles
+            });
+            profileConfiguration = await (0, index_1.fromFile)(cucumberLogger, cwd, configFile, options.profiles);
+            logger.checkpoint('Profile configuration loaded', {
+                keys: Object.keys(profileConfiguration),
+                transpiler: profileConfiguration.transpiler,
+                paths: profileConfiguration.paths
+            });
+        }
+        catch (error) {
+            logger.error('Failed to load configuration from file', error, { configFile });
+            throw new Error(`Failed to load configuration from "${configFile}": ${error.message}`, { cause: error });
+        }
+    }
+    // If a feature was passed in on command line, clear profile paths
+    const paths = options.provided?.paths;
     if (paths && paths?.length > 0) {
+        logger.checkpoint('Clearing profile paths (feature passed via CLI)', { providedPaths: paths });
         profileConfiguration.paths = [];
     }
-    const original = (0, index_1.mergeConfigurations)(index_1.DEFAULT_CONFIGURATION, profileConfiguration, (0, index_1.parseConfiguration)(logger, 'Provided', options.provided));
-    // Get the experimental decorators setting
+    // Merge configurations
+    let original;
+    try {
+        logger.checkpoint('Merging configurations');
+        const parsedProvided = (0, index_1.parseConfiguration)(cucumberLogger, 'Provided', options.provided);
+        logger.checkpoint('Provided configuration parsed', { parsedKeys: Object.keys(parsedProvided) });
+        original = (0, index_1.mergeConfigurations)(index_1.DEFAULT_CONFIGURATION, profileConfiguration, parsedProvided);
+        logger.checkpoint('Configurations merged', {
+            transpiler: original.transpiler,
+            experimentalDecorators: original.experimentalDecorators,
+            pathCount: original.paths?.length
+        });
+    }
+    catch (error) {
+        logger.error('Failed to merge configurations', error);
+        throw new Error(`Failed to merge configurations: ${error.message}`, { cause: error });
+    }
+    // Configure experimental decorators
     if (original.experimentalDecorators === undefined) {
         original.experimentalDecorators = false;
     }
     const experimentalDecorators = original.experimentalDecorators;
     global.experimentalDecorators = experimentalDecorators;
-    process.env.CUCUMBER_EXPERIMENTAL_DECORATORS = String(experimentalDecorators); // need to set here so can be accessed in mjs files
+    process.env.CUCUMBER_EXPERIMENTAL_DECORATORS = String(experimentalDecorators);
+    logger.checkpoint('Experimental decorators configured', { experimentalDecorators });
+    if (experimentalDecorators) {
+        consoleLogger.log(ansis_1.default.cyanBright('Using Experimental Decorators.'));
+    }
     /**
      * Ensures JSDOM environment is initialized before any test files are loaded.
-     * This adds the Vue-specific JSDOM setup to the beginning of Cucumber's require array,
-     * establishing the DOM environment needed for Vue component testing.
-     *
-     * Must run before test execution begins (mise en place for Vue testing).
      */
     const initJsDom = () => {
-        // Use require.resolve to get the absolute path
+        logger.checkpoint('Initializing JSDOM setup');
         try {
             const setupPath = require.resolve('@lynxwall/cucumber-tsflow/lib/transpilers/esm/vue-jsdom-setup');
+            logger.checkpoint('JSDOM setup path resolved', { setupPath });
             original.require.unshift(setupPath);
         }
         catch (e) {
-            // Fallback to relative path from lib directory
+            logger.checkpoint('require.resolve failed, using fallback', { error: e.message });
             const setupPath = (0, path_1.join)(__dirname, '../../transpilers/esm/vue-jsdom-setup.mjs');
+            logger.checkpoint('JSDOM setup fallback path', { setupPath });
             original.require.unshift(setupPath);
         }
     };
+    // Configure transpiler
     if (original.transpiler) {
-        switch (original.transpiler) {
-            case 'es-vue':
-                original.requireModule.push('@lynxwall/cucumber-tsflow/lib/transpilers/esvue');
-                break;
-            case 'ts-vue': {
-                const module = experimentalDecorators ? 'tsvue-exp' : 'tsvue';
-                original.requireModule.push(`@lynxwall/cucumber-tsflow/lib/transpilers/${module}`);
-                break;
-            }
-            case 'es-node': {
-                original.requireModule.push('@lynxwall/cucumber-tsflow/lib/transpilers/esnode');
-                break;
-            }
-            case 'ts-node': {
-                const module = experimentalDecorators ? 'tsnode-exp' : 'tsnode';
-                original.requireModule.push(`@lynxwall/cucumber-tsflow/lib/transpilers/${module}`);
-                break;
-            }
-            case 'ts-node-esm': {
-                original.loader.push(`@lynxwall/cucumber-tsflow/lib/transpilers/esm/tsnode-loader`); // per cucumber docs, we want to add this to the loader for esm
-                break;
-            }
-            case 'es-node-esm': {
-                original.loader.push(`@lynxwall/cucumber-tsflow/lib/transpilers/esm/esnode-loader`); // per cucumber docs, we want to add this to the loader for esm
-                break;
-            }
-            case 'ts-vue-esm': {
-                original.loader.push(`@lynxwall/cucumber-tsflow/lib/transpilers/esm/vue-loader`); // per cucumber docs, we want to add this to the loader for esm
-                initJsDom();
-                break;
-            }
-            case 'es-vue-esm': {
-                original.loader.push(`@lynxwall/cucumber-tsflow/lib/transpilers/esm/esvue-loader`); // per cucumber docs, we want to add this to the loader for esm
-                initJsDom();
-                break;
+        logger.checkpoint('Configuring transpiler', { transpiler: original.transpiler });
+        try {
+            switch (original.transpiler) {
+                case 'es-vue':
+                    logger.checkpoint('Adding es-vue requireModule');
+                    original.requireModule.push('@lynxwall/cucumber-tsflow/lib/transpilers/esvue');
+                    break;
+                case 'ts-vue': {
+                    const module = experimentalDecorators ? 'tsvue-exp' : 'tsvue';
+                    logger.checkpoint('Adding ts-vue requireModule', { module });
+                    original.requireModule.push(`@lynxwall/cucumber-tsflow/lib/transpilers/${module}`);
+                    break;
+                }
+                case 'es-node':
+                    logger.checkpoint('Adding es-node requireModule');
+                    original.requireModule.push('@lynxwall/cucumber-tsflow/lib/transpilers/esnode');
+                    break;
+                case 'ts-node': {
+                    const module = experimentalDecorators ? 'tsnode-exp' : 'tsnode';
+                    logger.checkpoint('Adding ts-node requireModule', { module });
+                    original.requireModule.push(`@lynxwall/cucumber-tsflow/lib/transpilers/${module}`);
+                    break;
+                }
+                case 'ts-node-esm':
+                    logger.checkpoint('Adding ts-node-esm loader');
+                    original.loader.push('@lynxwall/cucumber-tsflow/lib/transpilers/esm/tsnode-loader');
+                    break;
+                case 'es-node-esm':
+                    logger.checkpoint('Adding es-node-esm loader');
+                    original.loader.push('@lynxwall/cucumber-tsflow/lib/transpilers/esm/esnode-loader');
+                    break;
+                case 'ts-vue-esm':
+                    logger.checkpoint('Adding ts-vue-esm loader + JSDOM');
+                    original.loader.push('@lynxwall/cucumber-tsflow/lib/transpilers/esm/vue-loader');
+                    initJsDom();
+                    break;
+                case 'es-vue-esm':
+                    logger.checkpoint('Adding es-vue-esm loader + JSDOM');
+                    original.loader.push('@lynxwall/cucumber-tsflow/lib/transpilers/esm/esvue-loader');
+                    initJsDom();
+                    break;
+                default:
+                    logger.checkpoint('No built-in transpiler (user-provided expected)', {
+                        transpiler: original.transpiler
+                    });
+                    break;
             }
-            default:
-                // default sets nothing -- this allows users to not set the transpiler & use their own loaders/transpilers
-                break;
+            logger.checkpoint('Transpiler configured', {
+                loaders: original.loader,
+                requireModules: original.requireModule,
+                requires: original.require
+            });
         }
+        catch (error) {
+            logger.error('Failed to configure transpiler', error, { transpiler: original.transpiler });
+            throw new Error(`Failed to configure transpiler "${original.transpiler}": ${error.message}`, { cause: error });
+        }
+    }
+    else {
+        logger.checkpoint('No transpiler specified');
     }
-    // set the snippet syntax
+    // Set snippet syntax
     if (!original.formatOptions.snippetSyntax) {
         original.formatOptions.snippetSyntax = '@lynxwall/cucumber-tsflow/snippet';
     }
-    // look for behave format
-    for (let idx = 0; idx < original.format.length; idx++) {
-        if (typeof original.format[idx] === 'string') {
-            const formatItem = original.format[idx];
-            if (formatItem.startsWith('behave:')) {
-                original.format[idx] = formatItem.replace('behave', '@lynxwall/cucumber-tsflow/behave');
+    logger.checkpoint('Snippet syntax configured', { snippetSyntax: original.formatOptions.snippetSyntax });
+    // Process format options
+    logger.checkpoint('Processing format options', { formatCount: original.format?.length });
+    try {
+        for (let idx = 0; idx < original.format.length; idx++) {
+            if (typeof original.format[idx] === 'string') {
+                const formatItem = original.format[idx];
+                if (formatItem.startsWith('behave:')) {
+                    original.format[idx] = formatItem.replace('behave', '@lynxwall/cucumber-tsflow/behave');
+                    logger.checkpoint('Replaced behave format', { index: idx });
+                }
             }
-        }
-        else if (original.format[idx].length > 0) {
-            const formatItem = original.format[idx][0];
-            if (formatItem.startsWith('behave')) {
-                const newVal = formatItem.replace('behave', '@lynxwall/cucumber-tsflow/behave');
-                original.format[idx] = original.format[idx].length > 1 ? [newVal, original.format[idx][1]] : [newVal];
+            else if (original.format[idx].length > 0) {
+                const formatItem = original.format[idx][0];
+                if (formatItem.startsWith('behave')) {
+                    const newVal = formatItem.replace('behave', '@lynxwall/cucumber-tsflow/behave');
+                    original.format[idx] = original.format[idx].length > 1 ? [newVal, original.format[idx][1]] : [newVal];
+                    logger.checkpoint('Replaced behave format (array)', { index: idx });
+                }
             }
         }
-    }
-    // look for junitbamboo format
-    for (let idx = 0; idx < original.format.length; idx++) {
-        if (typeof original.format[idx] === 'string') {
-            const formatItem = original.format[idx];
-            if (formatItem.startsWith('junitbamboo:')) {
-                original.format[idx] = formatItem.replace('junitbamboo', '@lynxwall/cucumber-tsflow/junitbamboo');
+        for (let idx = 0; idx < original.format.length; idx++) {
+            if (typeof original.format[idx] === 'string') {
+                const formatItem = original.format[idx];
+                if (formatItem.startsWith('junitbamboo:')) {
+                    original.format[idx] = formatItem.replace('junitbamboo', '@lynxwall/cucumber-tsflow/junitbamboo');
+                    logger.checkpoint('Replaced junitbamboo format', { index: idx });
+                }
             }
-        }
-        else if (original.format[idx].length > 0) {
-            const formatItem = original.format[idx][0];
-            if (formatItem.startsWith('junitbamboo')) {
-                const newVal = formatItem.replace('junitbamboo', '@lynxwall/cucumber-tsflow/junitbamboo');
-                original.format[idx] = original.format[idx].length > 1 ? [newVal, original.format[idx][1]] : [newVal];
+            else if (original.format[idx].length > 0) {
+                const formatItem = original.format[idx][0];
+                if (formatItem.startsWith('junitbamboo')) {
+                    const newVal = formatItem.replace('junitbamboo', '@lynxwall/cucumber-tsflow/junitbamboo');
+                    original.format[idx] = original.format[idx].length > 1 ? [newVal, original.format[idx][1]] : [newVal];
+                    logger.checkpoint('Replaced junitbamboo format (array)', { index: idx });
+                }
             }
         }
+        logger.checkpoint('Format options processed');
     }
-    // check to see if a debugFile was passed in
+    catch (error) {
+        logger.error('Failed to process format options', error);
+        throw new Error(`Failed to process format options: ${error.message}`, { cause: error });
+    }
+    // Process debugFile
     if ((0, helpers_1.hasStringValue)(original.debugFile)) {
-        // Initialize gherkin manager with path to feature files
-        const gherkin = new gherkin_manager_1.default();
-        await gherkin.loadFeatures(original.paths);
-        const features = gherkin.findFeaturesByStepFile(original.debugFile);
-        if (features.length > 0) {
-            original.paths = [];
-            features.forEach(x => original.paths.push(x.featureFile));
+        logger.checkpoint('Processing debugFile', { debugFile: original.debugFile });
+        try {
+            const gherkin = new gherkin_manager_1.default();
+            await gherkin.loadFeatures(original.paths);
+            const features = gherkin.findFeaturesByStepFile(original.debugFile);
+            if (features.length > 0) {
+                original.paths = [];
+                features.forEach(x => original.paths.push(x.featureFile));
+                logger.checkpoint('Debug features found', { featureCount: features.length });
+            }
+            else {
+                cucumberLogger.warn(ansis_1.default.yellow(`\nUnable to find feature for debugFile: ${original.debugFile}`));
+                cucumberLogger.warn(ansis_1.default.yellow('All tests will be executed\n'));
+                logger.checkpoint('No features found for debugFile');
+            }
         }
-        else {
-            // log a message if the feature path is not found
-            logger.warn(ansis_1.default.yellow(`\nUnable to find feature for debugFile: ${original.debugFile}`));
-            logger.warn(ansis_1.default.yellow('All tests will be executed\n'));
+        catch (error) {
+            logger.error('Failed to process debugFile', error, { debugFile: original.debugFile });
+            throw new Error(`Failed to process debugFile "${original.debugFile}": ${error.message}`, { cause: error });
         }
     }
-    // check to see if enable-vue-style was set
-    // if not, default it to false
+    // Configure Vue style
     if (original.enableVueStyle === null || original.enableVueStyle === undefined) {
         original.enableVueStyle = false;
     }
-    // set our global parameter used by the Vue transpiler
-    // to determine if Vue Style Blocks should be enabled
     global.enableVueStyle = original.enableVueStyle;
-    (0, validate_configuration_1.validateConfiguration)(original, logger);
-    const runnable = await (0, convert_configuration_1.convertConfiguration)(logger, original, env);
+    logger.checkpoint('Vue style configured', { enableVueStyle: original.enableVueStyle });
+    // Validate configuration
+    try {
+        logger.checkpoint('Validating configuration');
+        (0, validate_configuration_1.validateConfiguration)(original, cucumberLogger);
+        logger.checkpoint('Configuration validated');
+    }
+    catch (error) {
+        logger.error('Configuration validation failed', error);
+        throw new Error(`Configuration validation failed: ${error.message}`, { cause: error });
+    }
+    // Convert configuration
+    let runnable;
+    try {
+        logger.checkpoint('Converting configuration');
+        runnable = await (0, convert_configuration_1.convertConfiguration)(cucumberLogger, original, env);
+        logger.checkpoint('Configuration converted', {
+            importPaths: runnable.support?.importPaths,
+            loaders: runnable.support?.loaders
+        });
+    }
+    catch (error) {
+        logger.error('Failed to convert configuration', error);
+        throw new Error(`Failed to convert configuration: ${error.message}`, { cause: error });
+    }
+    logger.checkpoint('loadConfiguration() completed');
     return {
         useConfiguration: original,
         runConfiguration: runnable