@sun-asterisk/sungen 1.0.0

package/dist/orchestrator/screen-manager.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * Screen Manager
+ * Manages screen definition files in qa/screens directory
+ */
+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.ScreenManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class ScreenManager {
+    constructor() {
+        this.cwd = process.cwd();
+        this.screensDir = path.join(this.cwd, 'qa', 'screens');
+    }
+    /**
+     * Add a new screen definition
+     */
+    async addScreen(options) {
+        console.log(`📱 Adding screen: ${options.name}...\n`);
+        // Validate screen name
+        this.validateScreenName(options.name);
+        // Normalize screen name for directory
+        const screenName = this.normalizeScreenName(options.name);
+        const screenDir = path.join(this.screensDir, screenName);
+        // Derive filename from path or use screen name
+        const filename = options.path
+            ? this.extractFilenameFromPath(options.path)
+            : screenName;
+        // Create directory structure
+        const featuresDir = path.join(screenDir, 'features');
+        const selectorsDir = path.join(screenDir, 'selectors');
+        const testDataDir = path.join(screenDir, 'test-data');
+        // File paths
+        const featurePath = path.join(featuresDir, `${filename}.feature`);
+        const selectorPath = path.join(selectorsDir, `${filename}.yaml`);
+        const testDataPath = path.join(testDataDir, `${filename}.yaml`);
+        // Smart behavior: Create dirs only if first file
+        const isFirstFile = !fs.existsSync(screenDir);
+        if (isFirstFile) {
+            console.log(`📱 Creating screen: ${options.name}...\n`);
+            // Create directories
+            try {
+                if (!fs.existsSync(this.screensDir)) {
+                    fs.mkdirSync(this.screensDir, { recursive: true });
+                    console.log(`✓ Created directory: qa/screens/\n`);
+                }
+                fs.mkdirSync(featuresDir, { recursive: true });
+                fs.mkdirSync(selectorsDir, { recursive: true });
+                fs.mkdirSync(testDataDir, { recursive: true });
+            }
+            catch (error) {
+                console.error(`❌ Error: Failed to create directories`);
+                console.error(`   ${error instanceof Error ? error.message : String(error)}`);
+                console.error('   Check file permissions and try again.\n');
+                process.exit(1);
+            }
+        }
+        else {
+            console.log(`📄 Adding feature to screen: ${options.name}...\n`);
+        }
+        // Check file existence to prevent overwrite
+        if (fs.existsSync(featurePath)) {
+            console.error(`❌ Error: Feature file "${filename}.feature" already exists`);
+            console.error(`   Path: ${featurePath}`);
+            console.error(`   Use a different --path value or delete existing file.`);
+            process.exit(1);
+        }
+        // Generate and write feature file
+        const featureContent = this.generateFeatureTemplate(options, filename);
+        try {
+            fs.writeFileSync(featurePath, featureContent, 'utf-8');
+        }
+        catch (error) {
+            console.error(`❌ Error: Failed to create feature file at ${featurePath}`);
+            console.error(`   ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+        // Generate and write selector file
+        const selectorContent = this.generateSelectorTemplate(options, filename);
+        try {
+            fs.writeFileSync(selectorPath, selectorContent, 'utf-8');
+        }
+        catch (error) {
+            console.error(`❌ Error: Failed to create selector file at ${selectorPath}`);
+            console.error(`   ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+        // Generate and write test data file
+        const testDataContent = this.generateTestDataTemplate(options);
+        try {
+            fs.writeFileSync(testDataPath, testDataContent, 'utf-8');
+        }
+        catch (error) {
+            console.error(`❌ Error: Failed to create test data file at ${testDataPath}`);
+            console.error(`   ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+        // Display success message
+        if (isFirstFile) {
+            console.log(`✓ Created screen: ${options.name} at ${screenDir}`);
+        }
+        else {
+            console.log(`✓ Added feature: ${filename} to ${screenName}`);
+        }
+        this.displaySuccess(options.name, filename, screenDir);
+    }
+    /**
+     * Validate screen name
+     */
+    validateScreenName(name) {
+        if (!name || name.trim().length === 0) {
+            console.error('❌ Error: Screen name cannot be empty');
+            process.exit(1);
+        }
+        // Check if name contains at least one alphanumeric character
+        if (!/[a-zA-Z0-9]/.test(name)) {
+            console.error('❌ Error: Screen name must contain at least one alphanumeric character');
+            console.error('   Valid examples: login, user-profile, Dashboard');
+            process.exit(1);
+        }
+    }
+    /**
+     * Normalize screen name to kebab-case for filename
+     */
+    normalizeScreenName(name) {
+        return name
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '')
+            .replace(/-+/g, '-');
+    }
+    /**
+     * Extract filename from path value
+     */
+    extractFilenameFromPath(pathString) {
+        // Remove leading and trailing slashes
+        const cleanPath = pathString.replace(/^\/+/, '').replace(/\/+$/, '');
+        // Split by '/' and take last segment
+        const segments = cleanPath.split('/');
+        const lastSegment = segments[segments.length - 1];
+        // Normalize to kebab-case
+        return this.normalizeScreenName(lastSegment);
+    }
+    /**
+     * Generate feature file template
+     */
+    generateFeatureTemplate(options, filename) {
+        const screenName = this.normalizeScreenName(options.name);
+        const featurePath = options.path || `/${screenName}`;
+        const description = options.description || `interact with the ${options.name} screen`;
+        return `Feature: ${options.name} Screen
+
+  As a user
+  I want to ${description}
+  So that I can accomplish my tasks
+  Path: ${featurePath}
+
+  @high
+  Scenario: Sample scenario for ${options.name}
+    Given User open page
+    When User click [element] button
+    Then User see [result] text with {{success}}
+`;
+    }
+    /**
+     * Generate selector YAML template
+     */
+    generateSelectorTemplate(options, filename) {
+        const timestamp = new Date().toISOString().split('T')[0];
+        const screenPath = options.path || '';
+        return `# ${options.name} Screen Selectors
+# Created: ${timestamp}
+${screenPath ? `# Path: ${screenPath}` : '# Path: (not specified - update as needed)'}
+
+# Example element - replace with actual elements or use 'sungen map'
+# 
+# Element structure:
+#   key: element-identifier
+#     selector: ""           # Playwright selector
+#     type: text|role|placeholder|testid|xpath
+#     value: "text content"  # Element value/text/label
+#     name: "Display Name"   # Optional: readable name
+#     nth: 0                 # Optional: element index if multiple matches
+
+# element:
+#  selector: ""
+#  type: role
+#  value: "button"
+#  name: "element"
+#  nth: 0
+
+# Next steps:
+# 1. Edit the feature file: qa/screens/${filename}/features/${filename}.feature
+# 2. Run: sungen map --screen ${filename}
+#    This will populate selectors from your feature file
+# 
+# Documentation: https://github.com/sun-asterisk/sungen
+`;
+    }
+    /**
+     * Generate test data YAML template
+     */
+    generateTestDataTemplate(options) {
+        const timestamp = new Date().toISOString().split('T')[0];
+        return `# ${options.name} Screen Test Data
+# Created: ${timestamp}
+
+# Define test data variables here
+# Example:
+# success: "Operation completed successfully"
+# username: "testuser@example.com"
+# password: "SecurePassword123"
+
+# Next steps:
+# 1. Add test data variables referenced in your feature scenarios
+# 2. Use {{variable}} syntax in your feature files to reference these values
+`;
+    }
+    /**
+     * Display success message with next steps
+     */
+    displaySuccess(name, filename, screenDir) {
+        console.log('✅ Screen definition created successfully!\n');
+        console.log(`Screen: ${name}`);
+        console.log(`Path:   ${screenDir}\n`);
+        console.log('Created files:');
+        console.log(`  📄 ${path.join(screenDir, 'features', `${filename}.feature`)}`);
+        console.log(`  📄 ${path.join(screenDir, 'selectors', `${filename}.yaml`)}`);
+        console.log(`  📄 ${path.join(screenDir, 'test-data', `${filename}.yaml`)}\n`);
+        console.log('Next steps:');
+        console.log(`  1. Edit the Gherkin feature file to define test scenarios`);
+        console.log(`  2. Run: sungen map --screen ${filename}`);
+        console.log(`     This will generate selector mappings from your feature file\n`);
+        console.log('Documentation: https://github.com/sun-asterisk/sungen');
+    }
+}
+exports.ScreenManager = ScreenManager;
+//# sourceMappingURL=screen-manager.js.map

package/dist/orchestrator/screen-manager.js.map

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

package/dist/tools/auto-tagger.d.ts

@@ -0,0 +1,107 @@
+/**
+ * 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
+ */
+export interface AutoTagConfig {
+    sourceRoot: string;
+    projectRoot: string;
+    screenName?: string;
+    dryRun: boolean;
+    force: boolean;
+    verbose: boolean;
+    preserveFormatting: boolean;
+}
+export interface TaggingResult {
+    filePath: string;
+    totalElements: number;
+    taggedElements: number;
+    skippedElements: number;
+    changes: ElementChange[];
+    modified: boolean;
+}
+export interface ElementChange {
+    line: number;
+    tag: string;
+    generatedId: string;
+    action: 'added' | 'skipped' | 'overwritten';
+    reason?: string;
+}
+export interface TaggingStats {
+    totalFiles: number;
+    modifiedFiles: number;
+    totalElements: number;
+    taggedElements: number;
+    skippedElements: number;
+    processingTime: number;
+}
+export declare class AutoTagger {
+    private config;
+    private extractor;
+    private stats;
+    private readonly INTERACTIVE_TAGS;
+    constructor(config: AutoTagConfig);
+    /**
+     * Tag a specific screen or all screens
+     */
+    tag(): Promise<TaggingStats>;
+    /**
+     * Tag a specific screen
+     */
+    private tagScreen;
+    /**
+     * Tag all screens (scan entire source root)
+     */
+    private tagAllScreens;
+    /**
+     * Tag a single file
+     */
+    private tagFile;
+    /**
+     * Tag elements in AST
+     */
+    private tagAST;
+    /**
+     * Determine if element should be tagged
+     */
+    private shouldTag;
+    /**
+     * Find existing attribute value
+     */
+    private findAttribute;
+    /**
+     * Set attribute value (replace if exists)
+     */
+    private setAttribute;
+    /**
+     * Add new attribute
+     */
+    private addAttribute;
+    /**
+     * Find source files for a screen
+     */
+    private findSourceFiles;
+    /**
+     * Find all source files recursively
+     */
+    private findAllSourceFiles;
+    /**
+     * Infer screen name from file path
+     */
+    private inferScreenName;
+    private createEmptyResult;
+    /**
+     * Get statistics
+     */
+    getStats(): TaggingStats;
+}
+//# sourceMappingURL=auto-tagger.d.ts.map

package/dist/tools/auto-tagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-tagger.d.ts","sourceRoot":"","sources":["../../src/tools/auto-tagger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,aAAa,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAgLD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,KAAK,CAOX;IAGF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0D;gBAE/E,MAAM,EAAE,aAAa;IAIjC;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;IAalC;;OAEG;YACW,SAAS;IAevB;;OAEG;YACW,aAAa;IAY3B;;OAEG;YACW,OAAO;IA4CrB;;OAEG;YACW,MAAM;IAmFpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,QAAQ,IAAI,YAAY;CAGzB"}