@simplysf/simply-utam-core 0.0.0 → 0.1.0

package/lib/scaffold/project-scaffolder.js

@@ -0,0 +1,313 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { discoverProject } from '../discovery/index.js';
+const currentDir = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Default location of external scaffold template files.
+ * Resolves to the templates directory in @simplysf/simply-utam-core whether in src or lib.
+ */
+export const DEFAULT_TEMPLATES_DIR = path.resolve(currentDir, '..', '..', 'templates');
+/**
+ * Standard recommended devDependencies for consuming UTAM with SimplyUTAM.
+ */
+export const DEFAULT_REQUIRED_DEV_DEPENDENCIES = [
+    'wireit',
+    'utam',
+    'salesforce-pageobjects',
+    'wdio-utam-service',
+    'chromedriver',
+    '@wdio/cli',
+    '@wdio/local-runner',
+    '@wdio/cucumber-framework',
+    '@wdio/spec-reporter',
+    '@wdio/allure-reporter',
+    'allure-commandline',
+    '@salesforce/core',
+    '@simplysf/simply-utam',
+];
+/**
+ * Loads an external template file from disk, performing token replacements.
+ *
+ * @param templateName - The filename of the template to load.
+ * @param templatesDir - The directory containing template files.
+ * @param tokens - Key-value replacements for {{token}} placeholders.
+ * @returns The resolved template content string.
+ * @throws If the template file does not exist.
+ */
+export function loadTemplate(templateName, templatesDir = DEFAULT_TEMPLATES_DIR, tokens = {}) {
+    const filePath = path.join(templatesDir, templateName);
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Scaffold template not found: '${filePath}'`);
+    }
+    let content = fs.readFileSync(filePath, 'utf-8');
+    for (const [key, value] of Object.entries(tokens)) {
+        const pattern = new RegExp(`\\{\\{${key}\\}\\}`, 'g');
+        content = content.replace(pattern, value);
+    }
+    return content;
+}
+/**
+ * Generates the generator.config.json content by loading its external template.
+ *
+ * @param sourceDir - The Salesforce source directory.
+ * @param appName - The application namespace name.
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Parsed JSON object for generator.config.json.
+ */
+export function generateGeneratorConfig(sourceDir, appName, templatesDir = DEFAULT_TEMPLATES_DIR) {
+    const normalizedSource = sourceDir.replace(/^[./\\]+/, '').replace(/\\/g, '/');
+    const raw = loadTemplate('generator.config.json', templatesDir, {
+        sourceDir: normalizedSource,
+        appName,
+    });
+    return JSON.parse(raw);
+}
+/**
+ * Generates the utam.config.json content by loading its external template.
+ *
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Parsed JSON object for utam.config.json.
+ */
+export function generateUtamConfig(templatesDir = DEFAULT_TEMPLATES_DIR) {
+    const raw = loadTemplate('utam.config.json', templatesDir);
+    return JSON.parse(raw);
+}
+/**
+ * Generates the wdio.conf.mjs configuration script content by loading its external template.
+ *
+ * @param sourceDir - The primary Salesforce source directory.
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Formatted JavaScript module text for wdio.conf.mjs.
+ */
+export function generateWdioConfig(sourceDir, templatesDir = DEFAULT_TEMPLATES_DIR) {
+    const normalizedSource = sourceDir.replace(/^[./\\]+/, '').replace(/\\/g, '/');
+    return loadTemplate('wdio.conf.mjs', templatesDir, {
+        sourceDir: normalizedSource,
+    });
+}
+/**
+ * Generates the .utam/namespace-map.json content by loading its external template.
+ *
+ * @param appName - The application namespace name.
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Parsed JSON object for namespace-map.json.
+ */
+export function generateNamespaceMap(appName, templatesDir = DEFAULT_TEMPLATES_DIR) {
+    const raw = loadTemplate('namespace-map.json', templatesDir, {
+        appName,
+    });
+    return JSON.parse(raw);
+}
+/**
+ * Generates the hello.feature starter Gherkin feature file content by loading its external template.
+ *
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Formatted Gherkin feature file text for hello.feature.
+ */
+export function generateHelloFeature(templatesDir = DEFAULT_TEMPLATES_DIR) {
+    try {
+        return loadTemplate('hello.feature', templatesDir);
+    }
+    catch {
+        return `Feature: Salesforce UI Smoke Test\n\n  Scenario: Log in and navigate to Salesforce Home\n    Given I open the Salesforce application "Sales"\n`;
+    }
+}
+/**
+ * Generates the hello.steps.mjs starter Cucumber step definition script content by loading its external template.
+ *
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Formatted JavaScript module text for hello.steps.mjs.
+ */
+export function generateHelloSteps(templatesDir = DEFAULT_TEMPLATES_DIR) {
+    try {
+        return loadTemplate('hello.steps.mjs', templatesDir);
+    }
+    catch {
+        return `import { Given } from '@wdio/cucumber-framework';\nimport { goToApplication } from '@simplysf/simply-utam';\n\nGiven('I open the Salesforce application {string}', async (appName) => {\n  // Authenticates via Salesforce CLI frontdoor URL and opens the application home page\n  await goToApplication(appName);\n});\n`;
+    }
+}
+/**
+ * Non-destructively injects standard UTAM Wireit scripts and task configurations into a package.json object.
+ * Loads task definitions from external wireit.json template.
+ *
+ * @param packageJson - The existing package.json object.
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns An object containing the modified package.json and lists of added keys.
+ */
+export function injectWireitConfiguration(packageJson, templatesDir = DEFAULT_TEMPLATES_DIR) {
+    const result = JSON.parse(JSON.stringify(packageJson));
+    result['scripts'] ??= {};
+    result['wireit'] ??= {};
+    const scripts = result['scripts'];
+    const wireit = result['wireit'];
+    const rawWireitTemplate = loadTemplate('wireit.json', templatesDir);
+    const wireitConfig = JSON.parse(rawWireitTemplate);
+    const standardScripts = wireitConfig.scripts ?? {};
+    const standardTasks = wireitConfig.wireit ?? {};
+    const addedScripts = [];
+    for (const [scriptName, scriptCommand] of Object.entries(standardScripts)) {
+        if (!scripts[scriptName]) {
+            scripts[scriptName] = scriptCommand;
+            addedScripts.push(scriptName);
+        }
+    }
+    const addedTasks = [];
+    for (const [taskName, taskConfig] of Object.entries(standardTasks)) {
+        if (!wireit[taskName]) {
+            wireit[taskName] = taskConfig;
+            addedTasks.push(taskName);
+        }
+    }
+    const updated = addedScripts.length > 0 || addedTasks.length > 0;
+    return { updated, packageJson: result, addedScripts, addedTasks };
+}
+/**
+ * Checks a package.json object for missing recommended devDependencies.
+ *
+ * @param packageJson - The target package.json object.
+ * @param requiredDependencies - Optional list of required dependency names.
+ * @returns Array of dependency names missing from both devDependencies and dependencies.
+ */
+export function checkMissingDependencies(packageJson, requiredDependencies = DEFAULT_REQUIRED_DEV_DEPENDENCIES) {
+    const devDeps = packageJson['devDependencies'] || {};
+    const deps = packageJson['dependencies'] || {};
+    return requiredDependencies.filter((dep) => !devDeps[dep] && !deps[dep]);
+}
+function resolveSourceDir(projectDir, explicitSourceDir) {
+    if (explicitSourceDir) {
+        return explicitSourceDir;
+    }
+    const discovery = discoverProject(projectDir);
+    if (discovery.sfdxProjectFile && discovery.packageDirectories.length > 0) {
+        return discovery.defaultPackageDirectory ?? discovery.packageDirectories[0];
+    }
+    if (discovery.packageDirectories.length > 0) {
+        return discovery.packageDirectories[0];
+    }
+    return 'force-app';
+}
+function resolveAppName(packageJsonData, explicitAppName) {
+    if (explicitAppName) {
+        return explicitAppName;
+    }
+    if (typeof packageJsonData?.['name'] === 'string') {
+        return packageJsonData['name'].replace(/^@[^/]+\//, '');
+    }
+    return 'salesforce-app';
+}
+function writeScaffoldFiles(projectDir, filesToCreate, force, dryRun) {
+    const createdFiles = [];
+    const skippedFiles = [];
+    for (const item of filesToCreate) {
+        const targetPath = path.join(projectDir, item.relativePath);
+        if (fs.existsSync(targetPath) && !force) {
+            skippedFiles.push(item.relativePath);
+        }
+        else {
+            createdFiles.push(item.relativePath);
+            if (!dryRun) {
+                fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+                fs.writeFileSync(targetPath, item.content, 'utf-8');
+            }
+        }
+    }
+    return { createdFiles, skippedFiles };
+}
+/**
+ * Scaffolds standard UTAM configurations, Wireit tasks, and namespace maps in a project directory.
+ *
+ * @param options - Scaffolding options.
+ * @returns Results describing created, skipped, and modified files.
+ */
+export function scaffoldProject(options) {
+    const projectDir = path.resolve(options?.projectDir ?? process.cwd());
+    const templatesDir = options?.templatesDir ?? DEFAULT_TEMPLATES_DIR;
+    const dryRun = options?.dryRun ?? false;
+    const force = options?.force ?? false;
+    const sourceDir = resolveSourceDir(projectDir, options?.sourceDir);
+    const packageJsonPath = path.join(projectDir, 'package.json');
+    let packageJsonData = null;
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            packageJsonData = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+        }
+        catch {
+            // Continue on read error
+        }
+    }
+    const appName = resolveAppName(packageJsonData, options?.appName);
+    const filesToCreate = [
+        {
+            relativePath: 'generator.config.json',
+            content: JSON.stringify(generateGeneratorConfig(sourceDir, appName, templatesDir), null, 2) + '\n',
+        },
+        {
+            relativePath: 'utam.config.json',
+            content: JSON.stringify(generateUtamConfig(templatesDir), null, 2) + '\n',
+        },
+        {
+            relativePath: 'wdio.conf.mjs',
+            content: generateWdioConfig(sourceDir, templatesDir),
+        },
+        {
+            relativePath: path.join('.utam', 'namespace-map.json'),
+            content: JSON.stringify(generateNamespaceMap(appName, templatesDir), null, 2) + '\n',
+        },
+    ];
+    const candidateUtamDirs = [
+        path.join(projectDir, sourceDir, 'test', 'utam'),
+        path.join(projectDir, sourceDir, 'tests', 'utam'),
+        path.join(projectDir, 'test', 'utam'),
+        path.join(projectDir, 'tests', 'utam'),
+    ];
+    const utamTestDirExists = candidateUtamDirs.some((dir) => fs.existsSync(dir));
+    if (!utamTestDirExists || force) {
+        filesToCreate.push({
+            relativePath: path.join(sourceDir, 'test', 'utam', 'features', 'hello.feature'),
+            content: generateHelloFeature(templatesDir),
+        }, {
+            relativePath: path.join(sourceDir, 'test', 'utam', 'step_definitions', 'hello.steps.mjs'),
+            content: generateHelloSteps(templatesDir),
+        });
+    }
+    const { createdFiles, skippedFiles } = writeScaffoldFiles(projectDir, filesToCreate, force, dryRun);
+    const modifiedFiles = [];
+    let updatedPackageJson;
+    if (packageJsonData) {
+        const injection = injectWireitConfiguration(packageJsonData, templatesDir);
+        if (injection.updated) {
+            modifiedFiles.push('package.json');
+            updatedPackageJson = injection.packageJson;
+            if (!dryRun) {
+                fs.writeFileSync(packageJsonPath, JSON.stringify(injection.packageJson, null, 2) + '\n', 'utf-8');
+            }
+        }
+    }
+    const missingDependencies = packageJsonData
+        ? checkMissingDependencies(packageJsonData)
+        : [...DEFAULT_REQUIRED_DEV_DEPENDENCIES];
+    return Promise.resolve({
+        createdFiles,
+        skippedFiles,
+        modifiedFiles,
+        updatedPackageJson,
+        missingDependencies,
+    });
+}
+//# sourceMappingURL=project-scaffolder.js.map

