@3fn/core 13.0.0

package/src/generators/BlendValueGenerator.ts

@@ -0,0 +1,198 @@
+/**
+ * Blend Value Generator
+ * 
+ * Generates blend value constants for all platforms.
+ * Outputs blend100-blend500 constants in platform-appropriate format:
+ * - Web: export const blend100 = 0.04
+ * - iOS: static let blend100: Double = 0.04
+ * - Android: const val blend100 = 0.04f
+ * 
+ * Integrates with existing unified generator infrastructure.
+ */
+
+import { getAllBlendTokens, BLEND_BASE_VALUE } from '../tokens/BlendTokens';
+import { PrimitiveToken } from '../types/PrimitiveToken';
+
+export interface BlendValueGenerationOptions {
+  includeComments?: boolean;
+  includeBaseValue?: boolean;
+}
+
+/**
+ * Blend Value Generator
+ * Generates platform-specific blend value constants
+ */
+export class BlendValueGenerator {
+  /**
+   * Generate blend values for all platforms
+   */
+  generateAll(options: BlendValueGenerationOptions = {}): {
+    web: string;
+    ios: string;
+    android: string;
+  } {
+    return {
+      web: this.generateWebBlendValues(options),
+      ios: this.generateiOSBlendValues(options),
+      android: this.generateAndroidBlendValues(options)
+    };
+  }
+
+  /**
+   * Generate blend values for web platform (JavaScript/TypeScript)
+   */
+  generateWebBlendValues(options: BlendValueGenerationOptions = {}): string {
+    const { includeComments = true, includeBaseValue = true } = options;
+    const tokens = getAllBlendTokens();
+    const lines: string[] = [];
+
+    if (includeComments) {
+      lines.push('/**');
+      lines.push(' * Blend Value Constants');
+      lines.push(' * Base value: 0.04 (4%)');
+      lines.push(' * Scale: 5 tokens from 4% to 20% in 4% increments');
+      lines.push(' * Usage: Apply with blend utilities for color modification');
+      lines.push(' */');
+      lines.push('');
+    }
+
+    if (includeBaseValue) {
+      lines.push(`export const BLEND_BASE_VALUE = ${BLEND_BASE_VALUE};`);
+      lines.push('');
+    }
+
+    lines.push('export const BlendTokens = {');
+    
+    tokens.forEach((token, index) => {
+      const value = token.baseValue;
+      const isLast = index === tokens.length - 1;
+      
+      if (includeComments) {
+        lines.push(`  // ${token.description}`);
+        lines.push(`  // ${token.mathematicalRelationship}`);
+      }
+      
+      lines.push(`  ${token.name}: ${value}${isLast ? '' : ','}`);
+      
+      if (!isLast && includeComments) {
+        lines.push('');
+      }
+    });
+    
+    lines.push('};');
+
+    return lines.join('\n');
+  }
+
+  /**
+   * Generate blend values for iOS platform (Swift)
+   */
+  generateiOSBlendValues(options: BlendValueGenerationOptions = {}): string {
+    const { includeComments = true, includeBaseValue = true } = options;
+    const tokens = getAllBlendTokens();
+    const lines: string[] = [];
+
+    if (includeComments) {
+      lines.push('/**');
+      lines.push(' * Blend Value Constants');
+      lines.push(' * Base value: 0.04 (4%)');
+      lines.push(' * Scale: 5 tokens from 4% to 20% in 4% increments');
+      lines.push(' * Usage: Apply with blend utilities for color modification');
+      lines.push(' */');
+      lines.push('');
+    }
+
+    lines.push('struct BlendTokens {');
+    
+    if (includeBaseValue) {
+      lines.push(`  static let baseValue: Double = ${BLEND_BASE_VALUE}`);
+      lines.push('');
+    }
+
+    tokens.forEach((token) => {
+      const value = token.baseValue;
+      
+      if (includeComments) {
+        lines.push(`  // ${token.description}`);
+        lines.push(`  // ${token.mathematicalRelationship}`);
+      }
+      
+      lines.push(`  static let ${token.name}: Double = ${value}`);
+      
+      if (includeComments) {
+        lines.push('');
+      }
+    });
+    
+    lines.push('}');
+
+    return lines.join('\n');
+  }
+
+  /**
+   * Generate blend values for Android platform (Kotlin)
+   */
+  generateAndroidBlendValues(options: BlendValueGenerationOptions = {}): string {
+    const { includeComments = true, includeBaseValue = true } = options;
+    const tokens = getAllBlendTokens();
+    const lines: string[] = [];
+
+    if (includeComments) {
+      lines.push('/**');
+      lines.push(' * Blend Value Constants');
+      lines.push(' * Base value: 0.04 (4%)');
+      lines.push(' * Scale: 5 tokens from 4% to 20% in 4% increments');
+      lines.push(' * Usage: Apply with blend utilities for color modification');
+      lines.push(' */');
+      lines.push('');
+    }
+
+    lines.push('object BlendTokens {');
+    
+    if (includeBaseValue) {
+      lines.push(`  const val baseValue = ${BLEND_BASE_VALUE}f`);
+      lines.push('');
+    }
+
+    tokens.forEach((token) => {
+      const value = token.baseValue;
+      
+      if (includeComments) {
+        lines.push(`  // ${token.description}`);
+        lines.push(`  // ${token.mathematicalRelationship}`);
+      }
+      
+      lines.push(`  const val ${token.name} = ${value}f`);
+      
+      if (includeComments) {
+        lines.push('');
+      }
+    });
+    
+    lines.push('}');
+
+    return lines.join('\n');
+  }
+
+  /**
+   * Format blend value for specific platform
+   * Helper method for integration with existing generator infrastructure
+   */
+  formatBlendValue(platform: 'web' | 'ios' | 'android', name: string, value: number): string {
+    switch (platform) {
+      case 'web':
+        return `export const ${name} = ${value};`;
+      case 'ios':
+        return `static let ${name}: Double = ${value}`;
+      case 'android':
+        return `const val ${name} = ${value}f`;
+    }
+  }
+
+  /**
+   * Get blend tokens as array for iteration
+   */
+  getBlendTokens(): PrimitiveToken[] {
+    return getAllBlendTokens();
+  }
+}