@vijaypjavvadi/bdd2pw 3.12.0 → 4.0.0

package/CHANGELOG.md

@@ -9,6 +9,104 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 _Nothing yet._
 
+## [4.0.0] — 2026-06-25
+
+### Theme: Data-driven scaffolds — bring your own data or generate it
+
+v4.0 is a **major version with no breaking changes**. The number bump
+reflects the size of the feature bundle, not the risk to existing users.
+Scaffolds that don't use the new `--data` / `--gen-data` flags behave
+identically to v3.12.
+
+### Added — `--data <path>` external data file injection
+
+Pass a CSV, JSON, or XLSX file. Every Scenario Outline in the .feature
+file gets its Examples table swapped with rows from the data file.
+Inline Examples in the .feature become the no-data fallback.
+
+```
+bdd2pw scaffold login.feature --data data/users.csv --url ... --page LoginPage --repo .
+```
+
+- CSV parser is dependency-free (RFC 4180 quoted fields, embedded
+  newlines, escaped quotes, mixed CRLF/LF).
+- JSON accepts either array of objects or `{rows: [...]}` envelope.
+- XLSX lazy-loads via the optional `xlsx` dep; clear `npm install xlsx`
+  hint if missing.
+- Per-scenario column filtering — extra data columns are dropped per
+  scenario, so a single 50-column data file can feed many narrow
+  scenarios without each one pulling in noise.
+- Scenarios whose placeholders reference columns NOT present in the
+  data are skipped with a warning in BDD_REVIEW.md (inline Examples
+  preserved).
+
+### Added — `--gen-data` synthetic data generator
+
+For when you need plausible test data but don't have a real dataset.
+Pass a schema JSON listing each column's source:
+
+```json
+{
+  "email": "faker.internet.email",
+  "password": "faker.internet.password",
+  "url_fragment": "inventory.html",
+  "description": "llm:auto insurance claim, one sentence"
+}
+```
+
+```
+bdd2pw scaffold login.feature --gen-data --schema users.schema.json --rows 50 --url ... --page LoginPage --repo .
+```
+
+- `faker.X.Y` paths resolve via `@faker-js/faker` (optional dep).
+- `llm:<prompt>` routes through the configured LLM provider (Anthropic,
+  OpenAI, or Gemini) for context-aware domain-specific data.
+- Literal strings repeat the same value in every row.
+- Seeded by default (seed=42) so output is reproducible across runs.
+  Override with `--seed N`.
+- Per-column LLM batching — one provider call per LLM-driven column
+  regardless of row count. 3 LLM fields × 50 rows = 3 calls.
+
+### Added — `LLMClient.generateText()` API
+
+Generic single-prompt text generation method on all three providers
+(Anthropic, OpenAI, Gemini). Routes through the same governance
+sanitisation, budget enforcement, timeout, and telemetry pipeline as
+binding generation. Used by the synth data generator; available for
+any custom downstream tooling that needs a clean LLM call.
+
+### CLI
+
+- `--data <path>` — load external data file
+- `--gen-data` — enable synthetic generation
+- `--schema <path>` — schema JSON for `--gen-data`
+- `--rows <n>` — row count for `--gen-data` (default 20)
+- `--seed <n>` — Faker seed (default 42)
+
+Precedence: `--data` wins if both are passed; warning printed to stderr.
+
+### Programmatic API
+
+`ScaffoldOptions.dataSource: {type: "file"|"synthetic", path?, schemaPath?, rows?, seed?}`
+- Failures fall back to inline Examples and surface as ReviewItems.
+- Same graceful-degradation pattern as the v2.0 LLM fallback failure mode.
+
+### New `optionalDependencies`
+
+- `@faker-js/faker ^9.3.0` — synthetic data generation
+- `xlsx ^0.18.5` — XLSX data file loading
+
+Same defensive `require()` loading pattern as existing optional deps.
+Users who only use Anthropic + CSV need neither.
+
+### Tests
+
+`tests/unit/v400Data.test.ts` — 28 cases across DataLoader (CSV/JSON
+parsing, file routing, validation), SynthGenerator (literal/Faker/LLM
+fields, error cases), and ExamplesInjector (extract placeholders,
+swap, skip vanilla, missing-column warning, per-scenario filtering,
+zero-row graceful handling).
+
 ## [3.12.0] — 2026-06-19
 
 > Note: v3.11.0 was tagged in git but never published to npm. v3.12.0