package/lib/scaffold/project-scaffolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scaffolder.js","sourceRoot":"","sources":["../../src/scaffold/project-scaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAa;IACzD,QAAQ;IACR,MAAM;IACN,wBAAwB;IACxB,mBAAmB;IACnB,cAAc;IACd,WAAW;IACX,oBAAoB;IACpB,0BAA0B;IAC1B,qBAAqB;IACrB,uBAAuB;IACvB,oBAAoB;IACpB,kBAAkB;IAClB,uBAAuB;CACxB,CAAC;AAmEF;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,YAAoB,EACpB,YAAY,GAAG,qBAAqB,EACpC,SAAiC,EAAE;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,OAAe,EACf,YAAY,GAAG,qBAAqB;IAEpC,MAAM,gBAAgB,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,YAAY,CAAC,uBAAuB,EAAE,YAAY,EAAE;QAC9D,SAAS,EAAE,gBAAgB;QAC3B,OAAO;KACR,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAY,GAAG,qBAAqB;IACrE,MAAM,GAAG,GAAG,YAAY,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,YAAY,GAAG,qBAAqB;IACxF,MAAM,gBAAgB,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC/E,OAAO,YAAY,CAAC,eAAe,EAAE,YAAY,EAAE;QACjD,SAAS,EAAE,gBAAgB;KAC5B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,YAAY,GAAG,qBAAqB;IACxF,MAAM,GAAG,GAAG,YAAY,CAAC,oBAAoB,EAAE,YAAY,EAAE;QAC3D,OAAO;KACR,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAY,GAAG,qBAAqB;IACvE,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gJAAgJ,CAAC;IAC1J,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAY,GAAG,qBAAqB;IACrE,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,4TAA4T,CAAC;IACtU,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,WAAoC,EACpC,YAAY,GAAG,qBAAqB;IAOpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAA4B,CAAC;IAClF,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAA4B,CAAC;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAA4B,CAAC;IAE3D,MAAM,iBAAiB,GAAG,YAAY,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAGhD,CAAC;IAEF,MAAM,eAAe,GAAG,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC;IACnD,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,IAAI,EAAE,CAAC;IAEhD,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC1E,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC;YACpC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;YAC9B,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,WAAoC,EACpC,oBAAoB,GAAG,iCAAiC;IAExD,MAAM,OAAO,GAAI,WAAW,CAAC,iBAAiB,CAA4B,IAAI,EAAE,CAAC;IACjF,MAAM,IAAI,GAAI,WAAW,CAAC,cAAc,CAA4B,IAAI,EAAE,CAAC;IAE3E,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB,EAAE,iBAA0B;IACtE,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,MAAM,SAAS,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,SAAS,CAAC,eAAe,IAAI,SAAS,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzE,OAAO,SAAS,CAAC,uBAAuB,IAAI,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,SAAS,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,eAA+C,EAAE,eAAwB;IAC/F,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,SAAS,kBAAkB,CACzB,UAAkB,EAClB,aAA+D,EAC/D,KAAc,EACd,MAAe;IAEf,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACxC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACrC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,qBAAqB,CAAC;IACpE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC;IAEtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAEnE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAC9D,IAAI,eAAe,GAAmC,IAAI,CAAC;IAC3D,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAA4B,CAAC;QACrG,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,MAAM,aAAa,GAAG;QACpB;YACE,YAAY,EAAE,uBAAuB;YACrC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI;SACnG;QACD;YACE,YAAY,EAAE,kBAAkB;YAChC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI;SAC1E;QACD;YACE,YAAY,EAAE,eAAe;YAC7B,OAAO,EAAE,kBAAkB,CAAC,SAAS,EAAE,YAAY,CAAC;SACrD;QACD;YACE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC;YACtD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI;SACrF;KACF,CAAC;IAEF,MAAM,iBAAiB,GAAG;QACxB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;KACvC,CAAC;IACF,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9E,IAAI,CAAC,iBAAiB,IAAI,KAAK,EAAE,CAAC;QAChC,aAAa,CAAC,IAAI,CAChB;YACE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC;YAC/E,OAAO,EAAE,oBAAoB,CAAC,YAAY,CAAC;SAC5C,EACD;YACE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;YACzF,OAAO,EAAE,kBAAkB,CAAC,YAAY,CAAC;SAC1C,CACF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,kBAAkB,CAAC,UAAU,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACpG,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,IAAI,kBAAuD,CAAC;IAE5D,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,yBAAyB,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QAC3E,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,kBAAkB,GAAG,SAAS,CAAC,WAAW,CAAC;YAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,EAAE,CAAC,aAAa,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;YACpG,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,mBAAmB,GAAG,eAAe;QACzC,CAAC,CAAC,wBAAwB,CAAC,eAAe,CAAC;QAC3C,CAAC,CAAC,CAAC,GAAG,iCAAiC,CAAC,CAAC;IAE3C,OAAO,OAAO,CAAC,OAAO,CAAC;QACrB,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,kBAAkB;QAClB,mBAAmB;KACpB,CAAC,CAAC;AACL,CAAC"}

