@sun-asterisk/sungen 3.2.6 → 3.2.8

package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/column-cell-assertion.hbs

@@ -1,3 +1,3 @@
-await expect({{> locator}}.getByRole('columnheader', { name: '{{columnName}}' })).toBeVisible();
-const {{columnIndexVar}} = (await page.getByRole('columnheader').allTextContents()).findIndex(h => h.includes('{{columnName}}'));
-await expect(page.getByRole('row').nth({{rowNth}}).getByRole('cell').nth({{columnIndexVar}})).toHaveText('{{dataValue}}');
+await expect({{> locator}}.getByRole('columnheader', { name: '{{columnName}}', includeHidden: true })).toBeVisible();
+const {{columnIndexVar}} = (await page.getByRole('columnheader', { includeHidden: true }).filter({ visible: true }).allTextContents()).findIndex(h => h.includes('{{columnName}}'));
+await expect(page.getByRole('row', { includeHidden: true }).filter({ visible: true }).nth({{rowNth}}).getByRole('cell', { includeHidden: true }).filter({ visible: true }).nth({{columnIndexVar}})).toHaveText('{{dataValue}}');

package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-empty.hbs

@@ -1 +1 @@
-await expect({{> locator}}.locator('tbody').getByRole('row')).toHaveCount(0);
+await expect({{> locator}}.locator('tbody').getByRole('row', { includeHidden: true }).filter({ visible: true })).toHaveCount(0);

package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-match-data.hbs