package/README.md

@@ -42,10 +42,13 @@ Point it at a `.feature` file and a URL. It parses the Gherkin, scans the live p
 
 > **The pitch.** Run `bdd2pw scaffold` and you get a Playwright TS repo where `npx playwright test` runs against the real site. For specific fixtures, all green. For vague ones, the 60-90% you'd otherwise hand-write is done; you finish the rest — or you let the governed LLM finish them.
 
-## What's new in v3.12.0
+## What's new in v4.0.0
 
-- **NEW** Gemini provider — three-provider parity is now complete. `--llm gemini` or `LLMClientOptions.provider: "gemini"` defaults to `gemini-2.5-flash` ($0.10/M input — the cheapest model across all three providers). Same cache, governance, batching, and telemetry pipeline as Anthropic and OpenAI. Install only when needed via `npm install @google/generative-ai`.
-- OpenAI provider with full parity (cache, governance, batching, telemetry). `--llm openai` defaults to `gpt-4o-mini` (v3.11.0).
+- **NEW** `--data <path>` — load CSV / JSON / XLSX file and inject rows into every Scenario Outline's Examples table. Drop in a 500-row dataset without touching the .feature file.
+- **NEW** `--gen-data --schema <path> --rows N` — generate synthetic Examples rows. Schema picks per-column source: `faker.internet.email` for common fields, `llm:auto insurance claim description` for context-aware domain data. Seeded for reproducibility (`--seed 42`).
+- **NEW** `LLMClient.generateText()` — generic single-prompt API on all three providers (Anthropic, OpenAI, Gemini). Same governance + budget + timeout + telemetry pipeline as binding generation.
+- Gemini provider — three-provider parity complete. `--llm gemini` defaults to `gemini-2.5-flash` ($0.10/M input — cheapest across all three providers). (v3.12.0)
+- OpenAI provider with full parity. `--llm openai` defaults to `gpt-4o-mini`. (v3.11.0)
 - `bdd2pw heal-stats <repo>` CLI reads `<repo>/artefacts/heal-events.jsonl` and writes a heal-stats.json sidecar with heal rate, top failing fields, retry latency, candidate-selector promotions (v3.10.0).
 - `llmStats: true` writes `<repo>/artefacts/llm-stats.json` with per-call latency, token counts, cache hit rate, and an estimated cost in USD (v3.9.0).
 - Seven domain rule packs (banking, healthcare, insurance, retail, gov, education, telecom) — ~140 industry-specific patterns total.
@@ -354,14 +357,15 @@ output/
 | v3.9.0 | Telemetry | `artefacts/llm-stats.json` sidecar — per-call latency + tokens + cache hit rate + estimated cost. Makes v3.5 batching ROI measurable per scaffold. |
 | v3.10.0 | Heal stats | `bdd2pw heal-stats <repo>` CLI consumes `artefacts/heal-events.jsonl` and writes `heal-stats.json` with heal rate, top failing fields, top error patterns, retry latency, candidate-selector promotions. Self-healing ROI per test run. |
 | v3.11.0 | OpenAI provider | `LLMClientOptions.provider: "openai"` lands with cache + governance + batching + telemetry parity. Default model `gpt-4o-mini` (~17x cheaper than `gpt-4o` for structured-JSON tasks). |
