@sun-asterisk/sungen 1.0.0

package/dist/generators/selector-mapper/ai-mapper.js

@@ -0,0 +1,457 @@
+"use strict";
+// @ts-nocheck
+/**
+ * AI-Assisted Selector Mapper
+ * Uses AI (Claude/Gemini) to map Gherkin element IDs to CSS selectors
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIMapper = void 0;
+exports.mapSelectors = mapSelectors;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const generative_ai_1 = require("@google/generative-ai");
+// ============================================================================
+// AI Mapper Class
+// ============================================================================
+class AIMapper {
+    constructor(config) {
+        this.config = config;
+        // Initialize AI clients
+        if (config.provider === 'anthropic') {
+            const apiKey = config.apiKey || process.env.ANTHROPIC_API_KEY;
+            if (!apiKey) {
+                throw new Error('ANTHROPIC_API_KEY not found');
+            }
+            this.anthropic = new sdk_1.default({ apiKey });
+        }
+        else if (config.provider === 'google') {
+            const apiKey = config.apiKey || process.env.GEMINI_API_KEY;
+            if (!apiKey) {
+                throw new Error('GEMINI_API_KEY not found');
+            }
+            this.googleAI = new generative_ai_1.GoogleGenerativeAI(apiKey);
+        }
+    }
+    /**
+     * Map element IDs to selectors using AI
+     */
+    async mapSelectors(request) {
+        const prompt = this.buildPrompt(request);
+        if (this.config.verbose) {
+            console.log('\n📤 Sending request to AI...');
+        }
+        let response;
+        let aiModel;
+        let tokenCost;
+        if (this.config.provider === 'anthropic') {
+            const result = await this.callAnthropic(prompt);
+            response = result.response;
+            aiModel = result.model;
+            tokenCost = result.tokenCost;
+        }
+        else {
+            const result = await this.callGoogle(prompt);
+            response = result.response;
+            aiModel = result.model;
+        }
+        // Parse AI response
+        const selectors = this.parseResponse(response, request.elementIds);
+        // UPDATED: Phase 1 - Task 3 - Don't create fake fallback placeholders
+        // Return null selectors with confidence "none" for missing elements
+        for (const elementId of request.elementIds) {
+            // CRITICAL FIX: Use clean ID to match heuristic format
+            const cleanId = elementId.replace(/[\[\]]/g, '').split('.').pop() || elementId;
+            if (!selectors[cleanId]) {
+                selectors[cleanId] = {
+                    selector: null,
+                    type: 'unknown',
+                    description: 'Element not found in UI Model - re-scan or add manually',
+                    discoveryMethod: 'ai-static-analysis',
+                    locatorType: 'css',
+                    confidence: 'none',
+                    reason: 'not-in-ui-model',
+                    suggestedAction: 'Run discovery again or add data-testid to source code'
+                };
+            }
+        }
+        return {
+            selectors,
+            metadata: {
+                aiModel,
+                tokenCost,
+                provider: this.config.provider
+            }
+        };
+    }
+    /**
+     * Build prompt for AI
+     */
+    buildPrompt(request) {
+        const { uiModel, elementIds } = request;
+        // Extract ALL relevant attributes from UI model (DON'T simplify!)
+        const enrichedElements = uiModel.elements.map(el => {
+            // Extract critical props from the props object
+            const props = el.props || {};
+            return {
+                key: el.key,
+                tag: el.tag,
+                // Top-level attributes
+                id: el.id,
+                name: el.name,
+                placeholder: el.placeholder,
+                ariaLabel: el.ariaLabel,
+                testId: el.testId,
+                text: el.text,
+                role: el.role,
+                // CRITICAL: Extract props that AI needs for selector generation
+                type: props.type, // button type="submit", input type="password"
+                href: props.href, // link href="/auth/register"
+                value: props.value, // input value
+                disabled: props.disabled, // button disabled
+                required: props.required, // input required
+                autoComplete: props.autoComplete, // input autocomplete
+                // Keep full props for AI to reference if needed
+                allProps: props
+            };
+        });
+        const prompt = `You are a test automation expert. Given a UI Model and a list of element IDs from Gherkin test scenarios, generate CSS selectors for each element.
+
+**CRITICAL: Use Semantic Understanding**
+The element IDs come from QA-written Gherkin scenarios and use human-readable names. You MUST understand the semantic meaning of each ID and match it to the appropriate UI element.
+
+**PHASE 2 ENHANCEMENT: Semantic Aliases & Context Awareness**
+
+Gherkin names often use INTENT-based naming while UI uses IMPLEMENTATION-based text. You must bridge this semantic gap:
+
+**Common Semantic Aliases:**
+
+**Action Buttons:**
+- "clear" / "clear-button" ≈ "New Chat" button (clears chat history)
+- "send" / "send-button" ≈ "Send", "Submit", "→", "➤" button
+- "submit" / "submit-button" ≈ "Submit", "Continue", "Sign In", "Register" button
+- "cancel" / "cancel-button" ≈ "Cancel", "Back", "Close" button
+- "delete" / "delete-button" ≈ "Delete", "Remove", "×" button
+- "edit" / "edit-button" ≈ "Edit", "Modify", "✎" button
+- "save" / "save-button" ≈ "Save", "Update", "Confirm" button
+
+**Brand/Identity Elements:**
+- "logo" ≈ heading with brand name OR image with alt="logo"
+- "title" ≈ main heading (h1) with brand/app name
+- "tagline" ≈ subtitle or description text
+
+**Navigation:**
+- "login-link" / "signin-link" ≈ link with text "Login", "Sign In", "Log In"
+- "register-link" / "signup-link" ≈ link with text "Register", "Sign Up", "Create Account"
+- "logout-link" / "signout-link" ≈ link/button with text "Logout", "Sign Out", "Log Out"
+- "back-link" ≈ link with text "Back", "←", "Return"
+
+**Input Fields (aliases for same field):**
+- "email" / "email-input" / "email-field" → input[type='email'] OR input[name='email']
+- "password" / "pass" / "password-input" / "pw" → input[type='password']
+- "message" / "message-input" / "input" / "textarea" → textarea for messages
+- "search" / "search-input" → input[type='search'] OR placeholder containing "search"
+
+**Container Elements:**
+- "messages" / "messages-container" / "messages-list" → div with overflow-y-auto OR flex-1 (scrollable area)
+- "empty-state" → text/paragraph shown when no content (e.g., "No messages yet", "Start a conversation")
+- "error" / "error-message" → text with red color (text-red-*) OR bg-red-*
+
+**Conditional Elements (may have isConditional marker):**
+- "timestamp" / "message-timestamp" → small text with time format (text-xs, text-gray-500)
+- "error" / "field-error" → conditionally rendered error message
+- "copy-button" → button that appears on hover (opacity-0 group-hover:opacity-100)
+- "tooltip" → conditionally shown helper text
+
+**Context Clues:**
+- If Gherkin says "clear-button" but UI has "New Chat" button → Match if button clears/resets state
+- If Gherkin says "logo" but UI has h1 text → Match heading with brand name
+- If Gherkin says "send" but UI has "Submit" → Match if button submits form
+- If multiple buttons exist, use context: submit buttons usually have type='submit', cancel buttons may have type='button'
+
+**Examples of semantic matching:**
+- \`[auth-login.email]\` OR \`[auth-login.email-input]\` → input with name="email" or id="email-address"
+- \`[auth-login.password]\` OR \`[auth-login.pass]\` → input with type="password" or name="password"
+- \`[auth-login.submit]\` OR \`[auth-login.login-button]\` → button with type="submit" OR button:has-text("Sign In")
+- \`[auth-login.signup-link]\` OR \`[auth-login.register-link]\` → link (a tag) pointing to signup/register
+- \`[chat.input]\` OR \`[chat.message-input]\` → textarea or input for chat messages
+- \`[chat.send-button]\` OR \`[chat.send]\` → button to send messages OR button:has-text("Send")
+- \`[chat.clear-button]\` → button:has-text("New Chat") (semantic alias: clear ≈ new chat)
+- \`[home.logo]\` → h1:has-text("PEU AI-Native Workflow") (logo as text heading)
+
+**Screen:** ${uiModel.screenId}
+**Framework:** ${uiModel.framework}
+
+**UI Elements Available:**
+${JSON.stringify(enrichedElements, null, 2)}
+
+**Element IDs to Resolve (from Gherkin):**
+${elementIds.map(id => `- ${id}`).join('\n')}
+
+**CRITICAL INSTRUCTIONS - MUST FOLLOW:**
+
+1. **Use EXACT attributes from UI Model** - Each element has \`type\`, \`href\`, \`id\`, \`name\`, etc. Use these EXACT values!
+
+2. **MANDATORY Selector Priority:**
+
+   **FOR BUTTONS (tag="button"):**
+   - If element has \`type\` attribute → **MUST use** \`button[type="..."]\`
+   - Example: \`type: "submit"\` → \`button[type='submit']\` (NOT \`button[role='button']\`!)
+   - Only use text if no type: \`button:has-text("...")\`
+
+   **FOR LINKS (tag="a", tag="link"):**
+   - If element has \`href\` → **MUST use** \`a[href="..."]\`
+   - Use EXACT href from UI Model
+   - Example: \`href: "/auth/register"\` → \`a[href='/auth/register']\`
+
+   **FOR INPUTS (tag="input"):**
+   - Priority: \`id\` > \`name\` > \`type\` + \`placeholder\`
+   - Example: \`id: "email-address"\` → \`#email-address\`
+   - Example: \`name: "password"\` → \`input[name='password']\`
+
+   **FOR TEXTAREA:**
+   - Priority: \`id\` > \`name\` > \`placeholder\`
+   - Example: \`placeholder: "Type your message"\` → \`textarea[placeholder*='Type your message']\`
+
+3. **NEVER use these (BANNED):**
+   - Generic \`role\` attribute for buttons/inputs
+   - Class names NOT in UI Model
+   - Invented/guessed selectors
+   - Just tag name without attributes (e.g., \`button\`, \`textarea\`)
+
+4. **Semantic matching:** "email", "email-input", "email-field" all = same element
+
+5. **Confidence levels:**
+   - \`high\`: Used id/name/type/href from UI Model - exact match
+   - \`medium\`: Used placeholder/text from UI Model OR semantic alias match (e.g., "clear" → "New Chat")
+   - \`low\`: Ambiguous match - multiple elements could match
+   - \`none\`: Element not found in UI Model (needs manual review)
+
+6. **PHASE 2: Ambiguity Detection & Helpful Messages**
+
+   If you find MULTIPLE elements that could match a Gherkin ID:
+   - Set confidence to \`low\`
+   - In description, list ALL potential matches
+   - Example:
+     \`\`\`json
+     {
+       "[chat.messages]": {
+         "selector": "div.flex-1.overflow-y-auto",
+         "type": "container",
+         "description": "AMBIGUOUS: Could be (1) messages container (div.flex-1), (2) messages list (div.max-w-4xl), or (3) message items. Recommend using [chat.messages-container] for container, [chat.messages-list] for list, or [chat.messages-item] for items.",
+         "confidence": "low"
+       }
+     }
+     \`\`\`
+
+   If element uses semantic alias:
+   - Set confidence to \`medium\`
+   - Explain the alias in description
+   - Example:
+     \`\`\`json
+     {
+       "[chat.clear-button]": {
+         "selector": "button:has-text('New Chat')",
+         "type": "button",
+         "description": "Semantic match: 'clear-button' maps to 'New Chat' button (clears chat history)",
+         "confidence": "medium"
+       }
+     }
+     \`\`\`
+
+7. **IF ELEMENT NOT FOUND IN UI MODEL:**
+   - DO NOT guess selectors or invent className patterns like \`div[className*='...']\`
+   - DO NOT create fake data-testid attributes like \`[data-testid="messages"]\`
+   - RETURN exactly:
+     \`\`\`json
+     {
+       "[element-id]": {
+         "selector": null,
+         "type": "unknown",
+         "description": "Element not found in UI Model",
+         "confidence": "none"
+       }
+     }
+     \`\`\`
+
+**Return ONLY valid JSON with this structure:**
+\`\`\`json
+{
+  "[element-id]": {
+    "selector": "css-selector-string",
+    "type": "input|button|link|textarea|text|container",
+    "description": "Human readable description",
+    "confidence": "high|medium|low"
+  }
+}
+\`\`\`
+
+**Example Response (showing CORRECT usage):**
+\`\`\`json
+{
+  "[auth-login.email]": {
+    "selector": "#email-address",
+    "type": "input",
+    "description": "Email input field",
+    "confidence": "high"
+  },
+  "[auth-login.submit]": {
+    "selector": "button[type='submit']",
+    "type": "button",
+    "description": "Login submit button",
+    "confidence": "high"
+  },
+  "[auth-login.signup-link]": {
+    "selector": "a[href='/auth/register']",
+    "type": "link",
+    "description": "Sign up link",
+    "confidence": "high"
+  }
+}
+\`\`\`
+
+**WRONG Examples (NEVER do this):**
+❌ \`"selector": "button[role='button']"\` - DON'T use role when type exists!
+❌ \`"selector": "button"\` - DON'T use tag only!
+❌ \`"selector": ".submit-btn"\` - DON'T invent class names!
+❌ \`"selector": "div[className*='chat-messages']"\` - DON'T guess className patterns!
+❌ \`"selector": "[data-testid='messages']"\` - DON'T create fake testids!
+✅ \`"selector": "button[type='submit']"\` - CORRECT! Uses type from UI Model!
+✅ \`"selector": null, "confidence": "none"\` - CORRECT! If not found in UI Model!
+
+**IMPORTANT:** Return ONLY the JSON object, no markdown, no additional text.`;
+        return prompt;
+    }
+    /**
+     * Call Anthropic API
+     */
+    async callAnthropic(prompt) {
+        if (!this.anthropic) {
+            throw new Error('Anthropic client not initialized');
+        }
+        const model = this.config.model || 'claude-3-5-haiku-20241022';
+        const message = await this.anthropic.messages.create({
+            model,
+            max_tokens: 4096,
+            messages: [{
+                    role: 'user',
+                    content: prompt
+                }]
+        });
+        const response = message.content[0].type === 'text' ? message.content[0].text : '';
+        const tokenCost = message.usage.input_tokens + message.usage.output_tokens;
+        if (this.config.verbose) {
+            console.log(`✅ Response received (${tokenCost} tokens)`);
+        }
+        return { response, model, tokenCost };
+    }
+    /**
+     * Call Google Gemini API
+     */
+    async callGoogle(prompt) {
+        if (!this.googleAI) {
+            throw new Error('Google AI client not initialized');
+        }
+        const model = this.config.model || 'gemini-2.0-flash-exp';
+        const genModel = this.googleAI.getGenerativeModel({ model });
+        const result = await genModel.generateContent(prompt);
+        const response = result.response.text();
+        if (this.config.verbose) {
+            console.log(`✅ Response received from ${model}`);
+        }
+        return { response, model };
+    }
+    /**
+     * Parse AI response into SelectorDSL
+     */
+    parseResponse(response, elementIds) {
+        // Extract JSON from response (handle markdown code blocks)
+        let jsonStr = response.trim();
+        // Remove markdown code blocks if present
+        const codeBlockMatch = jsonStr.match(/```(?:json)?\s*(\{[\s\S]*\})\s*```/);
+        if (codeBlockMatch) {
+            jsonStr = codeBlockMatch[1];
+        }
+        try {
+            const parsed = JSON.parse(jsonStr);
+            const selectors = {};
+            // Convert to SelectorDSL format
+            for (const elementId of elementIds) {
+                if (parsed[elementId]) {
+                    const entry = parsed[elementId];
+                    // CRITICAL FIX: Clean element ID to match heuristic format
+                    // [auth-login.email] → email
+                    // [chat.message-input] → message-input
+                    const cleanId = elementId.replace(/[\[\]]/g, '').split('.').pop() || elementId;
+                    selectors[cleanId] = {
+                        selector: entry.selector,
+                        type: entry.type,
+                        description: entry.description,
+                        discoveryMethod: 'ai-static-analysis',
+                        locatorType: 'css',
+                        confidence: entry.confidence || 'medium'
+                    };
+                }
+            }
+            return selectors;
+        }
+        catch (error) {
+            console.error('Failed to parse AI response:', error);
+            console.error('Response:', response);
+            throw new Error('AI response is not valid JSON');
+        }
+    }
+    /**
+     * Create fallback selector using heuristic rules
+     */
+    createFallbackSelector(elementId, uiModel) {
+        // Extract element name from ID
+        // e.g., "[login.email]" -> "email"
+        const match = elementId.match(/\[([^.]+)\.([^\]]+)\]/);
+        const elementName = match ? match[2] : 'unknown';
+        // Try to find matching element by name
+        const matchingElement = uiModel.elements.find(el => el.name === elementName ||
+            el.id === elementName ||
+            el.testId?.includes(elementName));
+        if (matchingElement) {
+            // Build selector
+            let selector = matchingElement.tag;
+            if (matchingElement.testId) {
+                selector = `[data-testid="${matchingElement.testId}"]`;
+            }
+            else if (matchingElement.id) {
+                selector = `#${matchingElement.id}`;
+            }
+            else if (matchingElement.name) {
+                selector = `${matchingElement.tag}[name="${matchingElement.name}"]`;
+            }
+            return {
+                selector,
+                type: matchingElement.tag,
+                description: `Fallback selector for ${elementName}`,
+                discoveryMethod: 'ai-static-analysis',
+                locatorType: 'css',
+                confidence: 'low'
+            };
+        }
+        // Ultimate fallback
+        return {
+            selector: `[data-testid="${elementName}"]`,
+            type: 'unknown',
+            description: `Placeholder selector for ${elementName} - needs manual review`,
+            discoveryMethod: 'ai-static-analysis',
+            locatorType: 'css',
+            confidence: 'low'
+        };
+    }
+}
+exports.AIMapper = AIMapper;
+// ============================================================================
+// Factory Function
+// ============================================================================
+async function mapSelectors(uiModel, elementIds, config) {
+    const mapper = new AIMapper(config);
+    return mapper.mapSelectors({ uiModel, elementIds });
+}
+//# sourceMappingURL=ai-mapper.js.map