@@ -1,13 +1,13 @@
 {{~#if isGiven~}}
 {
-  const rows = {{> locator}}.locator('tbody').getByRole('row');
+  const rows = {{> locator}}.locator('tbody').getByRole('row', { includeHidden: true }).filter({ visible: true });
 {{#each assertions}}
   {{this}}
 {{/each~}}
 }
 {{~else~}}
 {
-  const rows = {{> locator}}.locator('tbody').getByRole('row');
+  const rows = {{> locator}}.locator('tbody').getByRole('row', { includeHidden: true }).filter({ visible: true });
 {{#each assertions}}
   {{this}}
 {{/each~}}

package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-row-count.hbs

@@ -1 +1 @@
-await expect({{> locator}}.locator('tbody').getByRole('row')).toHaveCount({{expectedCount}});
+await expect({{> locator}}.locator('tbody').getByRole('row', { includeHidden: true }).filter({ visible: true })).toHaveCount({{expectedCount}});

package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-row-exists.hbs

@@ -1,7 +1,7 @@
 {{~#if isGiven}}
-const tableRow = {{> locator}}.getByRole('row').filter({ hasText: '{{escapeQuotes filterValue}}' });
+const tableRow = {{> locator}}.getByRole('row', { includeHidden: true }).filter({ hasText: '{{escapeQuotes filterValue}}' }).filter({ visible: true });
 await tableRow.waitFor();
 {{~else}}
-const tableRow = {{> locator}}.getByRole('row').filter({ hasText: '{{escapeQuotes filterValue}}' });
+const tableRow = {{> locator}}.getByRole('row', { includeHidden: true }).filter({ hasText: '{{escapeQuotes filterValue}}' }).filter({ visible: true });
 await expect(tableRow).toBeVisible();
 {{~/if}}

package/src/generators/test-generator/adapters/playwright/templates/steps/assertions/table-row-not-exists.hbs

@@ -1,5 +1,5 @@
 {{~#if isGiven}}
-await {{> locator}}.getByRole('row').filter({ hasText: '{{escapeQuotes filterValue}}' }).waitFor({ state: 'hidden' });
+await {{> locator}}.getByRole('row', { includeHidden: true }).filter({ hasText: '{{escapeQuotes filterValue}}' }).filter({ visible: true }).waitFor({ state: 'hidden' });
 {{~else}}
-await expect({{> locator}}.getByRole('row').filter({ hasText: '{{escapeQuotes filterValue}}' })).toHaveCount(0);
+await expect({{> locator}}.getByRole('row', { includeHidden: true }).filter({ hasText: '{{escapeQuotes filterValue}}' }).filter({ visible: true })).toHaveCount(0);
 {{~/if}}

package/src/generators/test-generator/step-mapper.ts

@@ -229,8 +229,12 @@ export class StepMapper {
    * Generate column assertion scoped to the current row.
    * Uses columns config for exact cell targeting (nth), or filter fallback.
    *
-   * With columns:  await expect(tableRow.getByRole('cell').nth(index)).toHaveText('value');
-   * Without:       await expect(tableRow.getByRole('cell').filter({ hasText: 'value' })).toBeVisible();
+   * With columns:  await expect(tableRow.getByRole('cell', { includeHidden: true }).filter({ visible: true }).nth(index)).toHaveText('value');
+   * Without:       await expect(tableRow.getByRole('cell', { includeHidden: true }).filter({ hasText: 'value' }).filter({ visible: true })).toBeVisible();
+   *
+   * includeHidden + visible filter: when a modal (e.g. Radix Dialog) is open the
+   * background gets aria-hidden="true", which empties plain getByRole() even though
+   * the cells are still rendered — measure what the user SEES, not the a11y tree.
    */
   private generateRowScopedColumnAssertion(step: ParsedStep): MappedStep {
     const columnRef = step.selectorRef || '';
@@ -259,16 +263,16 @@ export class StepMapper {
     if (columnIndex !== undefined) {
       // Exact cell: nth(index) + toHaveText
       if (isGiven) {
-        code = `await expect(tableRow.getByRole('cell').nth(${columnIndex})).toHaveText('${escapedValue}');`;
+        code = `await expect(tableRow.getByRole('cell', { includeHidden: true }).filter({ visible: true }).nth(${columnIndex})).toHaveText('${escapedValue}');`;
       } else {
-        code = `await expect(tableRow.getByRole('cell').nth(${columnIndex})).toHaveText('${escapedValue}');`;
+        code = `await expect(tableRow.getByRole('cell', { includeHidden: true }).filter({ visible: true }).nth(${columnIndex})).toHaveText('${escapedValue}');`;
       }
     } else {
       // Fallback: filter by text
       if (isGiven) {
-        code = `await tableRow.getByRole('cell').filter({ hasText: '${escapedValue}' }).waitFor();`;
+        code = `await tableRow.getByRole('cell', { includeHidden: true }).filter({ hasText: '${escapedValue}' }).filter({ visible: true }).waitFor();`;
       } else {
-        code = `await expect(tableRow.getByRole('cell').filter({ hasText: '${escapedValue}' })).toBeVisible();`;
+        code = `await expect(tableRow.getByRole('cell', { includeHidden: true }).filter({ hasText: '${escapedValue}' }).filter({ visible: true })).toBeVisible();`;
       }
     }
 

package/src/orchestrator/templates/ai-src/skills/sungen-api-design/SKILL.md

@@ -72,6 +72,14 @@ A flow (`create → login → delete`) is a **Functional integration** test, **n
 ## File upload (real files)
 `body:` carries only scalar fields — to send a **real file**, declare it in the catalog entry; the runtime reads the fixture from disk. Two forms, by how the server accepts the file:
 - **`files:`** → `multipart/form-data`, the file is a form part: `files: { file: { path: ":avatar", mimeType: image/png } }` (+ optional text `body:` fields alongside). Shorthand `files: { file: ":avatar" }`.
+  - **Multiple files under ONE field name** → make the field's value an **array** (each element a spec or shorthand string):
+    ```yaml
+    files:
+      gift_image:
+        - ":gift_image_1"    # test-data: gift_image_1 → fixtures/a.png
+        - ":gift_image_2"    # test-data: gift_image_2 → fixtures/b.png
+    ```
+    Each element binds its own `:param` from test-data. Use this for endpoints that accept a list of files under the same field — a single object value can only hold one file. **Automate multi-file uploads with `@api`; don't defer to `@manual`.** (File uploads use Playwright's `FormData` multipart, which requires **`@playwright/test` ≥ 1.44** — the version sungen installs by default; only projects pinned to an older Playwright need to upgrade.)
 - **`bodyFile:`** → raw binary body (the whole body IS the file's bytes, e.g. `application/octet-stream`): `bodyFile: { path: ":image", mimeType: application/octet-stream }`.
 
 Fixture path resolves cwd-relative/absolute first, else `qa/fixtures/<path>` (drop sample files there, reference by name from `test-data`). An empty resolved file param omits the part → use for missing-file `@cases` error rows. `files:`/`bodyFile:` are mutually exclusive. **Automate the upload success case with `@api`** — don't defer it to `@manual`.

package/src/orchestrator/templates/ai-src/skills/sungen-error-mapping/SKILL.md

@@ -91,7 +91,7 @@ needs any of these, it is a **finding for QA** — surface it in the run summary
 | toHaveValue mismatch | Expected value differs from actual | Fix value in test-data |
 | toContainText mismatch | Partial text not found | Fix expected partial text in test-data |
 | toBeVisible timeout | Element exists but hidden, or name wrong | Check: is element conditionally visible? Wrong name? Inside dialog? |
-| toHaveCount mismatch | Row count differs | Fix expected count in test-data. Verify: is table loaded? Filtered? |
+| toHaveCount mismatch | Row count differs | Fix expected count in test-data. Verify: is table loaded? Filtered? If `Received: 0` while a dialog is open → aria-hidden trap, see **Table-Specific Errors** |
 
 ### Assertion type rule
 
@@ -111,6 +111,7 @@ If `toHaveText` fails on an input → the Gherkin step has the wrong target type
 | `tableRow is not defined` | Column assertion without preceding row scope step | The Gherkin is missing a row-scope step — this is a **QA authoring gap → report it, let it FAIL**. Do NOT add the step during run-test (the Gherkin is frozen). |
 | `toHaveText` on cell fails (with columns) | Wrong column index in `columns` config | Re-count columns in snapshot (0-indexed). Fix `index` in selectors.yaml |
 | `toBeVisible` on cell fails (no columns) | `filter({ hasText })` didn't match | Check exact cell text in snapshot. Fix value in test-data |
+| Row/cell count reads 0 while a dialog is open, rows visibly present behind it | **aria-hidden trap**: the modal (Radix/MUI/HeadlessUI…) sets `aria-hidden="true"` on the background; plain `getByRole('row'/'cell')` reads the a11y tree, which is empty behind a modal. Twin symptom: count-0 assertions (`table is empty`, `row not exists`) false-PASS under the same condition | Re-run `sungen generate` — table locators from sungen ≥3.2.8 emit `getByRole(…, { includeHidden: true }).filter({ visible: true })` and are immune. Do NOT edit the expected count or weaken the assertion — the rows exist; the old locator measured the wrong tree |
 | Row filter matches 0 rows | Filter text doesn't match any row content | Re-snapshot → find actual row text. Fix filter value in test-data |
 | Row filter matches multiple rows | Filter text is too generic (matches multiple rows) | Use more specific filter text (unique identifier like email, ID) |
 | Table not found | Wrong table name or table not rendered | Re-snapshot → copy exact table accessible name |
@@ -153,6 +154,16 @@ If `toHaveText` fails on an input → the Gherkin step has the wrong target type
 
 ---
 
+## API Request Errors (`@api` / catalog)
+
+| Error | Diagnosis | Fix |
+|---|---|---|
+| `400 "Unexpected field"` on a file upload | Endpoint accepts **multiple files under one field**, but the catalog declared a single file (one part sent) | In `apis.yaml`, make that `files:` field an **array** — one `:param` per file: `files: { gift_image: [":gift_image_1", ":gift_image_2"] }`. Add matching `test-data` paths. This is a real automatable case — do NOT defer to `@manual`. |
+| `415 Unsupported Media Type` on upload | Sent multipart where the endpoint wants a raw binary body (or vice-versa) | Use `bodyFile:` (raw binary body) instead of `files:` (multipart part), or the reverse — they are mutually exclusive. |
+| `fixture "…" not found` | The referenced file isn't on disk | Drop the sample file under `qa/fixtures/` and reference it by name from `test-data`. |
+
+---
+
 ## Performance & Infrastructure Errors → Fix in `specs/base.ts`
 
 All generated `.spec.ts` import from `specs/base.ts` — shared context caching, navigation, overlay cleanup. AI **can and should** tune `base.ts` to match the project.

package/src/orchestrator/templates/ai-src/skills/sungen-selector-fix/SKILL.md

@@ -282,9 +282,12 @@ Report results. Do NOT enter another fix loop here.
 | `toHaveText` / `toHaveValue` mismatch | Wrong expected data | `test-data.yaml` |
 | `page.goto` error | Wrong URL | page selector in `selectors.yaml` |
 | `frame` error | Element inside iframe | add `frame` field |
+| `role` selector resolves to 0 elements **while a dialog is open**, element visibly rendered behind it | aria-hidden trap — the modal sets `aria-hidden="true"` on the background; role locators read the a11y tree | see aria-hidden note below — NOT a name mismatch, don't churn the selector name |
 
 **Group by root cause** — if 5 tests fail because `[Submit]` button has a different name, that's 1 fix, not 5.
 
+> **aria-hidden trap** (element exists in the screenshot, locator says 0, a modal is open): compiled TABLE steps are immune from sungen ≥3.2.8 (`includeHidden` + `visible` filter) — if the failing generated code lacks that, re-run `sungen generate` first. For a **user-defined `role` selector** asserted while a dialog is open, the selector name is NOT the problem: prefer restructuring the scenario to assert after the dialog closes; if asserting behind the modal is genuinely intended, switch that selector to `testid` or an allowed `locator` CSS (both DOM-based, immune to aria-hidden). Never "fix" it by renaming the role.
+
 **Check `test-results/` first** — Playwright captures failure screenshots automatically. Use these to diagnose before any MCP exploration.
 
 ### Step 2: Targeted MCP Exploration

package/src/orchestrator/templates/specs-api.ts

@@ -80,6 +80,46 @@ export function resolveFixture(p: string, label: string): string {
   throw new Error(`API Driver: ${label} — fixture "${p}" not found (looked in ${direct} and qa/fixtures/${p}).`);
 }
 
+/**
+ * Build the multipart FormData body for a file-upload request. A field's value may be a single spec
+ * OR an array of specs — an array sends MULTIPLE files under the SAME field name, which a plain object
+ * cannot express (a repeated key would overwrite). FormData.append keeps every part, so the request
+ * carries all files. Text `body` values ride along as form fields. An empty resolved path omits that
+ * part (the missing-file / wrong-type error row). Exported for unit test (assert form.getAll entries).
+ *
+ * Blob (not File): the global File constructor only exists on Node ≥20 while this package supports
+ * Node ≥18; Blob is available on 18+. FormData wraps Blob + filename into a File part internally, so
+ * the wire result is identical.
+ */
+export function buildMultipart(
+  files: Record<string, FileSpec | FileSpec[]>,
+  body: unknown,
+  params: Record<string, any>,
+  label: string,
+): FormData {
+  const form = new FormData();
+  // Append file parts first. A field's value may be a single spec or an array (multiple files under
+  // one name); FormData.append keeps every part where a plain object would overwrite on a repeated key.
+  for (const [field, raw] of Object.entries(files)) {
+    for (const s of Array.isArray(raw) ? raw : [raw]) {
+      const spec = typeof s === 'string' ? { path: s } : s;
+      const fpath = substituteRaw(String(spec.path), params);
+      if (!fpath) continue; // empty param → omit the part (a missing-file / wrong-type error row)
+      const resolved = resolveFixture(fpath, label);
+      const filename = spec.filename ?? path.basename(resolved);
+      const blob = new Blob([fs.readFileSync(resolved)], { type: spec.mimeType ?? inferMime(filename) });
+      form.append(spec.name ?? field, blob, filename);
+    }
+  }
+  // Text body fields ride along — but skip any name already added as a file part, so a catalog that
+  // declares the same key in both body: and files: sends ONE part (the file wins), matching the prior
+  // plain-object behaviour rather than emitting a duplicate field a strict server would reject.
+  if (body && typeof body === 'object')
+    for (const [k, v] of Object.entries(body as Record<string, unknown>))
+      if (!form.has(k)) form.append(k, typeof v === 'string' ? v : JSON.stringify(v));
+  return form;
+}
+
 /**
  * Join a datasource base URL with a catalog path. Concatenate rather than rely on Playwright's
  * baseURL resolution: an absolute path (`/user/1`) resolves against the base ORIGIN and would drop
@@ -113,7 +153,7 @@ class ApiClient {
    */
   async call(
     label: string,
-    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; files?: Record<string, FileSpec>; bodyFile?: FileSpec; headers?: Record<string, string>; timeout?: number; datasource?: string },
+    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; files?: Record<string, FileSpec | FileSpec[]>; bodyFile?: FileSpec; headers?: Record<string, string>; timeout?: number; datasource?: string },
     params: Record<string, any> = {},
     opts: { storageState?: string } = {},
   ): Promise<{ status: number; ok: boolean; body: any; headers: Record<string, string> }> {
@@ -150,21 +190,10 @@ class ApiClient {
         headers['content-type'] = spec.mimeType ?? 'application/octet-stream';
       }
     } else if (req.files && Object.keys(req.files).length) {
-      const mp: Record<string, any> = {};
-      if (body && typeof body === 'object')
-        for (const [k, v] of Object.entries(body as Record<string, unknown>)) mp[k] = typeof v === 'string' ? v : JSON.stringify(v);
-      for (const [field, raw] of Object.entries(req.files)) {
-        const spec = typeof raw === 'string' ? { path: raw } : raw;
-        const fpath = substituteRaw(String(spec.path), params);
-        if (!fpath) continue; // empty param → omit the part (a missing-file / wrong-type error row)
-        const resolved = resolveFixture(fpath, label);
-        const filename = spec.filename ?? path.basename(resolved);
-        mp[spec.name ?? field] = { name: filename, mimeType: spec.mimeType ?? inferMime(filename), buffer: fs.readFileSync(resolved) };
-      }
       // Playwright generates the multipart/form-data Content-Type (with boundary); drop any datasource
       // default Content-Type so it doesn't conflict with / duplicate the generated one.
       deleteHeader(headers, 'content-type');
-      bodyOpt.multipart = mp;
+      bodyOpt.multipart = buildMultipart(req.files, body, params, label);
     } else if (body !== undefined) {
       const enc = req.encoding ?? 'json';
       if (enc === 'form') bodyOpt.form = body;
@@ -201,7 +230,7 @@ class ApiClient {
    */
   async callN(
     label: string,
-    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; files?: Record<string, FileSpec>; bodyFile?: FileSpec; headers?: Record<string, string>; timeout?: number; datasource?: string },
+    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; files?: Record<string, FileSpec | FileSpec[]>; bodyFile?: FileSpec; headers?: Record<string, string>; timeout?: number; datasource?: string },
     params: Record<string, any> = {},
     n = 1,
     opts: { storageState?: string } = {},

package/dist/cli/types.d.ts

@@ -1,9 +0,0 @@
-/**
- * CLI Types
- * Future adapter interface for programmatic command execution (e.g., VSCode extension)
- */
-export interface CommandAdapter {
-    name: string;
-    execute(command: string, options: Record<string, any>): Promise<void>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE"}

package/dist/cli/types.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * CLI Types
- * Future adapter interface for programmatic command execution (e.g., VSCode extension)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/generators/gherkin-parser/selector-extractor.d.ts

@@ -1,37 +0,0 @@
-/**
- * Gherkin Selector Extractor
- * Scans Gherkin feature files and extracts all [screen.element] references
- */
-export interface ExtractedSelector {
-    screenId: string;
-    elementId: string;
-    fullRef: string;
-    occurrences: number;
-}
-export interface SelectorsByScreen {
-    [screenId: string]: {
-        [elementId: string]: {
-            fullRef: string;
-            occurrences: number;
-        };
-    };
-}
-export declare class GherkinSelectorExtractor {
-    /**
-     * Extract all selector references from Gherkin feature files
-     */
-    extractSelectors(featuresDir: string): SelectorsByScreen;
-    /**
-     * Extract selectors from feature file content
-     */
-    private extractSelectorsFromContent;
-    /**
-     * Generate base skeleton YAML structure
-     */
-    generateSkeletonYaml(screenId: string, selectors: SelectorsByScreen): string;
-    /**
-     * Write skeleton files for all screens
-     */
-    writeSkeletonFiles(selectors: SelectorsByScreen, outputDir: string): void;
-}
-//# sourceMappingURL=selector-extractor.d.ts.map

package/dist/generators/gherkin-parser/selector-extractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"selector-extractor.d.ts","sourceRoot":"","sources":["../../../src/generators/gherkin-parser/selector-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,QAAQ,EAAE,MAAM,GAAG;QAClB,CAAC,SAAS,EAAE,MAAM,GAAG;YACnB,OAAO,EAAE,MAAM,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAED,qBAAa,wBAAwB;IACnC;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB;IAgCxD;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA0BnC;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,MAAM;IA+B5E;;OAEG;IACH,kBAAkB,CAChB,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,MAAM,GAChB,IAAI;CAWR"}

package/dist/generators/gherkin-parser/selector-extractor.js

@@ -1,108 +0,0 @@
-"use strict";
-/**
- * Gherkin Selector Extractor
- * Scans Gherkin feature files and extracts all [screen.element] references
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GherkinSelectorExtractor = void 0;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const glob_1 = require("glob");
-class GherkinSelectorExtractor {
-    /**
-     * Extract all selector references from Gherkin feature files
-     */
-    extractSelectors(featuresDir) {
-        const featureFiles = glob_1.glob.sync('**/*.feature', {
-            cwd: featuresDir,
-            absolute: true,
-        });
-        const selectorsByScreen = {};
-        for (const filePath of featureFiles) {
-            const content = fs_1.default.readFileSync(filePath, 'utf-8');
-            const selectors = this.extractSelectorsFromContent(content);
-            // Merge into selectorsByScreen
-            for (const selector of selectors) {
-                if (!selectorsByScreen[selector.screenId]) {
-                    selectorsByScreen[selector.screenId] = {};
-                }
-                if (!selectorsByScreen[selector.screenId][selector.elementId]) {
-                    selectorsByScreen[selector.screenId][selector.elementId] = {
-                        fullRef: selector.fullRef,
-                        occurrences: 0,
-                    };
-                }
-                selectorsByScreen[selector.screenId][selector.elementId].occurrences++;
-            }
-        }
-        return selectorsByScreen;
-    }
-    /**
-     * Extract selectors from feature file content
-     */
-    extractSelectorsFromContent(content) {
-        const selectors = [];
-        // Regex to match [screen.element] or [screen]
-        const selectorRegex = /\[([a-zA-Z0-9_-]+)(?:\.([a-zA-Z0-9_-]+))?\]/g;
-        let match;
-        while ((match = selectorRegex.exec(content)) !== null) {
-            const fullRef = match[0]; // e.g., "[auth-login.email]"
-            const screenId = match[1]; // e.g., "auth-login"
-            const elementId = match[2]; // e.g., "email" (undefined for route-only refs)
-            // Only include selectors with both screen and element (skip route-only refs)
-            if (elementId) {
-                selectors.push({
-                    screenId,
-                    elementId,
-                    fullRef,
-                    occurrences: 1,
-                });
-            }
-        }
-        return selectors;
-    }
-    /**
-     * Generate base skeleton YAML structure
-     */
-    generateSkeletonYaml(screenId, selectors) {
-        const screenSelectors = selectors[screenId];
-        if (!screenSelectors) {
-            return `# No selectors found for screen: ${screenId}\n`;
-        }
-        const lines = [
-            `# Selector skeleton for screen: ${screenId}`,
-            `# AI will fill in the selector values based on UI model`,
-            `# This file is generated by scanning Gherkin feature files`,
-            '',
-        ];
-        // Sort by element ID for consistency
-        const sortedElementIds = Object.keys(screenSelectors).sort();
-        for (const elementId of sortedElementIds) {
-            const { fullRef, occurrences } = screenSelectors[elementId];
-            lines.push(`"${fullRef}":`);
-            lines.push(`  selector: ""`);
-            lines.push(`  type: ""`);
-            lines.push(`  description: ""`);
-            lines.push(`  # Referenced ${occurrences} time(s) in Gherkin`);
-            lines.push('');
-        }
-        return lines.join('\n');
-    }
-    /**
-     * Write skeleton files for all screens
-     */
-    writeSkeletonFiles(selectors, outputDir) {
-        // Ensure output directory exists
-        fs_1.default.mkdirSync(outputDir, { recursive: true });
-        for (const screenId of Object.keys(selectors)) {
-            const skeletonContent = this.generateSkeletonYaml(screenId, selectors);
-            const outputPath = path_1.default.join(outputDir, `${screenId}.skeleton.yaml`);
-            fs_1.default.writeFileSync(outputPath, skeletonContent, 'utf-8');
-        }
-    }
-}
-exports.GherkinSelectorExtractor = GherkinSelectorExtractor;
-//# sourceMappingURL=selector-extractor.js.map

package/dist/generators/gherkin-parser/selector-extractor.js.map

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

package/dist/generators/test-generator/types.d.ts

@@ -1,25 +0,0 @@
-/**
- * Test Generator Types
- * Core type definitions for the test generation compiler
- */
-/**
- * Generated Test Result
- */
-export interface GeneratedTest {
-    featureName: string;
-    filePath: string;
-    code: string;
-    sourceFile?: string;
-    stepCount?: number;
-}
-/**
- * Generation Statistics
- */
-export interface GenerationStats {
-    totalScenarios: number;
-    totalSteps: number;
-    dictionaryMatched: number;
-    todoCount: number;
-    generationTime: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/generators/test-generator/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/generators/test-generator/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/generators/test-generator/types.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * Test Generator Types
- * Core type definitions for the test generation compiler
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/generators/test-generator/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/generators/test-generator/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/generators/types.d.ts

@@ -1,119 +0,0 @@
-/**
- * Core types for Selector DSL Framework
- * Framework-agnostic types for multi-platform support
- */
-export interface UIElement {
-    key: string;
-    tag: string;
-    role?: string;
-    name?: string;
-    id?: string;
-    placeholder?: string;
-    label?: string;
-    text?: string;
-    ariaLabel?: string;
-    testId?: string;
-    source: string;
-    framework?: string;
-    props?: Record<string, any>;
-}
-export interface UIModel {
-    screenId: string;
-    routeId: string;
-    framework: FrameworkType;
-    sourceFiles: string[];
-    elements: UIElement[];
-    metadata?: {
-        scannedAt: string;
-        version: string;
-        hash: string;
-    };
-}
-export type DiscoveryMethod = 'ai-static-analysis' | 'manual' | 'runtime';
-export type LocatorType = 'css' | 'xpath' | 'resource-id' | 'accessibility-id' | 'test-id' | 'key' | 'text' | 'role';
-export interface SelectorEntry {
-    selector: string;
-    type: string;
-    description: string;
-    discoveryMethod: DiscoveryMethod;
-    locatorType?: LocatorType;
-    confidence?: 'high' | 'medium' | 'low';
-    alternatives?: string[];
-    metadata?: {
-        lastValidated?: string;
-        validationStatus?: 'valid' | 'invalid' | 'unknown';
-    };
-}
-export interface SelectorDSL {
-    [elementId: string]: SelectorEntry;
-}
-export type FrameworkType = 'react' | 'react-nextjs' | 'vue' | 'angular' | 'html' | 'flutter' | 'jetpack-compose' | 'swiftui';
-export type TargetPlatform = 'web' | 'android' | 'ios' | 'desktop';
-export type ExecutorType = 'playwright' | 'puppeteer' | 'selenium' | 'appium-android' | 'appium-ios' | 'flutter-driver' | 'espresso' | 'xcuitest';
-export interface ExecutorConfig {
-    type: ExecutorType;
-    platform: TargetPlatform;
-    selectorPath: string;
-    overridePath?: string;
-}
-export interface CacheEntry {
-    screenId: string;
-    hash: string;
-    selectors: SelectorDSL;
-    metadata: {
-        createdAt: string;
-        aiModel?: string;
-        tokenCost?: number;
-        framework: FrameworkType;
-    };
-}
-export interface GeneratorConfig {
-    aiProvider: 'anthropic' | 'google' | 'openai';
-    aiModel?: string;
-    sourceRoot: string;
-    uiModelPath: string;
-    selectorPath: string;
-    cachePath: string;
-    framework: FrameworkType;
-    enableCache: boolean;
-    cacheExpiry?: number;
-    parallelScans?: number;
-    verbose?: boolean;
-}
-export interface DiscoverOptions {
-    screenId?: string;
-    all?: boolean;
-    force?: boolean;
-}
-export interface GenerateOptions {
-    screenId?: string;
-    all?: boolean;
-    force?: boolean;
-    skipCache?: boolean;
-    runtimeData?: boolean;
-}
-export interface ValidateOptions {
-    screenId?: string;
-    all?: boolean;
-    executor?: ExecutorType;
-}
-export interface GherkinElementReference {
-    elementId: string;
-    screenId: string;
-    elementName: string;
-}
-export declare function parseElementReference(ref: string): GherkinElementReference | null;
-export declare class SelectorNotFoundError extends Error {
-    elementId: string;
-    screenId: string;
-    constructor(elementId: string, screenId: string);
-}
-export declare class UIModelNotFoundError extends Error {
-    screenId: string;
-    constructor(screenId: string);
-}
-export declare class GeneratorError extends Error {
-    cause?: Error;
-    constructor(message: string, cause?: Error);
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/generators/types.d.ts.map

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