@sun-asterisk/sungen 1.0.0

package/dist/tools/auto-tagger.js

@@ -0,0 +1,502 @@
+"use strict";
+/**
+ * Auto-Tagging Tool - v3.1
+ *
+ * Automatically injects stable data-testid attributes into React/Vue/HTML source code
+ *
+ * Key Features:
+ * 1. Idempotent (skips if data-testid already exists)
+ * 2. Preserves code formatting (Prettier/ESLint compatible)
+ * 3. Generates stable, semantic IDs (screen-element-type)
+ * 4. Supports React, Vue, HTML
+ * 5. Dry-run mode for preview
+ *
+ * Philosophy: Proactive solution - add test IDs BEFORE you need them
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoTagger = void 0;
+const parser = __importStar(require("@babel/parser"));
+const traverse_1 = __importDefault(require("@babel/traverse"));
+const generator_1 = __importDefault(require("@babel/generator"));
+const t = __importStar(require("@babel/types"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ============================================================================
+// TEST ID GENERATOR
+// ============================================================================
+class TestIDGenerator {
+    constructor(screenName) {
+        this.usedIds = new Set();
+        this.screenName = this.normalize(screenName);
+    }
+    /**
+     * Generate stable, semantic test ID
+     *
+     * Format: {screen}-{element}-{type}
+     * Examples:
+     * - login-email-input
+     * - login-password-input
+     * - login-submit-btn
+     * - dashboard-user-menu-btn
+     */
+    generate(element, index) {
+        const tag = element.tag?.toLowerCase() || 'element';
+        const props = element.props || {};
+        let elementName = '';
+        // Strategy 1: Use existing name/id/placeholder
+        if (props.name) {
+            elementName = this.normalize(props.name);
+        }
+        else if (props.id) {
+            elementName = this.normalize(props.id);
+        }
+        else if (props.placeholder) {
+            elementName = this.normalize(props.placeholder);
+        }
+        else if (element.text && ['button', 'a'].includes(tag)) {
+            elementName = this.normalize(element.text);
+        }
+        else if (props['aria-label']) {
+            elementName = this.normalize(props['aria-label']);
+        }
+        // Strategy 2: Use type-based naming
+        if (!elementName && props.type) {
+            elementName = this.normalize(props.type);
+        }
+        // Strategy 3: Fallback to index
+        if (!elementName) {
+            elementName = `${tag}-${index}`;
+        }
+        // Add suffix based on tag
+        const suffix = this.getSuffix(tag, props.type);
+        // Combine: screen-element-suffix
+        const baseId = `${this.screenName}-${elementName}${suffix}`;
+        // Ensure uniqueness
+        let finalId = baseId;
+        let counter = 1;
+        while (this.usedIds.has(finalId)) {
+            finalId = `${baseId}-${counter}`;
+            counter++;
+        }
+        this.usedIds.add(finalId);
+        return finalId;
+    }
+    getSuffix(tag, type) {
+        if (tag === 'input') {
+            if (type === 'submit')
+                return '-btn';
+            return '-input';
+        }
+        const suffixMap = {
+            'button': '-btn',
+            'a': '-link',
+            'select': '-select',
+            'textarea': '-textarea',
+            'form': '-form',
+        };
+        return suffixMap[tag] || '';
+    }
+    normalize(str) {
+        return str
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '');
+    }
+    reset() {
+        this.usedIds.clear();
+    }
+}
+// ============================================================================
+// AST ELEMENT EXTRACTOR
+// ============================================================================
+class ElementExtractor {
+    /**
+     * Extract element data from JSX node
+     */
+    extract(node) {
+        const openingElement = node.openingElement;
+        const tag = this.getTagName(openingElement.name);
+        // Extract props
+        const props = {};
+        for (const attr of openingElement.attributes) {
+            if (t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name)) {
+                const name = attr.name.name;
+                const value = this.getAttributeValue(attr.value);
+                props[name] = value;
+            }
+        }
+        // Extract text content
+        const text = this.extractTextContent(node);
+        return { tag, props, text, node, openingElement };
+    }
+    getTagName(name) {
+        if (t.isJSXIdentifier(name)) {
+            return name.name.toLowerCase();
+        }
+        if (t.isJSXMemberExpression(name)) {
+            // Handle <Form.Input> → "input"
+            return this.getTagName(name.property);
+        }
+        return 'unknown';
+    }
+    getAttributeValue(value) {
+        if (!value)
+            return true; // Boolean attribute
+        if (t.isStringLiteral(value))
+            return value.value;
+        if (t.isJSXExpressionContainer(value)) {
+            if (t.isStringLiteral(value.expression)) {
+                return value.expression.value;
+            }
+            if (t.isBooleanLiteral(value.expression)) {
+                return value.expression.value;
+            }
+        }
+        return undefined;
+    }
+    extractTextContent(node) {
+        const children = node.children || [];
+        for (const child of children) {
+            if (t.isJSXText(child)) {
+                const text = child.value.trim();
+                if (text)
+                    return text;
+            }
+            if (t.isJSXExpressionContainer(child)) {
+                if (t.isStringLiteral(child.expression)) {
+                    return child.expression.value;
+                }
+            }
+        }
+        return null;
+    }
+}
+// ============================================================================
+// AUTO TAGGER (Main Class)
+// ============================================================================
+class AutoTagger {
+    constructor(config) {
+        this.extractor = new ElementExtractor();
+        this.stats = {
+            totalFiles: 0,
+            modifiedFiles: 0,
+            totalElements: 0,
+            taggedElements: 0,
+            skippedElements: 0,
+            processingTime: 0,
+        };
+        // Interactive elements that should have data-testid
+        this.INTERACTIVE_TAGS = ['input', 'button', 'a', 'select', 'textarea', 'form'];
+        this.config = config;
+    }
+    /**
+     * Tag a specific screen or all screens
+     */
+    async tag() {
+        const startTime = Date.now();
+        if (this.config.screenName) {
+            await this.tagScreen(this.config.screenName);
+        }
+        else {
+            await this.tagAllScreens();
+        }
+        this.stats.processingTime = Date.now() - startTime;
+        return this.stats;
+    }
+    /**
+     * Tag a specific screen
+     */
+    async tagScreen(screenName) {
+        const files = this.findSourceFiles(screenName);
+        if (files.length === 0) {
+            console.log(`⚠️  No source files found for screen: ${screenName}`);
+            return;
+        }
+        console.log(`📂 Found ${files.length} files for screen: ${screenName}\n`);
+        for (const file of files) {
+            await this.tagFile(file, screenName);
+        }
+    }
+    /**
+     * Tag all screens (scan entire source root)
+     */
+    async tagAllScreens() {
+        console.log('📂 Scanning all source files...\n');
+        const allFiles = this.findAllSourceFiles(this.config.sourceRoot);
+        console.log(`Found ${allFiles.length} files\n`);
+        for (const file of allFiles) {
+            const screenName = this.inferScreenName(file);
+            await this.tagFile(file, screenName);
+        }
+    }
+    /**
+     * Tag a single file
+     */
+    async tagFile(filePath, screenName) {
+        this.stats.totalFiles++;
+        const relativePath = path.relative(this.config.projectRoot, filePath);
+        console.log(`📄 Processing: ${relativePath}`);
+        // Read file
+        const code = fs.readFileSync(filePath, 'utf-8');
+        // Parse with Babel
+        let ast;
+        try {
+            ast = parser.parse(code, {
+                sourceType: 'module',
+                plugins: ['jsx', 'typescript'],
+            });
+        }
+        catch (error) {
+            console.log(`   ⚠️  Parse error, skipping\n`);
+            return this.createEmptyResult(filePath);
+        }
+        // Tag elements in AST
+        const result = await this.tagAST(ast, filePath, screenName);
+        // Write back if modified and not dry-run
+        if (result.modified && !this.config.dryRun) {
+            const newCode = (0, generator_1.default)(ast, {
+                retainLines: true,
+                comments: true,
+            }).code;
+            fs.writeFileSync(filePath, newCode, 'utf-8');
+            this.stats.modifiedFiles++;
+            console.log(`   ✓ Modified (${result.taggedElements} elements tagged)\n`);
+        }
+        else if (result.modified && this.config.dryRun) {
+            console.log(`   🔍 Would modify (${result.taggedElements} elements)\n`);
+        }
+        else {
+            console.log(`   ○ No changes needed\n`);
+        }
+        return result;
+    }
+    /**
+     * Tag elements in AST
+     */
+    async tagAST(ast, filePath, screenName) {
+        const idGenerator = new TestIDGenerator(screenName);
+        const changes = [];
+        let totalElements = 0;
+        let taggedElements = 0;
+        let skippedElements = 0;
+        let modified = false;
+        let elementIndex = 0;
+        (0, traverse_1.default)(ast, {
+            JSXElement: (path) => {
+                const node = path.node;
+                const element = this.extractor.extract(node);
+                // Only process interactive elements
+                if (!this.shouldTag(element)) {
+                    return;
+                }
+                totalElements++;
+                elementIndex++;
+                // Check if already has data-testid
+                const existingTestId = this.findAttribute(element.openingElement, 'data-testid');
+                if (existingTestId && !this.config.force) {
+                    skippedElements++;
+                    changes.push({
+                        line: node.loc?.start.line || 0,
+                        tag: element.tag,
+                        generatedId: existingTestId,
+                        action: 'skipped',
+                        reason: 'Already has data-testid',
+                    });
+                    return;
+                }
+                // Generate test ID
+                const testId = idGenerator.generate(element, elementIndex);
+                // Add or replace data-testid attribute
+                if (existingTestId && this.config.force) {
+                    // Overwrite
+                    this.setAttribute(element.openingElement, 'data-testid', testId);
+                    taggedElements++;
+                    modified = true;
+                    changes.push({
+                        line: node.loc?.start.line || 0,
+                        tag: element.tag,
+                        generatedId: testId,
+                        action: 'overwritten',
+                        reason: `Replaced ${existingTestId}`,
+                    });
+                }
+                else {
+                    // Add new
+                    this.addAttribute(element.openingElement, 'data-testid', testId);
+                    taggedElements++;
+                    modified = true;
+                    changes.push({
+                        line: node.loc?.start.line || 0,
+                        tag: element.tag,
+                        generatedId: testId,
+                        action: 'added',
+                    });
+                }
+            },
+        });
+        this.stats.totalElements += totalElements;
+        this.stats.taggedElements += taggedElements;
+        this.stats.skippedElements += skippedElements;
+        return {
+            filePath,
+            totalElements,
+            taggedElements,
+            skippedElements,
+            changes,
+            modified,
+        };
+    }
+    /**
+     * Determine if element should be tagged
+     */
+    shouldTag(element) {
+        const tag = element.tag?.toLowerCase();
+        return this.INTERACTIVE_TAGS.includes(tag);
+    }
+    /**
+     * Find existing attribute value
+     */
+    findAttribute(openingElement, name) {
+        for (const attr of openingElement.attributes) {
+            if (t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === name) {
+                if (t.isStringLiteral(attr.value)) {
+                    return attr.value.value;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Set attribute value (replace if exists)
+     */
+    setAttribute(openingElement, name, value) {
+        for (const attr of openingElement.attributes) {
+            if (t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === name) {
+                attr.value = t.stringLiteral(value);
+                return;
+            }
+        }
+    }
+    /**
+     * Add new attribute
+     */
+    addAttribute(openingElement, name, value) {
+        const newAttr = t.jsxAttribute(t.jsxIdentifier(name), t.stringLiteral(value));
+        openingElement.attributes.push(newAttr);
+    }
+    /**
+     * Find source files for a screen
+     */
+    findSourceFiles(screenName) {
+        const patterns = [
+            path.join(this.config.sourceRoot, `${screenName}/page.tsx`),
+            path.join(this.config.sourceRoot, `${screenName}/index.tsx`),
+            path.join(this.config.sourceRoot, `${screenName}.tsx`),
+            path.join(this.config.sourceRoot, `${screenName}/page.js`),
+            path.join(this.config.sourceRoot, `${screenName}/index.js`),
+            path.join(this.config.sourceRoot, `${screenName}.js`),
+        ];
+        const found = [];
+        for (const pattern of patterns) {
+            if (fs.existsSync(pattern)) {
+                found.push(pattern);
+            }
+        }
+        return found;
+    }
+    /**
+     * Find all source files recursively
+     */
+    findAllSourceFiles(dir) {
+        const files = [];
+        const scan = (currentDir) => {
+            const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(currentDir, entry.name);
+                // Skip node_modules, .git, etc.
+                if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+                    continue;
+                }
+                if (entry.isDirectory()) {
+                    scan(fullPath);
+                }
+                else if (entry.isFile()) {
+                    // Only process .tsx, .jsx, .ts, .js files
+                    if (/\.(tsx|jsx|ts|js)$/.test(entry.name)) {
+                        files.push(fullPath);
+                    }
+                }
+            }
+        };
+        scan(dir);
+        return files;
+    }
+    /**
+     * Infer screen name from file path
+     */
+    inferScreenName(filePath) {
+        const relativePath = path.relative(this.config.sourceRoot, filePath);
+        const parts = relativePath.split(path.sep);
+        // Use first directory as screen name
+        if (parts.length > 1) {
+            return parts[0];
+        }
+        // Use filename without extension
+        const fileName = path.basename(filePath, path.extname(filePath));
+        return fileName === 'page' || fileName === 'index' ? 'app' : fileName;
+    }
+    createEmptyResult(filePath) {
+        return {
+            filePath,
+            totalElements: 0,
+            taggedElements: 0,
+            skippedElements: 0,
+            changes: [],
+            modified: false,
+        };
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+}
+exports.AutoTagger = AutoTagger;
+//# sourceMappingURL=auto-tagger.js.map

package/dist/tools/auto-tagger.js.map

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

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@sun-asterisk/sungen",
+  "version": "1.0.0",
+  "description": "AI-Native E2E Test Generator - Generate Playwright tests from Gherkin features using AI",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "sungen": "./bin/sungen.js"
+  },
+  "scripts": {
+    "build": "tsc && npm run copy-templates",
+    "copy-templates": "mkdir -p dist/generators/test-generator/adapters/playwright/templates/steps && cp -r src/generators/test-generator/adapters/playwright/templates/*.hbs dist/generators/test-generator/adapters/playwright/templates/ 2>/dev/null || true && cp -r src/generators/test-generator/adapters/playwright/templates/steps dist/generators/test-generator/adapters/playwright/templates/",
+    "dev": "tsx src/cli/index.ts",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "e2e",
+    "testing",
+    "playwright",
+    "gherkin",
+    "bdd",
+    "ai",
+    "test-generation",
+    "automation",
+    "qa"
+  ],
+  "author": "Bach Ngoc Hoai",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.71.0",
+    "@babel/parser": "^7.28.5",
+    "@babel/traverse": "^7.28.5",
+    "@babel/types": "^7.28.5",
+    "@cucumber/gherkin": "^37.0.0",
+    "@cucumber/messages": "^31.0.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "dotenv": "^17.2.3",
+    "fast-glob": "^3.3.3",
+    "glob": "^13.0.0",
+    "handlebars": "^4.7.8",
+    "ora": "^9.0.0",
+    "plop": "^4.0.4",
+    "tsx": "^4.21.0",
+    "yaml": "^2.8.2",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.57.0",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^20",
+    "jsdom": "^27.3.0",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "typescript": "^5"
+  },
+  "peerDependencies": {
+    "@playwright/test": "^1.57.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/cli/commands/auto-tag-command.ts

@@ -0,0 +1,80 @@
+/**
+ * Auto-Tag CLI Command
+ * Injects data-testid attributes into source code
+ */
+
+import { Command } from 'commander';
+import { AutoTagger, AutoTagConfig } from '../../tools/auto-tagger';
+import { RuntimeConfig } from '../../config/config-schema';
+import * as path from 'path';
+
+export function createAutoTagCommand(config: RuntimeConfig): Command {
+  const cmd = new Command('auto-tag');
+
+  cmd
+    .description('Auto-inject stable data-testid attributes into source code')
+    .option('--screen <name>', 'Tag specific screen (optional, defaults to all)')
+    .option('--dry-run', 'Preview changes without modifying files', false)
+    .option('--force', 'Overwrite existing data-testid attributes', false)
+    .option('--verbose', 'Show detailed output', false)
+    .action(async (options) => {
+      try {
+        console.log('\n🏷️  Sungen Auto-Tagger\n');
+
+        // Build config
+        const autoTagConfig: AutoTagConfig = {
+          sourceRoot: path.resolve(config.paths.sourceRoot),
+          projectRoot: process.cwd(),
+          screenName: options.screen,
+          dryRun: options.dryRun,
+          force: options.force,
+          verbose: options.verbose,
+          preserveFormatting: false,
+        };
+
+        if (options.dryRun) {
+          console.log('🔍 DRY RUN MODE - No files will be modified\n');
+        }
+
+        if (options.screen) {
+          console.log(`📍 Tagging screen: ${options.screen}\n`);
+        } else {
+          console.log('📍 Tagging all screens\n');
+        }
+
+        // Run auto-tagger
+        const tagger = new AutoTagger(autoTagConfig);
+        const stats = await tagger.tag();
+
+        // Display results
+        console.log('\n📊 RESULTS:\n');
+        console.log(`Files Processed:     ${stats.totalFiles}`);
+        console.log(`Files Modified:      ${stats.modifiedFiles}`);
+        console.log(`Total Elements:      ${stats.totalElements}`);
+        console.log(`Elements Tagged:     ${stats.taggedElements}`);
+        console.log(`Elements Skipped:    ${stats.skippedElements}`);
+        console.log(`Processing Time:     ${stats.processingTime}ms`);
+
+        if (stats.taggedElements > 0) {
+          const coverage = ((stats.taggedElements / stats.totalElements) * 100).toFixed(1);
+          console.log(`\n✨ Coverage: ${coverage}% of interactive elements now have data-testid`);
+        }
+
+        if (options.dryRun && stats.taggedElements > 0) {
+          console.log(`\n💡 Run without --dry-run to apply changes`);
+        }
+
+        if (!options.dryRun && stats.modifiedFiles > 0) {
+          console.log(`\n✅ Successfully tagged ${stats.taggedElements} elements in ${stats.modifiedFiles} files`);
+        }
+
+        console.log('');
+
+      } catch (error: any) {
+        console.error('\n❌ Auto-tagging failed:', error.message);
+        process.exit(1);
+      }
+    });
+
+  return cmd;
+}