@libar-dev/architect 1.0.0-pre.3

package/dist/lint/steps/cross-checks.js.map

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

package/dist/lint/steps/feature-checks.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Feature-only lint checks for vitest-cucumber compatibility.
+ *
+ * These checks scan raw .feature file text without needing the Gherkin parser
+ * (which would fail on some of the very issues we're detecting).
+ */
+import type { LintViolation } from '../../validation-schemas/lint.js';
+/**
+ * Check 4: Detect # at line start inside a """ pseudo-code-block in description context.
+ *
+ * The @cucumber/gherkin parser treats # as a comment even inside
+ * Feature/Rule descriptions. When authors embed code examples using
+ * """ delimiters in descriptions, they expect those to act as code blocks.
+ * But """ in descriptions is NOT a DocString — it's plain text. Any #
+ * inside will terminate the description and cause cryptic parse errors.
+ *
+ * Plain # comments outside """ blocks are intentional Gherkin comments
+ * and are NOT flagged (they gracefully terminate descriptions).
+ *
+ * Detection: State machine tracks description context AND whether we're
+ * inside a """ pseudo-code-block within that description.
+ */
+export declare function checkHashInDescription(content: string, filePath: string): readonly LintViolation[];
+/**
+ * Check 7: Detect multiple And steps with identical text in the same scenario.
+ *
+ * vitest-cucumber fails when the same And step text appears twice in one scenario.
+ * The fix is to consolidate into a single step with a DataTable or DocString.
+ */
+export declare function checkDuplicateAndSteps(content: string, filePath: string): readonly LintViolation[];
+/**
+ * Check 8: Detect $ in Given/When/Then/And step text.
+ *
+ * The $ character causes matching issues in vitest-cucumber's
+ * step expression parser.
+ */
+export declare function checkDollarInStepText(content: string, filePath: string): readonly LintViolation[];
+/**
+ * Check 9: Detect # character inside step text (mid-line), outside quoted strings.
+ *
+ * Some Gherkin parsers interpret # as a comment delimiter even when it
+ * appears in the middle of a step line, silently truncating the step text.
+ * For example, "Given a file with # inside" becomes "Given a file with".
+ *
+ * However, # inside quoted string values (e.g. `"## DDD Patterns"`) is
+ * safe — the Gherkin parser treats it as part of the string literal and
+ * does not interpret it as a comment. Only unquoted # is flagged.
+ *
+ * This is distinct from hash-in-description (which catches # inside """
+ * pseudo-code-blocks in descriptions). This check catches # in actual
+ * Given/When/Then/And/But step lines.
+ *
+ * Pure comment lines (starting with #) do not match STEP_LINE, so they
+ * are not flagged.
+ */
+export declare function checkHashInStepText(content: string, filePath: string): readonly LintViolation[];
+/**
+ * Check 10: Detect Gherkin keywords at the start of description lines.
+ *
+ * When a Feature or Rule description line starts with Given, When, Then,
+ * And, or But, the Gherkin parser interprets it as a step definition
+ * rather than description text. This terminates the description context
+ * and causes parse errors on subsequent description lines.
+ *
+ * Detection uses a state machine to track description context — after
+ * Feature: or Rule: lines, before Background:/Scenario:/etc. terminators.
+ * Within that context, lines starting with step keywords are flagged.
+ *
+ * Step DocStrings (""" blocks after Given/When/Then steps) are tracked
+ * separately. Feature:/Rule: appearing inside step DocStrings must NOT
+ * trigger description mode — they are just quoted text content.
+ */
+export declare function checkKeywordInDescription(content: string, filePath: string): readonly LintViolation[];
+/**
+ * Run all feature-only checks on a single file.
+ */
+export declare function runFeatureChecks(content: string, filePath: string): readonly LintViolation[];
+//# sourceMappingURL=feature-checks.d.ts.map

package/dist/lint/steps/feature-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-checks.d.ts","sourceRoot":"","sources":["../../../src/lint/steps/feature-checks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AA0BtE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,SAAS,aAAa,EAAE,CA6C1B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,SAAS,aAAa,EAAE,CAsC1B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAwBjG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAwB/F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,SAAS,aAAa,EAAE,CA+D1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAQ5F"}

package/dist/lint/steps/feature-checks.js

@@ -0,0 +1,279 @@
+/**
+ * Feature-only lint checks for vitest-cucumber compatibility.
+ *
+ * These checks scan raw .feature file text without needing the Gherkin parser
+ * (which would fail on some of the very issues we're detecting).
+ */
+import { STEP_LINT_RULES } from './types.js';
+import { stripQuotedContent } from './utils.js';
+/**
+ * Gherkin keywords that terminate a description context.
+ * When one of these appears at the expected indentation, the description is over.
+ */
+const DESCRIPTION_TERMINATORS = /^\s*(Background:|Scenario:|Scenario Outline:|Rule:|@\S|Examples:|\||Given |When |Then |And |But )/;
+/**
+ * Keywords that start a description context.
+ */
+const DESCRIPTION_STARTERS = /^\s*(Feature:|Rule:)\s/;
+/**
+ * Step keywords at the start of a line (after whitespace).
+ */
+const STEP_LINE = /^(\s+)(Given|When|Then|And|But)\s+(.+)$/;
+/**
+ * Scenario boundary markers (for grouping steps by scenario).
+ */
+const SCENARIO_BOUNDARY = /^\s*(Scenario:|Scenario Outline:|Examples:|Rule:|Feature:)/;
+/**
+ * Check 4: Detect # at line start inside a """ pseudo-code-block in description context.
+ *
+ * The @cucumber/gherkin parser treats # as a comment even inside
+ * Feature/Rule descriptions. When authors embed code examples using
+ * """ delimiters in descriptions, they expect those to act as code blocks.
+ * But """ in descriptions is NOT a DocString — it's plain text. Any #
+ * inside will terminate the description and cause cryptic parse errors.
+ *
+ * Plain # comments outside """ blocks are intentional Gherkin comments
+ * and are NOT flagged (they gracefully terminate descriptions).
+ *
+ * Detection: State machine tracks description context AND whether we're
+ * inside a """ pseudo-code-block within that description.
+ */
+export function checkHashInDescription(content, filePath) {
+    const violations = [];
+    const lines = content.split('\n');
+    let inDescription = false;
+    let inPseudoCodeBlock = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        // Start of description context
+        if (DESCRIPTION_STARTERS.test(line)) {
+            inDescription = true;
+            inPseudoCodeBlock = false;
+            continue;
+        }
+        // End of description context
+        if (inDescription && DESCRIPTION_TERMINATORS.test(line)) {
+            inDescription = false;
+            inPseudoCodeBlock = false;
+            continue;
+        }
+        if (!inDescription)
+            continue;
+        // Track """ pseudo-code-block boundaries within description
+        if (/^\s*"""/.test(line)) {
+            inPseudoCodeBlock = !inPseudoCodeBlock;
+            continue;
+        }
+        // Only flag # inside """ pseudo-code-blocks — those are the dangerous ones
+        if (inPseudoCodeBlock && /^\s*#/.test(line)) {
+            violations.push({
+                rule: STEP_LINT_RULES.hashInDescription.id,
+                severity: STEP_LINT_RULES.hashInDescription.severity,
+                message: `Line starts with # inside """ block in description — Gherkin parser will treat this as a comment, breaking the code example. Move to a step DocString or remove the #`,
+                file: filePath,
+                line: i + 1,
+            });
+        }
+    }
+    return violations;
+}
+/**
+ * Check 7: Detect multiple And steps with identical text in the same scenario.
+ *
+ * vitest-cucumber fails when the same And step text appears twice in one scenario.
+ * The fix is to consolidate into a single step with a DataTable or DocString.
+ */
+export function checkDuplicateAndSteps(content, filePath) {
+    const violations = [];
+    const lines = content.split('\n');
+    let currentScenarioAndSteps = new Map();
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        // New scenario boundary resets the And step collection
+        if (SCENARIO_BOUNDARY.test(line)) {
+            currentScenarioAndSteps = new Map();
+            continue;
+        }
+        // Check for And steps
+        const stepMatch = /^\s+And\s+(.+)$/.exec(line);
+        if (stepMatch !== null) {
+            const stepText = stepMatch[1]?.trim() ?? '';
+            if (stepText === '')
+                continue;
+            const previousLine = currentScenarioAndSteps.get(stepText);
+            if (previousLine !== undefined) {
+                violations.push({
+                    rule: STEP_LINT_RULES.duplicateAndStep.id,
+                    severity: STEP_LINT_RULES.duplicateAndStep.severity,
+                    message: `Duplicate And step text "${stepText}" — first seen at line ${previousLine}. Consolidate into a single step with DataTable`,
+                    file: filePath,
+                    line: i + 1,
+                });
+            }
+            else {
+                currentScenarioAndSteps.set(stepText, i + 1);
+            }
+        }
+    }
+    return violations;
+}
+/**
+ * Check 8: Detect $ in Given/When/Then/And step text.
+ *
+ * The $ character causes matching issues in vitest-cucumber's
+ * step expression parser.
+ */
+export function checkDollarInStepText(content, filePath) {
+    const violations = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        const stepMatch = STEP_LINE.exec(line);
+        if (stepMatch !== null) {
+            const stepText = stepMatch[3];
+            if (stepText !== undefined && stripQuotedContent(stepText).includes('$')) {
+                violations.push({
+                    rule: STEP_LINT_RULES.dollarInStepText.id,
+                    severity: STEP_LINT_RULES.dollarInStepText.severity,
+                    message: `Step text contains $ character which causes matching issues in vitest-cucumber`,
+                    file: filePath,
+                    line: i + 1,
+                });
+            }
+        }
+    }
+    return violations;
+}
+/**
+ * Check 9: Detect # character inside step text (mid-line), outside quoted strings.
+ *
+ * Some Gherkin parsers interpret # as a comment delimiter even when it
+ * appears in the middle of a step line, silently truncating the step text.
+ * For example, "Given a file with # inside" becomes "Given a file with".
+ *
+ * However, # inside quoted string values (e.g. `"## DDD Patterns"`) is
+ * safe — the Gherkin parser treats it as part of the string literal and
+ * does not interpret it as a comment. Only unquoted # is flagged.
+ *
+ * This is distinct from hash-in-description (which catches # inside """
+ * pseudo-code-blocks in descriptions). This check catches # in actual
+ * Given/When/Then/And/But step lines.
+ *
+ * Pure comment lines (starting with #) do not match STEP_LINE, so they
+ * are not flagged.
+ */
+export function checkHashInStepText(content, filePath) {
+    const violations = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        const stepMatch = STEP_LINE.exec(line);
+        if (stepMatch !== null) {
+            const stepText = stepMatch[3];
+            if (stepText !== undefined && stripQuotedContent(stepText).includes('#')) {
+                violations.push({
+                    rule: STEP_LINT_RULES.hashInStepText.id,
+                    severity: STEP_LINT_RULES.hashInStepText.severity,
+                    message: `Step text contains # outside quoted strings which may be interpreted as a comment, silently truncating the step`,
+                    file: filePath,
+                    line: i + 1,
+                });
+            }
+        }
+    }
+    return violations;
+}
+/**
+ * Check 10: Detect Gherkin keywords at the start of description lines.
+ *
+ * When a Feature or Rule description line starts with Given, When, Then,
+ * And, or But, the Gherkin parser interprets it as a step definition
+ * rather than description text. This terminates the description context
+ * and causes parse errors on subsequent description lines.
+ *
+ * Detection uses a state machine to track description context — after
+ * Feature: or Rule: lines, before Background:/Scenario:/etc. terminators.
+ * Within that context, lines starting with step keywords are flagged.
+ *
+ * Step DocStrings (""" blocks after Given/When/Then steps) are tracked
+ * separately. Feature:/Rule: appearing inside step DocStrings must NOT
+ * trigger description mode — they are just quoted text content.
+ */
+export function checkKeywordInDescription(content, filePath) {
+    const violations = [];
+    const lines = content.split('\n');
+    let inDescription = false;
+    let inStepDocString = false;
+    /** Keywords that break the parser when at the start of a description line */
+    const KEYWORD_AT_LINE_START = /^\s*(Given|When|Then|And|But)\s/;
+    /** Matches a """ delimiter line (with optional language hint) */
+    const DOCSTRING_DELIMITER = /^\s*"""/;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        // Track step DocString boundaries (""" blocks outside description context).
+        // Inside a step DocString, Feature:/Rule: are just quoted text — skip them.
+        if (DOCSTRING_DELIMITER.test(line)) {
+            if (!inDescription) {
+                inStepDocString = !inStepDocString;
+            }
+            continue;
+        }
+        // While inside a step DocString, skip all other checks
+        if (inStepDocString)
+            continue;
+        // Start of description context
+        if (DESCRIPTION_STARTERS.test(line)) {
+            inDescription = true;
+            continue;
+        }
+        if (!inDescription)
+            continue;
+        // IMPORTANT: This keyword check MUST come before the DESCRIPTION_TERMINATORS
+        // check below. The keyword IS what terminates the description (it's also in
+        // DESCRIPTION_TERMINATORS), but we need to flag it as a violation FIRST
+        // before exiting the description context. Reordering these blocks would
+        // cause keywords to silently exit the description without being flagged.
+        if (KEYWORD_AT_LINE_START.test(line)) {
+            // But only flag if we're still in description context —
+            // actual step lines inside Scenario blocks are fine
+            violations.push({
+                rule: STEP_LINT_RULES.keywordInDescription.id,
+                severity: STEP_LINT_RULES.keywordInDescription.severity,
+                message: `Description line starts with a Gherkin keyword — this breaks the parser. Rephrase to not start with Given/When/Then/And/But`,
+                file: filePath,
+                line: i + 1,
+            });
+            inDescription = false;
+            continue;
+        }
+        // End of description context (non-keyword terminators)
+        if (DESCRIPTION_TERMINATORS.test(line)) {
+            inDescription = false;
+            continue;
+        }
+    }
+    return violations;
+}
+/**
+ * Run all feature-only checks on a single file.
+ */
+export function runFeatureChecks(content, filePath) {
+    return [
+        ...checkHashInDescription(content, filePath),
+        ...checkDuplicateAndSteps(content, filePath),
+        ...checkDollarInStepText(content, filePath),
+        ...checkHashInStepText(content, filePath),
+        ...checkKeywordInDescription(content, filePath),
+    ];
+}
+//# sourceMappingURL=feature-checks.js.map

