@sun-asterisk/sungen 1.0.24 → 2.0.1

package/src/generators/dsl-writer/index.ts

@@ -1,253 +0,0 @@
-/**
- * DSL Writer and Override Loader
- * Writes selector DSL to YAML files and loads with override support
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import * as yaml from 'yaml';
-import { SelectorDSL, SelectorEntry } from '../types';
-
-// ============================================================================
-// DSL Writer
-// ============================================================================
-
-export interface WriteOptions {
-  outputPath: string;
-  screenId: string;
-  platform?: string; // web, android, ios, etc.
-}
-
-export async function writeDSL(
-  selectors: SelectorDSL,
-  options: WriteOptions
-): Promise<string> {
-  const { outputPath, screenId, platform } = options;
-
-  // Determine file path
-  let filePath: string;
-  if (platform) {
-    // Multi-platform: qa/selectors/web/screens/login.yaml
-    const platformDir = path.join(outputPath, platform, 'screens');
-    fs.mkdirSync(platformDir, { recursive: true });
-    filePath = path.join(platformDir, `${screenId}.yaml`);
-  } else {
-    // Single platform: qa/selectors/screens/login.yaml
-    const screensDir = path.join(outputPath, 'screens');
-    fs.mkdirSync(screensDir, { recursive: true });
-    filePath = path.join(screensDir, `${screenId}.yaml`);
-  }
-
-  // Convert to YAML with comments
-  const yamlContent = generateYAML(selectors, screenId);
-
-  // Write file
-  fs.writeFileSync(filePath, yamlContent, 'utf-8');
-
-  return filePath;
-}
-
-/**
- * Generate YAML content with nice formatting
- */
-function generateYAML(selectors: SelectorDSL, screenId: string): string {
-  const header = `# Selector DSL for screen: ${screenId}
-# Auto-generated by AI-assisted selector mapper
-# To override selectors, create ${screenId}.override.yaml in the same directory
-
-`;
-
-  const yamlDoc = yaml.stringify(selectors, {
-    indent: 2,
-    lineWidth: 100,
-    defaultKeyType: 'PLAIN',
-    defaultStringType: 'QUOTE_DOUBLE'
-  });
-
-  return header + yamlDoc;
-}
-
-// ============================================================================
-// DSL Loader with Override Support
-// ============================================================================
-
-export interface LoadOptions {
-  selectorPath: string;
-  screenId: string;
-  platform?: string;
-}
-
-export async function loadDSL(options: LoadOptions): Promise<SelectorDSL> {
-  const { selectorPath, screenId, platform } = options;
-
-  // Determine base file path
-  let basePath: string;
-  if (platform) {
-    basePath = path.join(selectorPath, platform, 'screens', `${screenId}.yaml`);
-  } else {
-    basePath = path.join(selectorPath, 'screens', `${screenId}.yaml`);
-  }
-
-  // Check if base file exists
-  if (!fs.existsSync(basePath)) {
-    throw new Error(`Selector DSL not found: ${basePath}`);
-  }
-
-  // Load base selectors
-  const baseContent = fs.readFileSync(basePath, 'utf-8');
-  const baseSelectors: SelectorDSL = yaml.parse(baseContent) || {};
-
-  // Load override file if exists
-  const overridePath = basePath.replace('.yaml', '.override.yaml');
-  if (fs.existsSync(overridePath)) {
-    const overrideContent = fs.readFileSync(overridePath, 'utf-8');
-    const overrideSelectors: SelectorDSL = yaml.parse(overrideContent) || {};
-
-    // Merge: override wins
-    return mergeSelectors(baseSelectors, overrideSelectors);
-  }
-
-  return baseSelectors;
-}
-
-/**
- * Merge base and override selectors
- * Override selectors take precedence
- */
-export function mergeSelectors(
-  base: SelectorDSL,
-  override: SelectorDSL
-): SelectorDSL {
-  const merged: SelectorDSL = { ...base };
-
-  for (const [elementId, entry] of Object.entries(override)) {
-    // Override completely replaces base
-    merged[elementId] = {
-      ...entry,
-      discoveryMethod: 'manual' // Mark as manually overridden
-    };
-  }
-
-  return merged;
-}
-
-// ============================================================================
-// Helper: Get Selector
-// ============================================================================
-
-export async function getSelector(
-  elementId: string,
-  options: LoadOptions
-): Promise<SelectorEntry | null> {
-  const selectors = await loadDSL(options);
-  return selectors[elementId] || null;
-}
-
-// ============================================================================
-// Helper: List All Selectors for Screen
-// ============================================================================
-
-export async function listSelectors(
-  options: LoadOptions
-): Promise<{ elementId: string; entry: SelectorEntry }[]> {
-  const selectors = await loadDSL(options);
-
-  return Object.entries(selectors).map(([elementId, entry]) => ({
-    elementId,
-    entry
-  }));
-}
-
-// ============================================================================
-// Helper: Validate Selector DSL File
-// ============================================================================
-
-export async function validateDSL(options: LoadOptions): Promise<{
-  valid: boolean;
-  errors: string[];
-}> {
-  const errors: string[] = [];
-
-  try {
-    const selectors = await loadDSL(options);
-
-    // Validate each selector entry
-    for (const [elementId, entry] of Object.entries(selectors)) {
-      // Check required fields
-      if (!entry.selector) {
-        errors.push(`${elementId}: Missing 'selector' field`);
-      }
-      if (!entry.type) {
-        errors.push(`${elementId}: Missing 'type' field`);
-      }
-      if (!entry.description) {
-        errors.push(`${elementId}: Missing 'description' field`);
-      }
-      if (!entry.discoveryMethod) {
-        errors.push(`${elementId}: Missing 'discoveryMethod' field`);
-      }
-
-      // Validate selector syntax (basic check)
-      if (entry.selector && entry.locatorType === 'css') {
-        try {
-          // Very basic CSS selector validation
-          if (entry.selector.includes('>>') || entry.selector.includes('//')) {
-            errors.push(`${elementId}: Invalid CSS selector syntax`);
-          }
-        } catch {
-          errors.push(`${elementId}: Invalid selector format`);
-        }
-      }
-    }
-  } catch (error) {
-    errors.push(`Failed to load DSL: ${(error as Error).message}`);
-  }
-
-  return {
-    valid: errors.length === 0,
-    errors
-  };
-}
-
-// ============================================================================
-// Helper: Create Override Template
-// ============================================================================
-
-export async function createOverrideTemplate(
-  options: LoadOptions
-): Promise<string> {
-  const { selectorPath, screenId, platform } = options;
-
-  // Load base selectors
-  const baseSelectors = await loadDSL(options);
-
-  // Generate override template with all elements commented out
-  let content = `# Override selectors for screen: ${screenId}
-# Uncomment and modify the selectors you want to override
-# Only include selectors that need to be changed
-
-`;
-
-  for (const [elementId, entry] of Object.entries(baseSelectors)) {
-    content += `# ${elementId}:\n`;
-    content += `#   selector: "${entry.selector}"\n`;
-    content += `#   type: "${entry.type}"\n`;
-    content += `#   description: "${entry.description}"\n`;
-    content += `#   discoveryMethod: manual\n\n`;
-  }
-
-  // Determine override file path
-  let overridePath: string;
-  if (platform) {
-    overridePath = path.join(selectorPath, platform, 'screens', `${screenId}.override.yaml`);
-  } else {
-    overridePath = path.join(selectorPath, 'screens', `${screenId}.override.yaml`);
-  }
-
-  // Write template if it doesn't exist
-  if (!fs.existsSync(overridePath)) {
-    fs.writeFileSync(overridePath, content, 'utf-8');
-  }
-
-  return overridePath;
-}