@sun-asterisk/sungen 3.2.6 → 3.2.7

package/src/generators/types.ts

@@ -1,227 +0,0 @@
-/**
- * Core types for Selector DSL Framework
- * Framework-agnostic types for multi-platform support
- */
-
-// ============================================================================
-// UI Model Types
-// ============================================================================
-
-export interface UIElement {
-  key: string;                    // Unique key within screen (e1, e2, ...)
-  tag: string;                    // HTML/component tag (input, button, View, TextField, ...)
-  role?: string;                  // ARIA role or semantic role
-  name?: string;                  // name attribute
-  id?: string;                    // id/resource-id attribute
-  placeholder?: string;           // placeholder text
-  label?: string;                 // Associated label text
-  text?: string;                  // Text content
-  ariaLabel?: string;             // aria-label attribute
-  testId?: string;                // data-testid / test ID
-  source: string;                 // Source file path
-  framework?: string;             // Framework-specific type (TextField, EditText, etc.)
-  props?: Record<string, any>;    // Additional framework-specific props
-}
-
-export interface UIModel {
-  screenId: string;               // Screen identifier (login, dashboard, ...)
-  routeId: string;                // Route path or identifier
-  framework: FrameworkType;       // Framework type
-  sourceFiles: string[];          // All source files merged
-  elements: UIElement[];          // All UI elements on this screen
-  metadata?: {
-    scannedAt: string;            // ISO timestamp
-    version: string;              // Tool version
-    hash: string;                 // Content hash for cache
-  };
-}
-
-// ============================================================================
-// Selector DSL Types
-// ============================================================================
-
-export type DiscoveryMethod =
-  | 'ai-static-analysis'          // Generated by AI from static code analysis
-  | 'manual'                      // Manually written by QA
-  | 'runtime';                    // Discovered at runtime
-
-export type LocatorType =
-  | 'css'                         // CSS selector (web)
-  | 'xpath'                       // XPath selector
-  | 'resource-id'                 // Android resource-id
-  | 'accessibility-id'            // iOS accessibility identifier
-  | 'test-id'                     // Framework test ID (data-testid, etc.)
-  | 'key'                         // Flutter Key
-  | 'text'                        // Text-based locator
-  | 'role';                       // ARIA role locator
-
-export interface SelectorEntry {
-  selector: string;               // The actual selector string
-  type: string;                   // Element type (input, button, link, text, ...)
-  description: string;            // Human-readable description
-  discoveryMethod: DiscoveryMethod;
-  locatorType?: LocatorType;      // Type of locator (for multi-platform)
-  confidence?: 'high' | 'medium' | 'low'; // AI confidence level
-  alternatives?: string[];        // Alternative selectors (fallbacks)
-  metadata?: {
-    lastValidated?: string;       // ISO timestamp
-    validationStatus?: 'valid' | 'invalid' | 'unknown';
-  };
-}
-
-export interface SelectorDSL {
-  [elementId: string]: SelectorEntry;
-}
-
-// ============================================================================
-// Framework Types
-// ============================================================================
-
-export type FrameworkType =
-  | 'react'
-  | 'react-nextjs'
-  | 'vue'
-  | 'angular'
-  | 'html'
-  | 'flutter'
-  | 'jetpack-compose'
-  | 'swiftui';
-
-export type TargetPlatform =
-  | 'web'
-  | 'android'
-  | 'ios'
-  | 'desktop';
-
-// ============================================================================
-// Executor Types
-// ============================================================================
-
-export type ExecutorType =
-  | 'playwright'                  // Web - Playwright
-  | 'puppeteer'                   // Web - Puppeteer
-  | 'selenium'                    // Web - Selenium
-  | 'appium-android'              // Android - Appium
-  | 'appium-ios'                  // iOS - Appium
-  | 'flutter-driver'              // Flutter Driver
-  | 'espresso'                    // Android - Espresso
-  | 'xcuitest';                   // iOS - XCUITest
-
-export interface ExecutorConfig {
-  type: ExecutorType;
-  platform: TargetPlatform;
-  selectorPath: string;           // Path to selector DSL files
-  overridePath?: string;          // Path to override files
-}
-
-// ============================================================================
-// Cache Types
-// ============================================================================
-
-export interface CacheEntry {
-  screenId: string;
-  hash: string;                   // SHA-256 hash of UI Model + element IDs
-  selectors: SelectorDSL;
-  metadata: {
-    createdAt: string;            // ISO timestamp
-    aiModel?: string;             // AI model used (claude-3-5-sonnet, gemini-2.0-flash, ...)
-    tokenCost?: number;           // Token usage
-    framework: FrameworkType;
-  };
-}
-
-// ============================================================================
-// Generator Config Types
-// ============================================================================
-
-export interface GeneratorConfig {
-  // AI Provider
-  aiProvider: 'anthropic' | 'google' | 'openai';
-  aiModel?: string;               // Optional: specific model (defaults to best available)
-
-  // Paths
-  sourceRoot: string;             // Root directory to scan (e.g., 'app', 'src')
-  uiModelPath: string;            // Where to save UI models
-  selectorPath: string;           // Where to save selectors
-  cachePath: string;              // Cache directory
-
-  // Framework
-  framework: FrameworkType;
-
-  // Options
-  enableCache: boolean;
-  cacheExpiry?: number;           // Cache expiry in milliseconds
-  parallelScans?: number;         // Number of parallel scans
-  verbose?: boolean;
-}
-
-// ============================================================================
-// CLI Types
-// ============================================================================
-
-export interface DiscoverOptions {
-  screenId?: string;              // Specific screen to discover
-  all?: boolean;                  // Discover all screens
-  force?: boolean;                // Force re-scan even if cached
-}
-
-export interface GenerateOptions {
-  screenId?: string;              // Specific screen to generate
-  all?: boolean;                  // Generate all screens
-  force?: boolean;                // Force re-generation
-  skipCache?: boolean;            // Skip cache lookup
-  runtimeData?: boolean;          // Runtime data loading (default: true). False = compile-time hardcoding.
-}
-
-export interface ValidateOptions {
-  screenId?: string;              // Specific screen to validate
-  all?: boolean;                  // Validate all screens
-  executor?: ExecutorType;        // Executor to validate against
-}
-
-// ============================================================================
-// Gherkin Integration Types
-// ============================================================================
-
-export interface GherkinElementReference {
-  elementId: string;              // e.g., "[login.email]"
-  screenId: string;               // e.g., "login"
-  elementName: string;            // e.g., "email"
-}
-
-export function parseElementReference(ref: string): GherkinElementReference | null {
-  // Parse "[screen.element]" format
-  const match = ref.match(/^\[([^.]+)\.([^\]]+)\]$/);
-  if (!match) return null;
-
-  return {
-    elementId: ref,
-    screenId: match[1],
-    elementName: match[2]
-  };
-}
-
-// ============================================================================
-// Error Types
-// ============================================================================
-
-export class SelectorNotFoundError extends Error {
-  constructor(public elementId: string, public screenId: string) {
-    super(`Selector not found: ${elementId} on screen ${screenId}`);
-    this.name = 'SelectorNotFoundError';
-  }
-}
-
-export class UIModelNotFoundError extends Error {
-  constructor(public screenId: string) {
-    super(`UI Model not found for screen: ${screenId}`);
-    this.name = 'UIModelNotFoundError';
-  }
-}
-
-export class GeneratorError extends Error {
-  constructor(message: string, public cause?: Error) {
-    super(message);
-    this.name = 'GeneratorError';
-  }
-}

