@3fn/core 14.1.0 → 15.0.0

package/src/generators/TokenFileGenerator.ts

@@ -1,2075 +0,0 @@
-/**
- * Token File Generator
- * 
- * Orchestrates the generation of platform-specific token constant files.
- * Generates DesignTokens.web.css, DesignTokens.ios.swift, and DesignTokens.android.kt
- * with mathematical consistency across all platforms.
- * 
- * Also generates BlendUtilities for each platform via BlendUtilityGenerator integration.
- */
-
-import { PrimitiveToken, TokenCategory } from '../types/PrimitiveToken';
-import { SemanticToken, SemanticCategory } from '../types/SemanticToken';
-import { WebFormatGenerator } from '../providers/WebFormatGenerator';
-import { iOSFormatGenerator } from '../providers/iOSFormatGenerator';
-import { AndroidFormatGenerator } from '../providers/AndroidFormatGenerator';
-import { FileMetadata } from '../providers/FormatProvider';
-import { getAllPrimitiveTokens, durationTokens, easingTokens, scaleTokens } from '../tokens';
-import { getAllSemanticTokens, getAllZIndexTokens, getAllElevationTokens, motionTokens } from '../tokens/semantic';
-import { BlendUtilityGenerator, BlendUtilityGenerationOptions } from './BlendUtilityGenerator';
-import { ComponentTokenRegistry, RegisteredComponentToken } from '../registries/ComponentTokenRegistry';
-import { allComposedColors } from '../tokens/color';
-import { colorHues, neutralHue } from '../tokens/color/channels/hues';
-import {
-  pinkLightness, orangeLightness, yellowLightness, greenLightness,
-  cyanLightness, tealLightness, purpleLightness,
-} from '../tokens/color/channels/lightness/chromatic';
-import {
-  pinkChroma, orangeChroma, yellowChroma, greenChroma,
-  cyanChroma, tealChroma, purpleChroma,
-} from '../tokens/color/channels/chroma/chromatic';
-import { whiteLightness, grayLightness, blackLightness } from '../tokens/color/channels/lightness/neutral';
-import { whiteChroma, grayChroma, blackChroma } from '../tokens/color/channels/chroma/neutral';
-
-export interface BaseGenerationOptions {
-  outputDir?: string;
-  version?: string;
-  includeComments?: boolean;
-  groupByCategory?: boolean;
-}
-
-export interface GenerationOptions extends BaseGenerationOptions {
-  /** Resolved primitive tokens from the configured source. When omitted, loads from package. */
-  primitiveTokens?: PrimitiveToken[];
-  /** Pre-resolved semantic tokens (light-base context). Generators require externally-resolved tokens (D9 Option B). */
-  semanticTokens: Array<Omit<SemanticToken, 'primitiveTokens'>>;
-  /** Pre-resolved semantic tokens (dark-base context). Used with semanticTokens to produce mode-aware output. */
-  darkSemanticTokens: Array<Omit<SemanticToken, 'primitiveTokens'>>;
-  /** Pre-resolved semantic tokens (light-wcag context). When provided, generates WCAG theme overrides. */
-  wcagSemanticTokens?: Array<Omit<SemanticToken, 'primitiveTokens'>>;
-  /** Pre-resolved semantic tokens (dark-wcag context). Used with wcagSemanticTokens for mode-aware WCAG output. */
-  darkWcagSemanticTokens?: Array<Omit<SemanticToken, 'primitiveTokens'>>;
-  /** Token names that have WCAG semantic overrides (Level 2). Only these appear in the WCAG override block. */
-  wcagOverrideKeys?: Set<string>;
-  /** Registered theme override sets for generalized theme block generation (Spec 094). */
-  themeOverrides?: ThemeOverrideSet[];
-  /** Token names that have moved to theme types — excluded from static iOS/Android output (Spec 094). */
-  themeVaryingTokens?: Set<string>;
-}
-
-/**
- * A resolved theme override set for generation.
- * Generalizes the WCAG-specific fields to support any registered theme.
- *
- * @see Spec 094 design.md § "Platform Generators (Modified)"
- */
-export interface ThemeOverrideSet {
-  /** Theme name used in CSS `data-theme` attribute and generated type names. */
-  name: string;
-  /** Theme mode: 'dark' = dark-only, 'light' = light-only, 'both' = light-dark(). */
-  mode: 'dark' | 'light' | 'both';
-  /** Resolved light tokens for this theme (or the only tokens if mode is 'light'). */
-  lightTokens: Array<Omit<SemanticToken, 'primitiveTokens'>>;
-  /** Resolved dark tokens for this theme (or the only tokens if mode is 'dark'). */
-  darkTokens: Array<Omit<SemanticToken, 'primitiveTokens'>>;
-  /** Token names that have overrides in this theme. Only these appear in the override block. */
-  overrideKeys: Set<string>;
-}
-
-export interface GenerationResult {
-  platform: 'web' | 'ios' | 'android';
-  filePath: string;
-  content: string;
-  tokenCount: number;
-  semanticTokenCount: number;
-  valid: boolean;
-  errors?: string[];
-  warnings?: string[];
-}
-
-export interface BlendUtilityResult {
-  platform: 'web' | 'ios' | 'android';
-  filePath: string;
-  content: string;
-  valid: boolean;
-  errors?: string[];
-}
-
-export interface AllGenerationResults {
-  tokens: GenerationResult[];
-  blendUtilities: BlendUtilityResult[];
-}
-
-/**
- * Result of component token generation for a single platform
- */
-export interface ComponentTokenGenerationResult {
-  platform: 'web' | 'ios' | 'android';
-  filePath: string;
-  content: string;
-  tokenCount: number;
-  componentCount: number;
-  valid: boolean;
-  errors?: string[];
-  warnings?: string[];
-}
-
-/**
- * Token File Generator
- * Generates platform-specific token constant files with mathematical consistency
- */
-export class TokenFileGenerator {
-  private webGenerator: WebFormatGenerator;
-  private iosGenerator: iOSFormatGenerator;
-  private androidGenerator: AndroidFormatGenerator;
-  private blendUtilityGenerator: BlendUtilityGenerator;
-
-  constructor() {
-    this.webGenerator = new WebFormatGenerator();
-    this.iosGenerator = new iOSFormatGenerator();
-    this.androidGenerator = new AndroidFormatGenerator('kotlin');
-    this.blendUtilityGenerator = new BlendUtilityGenerator();
-  }
-
-  /**
-   * Generate all platform-specific token files
-   */
-  generateAll(options: GenerationOptions): GenerationResult[] {
-    const results: GenerationResult[] = [];
-
-    results.push(this.generateWebTokens(options));
-    results.push(this.generateiOSTokens(options));
-    results.push(this.generateAndroidTokens(options));
-
-    return results;
-  }
-
-  /**
-   * Generate all platform-specific token files AND blend utilities
-   * This is the comprehensive generation method that produces all artifacts
-   */
-  generateAllWithBlendUtilities(options: GenerationOptions): AllGenerationResults {
-    const tokenResults = this.generateAll(options);
-    const blendResults = this.generateBlendUtilities(options);
-
-    return {
-      tokens: tokenResults,
-      blendUtilities: blendResults
-    };
-  }
-
-  /**
-   * Generate blend utilities for all platforms
-   * 
-   * @param options - Generation options
-   * @returns Array of blend utility generation results
-   */
-  generateBlendUtilities(options: BaseGenerationOptions = {}): BlendUtilityResult[] {
-    const { outputDir = 'output', includeComments = true } = options;
-    const blendOptions: BlendUtilityGenerationOptions = { includeComments };
-    const results: BlendUtilityResult[] = [];
-
-    // Generate Web blend utilities
-    try {
-      const webContent = this.blendUtilityGenerator.generateWebBlendUtilities(blendOptions);
-      results.push({
-        platform: 'web',
-        filePath: `${outputDir}/BlendUtilities.web.ts`,
-        content: webContent,
-        valid: this.validateWebBlendUtilitySyntax(webContent)
-      });
-    } catch (error) {
-      results.push({
-        platform: 'web',
-        filePath: `${outputDir}/BlendUtilities.web.ts`,
-        content: '',
-        valid: false,
-        errors: [`Web blend utility generation failed: ${error instanceof Error ? error.message : String(error)}`]
-      });
-    }
-
-    // Generate iOS blend utilities
-    try {
-      const iosContent = this.blendUtilityGenerator.generateiOSBlendUtilities(blendOptions);
-      results.push({
-        platform: 'ios',
-        filePath: `${outputDir}/BlendUtilities.ios.swift`,
-        content: iosContent,
-        valid: this.validateiOSBlendUtilitySyntax(iosContent)
-      });
-    } catch (error) {
-      results.push({
-        platform: 'ios',
-        filePath: `${outputDir}/BlendUtilities.ios.swift`,
-        content: '',
-        valid: false,
-        errors: [`iOS blend utility generation failed: ${error instanceof Error ? error.message : String(error)}`]
-      });
-    }
-
-    // Generate Android blend utilities
-    try {
-      const androidContent = this.blendUtilityGenerator.generateAndroidBlendUtilities(blendOptions);
-      results.push({
-        platform: 'android',
-        filePath: `${outputDir}/BlendUtilities.android.kt`,
-        content: androidContent,
-        valid: this.validateAndroidBlendUtilitySyntax(androidContent)
-      });
-    } catch (error) {
-      results.push({
-        platform: 'android',
-        filePath: `${outputDir}/BlendUtilities.android.kt`,
-        content: '',
-        valid: false,
-        errors: [`Android blend utility generation failed: ${error instanceof Error ? error.message : String(error)}`]
-      });
-    }
-
-    return results;
-  }
-
-  /**
-   * Generate component tokens for all platforms
-   * 
-   * Queries ComponentTokenRegistry.getAll() for tokens to generate.
-   * Generates output grouped by component.
-   * Maintains primitive token references in output (not inline values).
-   * 
-   * @param options - Generation options
-   * @returns Array of component token generation results for each platform
-   * 
-   * @see Requirements 5.1, 5.2, 5.3, 5.4 in .kiro/specs/037-component-token-generation-pipeline/requirements.md
-   */
-  generateComponentTokens(options: BaseGenerationOptions = {}): ComponentTokenGenerationResult[] {
-    const { outputDir = 'dist', version = '1.0.0', includeComments = true } = options;
-    const results: ComponentTokenGenerationResult[] = [];
-
-    // Get all registered component tokens
-    const allTokens = ComponentTokenRegistry.getAll();
-    
-    // Group tokens by component
-    const tokensByComponent = this.groupTokensByComponent(allTokens);
-    const componentCount = Object.keys(tokensByComponent).length;
-
-    // Generate for each platform
-    results.push(this.generateWebComponentTokens(tokensByComponent, outputDir, version, includeComments));
-    results.push(this.generateiOSComponentTokens(tokensByComponent, outputDir, version, includeComments));
-    results.push(this.generateAndroidComponentTokens(tokensByComponent, outputDir, version, includeComments));
-
-    return results;
-  }
-
-  /**
-   * Group component tokens by component name
-   * 
-   * @param tokens - Array of registered component tokens
-   * @returns Map of component name to tokens
-   */
-  private groupTokensByComponent(tokens: RegisteredComponentToken[]): Record<string, RegisteredComponentToken[]> {
-    const grouped: Record<string, RegisteredComponentToken[]> = {};
-    
-    for (const token of tokens) {
-      if (!grouped[token.component]) {
-        grouped[token.component] = [];
-      }
-      grouped[token.component].push(token);
-    }
-    
-    return grouped;
-  }
-
-  /**
-   * Generate Web CSS component tokens
-   * 
-   * Generates CSS custom properties referencing primitive tokens.
-   * Format: --button-icon-inset-large: var(--space-150);
-   * 
-   * @param tokensByComponent - Tokens grouped by component
-   * @param outputDir - Output directory
-   * @param version - Version string
-   * @param includeComments - Whether to include comments
-   * @returns Generation result for web platform
-   */
-  private generateWebComponentTokens(
-    tokensByComponent: Record<string, RegisteredComponentToken[]>,
-    outputDir: string,
-    version: string,
-    includeComments: boolean
-  ): ComponentTokenGenerationResult {
-    const lines: string[] = [];
-    const timestamp = new Date().toISOString();
-    let tokenCount = 0;
-
-    // Header
-    lines.push('/**');
-    lines.push(' * DesignerPunk Design System - Component Tokens');
-    lines.push(` * Generated: ${timestamp}`);
-    lines.push(` * Version: ${version}`);
-    lines.push(' * Platform: Web (CSS Custom Properties)');
-    lines.push(' *');
-    lines.push(' * Component-specific tokens that reference primitive tokens.');
-    lines.push(' * Use these for component-level styling consistency.');
-    lines.push(' */');
-    lines.push('');
-    lines.push(':root {');
-
-    // Generate tokens grouped by component
-    const components = Object.keys(tokensByComponent).sort();
-    
-    for (const component of components) {
-      const tokens = tokensByComponent[component];
-      
-      if (includeComments) {
-        lines.push('');
-        lines.push(`  /* ${component} Component Tokens */`);
-      }
-      
-      for (const token of tokens) {
-        const cssTokenName = this.formatWebComponentTokenName(token);
-        const cssValue = this.formatWebComponentTokenValue(token);
-        
-        if (includeComments && token.reasoning) {
-          lines.push(`  /* ${token.reasoning} */`);
-        }
-        
-        lines.push(`  ${cssTokenName}: ${cssValue};`);
-        tokenCount++;
-      }
-    }
-
-    lines.push('}');
-
-    const content = lines.join('\n');
-    const validation = this.validateWebComponentTokenSyntax(content);
-
-    return {
-      platform: 'web',
-      filePath: `${outputDir}/ComponentTokens.web.css`,
-      content,
-      tokenCount,
-      componentCount: components.length,
-      valid: validation.valid,
-      errors: validation.errors
-    };
-  }
-
-  /**
-   * Generate iOS Swift component tokens
-   * 
-   * Generates Swift constants referencing primitive tokens.
-   * Format: public static let insetLarge: CGFloat = SpacingTokens.space150
-   * 
-   * @param tokensByComponent - Tokens grouped by component
-   * @param outputDir - Output directory
-   * @param version - Version string
-   * @param includeComments - Whether to include comments
-   * @returns Generation result for iOS platform
-   */
-  private generateiOSComponentTokens(
-    tokensByComponent: Record<string, RegisteredComponentToken[]>,
-    outputDir: string,
-    version: string,
-    includeComments: boolean
-  ): ComponentTokenGenerationResult {
-    const lines: string[] = [];
-    const timestamp = new Date().toISOString();
-    let tokenCount = 0;
-
-    // Header
-    lines.push('///');
-    lines.push('/// DesignerPunk Design System - Component Tokens');
-    lines.push(`/// Generated: ${timestamp}`);
-    lines.push(`/// Version: ${version}`);
-    lines.push('/// Platform: iOS (Swift Constants)');
-    lines.push('///');
-    lines.push('/// Component-specific tokens that reference primitive tokens.');
-    lines.push('/// Use these for component-level styling consistency.');
-    lines.push('///');
-    lines.push('');
-    lines.push('import UIKit');
-    lines.push('');
-
-    // Generate tokens grouped by component (each component as an enum)
-    const components = Object.keys(tokensByComponent).sort();
-    
-    for (const component of components) {
-      const tokens = tokensByComponent[component];
-      const enumName = `${component}Tokens`;
-      
-      if (includeComments) {
-        lines.push(`/// ${component} Component Tokens`);
-      }
-      lines.push(`public enum ${enumName} {`);
-      
-      for (const token of tokens) {
-        const swiftConstName = this.formatiOSComponentTokenName(token);
-        const swiftType = this.getiOSComponentTokenType(token);
-        const swiftValue = this.formatiOSComponentTokenValue(token);
-        
-        if (includeComments && token.reasoning) {
-          lines.push(`    /// ${token.reasoning}`);
-        }
-        
-        lines.push(`    public static let ${swiftConstName}: ${swiftType} = ${swiftValue}`);
-        tokenCount++;
-      }
-      
-      lines.push('}');
-      lines.push('');
-    }
-
-    const content = lines.join('\n');
-    const validation = this.validateiOSComponentTokenSyntax(content);
-
-    return {
-      platform: 'ios',
-      filePath: `${outputDir}/ComponentTokens.ios.swift`,
-      content,
-      tokenCount,
-      componentCount: components.length,
-      valid: validation.valid,
-      errors: validation.errors
-    };
-  }
-
-  /**
-   * Generate Android Kotlin component tokens
-   * 
-   * Generates Kotlin constants referencing primitive tokens.
-   * Format: val insetLarge = SpacingTokens.space150
-   * 
-   * @param tokensByComponent - Tokens grouped by component
-   * @param outputDir - Output directory
-   * @param version - Version string
-   * @param includeComments - Whether to include comments
-   * @returns Generation result for Android platform
-   */
-  private generateAndroidComponentTokens(
-    tokensByComponent: Record<string, RegisteredComponentToken[]>,
-    outputDir: string,
-    version: string,
-    includeComments: boolean
-  ): ComponentTokenGenerationResult {
-    const lines: string[] = [];
-    const timestamp = new Date().toISOString();
-    let tokenCount = 0;
-
-    // Header
-    lines.push('/**');
-    lines.push(' * DesignerPunk Design System - Component Tokens');
-    lines.push(` * Generated: ${timestamp}`);
-    lines.push(` * Version: ${version}`);
-    lines.push(' * Platform: Android (Kotlin Constants)');
-    lines.push(' *');
-    lines.push(' * Component-specific tokens that reference primitive tokens.');
-    lines.push(' * Use these for component-level styling consistency.');
-    lines.push(' */');
-    lines.push('');
-    lines.push('package com.designerpunk.tokens');
-    lines.push('');
-
-    // Generate tokens grouped by component (each component as an object)
-    const components = Object.keys(tokensByComponent).sort();
-    
-    for (const component of components) {
-      const tokens = tokensByComponent[component];
-      const objectName = `${component}Tokens`;
-      
-      if (includeComments) {
-        lines.push(`/** ${component} Component Tokens */`);
-      }
-      lines.push(`object ${objectName} {`);
-      
-      for (const token of tokens) {
-        const kotlinConstName = this.formatAndroidComponentTokenName(token);
-        const kotlinValue = this.formatAndroidComponentTokenValue(token);
-        
-        if (includeComments && token.reasoning) {
-          lines.push(`    // ${token.reasoning}`);
-        }
-        
-        lines.push(`    val ${kotlinConstName} = ${kotlinValue}`);
-        tokenCount++;
-      }
-      
-      lines.push('}');
-      lines.push('');
-    }
-
-    const content = lines.join('\n');
-    const validation = this.validateAndroidComponentTokenSyntax(content);
-
-    return {
-      platform: 'android',
-      filePath: `${outputDir}/ComponentTokens.android.kt`,
-      content,
-      tokenCount,
-      componentCount: components.length,
-      valid: validation.valid,
-      errors: validation.errors
-    };
-  }
-
-  /**
-   * Format component token name for Web CSS
-   * Converts 'buttonicon.inset.large' to '--button-icon-inset-large'
-   */
-  private formatWebComponentTokenName(token: RegisteredComponentToken): string {
-    // Convert component.property.variant to kebab-case CSS custom property
-    const parts = token.name.split('.');
-    const kebabName = parts.map(part => 
-      part.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase()
-    ).join('-');
-    return `--${kebabName}`;
-  }
-
-  /**
-   * Format component token value for Web CSS
-   * Returns var(--space-150) for primitive references, or raw value
-   */
-  private formatWebComponentTokenValue(token: RegisteredComponentToken): string {
-    if (token.primitiveReference) {
-      // Convert primitive reference to CSS custom property reference
-      // e.g., 'space150' -> 'var(--space-150)'
-      const cssRef = token.primitiveReference
-        .replace(/([a-z])([A-Z])/g, '$1-$2')
-        .replace(/([a-zA-Z])(\d)/g, '$1-$2')
-        .toLowerCase();
-      return `var(--${cssRef})`;
-    }
-    // Return raw value for non-reference tokens
-    return String(token.value);
-  }
-
-  /**
-   * Format component token name for iOS Swift
-   * Converts 'buttonicon.inset.large' to 'insetLarge'
-   */
-  private formatiOSComponentTokenName(token: RegisteredComponentToken): string {
-    // Extract property name from full token name (remove component prefix)
-    const parts = token.name.split('.');
-    // Skip the component name (first part), join remaining parts in camelCase
-    const propertyParts = parts.slice(1);
-    if (propertyParts.length === 0) {
-      return parts[0];
-    }
-    return propertyParts.map((part, index) => 
-      index === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1)
-    ).join('');
-  }
-
-  /**
-   * Get Swift type for component token based on family
-   */
-  private getiOSComponentTokenType(token: RegisteredComponentToken): string {
-    switch (token.family) {
-      case 'spacing':
-      case 'sizing':
-      case 'radius':
-      case 'fontSize':
-      case 'tapArea':
-      case 'borderWidth':
-        return 'CGFloat';
-      case 'color':
-        return 'UIColor';
-      default:
-        return 'CGFloat';
-    }
-  }
-
-  /**
-   * Format component token value for iOS Swift
-   * Returns SpacingTokens.space150 for primitive references, or raw value
-   */
-  private formatiOSComponentTokenValue(token: RegisteredComponentToken): string {
-    if (token.primitiveReference) {
-      // Convert primitive reference to Swift constant reference
-      // e.g., 'space150' -> 'SpacingTokens.space150'
-      const familyClass = this.getFamilyClassName(token.family);
-      return `${familyClass}.${token.primitiveReference}`;
-    }
-    // Return raw value for non-reference tokens
-    return String(token.value);
-  }
-
-  /**
-   * Format component token name for Android Kotlin
-   * Converts 'buttonicon.inset.large' to 'insetLarge'
-   */
-  private formatAndroidComponentTokenName(token: RegisteredComponentToken): string {
-    // Same as iOS - extract property name from full token name
-    const parts = token.name.split('.');
-    const propertyParts = parts.slice(1);
-    if (propertyParts.length === 0) {
-      return parts[0];
-    }
-    return propertyParts.map((part, index) => 
-      index === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1)
-    ).join('');
-  }
-
-  /**
-   * Format component token value for Android Kotlin
-   * Returns SpacingTokens.space150 for primitive references, or raw value
-   */
-  private formatAndroidComponentTokenValue(token: RegisteredComponentToken): string {
-    if (token.primitiveReference) {
-      // Convert primitive reference to Kotlin constant reference
-      // e.g., 'space150' -> 'SpacingTokens.space150'
-      const familyClass = this.getFamilyClassName(token.family);
-      return `${familyClass}.${token.primitiveReference}`;
-    }
-    // Dimensional families need .dp suffix to match primitive token output (Task 1.4).
-    // 'sizing' is dimensional (component width/height) and belongs here: without it, a
-    // value-path sizing token emits a bare Int, which fails to compile against consumers
-    // that type the member as Dp (e.g. Avatar.android.kt's
-    // `val iconSizeXs: Dp = GeneratedAvatarTokens.iconSizeXs`).
-    const dimensionalFamilies = ['spacing', 'sizing', 'radius', 'tapArea', 'fontSize', 'borderWidth'];
-    if (dimensionalFamilies.includes(token.family)) {
-      return `${token.value}.dp`;
-    }
-    return String(token.value);
-  }
-
-  /**
-   * Get the class name for a token family
-   * Used for generating primitive token references
-   */
-  private getFamilyClassName(family: string): string {
-    const familyClassMap: Record<string, string> = {
-      'spacing': 'SpacingTokens',
-      'sizing': 'SizingTokens',
-      'radius': 'RadiusTokens',
-      'fontSize': 'FontSizeTokens',
-      'color': 'ColorTokens',
-      'tapArea': 'TapAreaTokens',
-      'borderWidth': 'BorderWidthTokens',
-      'lineHeight': 'LineHeightTokens',
-      'fontWeight': 'FontWeightTokens',
-      'fontFamily': 'FontFamilyTokens'
-    };
-    return familyClassMap[family] || `${family.charAt(0).toUpperCase() + family.slice(1)}Tokens`;
-  }
-
-  /**
-   * Validate Web component token CSS syntax
-   */
-  private validateWebComponentTokenSyntax(content: string): { valid: boolean; errors?: string[] } {
-    const errors: string[] = [];
-
-    // Check for :root selector
-    if (!content.includes(':root {')) {
-      errors.push('Missing :root selector');
-    }
-
-    // Check for balanced braces
-    const openBraces = (content.match(/{/g) || []).length;
-    const closeBraces = (content.match(/}/g) || []).length;
-    if (openBraces !== closeBraces) {
-      errors.push('Unbalanced braces in CSS');
-    }
-
-    return {
-      valid: errors.length === 0,
-      errors: errors.length > 0 ? errors : undefined
-    };
-  }
-
-  /**
-   * Validate iOS component token Swift syntax
-   */
-  private validateiOSComponentTokenSyntax(content: string): { valid: boolean; errors?: string[] } {
-    const errors: string[] = [];
-
-    // Check for UIKit import
-    if (!content.includes('import UIKit')) {
-      errors.push('Missing UIKit import');
-    }
-
-    // Check for balanced braces
-    const openBraces = (content.match(/{/g) || []).length;
-    const closeBraces = (content.match(/}/g) || []).length;
-    if (openBraces !== closeBraces) {
-      errors.push('Unbalanced braces in Swift');
-    }
-
-    return {
-      valid: errors.length === 0,
-      errors: errors.length > 0 ? errors : undefined
-    };
-  }
-
-  /**
-   * Validate Android component token Kotlin syntax
-   */
-  private validateAndroidComponentTokenSyntax(content: string): { valid: boolean; errors?: string[] } {
-    const errors: string[] = [];
-
-    // Check for package declaration
-    if (!content.includes('package com.designerpunk.tokens')) {
-      errors.push('Missing package declaration');
-    }
-
-    // Check for balanced braces
-    const openBraces = (content.match(/{/g) || []).length;
-    const closeBraces = (content.match(/}/g) || []).length;
-    if (openBraces !== closeBraces) {
-      errors.push('Unbalanced braces in Kotlin');
-    }
-
-    return {
-      valid: errors.length === 0,
-      errors: errors.length > 0 ? errors : undefined
-    };
-  }
-
-  /**
-   * Validate Web blend utility TypeScript syntax
-   * Basic validation to ensure generated code has expected structure
-   */
-  private validateWebBlendUtilitySyntax(content: string): boolean {
-    // Check for required function exports
-    const requiredFunctions = ['darkerBlend', 'lighterBlend', 'saturate', 'desaturate'];
-    const hasAllFunctions = requiredFunctions.every(fn => 
-      content.includes(`export function ${fn}`)
-    );
-
-    // Check for required type definitions
-    const hasRgbInterface = content.includes('interface RGB');
-    const hasHslInterface = content.includes('interface HSL');
-
-    // Check for required utility functions
-    const hasHexToRgb = content.includes('function hexToRgb');
-    const hasRgbToHex = content.includes('function rgbToHex');
-
-    return hasAllFunctions && hasRgbInterface && hasHslInterface && hasHexToRgb && hasRgbToHex;
-  }
-
-  /**
-   * Validate iOS blend utility Swift syntax
-   * Basic validation to ensure generated code has expected structure
-   */
-  private validateiOSBlendUtilitySyntax(content: string): boolean {
-    // Check for required imports
-    const hasSwiftUIImport = content.includes('import SwiftUI');
-
-    // Check for Color extension
-    const hasColorExtension = content.includes('extension Color');
-
-    // Check for required methods
-    const requiredMethods = ['darkerBlend', 'lighterBlend', 'saturate', 'desaturate'];
-    const hasAllMethods = requiredMethods.every(method => 
-      content.includes(`func ${method}`)
-    );
-
-    // Check for required structs
-    const hasRgbStruct = content.includes('struct RGB');
-    const hasHslStruct = content.includes('struct HSL');
-
-    return hasSwiftUIImport && hasColorExtension && hasAllMethods && hasRgbStruct && hasHslStruct;
-  }
-
-  /**
-   * Validate Android blend utility Kotlin syntax
-   * Basic validation to ensure generated code has expected structure
-   */
-  private validateAndroidBlendUtilitySyntax(content: string): boolean {
-    // Check for required package and imports
-    const hasPackage = content.includes('package com.designerpunk.tokens');
-    const hasColorImport = content.includes('import androidx.compose.ui.graphics.Color');
-
-    // Check for required extension functions
-    const requiredFunctions = ['darkerBlend', 'lighterBlend', 'saturate', 'desaturate'];
-    const hasAllFunctions = requiredFunctions.every(fn => 
-      content.includes(`fun Color.${fn}`)
-    );
-
-    // Check for required data classes
-    const hasRgbClass = content.includes('data class RGB');
-    const hasHslClass = content.includes('data class HSL');
-
-    return hasPackage && hasColorImport && hasAllFunctions && hasRgbClass && hasHslClass;
-  }
-
-  /**
-   * Generate semantic token section for specified platform
-   * Handles both single-reference and multi-reference tokens
-   * 
-   * @param semantics - Array of semantic tokens to generate
-   * @param platform - Target platform ('web', 'ios', or 'android')
-   * @returns Array of formatted token strings
-   */
-  private generateSemanticSection(
-    semantics: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    platform: 'web' | 'ios' | 'android',
-    darkSemantics?: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    excludeTokenNames?: Set<string>
-  ): string[] {
-    const lines: string[] = [];
-
-    // Select appropriate generator based on platform
-    let generator: WebFormatGenerator | iOSFormatGenerator | AndroidFormatGenerator;
-
-    switch (platform) {
-      case 'web':
-        generator = this.webGenerator;
-        break;
-      case 'ios':
-        generator = this.iosGenerator;
-        break;
-      case 'android':
-        generator = this.androidGenerator;
-        break;
-      default:
-        return lines;
-    }
-
-    // Build dark token lookup for mode-aware output
-    const darkMap = new Map<string, Omit<SemanticToken, 'primitiveTokens'>>();
-    if (darkSemantics) {
-      for (const dt of darkSemantics) {
-        darkMap.set(dt.name, dt);
-      }
-    }
-
-    // Iterate over semantic tokens
-    for (const semantic of semantics) {
-      // Skip tokens without primitiveReferences (e.g., semantic-only layering tokens)
-      if (!semantic.primitiveReferences) {
-        continue;
-      }
-
-      // Skip tokens that have moved to theme types (Spec 094 — prevents dual-pattern consumption)
-      if (excludeTokenNames && excludeTokenNames.has(semantic.name)) {
-        continue;
-      }
-      
-      // Special handling for ICON category tokens with fontSize/multiplier (icon sizes)
-      // Icon property tokens (like strokeWidth) are handled as single-reference tokens below
-      if (semantic.category === 'icon' && semantic.primitiveReferences.fontSize && semantic.primitiveReferences.multiplier) {
-        const iconLine = this.generateIconSizeToken(semantic, platform, generator);
-        if (iconLine) {
-          lines.push(iconLine);
-        }
-        continue;
-      }
-      
-      // Detect single-reference vs multi-reference tokens
-      // Single-reference tokens have:
-      // - Only one key in primitiveReferences, OR
-      // - A 'value' or 'default' key (standard single-reference pattern), OR
-      // - 'color' and 'opacity' keys (opacity composition pattern)
-      const refs = Object.keys(semantic.primitiveReferences);
-      const isOpacityComposition = refs.includes('color') && refs.includes('opacity') && refs.length === 2;
-      const isSingleReference = refs.length === 1 ||
-        refs.includes('value') ||
-        refs.includes('default') ||
-        isOpacityComposition;
-
-      // Call appropriate formatter method for each token based on reference type
-      let lightLine: string;
-      if (isSingleReference) {
-        lightLine = generator.formatSingleReferenceToken(semantic as SemanticToken);
-      } else {
-        lightLine = generator.formatMultiReferenceToken(semantic as SemanticToken);
-      }
-
-      // Mode-aware output: wrap in light-dark() when dark value differs (web only)
-      const darkToken = darkMap.get(semantic.name);
-      if (darkToken) {
-        let darkLine: string;
-        if (isSingleReference) {
-          darkLine = generator.formatSingleReferenceToken(darkToken as SemanticToken);
-        } else {
-          darkLine = generator.formatMultiReferenceToken(darkToken as SemanticToken);
-        }
-
-        const lightParts = this.extractFormattedParts(lightLine);
-        const darkParts = this.extractFormattedParts(darkLine);
-
-        if (lightParts && darkParts && lightParts.value !== darkParts.value) {
-          if (platform === 'web') {
-            lines.push(`  ${lightParts.name}: light-dark(${lightParts.value}, ${darkParts.value});`);
-            continue;
-          }
-          if (platform === 'ios') {
-            lines.push(
-              `    public static let ${lightParts.name}: UIColor = UIColor { $0.userInterfaceStyle == .dark ? ${darkParts.value} : ${lightParts.value} }`
-            );
-            continue;
-          }
-          if (platform === 'android') {
-            lines.push(
-              `    val ${lightParts.name}_light = ${lightParts.value}`
-            );
-            lines.push(
-              `    val ${lightParts.name}_dark = ${darkParts.value}`
-            );
-            continue;
-          }
-        }
-      }
-
-      lines.push(lightLine);
-    }
-
-    return lines;
-  }
-
-  /**
-   * Generate WCAG theme override block from 4-context resolved token sets (Spec 080 Phase 2).
-   * Compares base vs wcag tokens — emits overrides only where values differ.
-   */
-  private generateWcagOverrideBlock(
-    lightBase: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    darkBase: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    lightWcag: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    darkWcag: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    platform: 'web' | 'ios' | 'android',
-    wcagKeys?: Set<string>
-  ): string[] {
-    const lines: string[] = [];
-
-    // Build lookup maps
-    const lbMap = new Map(lightBase.map(t => [t.name, t]));
-    const dbMap = new Map(darkBase.map(t => [t.name, t]));
-    const lwMap = new Map(lightWcag.map(t => [t.name, t]));
-    const dwMap = new Map(darkWcag.map(t => [t.name, t]));
-
-    // Find color tokens where wcag override changes the primitive reference (Level 2 only).
-    // Tokens where only the primitive's own wcag slot differs are handled by the primitive layer.
-    const overrides: Array<{ token: Omit<SemanticToken, 'primitiveTokens'>; lwVal: string; dwVal: string; lbVal: string; dbVal: string }> = [];
-    for (const [name, lbToken] of lbMap) {
-      if (lbToken.category !== SemanticCategory.COLOR) continue;
-      if (wcagKeys && !wcagKeys.has(name)) continue;
-      const lwToken = lwMap.get(name);
-      const dbToken = dbMap.get(name);
-      const dwToken = dwMap.get(name);
-      if (!lwToken || !dbToken || !dwToken) continue;
-
-      const getVal = (t: Omit<SemanticToken, 'primitiveTokens'>) =>
-        t.primitiveReferences?.value ?? t.primitiveReferences?.default ?? Object.values(t.primitiveReferences || {})[0] ?? '';
-
-      overrides.push({ token: lbToken, lwVal: getVal(lwToken), dwVal: getVal(dwToken), lbVal: getVal(lbToken), dbVal: getVal(dbToken) });
-    }
-
-    if (overrides.length === 0) return lines;
-
-    // Helper: rgba string → iOS UIColor
-    const toIOS = (rgba: string) => {
-      const m = rgba.match(/rgba\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*,\s*([\d.]+)\s*\)/);
-      if (!m) return rgba;
-      return `UIColor(red: ${(+m[1]/255).toFixed(2)}, green: ${(+m[2]/255).toFixed(2)}, blue: ${(+m[3]/255).toFixed(2)}, alpha: ${(+m[4]).toFixed(2)})`;
-    };
-
-    // Helper: rgba string → Android Color.argb
-    const toAndroid = (rgba: string) => {
-      const m = rgba.match(/rgba\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*,\s*([\d.]+)\s*\)/);
-      if (!m) return rgba;
-      return `Color.argb(${Math.round(+m[4] * 255)}, ${m[1]}, ${m[2]}, ${m[3]})`;
-    };
-
-    switch (platform) {
-      case 'web': {
-        lines.push('');
-        lines.push('/* WCAG Theme: Semantic token overrides from theme files (Spec 080 Phase 2) */');
-        lines.push(':root[data-theme="wcag"] {');
-        for (const o of overrides) {
-          const name = this.webGenerator.getTokenName(o.token.name, o.token.category);
-          const cssName = name.startsWith('--') ? name : `--${name}`;
-          const value = o.lwVal !== o.dwVal
-            ? `light-dark(${o.lwVal}, ${o.dwVal})`
-            : o.lwVal;
-          lines.push(`  ${cssName}: ${value};`);
-        }
-        lines.push('}');
-        break;
-      }
-      case 'ios': {
-        lines.push('');
-        lines.push('    // MARK: - WCAG Theme Semantic Overrides (Spec 080 Phase 2)');
-        for (const o of overrides) {
-          const name = this.iosGenerator.getTokenName(o.token.name, o.token.category);
-          if (o.lwVal !== o.dwVal) {
-            lines.push(`    public static let ${name}_wcag: UIColor = UIColor { $0.userInterfaceStyle == .dark ? ${toIOS(o.dwVal)} : ${toIOS(o.lwVal)} }`);
-          } else {
-            lines.push(`    public static let ${name}_wcag: UIColor = ${toIOS(o.lwVal)}`);
-          }
-        }
-        break;
-      }
-      case 'android': {
-        lines.push('');
-        lines.push('    // WCAG Theme Semantic Overrides (Spec 080 Phase 2)');
-        for (const o of overrides) {
-          const name = this.androidGenerator.getTokenName(o.token.name, o.token.category);
-          if (o.lwVal !== o.dwVal) {
-            lines.push(`    val ${name}_wcag_light = ${toAndroid(o.lwVal)}`);
-            lines.push(`    val ${name}_wcag_dark = ${toAndroid(o.dwVal)}`);
-          } else {
-            lines.push(`    val ${name}_wcag = ${toAndroid(o.lwVal)}`);
-          }
-        }
-        break;
-      }
-    }
-
-    return lines;
-  }
-
-  /**
-   * Generate theme override blocks for any registered theme (Spec 094).
-   * Generalizes the WCAG-specific block to work with any ThemeOverrideSet.
-   *
-   * Web: produces `[data-theme="name"] { ... }` blocks after `:root` footer.
-   * iOS/Android: stub — full implementation in subtasks 2.3/2.4.
-   */
-  generateThemeOverrideBlocks(
-    platform: 'web' | 'ios' | 'android',
-    baseLight: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    baseDark: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    themeOverrides: ThemeOverrideSet[],
-    name: string = 'DesignerPunk',
-    abbreviation: string = 'DP'
-  ): string[] {
-    const lines: string[] = [];
-    switch (platform) {
-      case 'web':
-        for (const theme of themeOverrides) {
-          lines.push(...this.generateWebThemeBlock(baseLight, baseDark, theme));
-        }
-        break;
-      case 'ios':
-        lines.push(...this.generateSwiftThemeTypes(baseLight, baseDark, themeOverrides, name, abbreviation));
-        break;
-      case 'android':
-        lines.push(...this.generateKotlinThemeTypes(baseLight, baseDark, themeOverrides, name, abbreviation));
-        break;
-    }
-    return lines;
-  }
-
-  /**
-   * Generate a single web CSS theme override block.
-   * Produces `:root[data-theme="name"] { ... }` with overridden tokens.
-   * Dark-only themes include `color-scheme: dark` and use static values (no light-dark()).
-   */
-  private generateWebThemeBlock(
-    baseLight: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    baseDark: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    theme: ThemeOverrideSet
-  ): string[] {
-    const lines: string[] = [];
-
-    const lbMap = new Map(baseLight.map(t => [t.name, t]));
-    const dbMap = new Map(baseDark.map(t => [t.name, t]));
-    const ltMap = new Map(theme.lightTokens.map(t => [t.name, t]));
-    const dtMap = new Map(theme.darkTokens.map(t => [t.name, t]));
-
-    const overrides: Array<{ token: Omit<SemanticToken, 'primitiveTokens'>; lightVal: string; darkVal: string }> = [];
-
-    for (const [name] of lbMap) {
-      const lbToken = lbMap.get(name)!;
-      if (lbToken.category !== SemanticCategory.COLOR) continue;
-      if (!theme.overrideKeys.has(name)) continue;
-
-      const ltToken = ltMap.get(name);
-      const dtToken = dtMap.get(name);
-      if (!ltToken || !dtToken) continue;
-
-      const getVal = (t: Omit<SemanticToken, 'primitiveTokens'>) =>
-        t.primitiveReferences?.value ?? t.primitiveReferences?.default ?? Object.values(t.primitiveReferences || {})[0] ?? '';
-
-      overrides.push({ token: lbToken, lightVal: getVal(ltToken), darkVal: getVal(dtToken) });
-    }
-
-    if (overrides.length === 0) return lines;
-
-    lines.push('');
-    lines.push(`/* ${theme.name.charAt(0).toUpperCase() + theme.name.slice(1)} Theme: Semantic token overrides (Spec 094) */`);
-    lines.push(`:root[data-theme="${theme.name}"] {`);
-
-    if (theme.mode === 'dark') {
-      lines.push('  color-scheme: dark;');
-    }
-
-    for (const o of overrides) {
-      const name = this.webGenerator.getTokenName(o.token.name, o.token.category);
-      const cssName = name.startsWith('--') ? name : `--${name}`;
-
-      if (theme.mode === 'dark') {
-        // Dark-only: static value, no light-dark()
-        lines.push(`  ${cssName}: ${o.darkVal};`);
-      } else if (theme.mode === 'light') {
-        // Light-only: static value
-        lines.push(`  ${cssName}: ${o.lightVal};`);
-      } else {
-        // Both modes: light-dark() wrapping when values differ
-        const value = o.lightVal !== o.darkVal
-          ? `light-dark(${o.lightVal}, ${o.darkVal})`
-          : o.lightVal;
-        lines.push(`  ${cssName}: ${value};`);
-      }
-    }
-
-    lines.push('}');
-    return lines;
-  }
-
-  /**
-   * Generate Swift theme types: protocol, concrete structs, and EnvironmentKey.
-   * Uses SwiftUI Color type directly (not UIColor) for clean consumption.
-   *
-   * Output structure:
-   * - `{Name}Theme` protocol with theme-varying color properties
-   * - Concrete struct per theme context (light+dark for 'both', single for 'dark'/'light')
-   * - `{Abbreviation}ThemeKey: EnvironmentKey` with base light default
-   * - `EnvironmentValues` extension for `.{abbreviation}Theme` access
-   */
-  private generateSwiftThemeTypes(
-    baseLight: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    baseDark: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    themeOverrides: ThemeOverrideSet[],
-    name: string,
-    abbreviation: string
-  ): string[] {
-    // Collect all theme-varying token names
-    const varyingNames = new Set<string>();
-    for (const theme of themeOverrides) {
-      for (const key of theme.overrideKeys) {
-        varyingNames.add(key);
-      }
-    }
-    // Also include tokens that differ between base light and dark
-    const baseDarkMap = new Map(baseDark.map(t => [t.name, t]));
-    for (const lt of baseLight) {
-      if (lt.category !== SemanticCategory.COLOR) continue;
-      const dt = baseDarkMap.get(lt.name);
-      if (!dt) continue;
-      const lv = this.getResolvedValue(lt);
-      const dv = this.getResolvedValue(dt);
-      if (lv !== dv) varyingNames.add(lt.name);
-    }
-
-    if (varyingNames.size === 0) return [];
-
-    const lines: string[] = [];
-    const lowerAbbr = abbreviation.toLowerCase();
-
-    // Sort for deterministic output
-    const sortedNames = Array.from(varyingNames).sort();
-
-    // --- Protocol ---
-    lines.push('');
-    lines.push(`// MARK: - ${name} Theme System (Spec 094)`);
-    lines.push('');
-    lines.push('import SwiftUI');
-    lines.push('');
-    lines.push(`public protocol ${name}Theme {`);
-    for (const tokenName of sortedNames) {
-      const propName = this.iosGenerator.getTokenName(tokenName, SemanticCategory.COLOR);
-      lines.push(`    var ${propName}: Color { get }`);
-    }
-    lines.push('}');
-
-    // --- Base light struct ---
-    lines.push('');
-    lines.push(`public struct ${name}BaseLight: ${name}Theme {`);
-    for (const tokenName of sortedNames) {
-      const propName = this.iosGenerator.getTokenName(tokenName, SemanticCategory.COLOR);
-      const token = baseLight.find(t => t.name === tokenName);
-      const value = token ? this.rgbaToSwiftUIColor(this.getResolvedValue(token)) : 'Color.clear';
-      lines.push(`    public let ${propName}: Color = ${value}`);
-    }
-    lines.push('}');
-
-    // --- Base dark struct ---
-    lines.push('');
-    lines.push(`public struct ${name}BaseDark: ${name}Theme {`);
-    for (const tokenName of sortedNames) {
-      const propName = this.iosGenerator.getTokenName(tokenName, SemanticCategory.COLOR);
-      const dt = baseDark.find(t => t.name === tokenName);
-      const value = dt ? this.rgbaToSwiftUIColor(this.getResolvedValue(dt)) : 'Color.clear';
-      lines.push(`    public let ${propName}: Color = ${value}`);
-    }
-    lines.push('}');
-
-    // --- Theme override structs ---
-    for (const theme of themeOverrides) {
-      const themeName = theme.name.charAt(0).toUpperCase() + theme.name.slice(1);
-      if (theme.mode === 'both') {
-        // Light variant
-        lines.push('');
-        lines.push(`public struct ${name}${themeName}Light: ${name}Theme {`);
-        for (const tokenName of sortedNames) {
-          const propName = this.iosGenerator.getTokenName(tokenName, SemanticCategory.COLOR);
-          const token = theme.lightTokens.find(t => t.name === tokenName)
-            || baseLight.find(t => t.name === tokenName);
-          const value = token ? this.rgbaToSwiftUIColor(this.getResolvedValue(token)) : 'Color.clear';
-          lines.push(`    public let ${propName}: Color = ${value}`);
-        }
-        lines.push('}');
-        // Dark variant
-        lines.push('');
-        lines.push(`public struct ${name}${themeName}Dark: ${name}Theme {`);
-        for (const tokenName of sortedNames) {
-          const propName = this.iosGenerator.getTokenName(tokenName, SemanticCategory.COLOR);
-          const token = theme.darkTokens.find(t => t.name === tokenName)
-            || baseDark.find(t => t.name === tokenName);
-          const value = token ? this.rgbaToSwiftUIColor(this.getResolvedValue(token)) : 'Color.clear';
-          lines.push(`    public let ${propName}: Color = ${value}`);
-        }
-        lines.push('}');
-      } else {
-        // Single-mode (dark or light)
-        const tokens = theme.mode === 'dark' ? theme.darkTokens : theme.lightTokens;
-        const fallback = theme.mode === 'dark' ? baseDark : baseLight;
-        lines.push('');
-        lines.push(`public struct ${name}${themeName}: ${name}Theme {`);
-        for (const tokenName of sortedNames) {
-          const propName = this.iosGenerator.getTokenName(tokenName, SemanticCategory.COLOR);
-          const token = tokens.find(t => t.name === tokenName)
-            || fallback.find(t => t.name === tokenName);
-          const value = token ? this.rgbaToSwiftUIColor(this.getResolvedValue(token)) : 'Color.clear';
-          lines.push(`    public let ${propName}: Color = ${value}`);
-        }
-        lines.push('}');
-      }
-    }
-
-    // --- EnvironmentKey ---
-    lines.push('');
-    lines.push(`public struct ${abbreviation}ThemeKey: EnvironmentKey {`);
-    lines.push(`    public static let defaultValue: any ${name}Theme = ${name}BaseLight()`);
-    lines.push('}');
-    lines.push('');
-    lines.push('public extension EnvironmentValues {');
-    lines.push(`    var ${lowerAbbr}Theme: any ${name}Theme {`);
-    lines.push(`        get { self[${abbreviation}ThemeKey.self] }`);
-    lines.push(`        set { self[${abbreviation}ThemeKey.self] = newValue }`);
-    lines.push('    }');
-    lines.push('}');
-
-    return lines;
-  }
-
-  /** Extract the resolved value string from a semantic token's primitiveReferences. */
-  private getResolvedValue(token: Omit<SemanticToken, 'primitiveTokens'>): string {
-    return token.primitiveReferences?.value
-      ?? token.primitiveReferences?.default
-      ?? Object.values(token.primitiveReferences || {})[0]
-      ?? '';
-  }
-
-  /** Convert an rgba() string to SwiftUI Color initializer. */
-  private rgbaToSwiftUIColor(rgba: string): string {
-    const m = rgba.match(/rgba\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*,\s*([\d.]+)\s*\)/);
-    if (!m) return `Color.clear /* unresolved: ${rgba} */`;
-    const r = (+m[1] / 255).toFixed(2);
-    const g = (+m[2] / 255).toFixed(2);
-    const b = (+m[3] / 255).toFixed(2);
-    const a = (+m[4]).toFixed(2);
-    return `Color(red: ${r}, green: ${g}, blue: ${b}, opacity: ${a})`;
-  }
-
-  /**
-   * Generate Kotlin theme types: data class, named instances, and CompositionLocal.
-   * Uses Compose `Color` directly for clean consumption.
-   *
-   * Output structure:
-   * - `{Name}Theme` data class with theme-varying color properties
-   * - `{Name}Themes` object with named instances per theme context
-   * - `Local{Abbreviation}Theme` CompositionLocal with base light default
-   */
-  private generateKotlinThemeTypes(
-    baseLight: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    baseDark: Array<Omit<SemanticToken, 'primitiveTokens'>>,
-    themeOverrides: ThemeOverrideSet[],
-    name: string,
-    abbreviation: string
-  ): string[] {
-    // Collect theme-varying token names (same logic as Swift)
-    const varyingNames = new Set<string>();
-    for (const theme of themeOverrides) {
-      for (const key of theme.overrideKeys) {
-        varyingNames.add(key);
-      }
-    }
-    const baseDarkMap = new Map(baseDark.map(t => [t.name, t]));
-    for (const lt of baseLight) {
-      if (lt.category !== SemanticCategory.COLOR) continue;
-      const dt = baseDarkMap.get(lt.name);
-      if (!dt) continue;
-      if (this.getResolvedValue(lt) !== this.getResolvedValue(dt)) varyingNames.add(lt.name);
-    }
-
-    if (varyingNames.size === 0) return [];
-
-    const lines: string[] = [];
-    const sortedNames = Array.from(varyingNames).sort();
-
-    // --- Imports ---
-    lines.push('');
-    lines.push(`// ${name} Theme System (Spec 094)`);
-    lines.push('');
-    lines.push('import androidx.compose.runtime.compositionLocalOf');
-    lines.push('import androidx.compose.ui.graphics.Color');
-
-    // --- Data class ---
-    lines.push('');
-    lines.push(`data class ${name}Theme(`);
-    for (let i = 0; i < sortedNames.length; i++) {
-      const propName = this.androidGenerator.getTokenName(sortedNames[i], SemanticCategory.COLOR);
-      const comma = i < sortedNames.length - 1 ? ',' : '';
-      lines.push(`    val ${propName}: Color${comma}`);
-    }
-    lines.push(')');
-
-    // --- Themes object with instances ---
-    lines.push('');
-    lines.push(`object ${name}Themes {`);
-
-    // Base light
-    lines.push(`    val BaseLight = ${name}Theme(`);
-    for (let i = 0; i < sortedNames.length; i++) {
-      const token = baseLight.find(t => t.name === sortedNames[i]);
-      const value = token ? this.rgbaToComposeColor(this.getResolvedValue(token)) : 'Color.Unspecified';
-      const comma = i < sortedNames.length - 1 ? ',' : '';
-      lines.push(`        ${this.androidGenerator.getTokenName(sortedNames[i], SemanticCategory.COLOR)} = ${value}${comma}`);
-    }
-    lines.push('    )');
-
-    // Base dark
-    lines.push(`    val BaseDark = ${name}Theme(`);
-    for (let i = 0; i < sortedNames.length; i++) {
-      const dt = baseDark.find(t => t.name === sortedNames[i]);
-      const value = dt ? this.rgbaToComposeColor(this.getResolvedValue(dt)) : 'Color.Unspecified';
-      const comma = i < sortedNames.length - 1 ? ',' : '';
-      lines.push(`        ${this.androidGenerator.getTokenName(sortedNames[i], SemanticCategory.COLOR)} = ${value}${comma}`);
-    }
-    lines.push('    )');
-
-    // Theme override instances
-    for (const theme of themeOverrides) {
-      const themeName = theme.name.charAt(0).toUpperCase() + theme.name.slice(1);
-      if (theme.mode === 'both') {
-        for (const variant of ['Light', 'Dark'] as const) {
-          const tokens = variant === 'Light' ? theme.lightTokens : theme.darkTokens;
-          const fallback = variant === 'Light' ? baseLight : baseDark;
-          lines.push(`    val ${themeName}${variant} = ${name}Theme(`);
-          for (let i = 0; i < sortedNames.length; i++) {
-            const token = tokens.find(t => t.name === sortedNames[i])
-              || fallback.find(t => t.name === sortedNames[i]);
-            const value = token ? this.rgbaToComposeColor(this.getResolvedValue(token)) : 'Color.Unspecified';
-            const comma = i < sortedNames.length - 1 ? ',' : '';
-            lines.push(`        ${this.androidGenerator.getTokenName(sortedNames[i], SemanticCategory.COLOR)} = ${value}${comma}`);
-          }
-          lines.push('    )');
-        }
-      } else {
-        const tokens = theme.mode === 'dark' ? theme.darkTokens : theme.lightTokens;
-        const fallback = theme.mode === 'dark' ? baseDark : baseLight;
-        lines.push(`    val ${themeName} = ${name}Theme(`);
-        for (let i = 0; i < sortedNames.length; i++) {
-          const token = tokens.find(t => t.name === sortedNames[i])
-            || fallback.find(t => t.name === sortedNames[i]);
-          const value = token ? this.rgbaToComposeColor(this.getResolvedValue(token)) : 'Color.Unspecified';
-          const comma = i < sortedNames.length - 1 ? ',' : '';
-          lines.push(`        ${this.androidGenerator.getTokenName(sortedNames[i], SemanticCategory.COLOR)} = ${value}${comma}`);
-        }
-        lines.push('    )');
-      }
-    }
-
-    lines.push('}');
-
-    // --- CompositionLocal ---
-    lines.push('');
-    lines.push(`val Local${abbreviation}Theme = compositionLocalOf { ${name}Themes.BaseLight }`);
-
-    return lines;
-  }
-
-  /** Convert an rgba() string to Compose Color initializer. */
-  private rgbaToComposeColor(rgba: string): string {
-    const m = rgba.match(/rgba\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*,\s*([\d.]+)\s*\)/);
-    if (!m) return `Color.Unspecified /* unresolved: ${rgba} */`;
-    return `Color(${m[1]}, ${m[2]}, ${m[3]}, ${Math.round(+m[4] * 255)})`;
-  }
-
-  /**
-   * Generate icon size token with calculated value.
-   * Resolves fontSize and lineHeight primitives and applies formula: fontSize × lineHeight
-   *
-   * @param semantic - Icon size semantic token
-   * @param platform - Target platform
-   * @param generator - Platform-specific generator
-   * @returns Formatted token string with calculated value
-   */
-  private generateIconSizeToken(
-    semantic: Omit<SemanticToken, 'primitiveTokens'>,
-    platform: 'web' | 'ios' | 'android',
-    generator: WebFormatGenerator | iOSFormatGenerator | AndroidFormatGenerator
-  ): string | null {
-    // Get fontSize and multiplier primitive references
-    const fontSizeRef = semantic.primitiveReferences.fontSize;
-    const multiplierRef = semantic.primitiveReferences.multiplier;
-    
-    if (!fontSizeRef || !multiplierRef) {
-      console.warn(`Icon token ${semantic.name} missing fontSize or multiplier reference`);
-      return null;
-    }
-    
-    // Import primitive tokens and parsing utilities
-    const { fontSizeTokens } = require('../tokens/FontSizeTokens');
-    const { lineHeightTokens } = require('../tokens/LineHeightTokens');
-    const { parseMultiplier, CUSTOM_MULTIPLIER_PREFIX } = require('../tokens/semantic/IconTokens');
-    
-    // Resolve fontSize primitive token
-    const fontSizeToken = fontSizeTokens[fontSizeRef];
-    
-    if (!fontSizeToken) {
-      console.warn(`Icon token ${semantic.name} references invalid fontSize: ${fontSizeRef}`);
-      return null;
-    }
-    
-    // Resolve multiplier - can be a lineHeight token reference or 'custom:X.XXX'
-    let multiplierValue: number;
-    try {
-      multiplierValue = parseMultiplier(multiplierRef);
-    } catch (error) {
-      console.warn(`Icon token ${semantic.name} has invalid multiplier: ${multiplierRef}`);
-      return null;
-    }
-    
-    // Calculate icon size: fontSize × multiplier (rounded)
-    const calculatedSize = Math.round(fontSizeToken.baseValue * multiplierValue);
-    
-    // Generate platform-specific token with calculated value, description, and context
-    return generator.formatIconSizeToken(
-      semantic.name,
-      calculatedSize,
-      semantic.category,
-      semantic.description,
-      semantic.context
-    );
-  }
-
-  /**
-   * Generate motion token section for specified platform
-   * Handles primitive motion tokens (duration, easing, scale) and semantic motion tokens
-   * 
-   * @param platform - Target platform ('web', 'ios', or 'android')
-   * @returns Array of formatted token strings
-   */
-  private generateMotionSection(platform: 'web' | 'ios' | 'android'): string[] {
-    const lines: string[] = [];
-
-    // Import platform builders for motion token generation
-    const { WebBuilder } = require('../build/platforms/WebBuilder');
-    const { iOSBuilder } = require('../build/platforms/iOSBuilder');
-    const { AndroidBuilder } = require('../build/platforms/AndroidBuilder');
-
-    // Select appropriate builder based on platform
-    let builder: any;
-
-    switch (platform) {
-      case 'web':
-        builder = new WebBuilder();
-        break;
-      case 'ios':
-        builder = new iOSBuilder();
-        break;
-      case 'android':
-        builder = new AndroidBuilder();
-        break;
-      default:
-        return lines;
-    }
-
-    // Generate primitive motion tokens
-    const durationLines = builder.generateDurationTokens(durationTokens);
-    const easingLines = builder.generateEasingTokens(easingTokens);
-    const scaleLines = builder.generateScaleTokens(scaleTokens);
-
-    lines.push(durationLines);
-    lines.push(easingLines);
-    lines.push(scaleLines);
-
-    // Generate semantic motion tokens
-    const semanticMotionLines = builder.generateSemanticMotionTokens(motionTokens);
-    lines.push(semanticMotionLines);
-
-    return lines;
-  }
-
-  /**
-   * Generate layering token section for specified platform
-   * Handles semantic-only layering tokens (z-index and elevation)
-   * 
-   * @param platform - Target platform ('web', 'ios', or 'android')
-   * @returns Array of formatted token strings
-   */
-  private generateLayeringSection(platform: 'web' | 'ios' | 'android'): string[] {
-    const lines: string[] = [];
-
-    // Route z-index tokens to web/iOS, elevation tokens to Android
-    if (platform === 'web' || platform === 'ios') {
-      // Get z-index tokens for web and iOS
-      const zIndexTokens = getAllZIndexTokens();
-      
-      for (const token of zIndexTokens) {
-        // Format z-index token based on platform
-        if (platform === 'web') {
-          // Web: CSS custom property format
-          // --z-index-modal: 400;
-          const kebabName = token.name.replace('zIndex.', 'z-index-');
-          lines.push(`  --${kebabName}: ${token.value};`);
-        } else {
-          // iOS: Swift constant format with scaled value
-          // static let zIndexModal: CGFloat = 4
-          const suffix = token.name.replace('zIndex.', '');
-          const camelSuffix = suffix.charAt(0).toUpperCase() + suffix.slice(1);
-          const camelName = 'zIndex' + camelSuffix;
-          const scaledValue = token.value / 100; // Scale down from 100-600 to 1-6
-          lines.push(`    static let ${camelName}: CGFloat = ${scaledValue}`);
-        }
-      }
-    } else if (platform === 'android') {
-      // Get elevation tokens for Android
-      const elevationTokens = getAllElevationTokens();
-      
-      for (const token of elevationTokens) {
-        // Use AndroidFormatGenerator to format elevation tokens
-        lines.push(this.androidGenerator.formatElevationToken(token.name, token.value));
-      }
-    }
-
-    return lines;
-  }
-
-  // ---------------------------------------------------------------------------
-  // Platform token generation
-  //
-  // All three platforms follow the same generation flow. Platform-specific
-  // formatting is handled by the generator instances (WebFormatGenerator,
-  // iOSFormatGenerator, AndroidFormatGenerator). This consolidated method
-  // ensures filtering logic, section ordering, and structural decisions
-  // stay in sync across platforms.
-  // ---------------------------------------------------------------------------
-
-  /** Platform-specific configuration for the consolidated generation flow. */
-  private static readonly PLATFORM_CONFIG: Record<'web' | 'ios' | 'android', {
-    fileName: string;
-    motionComment: string;
-    layeringComment: string;
-    /** Web closes :root before WCAG overrides; iOS/Android put WCAG inside the struct. */
-    wcagAfterFooter: boolean;
-  }> = {
-    web: {
-      fileName: 'DesignTokens.web.css',
-      motionComment: '  /* Motion Tokens */',
-      layeringComment: '  /* Layering Tokens (Z-Index) */',
-      wcagAfterFooter: true,
-    },
-    ios: {
-      fileName: 'DesignTokens.ios.swift',
-      motionComment: '    // MARK: - Motion Tokens',
-      layeringComment: '    // MARK: - Layering Tokens (Z-Index)',
-      wcagAfterFooter: false,
-    },
-    android: {
-      fileName: 'DesignTokens.android.kt',
-      motionComment: '    // Motion Tokens',
-      layeringComment: '    // Layering Tokens (Elevation)',
-      wcagAfterFooter: false,
-    },
-  };
-
-  /**
-   * Categories handled by dedicated sections (generateMotionSection),
-   * excluded from the generic primitive pass to prevent duplicates.
-   */
-  private static readonly DEDICATED_PRIMITIVE_CATEGORIES = new Set([
-    TokenCategory.EASING, TokenCategory.DURATION, TokenCategory.SCALE,
-  ]);
-
-  /**
-   * Semantic name prefixes handled by dedicated sections
-   * (generateMotionSection, generateLayeringSection),
-   * excluded from the generic semantic pass.
-   */
-  private static readonly DEDICATED_SEMANTIC_PREFIXES = ['zIndex.', 'elevation.', 'motion.'];
-
-  /** Get primitive tokens for the generic pass (excludes dedicated-section categories). */
-  private getGenerationPrimitives(primitiveTokens: PrimitiveToken[]): PrimitiveToken[] {
-    return primitiveTokens.filter(
-      t => !TokenFileGenerator.DEDICATED_PRIMITIVE_CATEGORIES.has(t.category)
-    );
-  }
-
-  /** Filter semantics for the generic pass (excludes dedicated-section prefixes). */
-  private filterGenerationSemantics(
-    tokens: Array<Omit<SemanticToken, 'primitiveTokens'>>
-  ): Array<Omit<SemanticToken, 'primitiveTokens'>> {
-    return tokens.filter(s =>
-      TokenFileGenerator.DEDICATED_SEMANTIC_PREFIXES.every(p => !s.name.startsWith(p))
-    );
-  }
-
-  /** Get the format generator instance for a platform. */
-  private getGenerator(platform: 'web' | 'ios' | 'android'): WebFormatGenerator | iOSFormatGenerator | AndroidFormatGenerator {
-    switch (platform) {
-      case 'web': return this.webGenerator;
-      case 'ios': return this.iosGenerator;
-      case 'android': return this.androidGenerator;
-    }
-  }
-
-  /**
-   * Generate token file for a specific platform.
-   *
-   * Shared flow: header → primitives → semantics → motion → layering → WCAG → footer.
-   * Web places footer before WCAG (overrides live outside :root);
-   * iOS/Android place WCAG before footer (overrides live inside the struct).
-   */
-  private generatePlatformTokens(
-    platform: 'web' | 'ios' | 'android',
-    options: GenerationOptions
-  ): GenerationResult {
-    const {
-      outputDir = 'output',
-      version = '1.0.0',
-      includeComments = true,
-      groupByCategory = true,
-      semanticTokens,
-      darkSemanticTokens,
-    } = options;
-
-    const config = TokenFileGenerator.PLATFORM_CONFIG[platform];
-    const generator = this.getGenerator(platform);
-    const metadata: FileMetadata = { version, generatedAt: new Date() };
-
-    const tokens = this.getGenerationPrimitives(options.primitiveTokens || getAllPrimitiveTokens());
-    const semantics = this.filterGenerationSemantics(semanticTokens);
-    const darkSemantics = this.filterGenerationSemantics(darkSemanticTokens);
-
-    const lines: string[] = [];
-    let semanticTokenCount = 0;
-
-    // --- Header ---
-    lines.push(generator.generateHeader(metadata));
-    if (platform === 'web') {
-      lines.push('  color-scheme: light dark;');
-    }
-
-    // --- Primitive tokens ---
-    if (includeComments) {
-      lines.push(generator.generateSectionComment('primitive'));
-    }
-
-    if (groupByCategory) {
-      const categories = this.getUniqueCategories(tokens);
-      for (const category of categories) {
-        if (category === TokenCategory.COLOR) {
-          // OKLCH color output — uses composed colors instead of old RGBA PrimitiveTokens
-          if (includeComments) {
-            lines.push((generator as any).generateCategoryComment(category));
-          }
-          if (platform === 'web') {
-            lines.push(...this.generateOklchWebColors());
-          } else if (platform === 'ios') {
-            lines.push(...this.generateOklchNativeColors('ios'));
-          } else {
-            lines.push(...this.generateOklchNativeColors('android'));
-          }
-          continue;
-        }
-        const categoryTokens = tokens.filter(t => t.category === category);
-        if (includeComments) {
-          lines.push((generator as any).generateCategoryComment(category));
-        }
-        for (const token of categoryTokens) {
-          if (includeComments && 'mathematicalRelationship' in token) {
-            lines.push((generator as any).generateMathematicalComment(token as PrimitiveToken));
-          }
-          lines.push(generator.formatToken(token));
-        }
-      }
-    } else {
-      for (const token of tokens) {
-        lines.push(generator.formatToken(token));
-      }
-    }
-
-    // --- Semantic tokens ---
-    if (includeComments) {
-      lines.push(generator.generateSectionComment('semantic'));
-    }
-    const semanticLines = this.generateSemanticSection(
-      semantics, platform, darkSemantics,
-      platform !== 'web' ? options.themeVaryingTokens : undefined
-    );
-    lines.push(...semanticLines);
-    semanticTokenCount = semantics.length;
-
-    // --- Motion tokens (dedicated section) ---
-    if (includeComments) {
-      lines.push('');
-      lines.push(config.motionComment);
-    }
-    const motionLines = this.generateMotionSection(platform);
-    lines.push(...motionLines);
-    semanticTokenCount += motionLines.length;
-
-    // --- Layering tokens (dedicated section) ---
-    if (includeComments) {
-      lines.push('');
-      lines.push(config.layeringComment);
-    }
-    const layeringLines = this.generateLayeringSection(platform);
-    lines.push(...layeringLines);
-    semanticTokenCount += layeringLines.length;
-
-    // --- WCAG overrides + Footer ---
-    // Web: footer first (closes :root), then WCAG outside it.
-    // iOS/Android: WCAG inside the struct, then footer closes it.
-    const wcagLines = this.maybeGenerateWcagBlock(platform, options);
-
-    if (config.wcagAfterFooter) {
-      lines.push(generator.generateFooter());
-      lines.push(...wcagLines);
-    } else {
-      lines.push(...wcagLines);
-      lines.push(generator.generateFooter());
-    }
-
-    const content = lines.join('\n');
-    const validation = generator.validateSyntax(content);
-
-    return {
-      platform,
-      filePath: `${outputDir}/${config.fileName}`,
-      content,
-      tokenCount: (options.primitiveTokens || getAllPrimitiveTokens()).length,
-      semanticTokenCount,
-      valid: validation.valid,
-      errors: validation.errors,
-    };
-  }
-
-  /** Generate WCAG override block if WCAG tokens are provided. */
-  private maybeGenerateWcagBlock(
-    platform: 'web' | 'ios' | 'android',
-    options: GenerationOptions
-  ): string[] {
-    if (options.wcagSemanticTokens && options.darkWcagSemanticTokens) {
-      const wcagLines = this.generateWcagOverrideBlock(
-        options.semanticTokens, options.darkSemanticTokens,
-        options.wcagSemanticTokens, options.darkWcagSemanticTokens,
-        platform, options.wcagOverrideKeys
-      );
-      if (wcagLines.length > 0) return wcagLines;
-    }
-    return [];
-  }
-
-  /** Generate web token file (CSS). */
-  generateWebTokens(options: GenerationOptions): GenerationResult {
-    return this.generatePlatformTokens('web', options);
-  }
-
-  /** Generate iOS token file (Swift). */
-  generateiOSTokens(options: GenerationOptions): GenerationResult {
-    return this.generatePlatformTokens('ios', options);
-  }
-
-  /** Generate Android token file (Kotlin). */
-  generateAndroidTokens(options: GenerationOptions): GenerationResult {
-    return this.generatePlatformTokens('android', options);
-  }
-
-  /**
-   * Extract name and value from a formatted token line (any platform).
-   * Web:     `  --color-text-default: rgba(38, 50, 58, 1);` → { name: '--color-text-default', value: 'rgba(38, 50, 58, 1)' }
-   * iOS:     `    public static let colorTextDefault: UIColor = UIColor(...)` → { name: 'colorTextDefault', value: 'UIColor(...)' }
-   * Android: `    val color_text_default = Color.argb(255, 38, 50, 58)` → { name: 'color_text_default', value: 'Color.argb(255, 38, 50, 58)' }
-   */
-  private extractFormattedParts(line: string): { name: string; value: string } | null {
-    const lastLine = line.includes('\n') ? line.split('\n').pop()! : line;
-    // Web: --prop-name: value;
-    const cssMatch = lastLine.match(/^\s*(--[\w-]+):\s*(.+);$/);
-    if (cssMatch) return { name: cssMatch[1], value: cssMatch[2].trim() };
-    // iOS: public static let name: Type = value
-    const swiftMatch = lastLine.match(/public static let (\w+).*?=\s*(.+)$/);
-    if (swiftMatch) return { name: swiftMatch[1], value: swiftMatch[2].trim() };
-    // Android (Kotlin): val name = value
-    const kotlinMatch = lastLine.match(/^\s*val\s+([\w_]+)\s*=\s*(.+)$/);
-    if (kotlinMatch) return { name: kotlinMatch[1], value: kotlinMatch[2].trim() };
-    return null;
-  }
-
-  /**
-   * Get unique categories from token list
-   */
-  private getUniqueCategories(tokens: PrimitiveToken[]): TokenCategory[] {
-    const categories = new Set<TokenCategory>();
-    tokens.forEach(token => categories.add(token.category));
-    return Array.from(categories).sort();
-  }
-
-
-
-  /**
-   * Validate mathematical consistency across platforms
-   * Extended to include semantic token validation with nuanced platform-specific token handling
-   * 
-   * Platform-specific tokens (documented in acknowledged-differences.json) are excluded from
-   * count comparisons. For example, Android has elevation.none (0dp baseline) while web/iOS
-   * don't need a "zero" z-index token.
-   */
-  validateCrossPlatformConsistency(results: GenerationResult[]): {
-    consistent: boolean;
-    issues: string[];
-    platformSpecificTokens?: { platform: string; tokens: string[] }[];
-  } {
-    const issues: string[] = [];
-    const platformSpecificInfo: { platform: string; tokens: string[] }[] = [];
-
-    // Check that all platforms generated successfully FIRST (most critical)
-    const invalidPlatforms = results.filter(r => !r.valid);
-    if (invalidPlatforms.length > 0) {
-      invalidPlatforms.forEach(r => {
-        issues.push(`${r.platform} generation failed: ${r.errors?.join(', ')}`);
-      });
-    }
-
-    // Load acknowledged differences registry for platform-specific token handling
-    let acknowledgedDifferences: any = null;
-    try {
-      // Try multiple paths since this file may be run from different locations
-      try {
-        acknowledgedDifferences = require('../__tests__/fixtures/acknowledged-differences.json');
-      } catch {
-        acknowledgedDifferences = require('../../__tests__/fixtures/acknowledged-differences.json');
-      }
-    } catch (e) {
-      // Registry not available, proceed with strict validation
-    }
-
-    // Get platform-specific token counts from registry
-    const platformSpecificCounts: Record<string, number> = {};
-    if (acknowledgedDifferences?.platformSpecificTokens?.tokens) {
-      for (const token of acknowledgedDifferences.platformSpecificTokens.tokens) {
-        platformSpecificCounts[token.platform] = (platformSpecificCounts[token.platform] || 0) + 1;
-        
-        // Track for reporting
-        const existing = platformSpecificInfo.find(p => p.platform === token.platform);
-        if (existing) {
-          existing.tokens.push(token.token);
-        } else {
-          platformSpecificInfo.push({ platform: token.platform, tokens: [token.token] });
-        }
-      }
-    }
-
-    // Check that all platforms have the same primitive token count
-    const tokenCounts = results.map(r => r.tokenCount);
-    const uniqueCounts = new Set(tokenCounts);
-
-    if (uniqueCounts.size > 1) {
-      issues.push(`Primitive token count mismatch across platforms: ${Array.from(uniqueCounts).join(', ')}`);
-    }
-
-    // Check semantic token counts with platform-specific token adjustment
-    // Only apply adjustment if the raw counts suggest platform-specific tokens are present
-    // (i.e., the difference between platforms matches the expected platform-specific count)
-    const semanticTokenCounts = results.map(r => r.semanticTokenCount);
-    const uniqueRawCounts = new Set(semanticTokenCounts);
-    
-    // First check if raw counts are already consistent
-    if (uniqueRawCounts.size === 1) {
-      // All platforms have same count - no adjustment needed
-      // This handles mock data and cases where platform-specific tokens aren't present
-    } else {
-      // Raw counts differ - check if the difference matches platform-specific tokens
-      const normalizedSemanticCounts = results.map(r => {
-        const platformSpecificCount = platformSpecificCounts[r.platform] || 0;
-        return {
-          platform: r.platform,
-          original: r.semanticTokenCount,
-          normalized: r.semanticTokenCount - platformSpecificCount,
-          platformSpecific: platformSpecificCount
-        };
-      });
-
-      const uniqueNormalizedCounts = new Set(normalizedSemanticCounts.map(c => c.normalized));
-
-      if (uniqueNormalizedCounts.size > 1) {
-        // Still mismatched after adjustment - report the issue
-        const countDetails = normalizedSemanticCounts
-          .map(c => `${c.platform}=${c.original}${c.platformSpecific > 0 ? ` (${c.platformSpecific} platform-specific)` : ''}`)
-          .join(', ');
-        issues.push(`Semantic token count mismatch across platforms (after excluding platform-specific tokens): ${countDetails}`);
-      }
-      // If normalized counts are consistent, the difference was due to documented platform-specific tokens
-    }
-
-    // Verify all platforms have same semantic token names (excluding platform-specific)
-    const semanticTokenNames = this.extractSemanticTokenNames(results);
-
-    if (semanticTokenNames.length > 0) {
-      const referenceNames = semanticTokenNames[0].names;
-      const referencePlatform = semanticTokenNames[0].platform;
-
-      for (let i = 1; i < semanticTokenNames.length; i++) {
-        const current = semanticTokenNames[i];
-
-        const missingInCurrent = referenceNames.filter(name => !current.names.includes(name));
-        const extraInCurrent = current.names.filter(name => !referenceNames.includes(name));
-
-        if (missingInCurrent.length > 0) {
-          issues.push(`${current.platform} missing semantic tokens present in ${referencePlatform}: ${missingInCurrent.join(', ')}`);
-        }
-
-        if (extraInCurrent.length > 0) {
-          issues.push(`${current.platform} has extra semantic tokens not in ${referencePlatform}: ${extraInCurrent.join(', ')}`);
-        }
-      }
-    }
-
-    // Verify all platforms maintain same primitive→semantic relationships
-    const relationships = this.extractPrimitiveSemanticRelationships(results);
-
-    if (relationships.length > 0) {
-      const referenceRelationships = relationships[0].relationships;
-      const referencePlatform = relationships[0].platform;
-
-      for (let i = 1; i < relationships.length; i++) {
-        const current = relationships[i];
-
-        for (const [semanticName, primitiveRefs] of Object.entries(referenceRelationships)) {
-          const currentRefs = current.relationships[semanticName];
-
-          if (!currentRefs) {
-            issues.push(`${current.platform} missing semantic token '${semanticName}' present in ${referencePlatform}`);
-            continue;
-          }
-
-          const refKeys = Object.keys(primitiveRefs).sort();
-          const currKeys = Object.keys(currentRefs).sort();
-
-          if (JSON.stringify(refKeys) !== JSON.stringify(currKeys)) {
-            issues.push(`${current.platform} has different primitive references for '${semanticName}' compared to ${referencePlatform}`);
-          } else {
-            for (const key of refKeys) {
-              if (primitiveRefs[key] !== currentRefs[key]) {
-                issues.push(`${current.platform} semantic token '${semanticName}' references '${currentRefs[key]}' for ${key}, but ${referencePlatform} references '${primitiveRefs[key]}'`);
-              }
-            }
-          }
-        }
-      }
-    }
-
-    return {
-      consistent: issues.length === 0,
-      issues,
-      platformSpecificTokens: platformSpecificInfo.length > 0 ? platformSpecificInfo : undefined
-    };
-  }
-
-  /**
-   * Extract semantic token names from generated content
-   * Parses the generated files to extract semantic token names
-   * 
-   * @param results - Generation results for all platforms
-   * @returns Array of platform token names
-   */
-  private extractSemanticTokenNames(results: GenerationResult[]): Array<{
-    platform: string;
-    names: string[];
-  }> {
-    const semantics = getAllSemanticTokens();
-    const semanticNames = semantics.map(s => s.name);
-
-    return results.map(result => ({
-      platform: result.platform,
-      names: semanticNames
-    }));
-  }
-
-  /**
-   * Extract primitive→semantic relationships from generated content
-   * Analyzes semantic tokens to extract their primitive references
-   * 
-   * @param results - Generation results for all platforms
-   * @returns Array of platform relationships
-   */
-  private extractPrimitiveSemanticRelationships(results: GenerationResult[]): Array<{
-    platform: string;
-    relationships: Record<string, Record<string, string>>;
-  }> {
-    const semantics = getAllSemanticTokens();
-
-    // Build relationships map from semantic tokens
-    const relationships: Record<string, Record<string, string>> = {};
-
-    for (const semantic of semantics) {
-      relationships[semantic.name] = { ...semantic.primitiveReferences };
-    }
-
-    // Return same relationships for all platforms (they should be identical)
-    return results.map(result => ({
-      platform: result.platform,
-      relationships: { ...relationships }
-    }));
-  }
-
-  // --- OKLCH Color Generation Helpers (Spec 112) ---
-
-  private generateOklchWebColors(): string[] {
-    const lines: string[] = [];
-
-    // Channel custom properties
-    const families: Array<{ name: string; hue: number; lightness: Record<number, number>; chroma: Record<number, number> }> = [
-      { name: 'pink', hue: colorHues.pink, lightness: pinkLightness, chroma: pinkChroma },
-      { name: 'orange', hue: colorHues.orange, lightness: orangeLightness, chroma: orangeChroma },
-      { name: 'yellow', hue: colorHues.yellow, lightness: yellowLightness, chroma: yellowChroma },
-      { name: 'green', hue: colorHues.green, lightness: greenLightness, chroma: greenChroma },
-      { name: 'cyan', hue: colorHues.cyan, lightness: cyanLightness, chroma: cyanChroma },
-      { name: 'teal', hue: colorHues.teal, lightness: tealLightness, chroma: tealChroma },
-      { name: 'purple', hue: colorHues.purple, lightness: purpleLightness, chroma: purpleChroma },
-    ];
-
-    // Emit channel primitives
-    for (const family of families) {
-      lines.push(...this.webGenerator.formatOklchChannels(family.name, family.hue, family.lightness, family.chroma));
-    }
-    // Neutral hue
-    lines.push(`  --neutral-hue: ${neutralHue};`);
-    // Neutral channels
-    lines.push(...this.webGenerator.formatOklchChannels('white', neutralHue, whiteLightness as any, whiteChroma as any));
-    lines.push(...this.webGenerator.formatOklchChannels('gray', neutralHue, grayLightness as any, grayChroma as any));
-    lines.push(...this.webGenerator.formatOklchChannels('black', neutralHue, blackLightness as any, blackChroma as any));
-
-    // Emit composed colors
-    for (const color of allComposedColors) {
-      lines.push(this.webGenerator.formatOklchColor(color.name, color.resolved.l, color.resolved.c, color.resolved.h));
-    }
-
-    return lines;
-  }
-
-  private generateOklchNativeColors(platform: 'ios' | 'android'): string[] {
-    const lines: string[] = [];
-    const gen = platform === 'ios' ? this.iosGenerator : this.androidGenerator;
-
-    for (const color of allComposedColors) {
-      lines.push(gen.formatOklchColor(color.name, color.resolved.l, color.resolved.c, color.resolved.h));
-    }
-
-    return lines;
-  }
-}