package/lib/steps/expression-matcher.d.ts

@@ -0,0 +1,42 @@
+import { ParameterTypeRegistry, Expression } from '@cucumber/cucumber-expressions';
+export interface RawExtractedExpression {
+    pattern: string;
+    isRegex: boolean;
+    flags?: string;
+}
+export interface CompiledStepExpression {
+    source: string;
+    isRegex: boolean;
+    expression: Expression;
+}
+/**
+ * Normalizes expression strings to eliminate trivial escaping variations when comparing.
+ *
+ * @param expr - Raw expression string.
+ * @returns Normalized expression string.
+ */
+export declare function normalizeExpression(expr: string): string;
+/**
+ * Statically parses step definition file content to extract registered step expressions
+ * without executing the file or loading modules at runtime.
+ *
+ * @param content - File content of step definitions.
+ * @returns Array of raw extracted string and regexp patterns.
+ */
+export declare function extractStepExpressionsFromContent(content: string): RawExtractedExpression[];
+/**
+ * Compiles raw extracted expressions into official Cucumber expression matchers.
+ *
+ * @param rawExpressions - Raw extracted expression definitions.
+ * @param registry - Optional Cucumber parameter type registry.
+ * @returns Array of compiled step expressions ready for matching.
+ */
+export declare function compileStepExpressions(rawExpressions: RawExtractedExpression[], registry?: ParameterTypeRegistry): CompiledStepExpression[];
+/**
+ * Checks if a given Gherkin step text matches any registered step definition expression.
+ *
+ * @param stepText - Raw step phrase text from a feature file.
+ * @param compiledExpressions - Compiled step expressions to test against.
+ * @returns True if a match is found, false otherwise.
+ */
+export declare function matchStepAgainstExpressions(stepText: string, compiledExpressions: CompiledStepExpression[]): boolean;