-| **v3.12.0 (current)** | Gemini provider | `LLMClientOptions.provider: "gemini"` lands with full parity. Default model `gemini-2.5-flash` ($0.10/M input — cheapest across all three providers). Three-provider parity complete. |
+| v3.12.0 | Gemini provider | `LLMClientOptions.provider: "gemini"` lands with full parity. Default model `gemini-2.5-flash` ($0.10/M input — cheapest across all three providers). Three-provider parity complete. |
+| **v4.0.0 (current)** | Data-driven scaffolds | `--data <path>` (CSV/JSON/XLSX) and `--gen-data --schema <path>` (Faker + LLM) inject Examples rows into Scenario Outlines. `LLMClient.generateText()` added to all three providers. **Additive only — no breaking changes.** |
 
 ### Next 6 months (Jun 2026 → Nov 2026, ~2 releases/month)
 
 | Target | Version | Theme | Headline |
 |---|---|---|---|
 | Aug 2026 | **v3.13.0** | Auto-rules | `bdd2pw apply-proposals --interactive` — walks the human through each v3.6 proposal, validates the regex compiles + matches the sample texts, optionally appends to `stepMatcher.ts`. Closes the propose-rules loop. |
-| Aug 2026 | **v4.0.0** | Modern defaults | Semver-major reset: bump Anthropic default model, retire v2.x deprecated APIs, switch test-signature defaults to current best practice. Migration guide ships alongside. |
+| Aug 2026 | **v4.1.0** | Modern defaults | Bump default models, retire v2.x deprecated APIs, flip opt-in defaults (domains, llm-stats, healing) to opt-out. Migration guide ships alongside. |
 | Sep 2026 | **v4.1.0** | sel2pw merge | sel2pw migrated onto `@vijaypjavvadi/pw-emit` — three packages share one emitter. All future v3.x emitter improvements automatically flow to Selenium users. |
 | Sep 2026 | **v4.2.0** | Domain packs | Three more opt-in packs: **fintech** (KYC, AML, trading desks), **real-estate** (MLS, listings, escrow), **hospitality** (PMS, reservations, OTA). ~60 more rules. |
 | Oct 2026 | **v4.3.0** | API v2 | WebSocket assertion rules, multipart file-upload patterns, GraphQL query / mutation / subscription rules. Extends v3.0's API testing surface. |

package/dist/cli.js

@@ -77,6 +77,12 @@ program
     .option("--force", "Overwrite existing spec files", false)
     .option("--self-healing", "Wrap emitted locators in healOrThrow() and generate lib/heal.ts + tsconfig path alias. Locator events are logged to artefacts/heal-events.jsonl for the offline self-heal pipeline. Action-time healing is v1.2.", false)
     .option("--llm-stats", "v3.9.0 — write <repo>/artefacts/llm-stats.json with per-call latency, token counts, cache hit rate, and estimated cost.", false)
+    // v4.0.0 — data-driven Examples injection.
+    .option("--data <path>", "v4.0.0 — load CSV / JSON / XLSX file and inject rows into every Scenario Outline's Examples table. Inline Examples are overridden when this is set. Failures fall back to inline Examples + warn in BDD_REVIEW.md.")
+    .option("--gen-data", "v4.0.0 — generate synthetic Examples rows via Faker + LLM. Requires --schema. Combine with --rows to set row count.", false)
+    .option("--schema <path>", "v4.0.0 — JSON schema for --gen-data. Object of {column: source} where source is 'faker.X.Y', 'llm:<prompt>', or a literal string.")
+    .option("--rows <n>", "v4.0.0 — row count for --gen-data. Default 20.", "20")
+    .option("--seed <n>", "v4.0.0 — Faker RNG seed for --gen-data reproducibility. Default 42.", "42")
     .action(async (feature, opts) => {
     try {
         // v2.0 — wire the actual LLM config when --llm is passed. The legacy
@@ -107,6 +113,14 @@ program
                     : undefined,
             })
             : undefined;
+        // v4.0.0 — warn if user passed both data sources. --data wins.
+        if (opts.data && opts.genData) {
+            console.warn("[bdd2pw] both --data and --gen-data passed; --data wins. --gen-data ignored.");
+        }
+        // v4.0.0 — warn if --gen-data without --schema.
+        if (opts.genData && !opts.schema) {
+            console.warn("[bdd2pw] --gen-data requires --schema <path>. Ignoring --gen-data.");
+        }
         const result = await (0, index_1.scaffold)({
             feature: path.resolve(feature),
             url: opts.url,
@@ -129,6 +143,21 @@ program
             selfHealing: opts.selfHealing,
             // v3.9.0 — telemetry sidecar
             llmStats: opts.llmStats === true,
+            // v4.0.0 — data-driven Examples injection. --data wins over
+            // --gen-data when both are passed (and we warn in stderr so the
+            // user sees what happened).
+            dataSource: opts.data
+                ? { type: "file", path: path.resolve(opts.data) }
+                : opts.genData
+                    ? {
+                        type: "synthetic",
+                        schemaPath: opts.schema
+                            ? path.resolve(opts.schema)
+                            : undefined,
+                        rows: opts.rows ? Number(opts.rows) : undefined,
+                        seed: opts.seed ? Number(opts.seed) : undefined,
+                    }
+                    : undefined,
         });
         logger_1.logger.info({ result }, "scaffold complete");
     }