package/dist/lint/steps/feature-checks.js.map

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

package/dist/lint/steps/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * vitest-cucumber step lint module.
+ *
+ * Provides static analysis for vitest-cucumber feature/step compatibility.
+ * Catches common traps that cause runtime failures:
+ * - {string} function params inside ScenarioOutline (should use variables)
+ * - Missing And destructuring (causes StepAbleUnknowStepError)
+ * - Missing Rule() wrapper (causes step matching failures)
+ * - # in descriptions (terminates Gherkin parser context)
+ * - Regex step patterns (not supported by vitest-cucumber)
+ * - {phrase} usage (not supported by vitest-cucumber)
+ */
+export type { StepLintRule, FeatureStepPair } from './types.js';
+export { STEP_LINT_RULES } from './types.js';
+export { runStepLint } from './runner.js';
+export type { StepLintOptions } from './runner.js';
+export { checkHashInDescription, checkDuplicateAndSteps, checkDollarInStepText, checkHashInStepText, checkKeywordInDescription, runFeatureChecks, } from './feature-checks.js';
+export { checkRegexStepPatterns, checkPhraseUsage, checkRepeatedStepPattern, runStepChecks, } from './step-checks.js';
+export { checkScenarioOutlineFunctionParams, checkMissingAndDestructuring, checkMissingRuleWrapper, checkOutlineQuotedValues, runCrossChecks, } from './cross-checks.js';
+export { extractFeaturePath, resolveFeatureStepPairs } from './pair-resolver.js';
+export { countBraceBalance } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lint/steps/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lint/steps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kCAAkC,EAClC,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/lint/steps/index.js