package/lib/steps/expression-matcher.js

@@ -0,0 +1,106 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ParameterTypeRegistry, CucumberExpression, RegularExpression, } from '@cucumber/cucumber-expressions';
+/**
+ * Normalizes expression strings to eliminate trivial escaping variations when comparing.
+ *
+ * @param expr - Raw expression string.
+ * @returns Normalized expression string.
+ */
+export function normalizeExpression(expr) {
+    return expr.trim().replace(/\\'/g, "'").replace(/\\"/g, '"').replace(/\\\\/g, '\\');
+}
+/**
+ * Statically parses step definition file content to extract registered step expressions
+ * without executing the file or loading modules at runtime.
+ *
+ * @param content - File content of step definitions.
+ * @returns Array of raw extracted string and regexp patterns.
+ */
+export function extractStepExpressionsFromContent(content) {
+    const expressions = [];
+    // Match string step definitions: Given('...', ...), When("...", ...), Then(`...`, ...)
+    const stringRegex = /(?:Given|When|Then|Step|DefineStep)\s*\(\s*(['"`])([\s\S]*?)\1\s*,/g;
+    let match;
+    while ((match = stringRegex.exec(content)) !== null) {
+        expressions.push({
+            pattern: match[2],
+            isRegex: false,
+        });
+    }
+    // Match RegExp step definitions: Given(/^...$/, ...), When(/.../i, ...)
+    const regexRegex = /(?:Given|When|Then|Step|DefineStep)\s*\(\s*\/((?:\\\/|[^/\r\n])+)\/([a-z]*)\s*,/g;
+    while ((match = regexRegex.exec(content)) !== null) {
+        expressions.push({
+            pattern: match[1],
+            isRegex: true,
+            flags: match[2],
+        });
+    }
+    return expressions;
+}
+/**
+ * Compiles raw extracted expressions into official Cucumber expression matchers.
+ *
+ * @param rawExpressions - Raw extracted expression definitions.
+ * @param registry - Optional Cucumber parameter type registry.
+ * @returns Array of compiled step expressions ready for matching.
+ */
+export function compileStepExpressions(rawExpressions, registry = new ParameterTypeRegistry()) {
+    const compiled = [];
+    for (const raw of rawExpressions) {
+        try {
+            if (raw.isRegex) {
+                const regex = new RegExp(raw.pattern, raw.flags ?? '');
+                const regExpr = new RegularExpression(regex, registry);
+                compiled.push({
+                    source: raw.pattern,
+                    isRegex: true,
+                    expression: regExpr,
+                });
+            }
+            else {
+                const cucExpr = new CucumberExpression(raw.pattern, registry);
+                compiled.push({
+                    source: raw.pattern,
+                    isRegex: false,
+                    expression: cucExpr,
+                });
+            }
+        }
+        catch {
+            // Gracefully ignore expressions with invalid syntax
+        }
+    }
+    return compiled;
+}
+/**
+ * Checks if a given Gherkin step text matches any registered step definition expression.
+ *
+ * @param stepText - Raw step phrase text from a feature file.
+ * @param compiledExpressions - Compiled step expressions to test against.
+ * @returns True if a match is found, false otherwise.
+ */
+export function matchStepAgainstExpressions(stepText, compiledExpressions) {
+    for (const item of compiledExpressions) {
+        const args = item.expression.match(stepText);
+        if (args !== null) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=expression-matcher.js.map

package/lib/steps/expression-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-matcher.js","sourceRoot":"","sources":["../../src/steps/expression-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAElB,MAAM,gCAAgC,CAAC;AAcxC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACtF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAAe;IAC/D,MAAM,WAAW,GAA6B,EAAE,CAAC;IAEjD,uFAAuF;IACvF,MAAM,WAAW,GAAG,qEAAqE,CAAC;IAC1F,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpD,WAAW,CAAC,IAAI,CAAC;YACf,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YACjB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;IAED,wEAAwE;IACxE,MAAM,UAAU,GAAG,kFAAkF,CAAC;IACtG,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACnD,WAAW,CAAC,IAAI,CAAC;YACf,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YACjB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;SAChB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAwC,EACxC,WAAkC,IAAI,qBAAqB,EAAE;IAE7D,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAE9C,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBACvD,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBACvD,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,GAAG,CAAC,OAAO;oBACnB,OAAO,EAAE,IAAI;oBACb,UAAU,EAAE,OAAO;iBACpB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC9D,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,GAAG,CAAC,OAAO;oBACnB,OAAO,EAAE,KAAK;oBACd,UAAU,EAAE,OAAO;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAgB,EAAE,mBAA6C;IACzG,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/steps/gherkin-parser.d.ts

@@ -0,0 +1,27 @@
+import { Parser } from '@cucumber/gherkin';
+export type StepSemanticKeyword = 'Given' | 'When' | 'Then';
+export interface ParsedGherkinStep {
+    keyword: StepSemanticKeyword;
+    rawKeyword: string;
+    text: string;
+    filePath: string;
+    line: number;
+    hasDataTable: boolean;
+    hasDocString: boolean;
+}
+/**
+ * Parses Gherkin source text into an AST using the official @cucumber/gherkin parser.
+ *
+ * @param content - Gherkin feature source text.
+ * @returns Parsed AST document representation.
+ */
+export declare function parseGherkinDocument(content: string): ReturnType<Parser<unknown>['parse']>;
+/**
+ * Traverses a Gherkin document AST and extracts all scenario, background, and rule steps,
+ * normalizing 'And' and 'But' keywords to their semantic parent keyword (Given, When, Then).
+ *
+ * @param content - Gherkin feature file content.
+ * @param filePath - Path to the feature file for error and location reporting.
+ * @returns Extracted steps with normalized semantic keywords.
+ */
+export declare function extractStepsFromGherkin(content: string, filePath?: string): ParsedGherkinStep[];

package/lib/steps/gherkin-parser.js

@@ -0,0 +1,98 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Parser, AstBuilder, GherkinClassicTokenMatcher } from '@cucumber/gherkin';
+import { IdGenerator } from '@cucumber/messages';
+/**
+ * Parses Gherkin source text into an AST using the official @cucumber/gherkin parser.
+ *
+ * @param content - Gherkin feature source text.
+ * @returns Parsed AST document representation.
+ */
+export function parseGherkinDocument(content) {
+    const builder = new AstBuilder(IdGenerator.uuid());
+    const matcher = new GherkinClassicTokenMatcher();
+    const parser = new Parser(builder, matcher);
+    return parser.parse(content);
+}
+/**
+ * Traverses a Gherkin document AST and extracts all scenario, background, and rule steps,
+ * normalizing 'And' and 'But' keywords to their semantic parent keyword (Given, When, Then).
+ *
+ * @param content - Gherkin feature file content.
+ * @param filePath - Path to the feature file for error and location reporting.
+ * @returns Extracted steps with normalized semantic keywords.
+ */
+export function extractStepsFromGherkin(content, filePath = 'unknown.feature') {
+    let gherkinDocument;
+    try {
+        gherkinDocument = parseGherkinDocument(content);
+    }
+    catch {
+        // If parsing fails (e.g. invalid feature syntax), return empty list
+        return [];
+    }
+    if (!gherkinDocument?.feature) {
+        return [];
+    }
+    const steps = [];
+    function processSteps(stepNodes) {
+        let currentKeyword = 'Given';
+        for (const stepNode of stepNodes) {
+            const rawKeyword = stepNode.keyword ? stepNode.keyword.trim() : 'Given';
+            const text = stepNode.text ? stepNode.text.trim() : '';
+            if (rawKeyword === 'Given') {
+                currentKeyword = 'Given';
+            }
+            else if (rawKeyword === 'When') {
+                currentKeyword = 'When';
+            }
+            else if (rawKeyword === 'Then') {
+                currentKeyword = 'Then';
+            }
+            // 'And' or 'But' inherit currentKeyword
+            steps.push({
+                keyword: currentKeyword,
+                rawKeyword,
+                text,
+                filePath,
+                line: stepNode.location?.line ?? 0,
+                hasDataTable: Boolean(stepNode.dataTable?.rows && stepNode.dataTable.rows.length > 0),
+                hasDocString: Boolean(stepNode.docString?.content),
+            });
+        }
+    }
+    const children = gherkinDocument.feature.children ?? [];
+    for (const child of children) {
+        if (Array.isArray(child.background?.steps)) {
+            processSteps(child.background.steps);
+        }
+        if (Array.isArray(child.scenario?.steps)) {
+            processSteps(child.scenario.steps);
+        }
+        if (Array.isArray(child.rule?.children)) {
+            for (const ruleChild of child.rule.children) {
+                if (Array.isArray(ruleChild.background?.steps)) {
+                    processSteps(ruleChild.background.steps);
+                }
+                if (Array.isArray(ruleChild.scenario?.steps)) {
+                    processSteps(ruleChild.scenario.steps);
+                }
+            }
+        }
+    }
+    return steps;
+}
+//# sourceMappingURL=gherkin-parser.js.map

package/lib/steps/gherkin-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gherkin-parser.js","sourceRoot":"","sources":["../../src/steps/gherkin-parser.ts"],"names":[],"mappings":"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"}

package/lib/steps/index.d.ts

@@ -0,0 +1,4 @@
+export * from './gherkin-parser.js';
+export * from './expression-matcher.js';
+export * from './snippet-generator.js';
+export * from './step-scaffolder.js';

package/lib/steps/index.js

@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export * from './gherkin-parser.js';
+export * from './expression-matcher.js';
+export * from './snippet-generator.js';
+export * from './step-scaffolder.js';
+//# sourceMappingURL=index.js.map

package/lib/steps/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/steps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}