package/dist/cli.js.map

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

package/dist/data/dataLoader.d.ts

@@ -0,0 +1,78 @@
+/**
+ * v4.0.0 — DataLoader.
+ *
+ * Reads CSV / JSON / XLSX into a normalized `DataRow[]` for injection
+ * into Scenario Outline Examples tables.
+ *
+ * Normalization contract:
+ *   - All values are coerced to strings (Gherkin Examples tables are
+ *     always string-typed; the test code does the parsing).
+ *   - Headers are trimmed; empty headers are rejected up-front so the
+ *     placeholder-to-column matching downstream is deterministic.
+ *   - Empty rows (all-blank cells) are dropped silently — they're
+ *     a frequent artifact of hand-edited CSVs.
+ *
+ * Format detection is by file extension. .xlsx loading is lazy via
+ * the `xlsx` optional dep — if missing, the user gets a clear
+ * `npm install xlsx` error instead of a module-resolution crash.
+ *
+ * Error model: every loader function throws `DataLoaderError` with
+ * a human-readable message. The orchestrator in `scaffold()` catches
+ * this and surfaces it as a `ReviewItem` so the failure shows up in
+ * BDD_REVIEW.md alongside other diagnostics — not just on stderr.
+ */
+/** One row of data. All values are strings (Gherkin convention). */
+export type DataRow = Record<string, string>;
+export declare class DataLoaderError extends Error {
+    readonly file?: string | undefined;
+    constructor(message: string, file?: string | undefined);
+}
+/**
+ * Entry point. Routes by extension to the right parser.
+ *
+ * @param filePath  Absolute or relative path to a .csv / .json / .xlsx file.
+ * @returns         Array of rows, each a string-keyed dict.
+ * @throws DataLoaderError on any read / parse / shape error.
+ */
+export declare function loadDataFile(filePath: string): DataRow[];
+/**
+ * CSV parser — RFC 4180 compliant for the practical subset:
+ *   - Quoted fields with embedded commas
+ *   - Quoted fields with embedded newlines
+ *   - Escaped quotes (`""` inside a quoted field)
+ *   - Mixed CRLF / LF line endings
+ *
+ * Does NOT delegate to papaparse — keeping this dependency-free since
+ * the format is small enough to handle inline and we want bdd2pw to
+ * scaffold without an `npm install` step on the user's machine.
+ */
+export declare function parseCsv(text: string, fileLabel?: string): DataRow[];
+/**
+ * JSON parser — accepts either:
+ *   1. Array of objects: `[{a:1,b:2}, {a:3,b:4}]` — most natural shape.
+ *   2. Object with `rows`: `{rows: [{...}, {...}]}` — useful for files
+ *      that also carry metadata (generator seed, source URL, etc).
+ *
+ * Numbers and booleans are stringified for Gherkin Examples compatibility.
+ * Null values become empty strings.
+ */
+export declare function parseJson(text: string, fileLabel?: string): DataRow[];
+/**
+ * XLSX parser — uses the optional `xlsx` dep. Reads the FIRST sheet
+ * only; users with multi-sheet workbooks should export the sheet they
+ * want to CSV.
+ *
+ * Lazy-loaded so users who never use XLSX don't need the dep installed.
+ */
+export declare function parseXlsx(absPath: string, fileLabel?: string): DataRow[];
+/**
+ * Validates that the loaded data rows have every column the Scenario
+ * Outline placeholders reference. Returns the list of missing column
+ * names; empty array means OK.
+ *
+ * Called by the scaffold orchestrator after parsing the .feature file.
+ * If anything is missing, the orchestrator surfaces it as a
+ * `ReviewItem` and skips Examples injection for that scenario rather
+ * than producing a broken spec.
+ */
+export declare function validateColumnsForPlaceholders(rows: DataRow[], placeholders: string[]): string[];