package/src/orchestrator/figma/node-path-collapser.ts

@@ -1,38 +0,0 @@
-/**
- * Pure helper: collapse consecutive repeated segments in a Figma node path.
- *
- * Delimiter: " > " (space-angle-space).
- * Collapsed runs use the multiplication sign × (U+00D7).
- *
- * Examples:
- *   "A > B > C"                              → "A > B > C"          (unchanged)
- *   "A > B > B > C"                          → "A > B×2 > C"
- *   "Container > Container > Container > X"  → "Container×3 > X"
- *   "A > A > A > A > A > B > C"             → "A×5 > B > C"
- *   "A"                                       → "A"                  (single)
- *   ""                                        → ""                   (empty)
- */
-export function collapseNodePath(path: string): string {
-  if (!path) return path;
-
-  const DELIMITER = ' > ';
-  const segments = path.split(DELIMITER);
-
-  const collapsed: string[] = [];
-  let i = 0;
-
-  while (i < segments.length) {
-    const current = segments[i];
-    let count = 1;
-
-    // Count consecutive identical segments
-    while (i + count < segments.length && segments[i + count] === current) {
-      count++;
-    }
-
-    collapsed.push(count > 1 ? `${current}×${count}` : current);
-    i += count;
-  }
-
-  return collapsed.join(DELIMITER);
-}