@@ -0,0 +1,26 @@
+/**
+ * vitest-cucumber step lint module.
+ *
+ * Provides static analysis for vitest-cucumber feature/step compatibility.
+ * Catches common traps that cause runtime failures:
+ * - {string} function params inside ScenarioOutline (should use variables)
+ * - Missing And destructuring (causes StepAbleUnknowStepError)
+ * - Missing Rule() wrapper (causes step matching failures)
+ * - # in descriptions (terminates Gherkin parser context)
+ * - Regex step patterns (not supported by vitest-cucumber)
+ * - {phrase} usage (not supported by vitest-cucumber)
+ */
+export { STEP_LINT_RULES } from './types.js';
+// Runner
+export { runStepLint } from './runner.js';
+// Feature checks (for targeted use)
+export { checkHashInDescription, checkDuplicateAndSteps, checkDollarInStepText, checkHashInStepText, checkKeywordInDescription, runFeatureChecks, } from './feature-checks.js';
+// Step checks (for targeted use)
+export { checkRegexStepPatterns, checkPhraseUsage, checkRepeatedStepPattern, runStepChecks, } from './step-checks.js';
+// Cross-file checks (for targeted use)
+export { checkScenarioOutlineFunctionParams, checkMissingAndDestructuring, checkMissingRuleWrapper, checkOutlineQuotedValues, runCrossChecks, } from './cross-checks.js';
+// Pair resolver (for targeted use)
+export { extractFeaturePath, resolveFeatureStepPairs } from './pair-resolver.js';
+// Utilities
+export { countBraceBalance } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/lint/steps/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lint/steps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,oCAAoC;AACpC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,iCAAiC;AACjC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,uCAAuC;AACvC,OAAO,EACL,kCAAkC,EAClC,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,mCAAmC;AACnC,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/lint/steps/pair-resolver.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Resolves feature-to-step file pairs by extracting loadFeature() paths
+ * from step definition files.
+ */
+import type { LintViolation } from '../../validation-schemas/lint.js';
+import type { FeatureStepPair } from './types.js';
+/**
+ * Extract the feature file path from a loadFeature() call in step file content.
+ *
+ * Supports two patterns:
+ * 1. Simple string: loadFeature('tests/features/path/name.feature')
+ * 2. resolve(): loadFeature(resolve(__dirname, '../../../features/path/name.feature'))
+ *
+ * Returns null if no loadFeature call found or path is not extractable.
+ */
+export declare function extractFeaturePath(stepFileContent: string): string | null;
+/**
+ * Resolve feature<->step file pairs from a list of step files.
+ *
+ * For each .steps.ts file, extracts the loadFeature() path and resolves
+ * it to an absolute path relative to baseDir.
+ *
+ * Returns pairs and any warnings (e.g., unparseable loadFeature calls).
+ */
+export declare function resolveFeatureStepPairs(stepFiles: readonly string[], baseDir: string): {
+    readonly pairs: readonly FeatureStepPair[];
+    readonly warnings: readonly LintViolation[];
+};
+//# sourceMappingURL=pair-resolver.d.ts.map