package/dist/data/dataLoader.js

@@ -0,0 +1,339 @@
+"use strict";
+/**
+ * v4.0.0 — DataLoader.
+ *
+ * Reads CSV / JSON / XLSX into a normalized `DataRow[]` for injection
+ * into Scenario Outline Examples tables.
+ *
+ * Normalization contract:
+ *   - All values are coerced to strings (Gherkin Examples tables are
+ *     always string-typed; the test code does the parsing).
+ *   - Headers are trimmed; empty headers are rejected up-front so the
+ *     placeholder-to-column matching downstream is deterministic.
+ *   - Empty rows (all-blank cells) are dropped silently — they're
+ *     a frequent artifact of hand-edited CSVs.
+ *
+ * Format detection is by file extension. .xlsx loading is lazy via
+ * the `xlsx` optional dep — if missing, the user gets a clear
+ * `npm install xlsx` error instead of a module-resolution crash.
+ *
+ * Error model: every loader function throws `DataLoaderError` with
+ * a human-readable message. The orchestrator in `scaffold()` catches
+ * this and surfaces it as a `ReviewItem` so the failure shows up in
+ * BDD_REVIEW.md alongside other diagnostics — not just on stderr.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataLoaderError = void 0;
+exports.loadDataFile = loadDataFile;
+exports.parseCsv = parseCsv;
+exports.parseJson = parseJson;
+exports.parseXlsx = parseXlsx;
+exports.validateColumnsForPlaceholders = validateColumnsForPlaceholders;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class DataLoaderError extends Error {
+    constructor(message, file) {
+        super(message);
+        this.file = file;
+        this.name = "DataLoaderError";
+    }
+}
+exports.DataLoaderError = DataLoaderError;
+/**
+ * Entry point. Routes by extension to the right parser.
+ *
+ * @param filePath  Absolute or relative path to a .csv / .json / .xlsx file.
+ * @returns         Array of rows, each a string-keyed dict.
+ * @throws DataLoaderError on any read / parse / shape error.
+ */
+function loadDataFile(filePath) {
+    const abs = path.resolve(filePath);
+    if (!fs.existsSync(abs)) {
+        throw new DataLoaderError(`Data file not found: ${filePath}`, filePath);
+    }
+    const ext = path.extname(abs).toLowerCase();
+    switch (ext) {
+        case ".csv":
+            return parseCsv(fs.readFileSync(abs, "utf-8"), filePath);
+        case ".json":
+            return parseJson(fs.readFileSync(abs, "utf-8"), filePath);
+        case ".xlsx":
+        case ".xls":
+            return parseXlsx(abs, filePath);
+        default:
+            throw new DataLoaderError(`Unsupported data file extension "${ext}". Supported: .csv, .json, .xlsx`, filePath);
+    }
+}
+/**
+ * CSV parser — RFC 4180 compliant for the practical subset:
+ *   - Quoted fields with embedded commas
+ *   - Quoted fields with embedded newlines
+ *   - Escaped quotes (`""` inside a quoted field)
+ *   - Mixed CRLF / LF line endings
+ *
+ * Does NOT delegate to papaparse — keeping this dependency-free since
+ * the format is small enough to handle inline and we want bdd2pw to
+ * scaffold without an `npm install` step on the user's machine.
+ */
+function parseCsv(text, fileLabel) {
+    // Strip UTF-8 BOM if present. PowerShell's `Out-File -Encoding utf8`
+    // adds one by default, as do several Windows editors. Without this
+    // strip, the first header gets a U+FEFF prefix and downstream column
+    // matching silently fails.
+    if (text.charCodeAt(0) === 0xfeff)
+        text = text.slice(1);
+    // Normalize line endings, drop a trailing newline if present.
+    const normalized = text.replace(/\r\n?/g, "\n").replace(/\n$/, "");
+    if (normalized.length === 0) {
+        throw new DataLoaderError("CSV file is empty", fileLabel);
+    }
+    const lines = [];
+    let current = [];
+    let field = "";
+    let inQuotes = false;
+    let i = 0;
+    while (i < normalized.length) {
+        const c = normalized[i];
+        if (inQuotes) {
+            if (c === '"') {
+                if (normalized[i + 1] === '"') {
+                    field += '"';
+                    i += 2;
+                    continue;
+                }
+                inQuotes = false;
+                i += 1;
+                continue;
+            }
+            field += c;
+            i += 1;
+        }
+        else {
+            if (c === '"') {
+                inQuotes = true;
+                i += 1;
+            }
+            else if (c === ",") {
+                current.push(field);
+                field = "";
+                i += 1;
+            }
+            else if (c === "\n") {
+                current.push(field);
+                field = "";
+                lines.push(current);
+                current = [];
+                i += 1;
+            }
+            else {
+                field += c;
+                i += 1;
+            }
+        }
+    }
+    // Flush last field + last row.
+    current.push(field);
+    lines.push(current);
+    if (lines.length < 2) {
+        throw new DataLoaderError("CSV must have at least a header row and one data row", fileLabel);
+    }
+    const headers = lines[0].map((h) => h.trim());
+    validateHeaders(headers, fileLabel);
+    const rows = [];
+    for (let r = 1; r < lines.length; r++) {
+        const cells = lines[r];
+        if (isBlankRow(cells))
+            continue;
+        const row = {};
+        for (let c = 0; c < headers.length; c++) {
+            row[headers[c]] = (cells[c] ?? "").trim();
+        }
+        rows.push(row);
+    }
+    if (rows.length === 0) {
+        throw new DataLoaderError("CSV had a header row but no non-empty data rows", fileLabel);
+    }
+    return rows;
+}
+/**
+ * JSON parser — accepts either:
+ *   1. Array of objects: `[{a:1,b:2}, {a:3,b:4}]` — most natural shape.
+ *   2. Object with `rows`: `{rows: [{...}, {...}]}` — useful for files
+ *      that also carry metadata (generator seed, source URL, etc).
+ *
+ * Numbers and booleans are stringified for Gherkin Examples compatibility.
+ * Null values become empty strings.
+ */
+function parseJson(text, fileLabel) {
+    // Strip UTF-8 BOM (see parseCsv for rationale).
+    if (text.charCodeAt(0) === 0xfeff)
+        text = text.slice(1);
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new DataLoaderError(`JSON parse error: ${msg}`, fileLabel);
+    }
+    let raw;
+    if (Array.isArray(parsed)) {
+        raw = parsed;
+    }
+    else if (parsed &&
+        typeof parsed === "object" &&
+        Array.isArray(parsed.rows)) {
+        raw = parsed.rows;
+    }
+    else {
+        throw new DataLoaderError('JSON must be an array of objects OR an object with a "rows" array', fileLabel);
+    }
+    if (raw.length === 0) {
+        throw new DataLoaderError("JSON contained zero rows", fileLabel);
+    }
+    const rows = [];
+    let headersSeen = null;
+    for (const item of raw) {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+            throw new DataLoaderError(`Every JSON row must be a plain object; got: ${JSON.stringify(item)?.slice(0, 80)}`, fileLabel);
+        }
+        const obj = item;
+        const row = {};
+        for (const [k, v] of Object.entries(obj)) {
+            row[k] = v === null || v === undefined ? "" : String(v);
+        }
+        if (!headersSeen) {
+            headersSeen = new Set(Object.keys(row));
+            validateHeaders(Array.from(headersSeen), fileLabel);
+        }
+        rows.push(row);
+    }
+    return rows;
+}
+/**
+ * XLSX parser — uses the optional `xlsx` dep. Reads the FIRST sheet
+ * only; users with multi-sheet workbooks should export the sheet they
+ * want to CSV.
+ *
+ * Lazy-loaded so users who never use XLSX don't need the dep installed.
+ */
+function parseXlsx(absPath, fileLabel) {
+    let xlsx;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        xlsx = require("xlsx");
+    }
+    catch {
+        throw new DataLoaderError("xlsx package not installed. Run: npm install xlsx", fileLabel);
+    }
+    const wb = xlsx.readFile(absPath);
+    const firstSheetName = wb.SheetNames[0];
+    if (!firstSheetName) {
+        throw new DataLoaderError("XLSX has no sheets", fileLabel);
+    }
+    const sheet = wb.Sheets[firstSheetName];
+    // sheet_to_json with header:1 returns array of arrays — we then
+    // promote first row to headers ourselves so the validation flow
+    // matches the CSV path exactly.
+    const aoa = xlsx.utils.sheet_to_json(sheet, {
+        header: 1,
+        defval: "",
+        blankrows: false,
+        raw: false,
+    });
+    if (aoa.length < 2) {
+        throw new DataLoaderError("XLSX must have at least a header row and one data row", fileLabel);
+    }
+    const headers = aoa[0].map((h) => String(h ?? "").trim());
+    validateHeaders(headers, fileLabel);
+    const rows = [];
+    for (let r = 1; r < aoa.length; r++) {
+        const cells = aoa[r];
+        if (isBlankRow(cells.map((c) => String(c ?? ""))))
+            continue;
+        const row = {};
+        for (let c = 0; c < headers.length; c++) {
+            row[headers[c]] = String(cells[c] ?? "").trim();
+        }
+        rows.push(row);
+    }
+    if (rows.length === 0) {
+        throw new DataLoaderError("XLSX had a header row but no non-empty data rows", fileLabel);
+    }
+    return rows;
+}
+// --- helpers ----------------------------------------------------------------
+function validateHeaders(headers, fileLabel) {
+    if (headers.length === 0) {
+        throw new DataLoaderError("No headers found", fileLabel);
+    }
+    const blanks = headers
+        .map((h, i) => (h.length === 0 ? i : -1))
+        .filter((i) => i >= 0);
+    if (blanks.length > 0) {
+        throw new DataLoaderError(`Header row has blank column(s) at index: ${blanks.join(", ")}`, fileLabel);
+    }
+    const seen = new Set();
+    const dupes = [];
+    for (const h of headers) {
+        if (seen.has(h))
+            dupes.push(h);
+        seen.add(h);
+    }
+    if (dupes.length > 0) {
+        throw new DataLoaderError(`Duplicate header(s): ${[...new Set(dupes)].join(", ")}`, fileLabel);
+    }
+}
+function isBlankRow(cells) {
+    return cells.every((c) => (c ?? "").toString().trim() === "");
+}
+/**
+ * Validates that the loaded data rows have every column the Scenario
+ * Outline placeholders reference. Returns the list of missing column
+ * names; empty array means OK.
+ *
+ * Called by the scaffold orchestrator after parsing the .feature file.
+ * If anything is missing, the orchestrator surfaces it as a
+ * `ReviewItem` and skips Examples injection for that scenario rather
+ * than producing a broken spec.
+ */
+function validateColumnsForPlaceholders(rows, placeholders) {
+    if (rows.length === 0)
+        return placeholders;
+    const presentColumns = new Set(Object.keys(rows[0]));
+    return placeholders.filter((p) => !presentColumns.has(p));
+}
+//# sourceMappingURL=dataLoader.js.map