@sun-asterisk/sungen 1.0.24 → 2.0.1

package/src/orchestrator/templates/readme.md

@@ -0,0 +1,197 @@
+# Sungen Test Automation
+
+This project uses [Sungen v2](https://github.com/sun-asterisk/sungen) — a deterministic E2E test compiler.
+
+## How it works
+
+```
+AI (Copilot/Claude + MCP Playwright) → visits URL → generates files
+sungen generate → compiles Gherkin + selectors + data → Playwright .spec.ts
+```
+
+## Directory Structure
+
+```
+├── qa/screens/<name>/
+│   ├── features/         # .feature files (Gherkin)
+│   ├── selectors/        # Element locator YAML mappings
+│   └── test-data/        # Test data YAML values
+├── specs/
+│   ├── generated/        # Auto-generated Playwright tests
+│   └── .auth/            # Auth storage states
+├── docs/
+│   └── gherkin-dictionary.md  # Full grammar & compiler rules
+├── .github/
+│   └── copilot-instructions.md  # AI rules for GitHub Copilot
+└── CLAUDE.md                    # AI rules for Claude Code
+```
+
+## Workflow
+
+### 1. Add a screen
+
+```bash
+sungen add --screen login --path /login
+# Add more features to an existing screen:
+sungen add --screen login --feature forgot-password
+```
+
+### 2. Set up auth (if needed)
+
+```bash
+sungen makeauth admin
+# Opens browser → login manually → saves specs/.auth/admin.json
+```
+
+### 3. Generate Gherkin + selectors with AI
+
+Use your AI assistant (GitHub Copilot or Claude Code) to:
+1. Navigate to the page URL via MCP Playwright
+2. Take an accessibility snapshot
+3. Generate `.feature` + `selectors.yaml` + `test-data.yaml`
+
+The AI rules in `.github/copilot-instructions.md` and `CLAUDE.md` teach the AI
+how to write correct Gherkin syntax and selector YAML for sungen.
+
+### 4. Compile to Playwright tests
+
+```bash
+sungen generate --screen login
+# or for all screens:
+sungen generate --all
+```
+
+### 5. Run tests
+
+```bash
+npx playwright test
+npx playwright test --ui   # interactive mode
+```
+
+### 6. Fix failures (AI Verify loop)
+
+When tests fail, use AI to read the error → fix `selectors.yaml` → recompile → re-run.
+
+| Error | Fix in selectors.yaml |
+|---|---|
+| strict mode: resolved to N elements | Add `exact: true` or `scope` or `nth` |
+| element(s) not found | Fix `name`, `type`, or `value` |
+| getByText matched too many | Add `match: 'exact'` or `nth` |
+
+---
+
+## Gherkin Guide
+
+### Syntax
+
+```
+User <action> [<Target>] <type> with {{<Value>}}
+```
+
+- `[Target]` → selector reference → lookup in `selectors/*.yaml`
+- `{{Value}}` → test data reference → lookup in `test-data/*.yaml`
+- `<type>` → element type: button, link, field, heading, text, etc.
+
+### Pattern Shapes (17 total)
+
+#### Actions
+
+| Pattern | Example |
+|---|---|
+| Simple click | `User click [Submit] button` |
+| Click with data | `User click [Teammate] button with {{name}}` |
+| Fill field | `User fill [Email] field with {{email}}` |
+| Check/Uncheck | `User check [Remember me] checkbox` |
+| Select dropdown | `User select [Country] dropdown with {{country}}` |
+| Upload file | `User upload [Avatar] file with {{path}}` |
+| Double click | `User double click [Cell] element` |
+| Hover | `User hover [Info] icon` |
+| Clear | `User clear [Search] field` |
+
+#### Keyboard
+
+| Pattern | Example |
+|---|---|
+| Global key | `User press Escape key` |
+| Key on element | `User press Enter on [Search] field` |
+
+#### Navigation
+
+| Pattern | Example |
+|---|---|
+| Open page | `User is on [login] page` |
+| See page (URL) | `User see [dashboard] page` |
+
+#### Wait
+
+| Pattern | Example |
+|---|---|
+| Wait timeout | `User wait for 3 seconds` |
+| Wait element | `User wait for [Modal] dialog` |
+| Wait hidden | `User wait for [Loading] spinner is hidden` |
+| Wait with data | `User wait for [Dialog] dialog with {{title}}` |
+
+#### Assertions
+
+| Pattern | Example |
+|---|---|
+| See element | `User see [Welcome] heading` |
+| See with value | `User see [Title] heading with {{title}}` |
+| State check | `User see [Submit] button is disabled` |
+| State + data | `User see [Panel] dialog with {{title}} is hidden` |
+| Text contains | `User see [Message] text contains {{partial}}` |
+
+States: `hidden`, `visible`, `disabled`, `enabled`, `checked`, `unchecked`, `focused`, `empty`
+
+#### Table
+
+| Pattern | Example |
+|---|---|
+| Row exists | `User see [Users] table has row with {{name}}` |
+| No row | `User see [Users] table has no row with {{name}}` |
+| Row count | `User see [Users] table has {{count}} rows` |
+| Column exists | `User see [Users] table has [Email] column` |
+| Cell by filter | `User see [Users] table row with {{name}} has [Status] with {{status}}` |
+| Cell by index | `User see [Users] table row 1 [Name] cell with {{name}}` |
+| Action in row | `User click [Edit] in [Users] table row with {{name}}` |
+| Empty table | `User see [Users] table is empty` |
+
+#### Scope
+
+| Pattern | Example |
+|---|---|
+| Scroll | `User scroll to [Footer] section` |
+| Frame enter | `User switch to [Payment] frame` |
+| Frame exit | `User switch to [main] frame` |
+
+### Tags
+
+| Tag | Purpose |
+|---|---|
+| `@auth:role` | Use Playwright storage state for auth |
+| `@steps:name` | Define reusable step group |
+| `@extend:name` | Inherit steps from another scenario |
+| `@manual` | Skip scenario in generation |
+
+### Selector YAML
+
+```yaml
+submit.button:
+  type: 'role'              # testid, role, text, label, placeholder, locator, page
+  value: 'button'           # role name, testid value, CSS selector, etc.
+  name: 'Submit'            # accessible name
+  nth: 0                    # element index (0=first, 1=.nth(0), 2=.nth(1))
+  exact: true               # exact name match (avoid "Submit" matching "Submit Form")
+  scope: 'desktop navigation'  # scope to parent landmark
+  match: 'exact'            # exact text match for getByText
+```
+
+Locator priority: `data-testid` > `role+name` > `label` > `text` > `CSS`
+
+---
+
+## Documentation
+
+- [Gherkin Dictionary](docs/gherkin-dictionary.md) — full grammar, all 17 patterns, compiler rules
+- [Sungen GitHub](https://github.com/sun-asterisk/sungen)
+- [Playwright Documentation](https://playwright.dev)

package/src/utils/selector-types.ts

@@ -12,6 +12,9 @@ export const VALID_SELECTOR_TYPES = [
   'column',
   'locator',
   'id',
+  'upload',
+  'frame',
+  'table',
 ] as const;
 
 export type SelectorType = (typeof VALID_SELECTOR_TYPES)[number];

package/dist/cli/commands/cache-clear.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function registerCacheClearCommand(program: Command): void;
-//# sourceMappingURL=cache-clear.d.ts.map

package/dist/cli/commands/cache-clear.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache-clear.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/cache-clear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBhE"}

package/dist/cli/commands/cache-clear.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerCacheClearCommand = registerCacheClearCommand;
-const config_loader_1 = require("../../config/config-loader");
-const cache_manager_1 = require("../../orchestrator/cache-manager");
-function registerCacheClearCommand(program) {
-    program
-        .command('cache-clear')
-        .description('Clear all caches')
-        .action(async () => {
-        try {
-            const config = new config_loader_1.ConfigLoader().load({});
-            const cacheManager = new cache_manager_1.CacheManager(config);
-            console.log('🗑️  Clearing cache...');
-            await cacheManager.clear();
-            console.log('✅ Cache cleared successfully');
-        }
-        catch (error) {
-            console.error('❌ Cache clear failed:', error);
-            process.exit(1);
-        }
-    });
-}
-//# sourceMappingURL=cache-clear.js.map

package/dist/cli/commands/cache-clear.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache-clear.js","sourceRoot":"","sources":["../../../src/cli/commands/cache-clear.ts"],"names":[],"mappings":";;AAIA,8DAiBC;AApBD,8DAA0D;AAC1D,oEAAgE;AAEhE,SAAgB,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,kBAAkB,CAAC;SAC/B,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,4BAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3C,MAAM,YAAY,GAAG,IAAI,4BAAY,CAAC,MAAM,CAAC,CAAC;YAE9C,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACtC,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/full.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function registerFullCommand(program: Command): void;
-//# sourceMappingURL=full.d.ts.map

package/dist/cli/commands/full.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"full.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/full.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8B1D"}

package/dist/cli/commands/full.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerFullCommand = registerFullCommand;
-const config_loader_1 = require("../../config/config-loader");
-const pipeline_1 = require("../../orchestrator/pipeline");
-function registerFullCommand(program) {
-    program
-        .command('full')
-        .description('Run full pipeline (live-scan + map + generate)')
-        .option('-s, --screen <name>', 'Process specific screen (optional)')
-        .option('-f, --force', 'Force rescan and overwrite')
-        .option('--headed', 'Launch browser in headed mode during live-scan', false)
-        .option('--auth-dir <path>', 'Auth storage state directory for live-scan', 'specs/.auth')
-        .option('--skip-live-scan', 'Skip live-scan phase')
-        .action(async (options) => {
-        try {
-            const cliOptions = {
-                ...program.opts(),
-                ...options,
-            };
-            const config = new config_loader_1.ConfigLoader().load(cliOptions);
-            const pipeline = new pipeline_1.Pipeline(config);
-            const screens = options.screen ? [options.screen] : undefined;
-            await pipeline.runFull(screens, {
-                headed: options.headed,
-                authDir: options.authDir,
-                skipLiveScan: options.skipLiveScan,
-                force: options.force,
-            });
-        }
-        catch (error) {
-            console.error('❌ Full pipeline failed:', error);
-            process.exit(1);
-        }
-    });
-}
-//# sourceMappingURL=full.js.map

package/dist/cli/commands/full.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"full.js","sourceRoot":"","sources":["../../../src/cli/commands/full.ts"],"names":[],"mappings":";;AAIA,kDA8BC;AAjCD,8DAA0D;AAC1D,0DAAuD;AAEvD,SAAgB,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;SACnE,MAAM,CAAC,aAAa,EAAE,4BAA4B,CAAC;SACnD,MAAM,CAAC,UAAU,EAAE,gDAAgD,EAAE,KAAK,CAAC;SAC3E,MAAM,CAAC,mBAAmB,EAAE,4CAA4C,EAAE,aAAa,CAAC;SACxF,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;SAClD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG;gBACjB,GAAG,OAAO,CAAC,IAAI,EAAE;gBACjB,GAAG,OAAO;aACX,CAAC;YACF,MAAM,MAAM,GAAG,IAAI,4BAAY,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC,MAAM,CAAC,CAAC;YAEtC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9D,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/live-scan.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function registerLiveScanCommand(program: Command): void;
-//# sourceMappingURL=live-scan.d.ts.map

package/dist/cli/commands/live-scan.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"live-scan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/live-scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+E9D"}

package/dist/cli/commands/live-scan.js

@@ -1,78 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerLiveScanCommand = registerLiveScanCommand;
-function registerLiveScanCommand(program) {
-    program
-        .command('live-scan')
-        .description('Scan a live site to discover real selectors for Gherkin element references')
-        .requiredOption('-s, --screen <name>', 'Screen name to scan')
-        .option('--url <baseUrl>', 'Override base URL (default: read from playwright.config.ts)')
-        .option('--headed', 'Launch browser in headed (visible) mode', false)
-        .option('--auth-dir <path>', 'Directory containing auth storage state files', 'specs/.auth')
-        .option('-f, --force', 'Force rescan all elements, ignoring existing results', false)
-        .action(async (options) => {
-        try {
-            const { LiveScanner } = require('../../core/live-scanner');
-            console.log('\n🔍 Sungen Live Scanner\n');
-            console.log(`📍 Screen: ${options.screen}`);
-            console.log(`🖥️  Mode: ${options.headed ? 'headed' : 'headless'}`);
-            if (options.force) {
-                console.log(`🔄 Force mode: rescanning all elements`);
-            }
-            const scanner = new LiveScanner({
-                baseUrl: options.url,
-                screenName: options.screen,
-                screensDir: 'qa/screens',
-                headed: options.headed,
-                authDir: options.authDir,
-                force: options.force,
-            });
-            const results = await scanner.scan();
-            // Print final summary
-            console.log('\n📊 SCAN SUMMARY\n');
-            let totalElements = 0;
-            let totalResolved = 0;
-            let totalWarnings = 0;
-            let totalUnresolved = 0;
-            let totalSkipped = 0;
-            for (const result of results) {
-                for (const scenario of Object.values(result.scenarios)) {
-                    for (const element of Object.values(scenario.elements)) {
-                        totalElements++;
-                        if (element.skipped) {
-                            totalSkipped++;
-                            totalResolved++;
-                        }
-                        else if (element.matchMethod === 'unresolved') {
-                            totalUnresolved++;
-                        }
-                        else {
-                            totalResolved++;
-                            if (element.warning)
-                                totalWarnings++;
-                        }
-                    }
-                }
-            }
-            console.log(`Total Elements:  ${totalElements}`);
-            console.log(`Resolved:        ${totalResolved}`);
-            if (totalSkipped > 0) {
-                console.log(`Skipped (cached): ${totalSkipped}`);
-            }
-            console.log(`Warnings:        ${totalWarnings}`);
-            console.log(`Unresolved:      ${totalUnresolved}`);
-            if (totalUnresolved > 0) {
-                console.log(`\n⚠️  ${totalUnresolved} element(s) could not be found on the live site`);
-            }
-            if (totalResolved > 0) {
-                console.log(`\n✅ Live scan complete. Run 'sungen map --screen ${options.screen}' to generate selectors.`);
-            }
-            console.log('');
-        }
-        catch (error) {
-            console.error('\n❌ Live scan failed:', error.message);
-            process.exit(1);
-        }
-    });
-}
-//# sourceMappingURL=live-scan.js.map

package/dist/cli/commands/live-scan.js.map

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

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

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function registerMapCommand(program: Command): void;
-//# sourceMappingURL=map.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6FzD"}

package/dist/cli/commands/map.js

@@ -1,93 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerMapCommand = registerMapCommand;
-const config_loader_1 = require("../../config/config-loader");
-function registerMapCommand(program) {
-    program
-        .command('map')
-        .description('Generate selector and test-data YAML from Gherkin feature files')
-        .option('-s, --screen <name>', 'Screen name (reads from qa/screens/<name>/features/)')
-        .option('--file <path>', 'Single feature file path (generates selectors next to features folder)')
-        .option('-o, --output <dir>', 'Output directory for generated files')
-        .option('-f, --force', 'Force overwrite existing YAML files and rescan all elements')
-        .option('--skip-live-scan', 'Skip live-scan before mapping (live-scan runs by default)')
-        .option('--headed', 'Launch browser in headed mode during live-scan', false)
-        .option('--auth-dir <path>', 'Auth storage state directory for live-scan', 'specs/.auth')
-        .option('-v, --verbose', 'Detailed output')
-        .action(async (options) => {
-        try {
-            const path = require('path');
-            const cliOptions = {
-                ...program.opts(),
-                ...options,
-            };
-            const config = new config_loader_1.ConfigLoader().load(cliOptions);
-            const { ScaffoldGenerator } = require('../../generators/scaffold-generator');
-            const generator = new ScaffoldGenerator();
-            if (options.screen) {
-                const screensDir = options.output || 'qa/screens';
-                const forceOverwrite = cliOptions.force || false;
-                // Run live-scan by default before mapping (skip with --skip-live-scan)
-                if (!options.skipLiveScan) {
-                    const { LiveScanner } = require('../../core/live-scanner');
-                    console.log('🔍 Running live-scan before mapping...\n');
-                    const scanner = new LiveScanner({
-                        screenName: options.screen,
-                        screensDir,
-                        headed: options.headed,
-                        authDir: options.authDir,
-                    });
-                    await scanner.scan();
-                    console.log('');
-                }
-                if (forceOverwrite) {
-                    console.log(`Mapping screen: ${options.screen} (force: selectors will be overwritten)\n`);
-                }
-                else {
-                    console.log(`Mapping screen: ${options.screen}\n`);
-                }
-                const results = generator.processScreen(options.screen, screensDir, forceOverwrite);
-                for (const result of results) {
-                    console.log(`✓ Mapped ${result.featureFile}.feature`);
-                    if (result.selectorsSkipped) {
-                        console.log(`   ⊘ ${path.basename(result.selectorsPath)} (skipped - already exists)`);
-                    }
-                    else {
-                        console.log(`   → ${path.basename(result.selectorsPath)} (${result.elementCount} elements)`);
-                    }
-                    if (result.testDataMerged) {
-                        console.log(`   ↻ ${path.basename(result.testDataPath)} (smart-merged — ${result.dataRefCount} variables)\n`);
-                    }
-                    else {
-                        console.log(`   → ${path.basename(result.testDataPath)} (${result.dataRefCount} variables)\n`);
-                    }
-                }
-                console.log(`Next step: sungen generate --screen ${options.screen}`);
-                console.log('     This will create the test specs based on the mapped selectors and test data.');
-            }
-            else if (options.file) {
-                const deriveOutputDir = (featureFilePath) => {
-                    const featureDir = path.dirname(featureFilePath);
-                    if (featureDir.includes('features')) {
-                        return featureDir.replace(/features\/?$/, 'selectors/screens');
-                    }
-                    return path.join(featureDir, '..', 'selectors', 'screens');
-                };
-                const outputDir = options.output || deriveOutputDir(options.file);
-                const forceOverwrite = cliOptions.force || false;
-                console.log(`Mapping from file: ${options.file}\n`);
-                const result = generator.processFeatureFile(options.file, outputDir, forceOverwrite);
-                console.log(`✓ Generated: ${result.outputPath} (${result.elementCount} elements)`);
-            }
-            else {
-                console.error('❌ Error: Please specify --screen <name> or --file <path>');
-                process.exit(1);
-            }
-        }
-        catch (error) {
-            console.error('❌ Mapping failed:', error);
-            process.exit(1);
-        }
-    });
-}
-//# sourceMappingURL=map.js.map

package/dist/cli/commands/map.js.map

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

package/dist/cli/commands/validate.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function registerValidateCommand(program: Command): void;
-//# sourceMappingURL=validate.d.ts.map

package/dist/cli/commands/validate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsC9D"}

package/dist/cli/commands/validate.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerValidateCommand = registerValidateCommand;
-const utils_1 = require("../utils");
-function registerValidateCommand(program) {
-    program
-        .command('validate')
-        .description('Validate Gherkin features and selector/test-data mappings')
-        .option('-s, --screen <name>', 'Validate specific screen (optional, defaults to all)')
-        .option('--json', 'Output results as JSON')
-        .option('-v, --verbose', 'Show all checks, not just failures')
-        .action(async (options) => {
-        try {
-            const { ScreenValidator } = require('../../core/validator');
-            const validator = new ScreenValidator({
-                verbose: options.verbose,
-            });
-            let result;
-            if (options.screen) {
-                console.log(`Validating screen: ${options.screen}\n`);
-                result = validator.validateScreen(options.screen);
-            }
-            else {
-                console.log('Validating all screens...\n');
-                result = validator.validateAll();
-            }
-            if (options.json) {
-                console.log(JSON.stringify(result, null, 2));
-            }
-            else {
-                (0, utils_1.printValidationResult)(result, options.verbose);
-            }
-            if (!result.valid) {
-                process.exit(1);
-            }
-        }
-        catch (error) {
-            console.error('❌ Validation failed:', error);
-            process.exit(1);
-        }
-    });
-}
-//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":";;AAIA,0DAsCC;AAxCD,oCAAiD;AAEjD,SAAgB,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,qBAAqB,EAAE,sDAAsD,CAAC;SACrF,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;SAC1C,MAAM,CAAC,eAAe,EAAE,oCAAoC,CAAC;SAC7D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;YAE5D,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC;gBACpC,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,CAAC,CAAC;YAEH,IAAI,MAAwB,CAAC;YAC7B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;gBACtD,MAAM,GAAG,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;gBAC3C,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;YACnC,CAAC;YAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,IAAA,6BAAqB,EAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/utils.d.ts

@@ -1,6 +0,0 @@
-import { ValidationResult } from '../core/validator';
-/**
- * Print validation result to console
- */
-export declare function printValidationResult(result: ValidationResult, verbose?: boolean): void;
-//# sourceMappingURL=utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAqBrD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAE,OAAe,GAAG,IAAI,CAiF9F"}