package/dist/lint/steps/pair-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pair-resolver.d.ts","sourceRoot":"","sources":["../../../src/lint/steps/pair-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBzE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,MAAM,GACd;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,CAwC7F"}

package/dist/lint/steps/pair-resolver.js

@@ -0,0 +1,76 @@
+/**
+ * Resolves feature-to-step file pairs by extracting loadFeature() paths
+ * from step definition files.
+ */
+import { readFileSync } from 'fs';
+import { dirname, resolve } from 'path';
+import { STEP_LINT_RULES } from './types.js';
+/**
+ * Extract the feature file path from a loadFeature() call in step file content.
+ *
+ * Supports two patterns:
+ * 1. Simple string: loadFeature('tests/features/path/name.feature')
+ * 2. resolve(): loadFeature(resolve(__dirname, '../../../features/path/name.feature'))
+ *
+ * Returns null if no loadFeature call found or path is not extractable.
+ */
+export function extractFeaturePath(stepFileContent) {
+    // Pattern 1: Simple string literal
+    const simpleMatch = /loadFeature\s*\(\s*['"]([^'"]+)['"]\s*\)/.exec(stepFileContent);
+    if (simpleMatch?.[1] !== undefined) {
+        return simpleMatch[1];
+    }
+    // Pattern 2: resolve(__dirname, 'relative/path')
+    const resolveMatch = /loadFeature\s*\(\s*resolve\s*\([^,]*,\s*['"]([^'"]+)['"]\s*\)\s*\)/.exec(stepFileContent);
+    if (resolveMatch?.[1] !== undefined) {
+        return resolveMatch[1];
+    }
+    return null;
+}
+/**
+ * Resolve feature<->step file pairs from a list of step files.
+ *
+ * For each .steps.ts file, extracts the loadFeature() path and resolves
+ * it to an absolute path relative to baseDir.
+ *
+ * Returns pairs and any warnings (e.g., unparseable loadFeature calls).
+ */
+export function resolveFeatureStepPairs(stepFiles, baseDir) {
+    const pairs = [];
+    const warnings = [];
+    for (const stepPath of stepFiles) {
+        let content;
+        try {
+            content = readFileSync(stepPath, 'utf-8');
+        }
+        catch {
+            warnings.push({
+                rule: STEP_LINT_RULES.pairResolver.id,
+                severity: STEP_LINT_RULES.pairResolver.severity,
+                message: `Could not read step file`,
+                file: stepPath,
+                line: 0,
+            });
+            continue;
+        }
+        const extractedPath = extractFeaturePath(content);
+        if (extractedPath === null) {
+            warnings.push({
+                rule: STEP_LINT_RULES.pairResolver.id,
+                severity: STEP_LINT_RULES.pairResolver.severity,
+                message: `Could not extract loadFeature() path — cross-file checks will be skipped`,
+                file: stepPath,
+                line: 0,
+            });
+            continue;
+        }
+        // If path starts with ../ or ./, resolve relative to the step file's directory
+        // (the resolve(__dirname, '...') pattern). Otherwise resolve relative to baseDir.
+        const featurePath = extractedPath.startsWith('.')
+            ? resolve(dirname(stepPath), extractedPath)
+            : resolve(baseDir, extractedPath);
+        pairs.push({ featurePath, stepPath });
+    }
+    return { pairs, warnings };
+}
+//# sourceMappingURL=pair-resolver.js.map