package/dist/generators/selector-mapper/ai-mapper.js.map

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

package/dist/generators/selector-mapper/hybrid-mapper.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Hybrid Selector Mapper
+ * Combines heuristic matching (fast, free) with AI fallback (slow, accurate)
+ *
+ * Strategy:
+ * 1. Try heuristic matching (90% success, 0 cost, instant)
+ * 2. Fallback to AI mapping (10% cases, paid, 2-5s)
+ *
+ * Benefits:
+ * - 90% cost reduction
+ * - 10x faster mapping
+ * - Deterministic results for common elements
+ */
+import { AIMapperConfig } from './ai-mapper';
+import { UIModel, SelectorDSL } from '../types';
+export interface HybridMapperConfig extends AIMapperConfig {
+    heuristicFirst?: boolean;
+    minHeuristicConfidence?: number;
+}
+export interface HybridMappingStats {
+    total: number;
+    heuristicMatches: number;
+    aiMatches: number;
+    heuristicSuccessRate: number;
+    estimatedCost: number;
+    estimatedTime: number;
+}
+export declare class HybridMapper {
+    private aiMapper;
+    private config;
+    private stats;
+    constructor(config: HybridMapperConfig);
+    /**
+     * Map element IDs to selectors using hybrid approach
+     */
+    mapSelectors(uiModel: UIModel, elementIds: string[]): Promise<SelectorDSL>;
+    /**
+     * Get mapping statistics
+     */
+    getStats(): HybridMappingStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+}
+/**
+ * Example Usage:
+ *
+ * const mapper = new HybridMapper({
+ *   provider: 'anthropic',
+ *   apiKey: process.env.ANTHROPIC_API_KEY,
+ *   verbose: true,
+ *   heuristicFirst: true,
+ *   minHeuristicConfidence: 0.8
+ * });
+ *
+ * const selectors = await mapper.mapSelectors(uiModel, [
+ *   '[login.email]',
+ *   '[login.password]',
+ *   '[login.submit]'
+ * ]);
+ *
+ * const stats = mapper.getStats();
+ * console.log(`Heuristic success: ${stats.heuristicSuccessRate}%`);
+ * console.log(`Cost: $${stats.estimatedCost}`);
+ */
+//# sourceMappingURL=hybrid-mapper.d.ts.map

package/dist/generators/selector-mapper/hybrid-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-mapper.d.ts","sourceRoot":"","sources":["../../../src/generators/selector-mapper/hybrid-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAY,cAAc,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,OAAO,EAAa,WAAW,EAAiB,MAAM,UAAU,CAAC;AAqP1E,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAqB;gBAEtB,MAAM,EAAE,kBAAkB;IAiBtC;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAqFhF;;OAEG;IACH,QAAQ,IAAI,kBAAkB;IAI9B;;OAEG;IACH,UAAU,IAAI,IAAI;CAUnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG"}