package/dist/lint/steps/pair-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pair-resolver.js","sourceRoot":"","sources":["../../../src/lint/steps/pair-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGxC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,eAAuB;IACxD,mCAAmC;IACnC,MAAM,WAAW,GAAG,0CAA0C,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACrF,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,iDAAiD;IACjD,MAAM,YAAY,GAAG,oEAAoE,CAAC,IAAI,CAC5F,eAAe,CAChB,CAAC;IACF,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAA4B,EAC5B,OAAe;IAEf,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IAErC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,eAAe,CAAC,YAAY,CAAC,EAAE;gBACrC,QAAQ,EAAE,eAAe,CAAC,YAAY,CAAC,QAAQ;gBAC/C,OAAO,EAAE,0BAA0B;gBACnC,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC;aACR,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,eAAe,CAAC,YAAY,CAAC,EAAE;gBACrC,QAAQ,EAAE,eAAe,CAAC,YAAY,CAAC,QAAQ;gBAC/C,OAAO,EAAE,0EAA0E;gBACnF,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC;aACR,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,+EAA+E;QAC/E,kFAAkF;QAClF,MAAM,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC;YAC/C,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC"}

package/dist/lint/steps/runner.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Orchestrator for vitest-cucumber step lint checks.
+ *
+ * Discovers feature and step files, pairs them, runs all checks,
+ * and returns a LintSummary compatible with the existing lint engine.
+ */
+import type { LintSummary } from '../engine.js';
+/**
+ * Options for the step lint runner
+ */
+export interface StepLintOptions {
+    /** Base directory for resolving paths (default: cwd) */
+    readonly baseDir?: string;
+    /** Feature file glob patterns (default: tests + specs + decisions) */
+    readonly featureGlobs?: readonly string[];
+    /** Step file glob patterns (default: tests/steps) */
+    readonly stepGlobs?: readonly string[];
+}
+/**
+ * Run all step lint checks and return a LintSummary.
+ *
+ * Executes three categories of checks:
+ * 1. Feature-only checks on all .feature files
+ * 2. Step-only checks on all .steps.ts files
+ * 3. Cross-file checks on paired feature+step files
+ */
+export declare function runStepLint(options?: StepLintOptions): LintSummary;
+//# sourceMappingURL=runner.d.ts.map

package/dist/lint/steps/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/lint/steps/runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,cAAc,CAAC;AAkB5D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,eAAoB,GAAG,WAAW,CA4DtE"}