@3fn/core 14.0.0 → 15.0.0

package/src/build/__tests__/AndroidBuildIntegration.test.ts

@@ -1,437 +0,0 @@
-/**
- * @category evergreen
- * @purpose Verify build system integration produces correct outputs for all platforms
- */
-/**
- * Android Build Integration Tests
- * 
- * Integration tests for Android build and validation workflow
- * Tests the complete flow from build to validation
- */
-
-import { AndroidBuilder } from '../platforms/AndroidBuilder';
-import { AndroidBuildValidator } from '../validation/AndroidBuildValidator';
-import { BuildConfig } from '../types/BuildConfig';
-import { ComponentDefinition } from '../platforms/PlatformBuilder';
-import { PlatformTokens } from '../tokens/PlatformTokens';
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import * as os from 'os';
-
-describe('Android Build Integration', () => {
-  let builder: AndroidBuilder;
-  let validator: AndroidBuildValidator;
-  let tempDir: string;
-  
-  beforeEach(async () => {
-    builder = new AndroidBuilder({
-      kotlinVersion: '1.9.20',
-      minSdkVersion: 24,
-      targetSdkVersion: 34,
-      dependencies: []
-    });
-    
-    validator = new AndroidBuildValidator();
-    
-    // Create temporary directory for build output
-    tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'android-build-integration-'));
-  });
-  
-  afterEach(async () => {
-    // Clean up temporary directory
-    try {
-      await fs.rm(tempDir, { recursive: true, force: true });
-    } catch {
-      // Ignore cleanup errors
-    }
-  });
-  
-  describe('Complete build and validation workflow', () => {
-    it('should build and validate Android package successfully', async () => {
-      // Create mock component definitions
-      const components: ComponentDefinition[] = [
-        {
-          name: 'Button',
-          description: 'A button component',
-          category: 'action',
-          properties: [],
-          methods: [],
-          tokens: []
-        }
-      ];
-      
-      // Create mock platform tokens
-      const tokens: PlatformTokens = {
-        platform: 'android',
-        primitives: {
-          spacing: {
-            space100: { value: 8, unit: 'dp', token: 'space100' },
-            space200: { value: 16, unit: 'dp', token: 'space200' }
-          },
-          colors: {
-            'color.blue.500': { value: '#3B82F6', unit: '', token: 'color.blue.500' }
-          },
-          typography: {
-            fontSize100: { value: 16, unit: 'sp', token: 'fontSize100' }
-          },
-          radius: {
-            radius050: { value: 4, unit: 'dp', token: 'radius050' }
-          },
-          sizing: {
-            size100: { value: 8, unit: 'dp', token: 'size100' }
-          },
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        semantics: {
-          spacing: {},
-          colors: {},
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        components: {
-          spacing: {},
-          colors: {},
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        metadata: {
-          platform: 'android',
-          defaultSpacingUnit: 'dp',
-          defaultTypographyUnit: 'sp',
-          supportedUnits: ['dp', 'sp'],
-          constraints: {
-            decimalPrecision: 2,
-            supportsSubpixel: true,
-            roundingMode: 'round'
-          },
-          generatedAt: new Date()
-        }
-      };
-      
-      // Create build configuration
-      const config: BuildConfig = {
-        platforms: ['android'],
-        mode: 'development',
-        outputDir: tempDir,
-        parallel: false,
-        incremental: false,
-        sourceMaps: true,
-        minify: false,
-        validation: {
-          interfaces: true,
-          tokens: true,
-          mathematical: true
-        }
-      };
-      
-      // Execute build
-      const buildResult = await builder.build(components, tokens, config);
-      
-      // Verify build succeeded
-      expect(buildResult.success).toBe(true);
-      expect(buildResult.platform).toBe('android');
-      expect(buildResult.errors.length).toBe(0);
-      
-      // Execute validation
-      const validationResult = await validator.validate(buildResult);
-      
-      // Verify validation passed
-      expect(validationResult.valid).toBe(true);
-      expect(validationResult.buildGradleValid).toBe(true);
-      expect(validationResult.kotlinConstantsValid).toBe(true);
-      expect(validationResult.moduleImportValid).toBe(true);
-      expect(validationResult.optimizationsValid).toBe(true);
-      expect(validationResult.errors.length).toBe(0);
-      
-      // Verify build artifacts exist
-      const buildGradlePath = path.join(buildResult.packagePath, 'build.gradle.kts');
-      const buildGradleExists = await fs.access(buildGradlePath).then(() => true).catch(() => false);
-      expect(buildGradleExists).toBe(true);
-      
-      const manifestPath = path.join(buildResult.packagePath, 'src', 'main', 'AndroidManifest.xml');
-      const manifestExists = await fs.access(manifestPath).then(() => true).catch(() => false);
-      expect(manifestExists).toBe(true);
-      
-      // Verify Kotlin files exist
-      expect(validationResult.details.kotlinFiles).toBeDefined();
-      expect(validationResult.details.kotlinFiles!.length).toBeGreaterThan(0);
-    });
-    
-    it('should provide detailed validation errors for invalid build', async () => {
-      // Create a build result with missing files
-      const buildResult = {
-        platform: 'android' as const,
-        success: true,
-        packagePath: tempDir,
-        duration: 1000,
-        warnings: [],
-        errors: []
-      };
-      
-      // Execute validation (should fail due to missing files)
-      const validationResult = await validator.validate(buildResult);
-      
-      // Verify validation failed
-      expect(validationResult.valid).toBe(false);
-      expect(validationResult.errors.length).toBeGreaterThan(0);
-      
-      // Verify error details are provided
-      const firstError = validationResult.errors[0];
-      expect(firstError.code).toBeDefined();
-      expect(firstError.message).toBeDefined();
-      expect(firstError.severity).toBe('error');
-      expect(firstError.category).toBeDefined();
-      expect(firstError.suggestions.length).toBeGreaterThan(0);
-    });
-    
-    it('should validate Jetpack Compose optimizations', async () => {
-      const components: ComponentDefinition[] = [];
-      const tokens: PlatformTokens = {
-        platform: 'android',
-        primitives: {
-          spacing: { space100: { value: 8, unit: 'dp', token: 'space100' } },
-          colors: {},
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        semantics: {
-          spacing: {},
-          colors: {},
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        components: {
-          spacing: {},
-          colors: {},
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        metadata: {
-          platform: 'android',
-          defaultSpacingUnit: 'dp',
-          defaultTypographyUnit: 'sp',
-          supportedUnits: ['dp', 'sp'],
-          constraints: {
-            decimalPrecision: 2,
-            supportsSubpixel: true,
-            roundingMode: 'round'
-          },
-          generatedAt: new Date()
-        }
-      };
-      
-      const config: BuildConfig = {
-        platforms: ['android'],
-        mode: 'production',
-        outputDir: tempDir,
-        parallel: false,
-        incremental: false,
-        sourceMaps: false,
-        minify: true,
-        validation: {
-          interfaces: true,
-          tokens: true,
-          mathematical: true
-        }
-      };
-      
-      // Execute build
-      const buildResult = await builder.build(components, tokens, config);
-      expect(buildResult.success).toBe(true);
-      
-      // Execute validation
-      const validationResult = await validator.validate(buildResult);
-      
-      // Verify Compose optimizations are validated
-      expect(validationResult.optimizationsValid).toBe(true);
-      expect(validationResult.details.optimizations).toBeDefined();
-      expect(validationResult.details.optimizations).toContain('Jetpack Compose enabled');
-    });
-  });
-  
-  describe('Build artifact validation', () => {
-    it('should validate build.gradle.kts contains required dependencies', async () => {
-      const components: ComponentDefinition[] = [];
-      const tokens: PlatformTokens = {
-        platform: 'android',
-        primitives: {
-          spacing: {},
-          colors: {},
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        semantics: {
-          spacing: {},
-          colors: {},
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        components: {
-          spacing: {},
-          colors: {},
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        metadata: {
-          platform: 'android',
-          defaultSpacingUnit: 'dp',
-          defaultTypographyUnit: 'sp',
-          supportedUnits: ['dp', 'sp'],
-          constraints: {
-            decimalPrecision: 2,
-            supportsSubpixel: true,
-            roundingMode: 'round'
-          },
-          generatedAt: new Date()
-        }
-      };
-      
-      const config: BuildConfig = {
-        platforms: ['android'],
-        mode: 'development',
-        outputDir: tempDir,
-        parallel: false,
-        incremental: false,
-        sourceMaps: true,
-        minify: false,
-        validation: {
-          interfaces: true,
-          tokens: true,
-          mathematical: true
-        }
-      };
-      
-      // Execute build
-      const buildResult = await builder.build(components, tokens, config);
-      expect(buildResult.success).toBe(true);
-      
-      // Read build.gradle.kts
-      const buildGradlePath = path.join(buildResult.packagePath, 'build.gradle.kts');
-      const buildGradleContent = await fs.readFile(buildGradlePath, 'utf-8');
-      
-      // Verify required dependencies
-      expect(buildGradleContent).toContain('androidx.compose.ui:ui');
-      expect(buildGradleContent).toContain('androidx.compose.material3:material3');
-      expect(buildGradleContent).toContain('org.jetbrains.kotlin:kotlin-stdlib');
-    });
-    
-    it('should validate Kotlin token files have proper structure', async () => {
-      const components: ComponentDefinition[] = [];
-      const tokens: PlatformTokens = {
-        platform: 'android',
-        primitives: {
-          spacing: {
-            space100: { value: 8, unit: 'dp', token: 'space100' },
-            space200: { value: 16, unit: 'dp', token: 'space200' }
-          },
-          colors: {
-            'color.blue.500': { value: '#3B82F6', unit: '', token: 'color.blue.500' }
-          },
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        semantics: {
-          spacing: {},
-          colors: {},
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        components: {
-          spacing: {},
-          colors: {},
-          typography: {},
-          radius: {},
-          sizing: {},
-          opacity: {},
-          elevation: {},
-          animation: {}
-        },
-        metadata: {
-          platform: 'android',
-          defaultSpacingUnit: 'dp',
-          defaultTypographyUnit: 'sp',
-          supportedUnits: ['dp', 'sp'],
-          constraints: {
-            decimalPrecision: 2,
-            supportsSubpixel: true,
-            roundingMode: 'round'
-          },
-          generatedAt: new Date()
-        }
-      };
-      
-      const config: BuildConfig = {
-        platforms: ['android'],
-        mode: 'development',
-        outputDir: tempDir,
-        parallel: false,
-        incremental: false,
-        sourceMaps: true,
-        minify: false,
-        validation: {
-          interfaces: true,
-          tokens: true,
-          mathematical: true
-        }
-      };
-      
-      // Execute build
-      const buildResult = await builder.build(components, tokens, config);
-      expect(buildResult.success).toBe(true);
-      
-      // Execute validation
-      const validationResult = await validator.validate(buildResult);
-      expect(validationResult.valid).toBe(true);
-      
-      // Verify Kotlin files were generated
-      expect(validationResult.details.kotlinFiles).toBeDefined();
-      expect(validationResult.details.kotlinFiles!.length).toBeGreaterThan(0);
-      
-      // Verify token file exists and has proper structure
-      const tokenFiles = validationResult.details.kotlinFiles!.filter(f => f.includes('tokens/'));
-      expect(tokenFiles.length).toBeGreaterThan(0);
-    });
-  });
-});

package/src/build/__tests__/AndroidMotionTokenGeneration.test.ts

@@ -1,256 +0,0 @@
-/**
- * @category evergreen
- * @purpose Verify build system generates required outputs with correct structure
- */
-/**
- * Android Motion Token Generation Tests
- * 
- * Tests for Android platform motion token generation methods.
- * Verifies that duration, easing, scale, and semantic motion tokens
- * are generated correctly in Kotlin format.
- * 
- * Requirements: 1.7, 2.7, 3.1, 5.1, 5.2, 6.3, 6.7
- */
-
-import { AndroidBuilder } from '../platforms/AndroidBuilder';
-import { durationTokens } from '../../tokens/DurationTokens';
-import { easingTokens } from '../../tokens/EasingTokens';
-import { scaleTokens } from '../../tokens/ScaleTokens';
-import { motionTokens } from '../../tokens/semantic/MotionTokens';
-
-describe('AndroidBuilder - Motion Token Generation', () => {
-  let builder: AndroidBuilder;
-
-  beforeEach(() => {
-    builder = new AndroidBuilder();
-  });
-
-  describe('generateDurationTokens', () => {
-    it('should generate Kotlin duration constants in milliseconds', () => {
-      const result = builder.generateDurationTokens(durationTokens);
-
-      // Should contain object declaration
-      expect(result).toContain('object Duration {');
-
-      // Should generate duration150 constant
-      expect(result).toContain('val Duration150 = 150');
-
-      // Should generate duration250 constant
-      expect(result).toContain('val Duration250 = 250');
-
-      // Should generate duration350 constant
-      expect(result).toContain('val Duration350 = 350');
-
-      // Should include comments
-      expect(result).toContain('/** duration150: 150ms */');
-      expect(result).toContain('/** duration250: 250ms */');
-      expect(result).toContain('/** duration350: 350ms */');
-    });
-
-    it('should use milliseconds for Android platform', () => {
-      const result = builder.generateDurationTokens(durationTokens);
-
-      // Android uses milliseconds (not seconds like iOS)
-      expect(result).toContain('150'); // Not 0.15
-      expect(result).toContain('250'); // Not 0.25
-      expect(result).toContain('350'); // Not 0.35
-    });
-  });
-
-  describe('generateEasingTokens', () => {
-    it('should generate Kotlin easing constants with CubicBezierEasing', () => {
-      const result = builder.generateEasingTokens(easingTokens);
-
-      // Should contain object declaration
-      expect(result).toContain('object Easing {');
-
-      // Should generate easingStandard constant
-      expect(result).toContain('val EasingStandard = CubicBezierEasing(0.4f, 0.0f, 0.2f, 1.0f)');
-
-      // Should generate easingDecelerate constant
-      expect(result).toContain('val EasingDecelerate = CubicBezierEasing(0.0f, 0.0f, 0.2f, 1.0f)');
-
-      // Should generate easingAccelerate constant
-      expect(result).toContain('val EasingAccelerate = CubicBezierEasing(0.4f, 0.0f, 1.0f, 1.0f)');
-
-      // Should include comments with cubic-bezier notation
-      expect(result).toContain('/** easingStandard: cubic-bezier(0.4, 0.0, 0.2, 1) */');
-    });
-
-    it('should use float literals (f suffix) for CubicBezierEasing parameters', () => {
-      const result = builder.generateEasingTokens(easingTokens);
-
-      // All parameters should have 'f' suffix for Kotlin float literals
-      expect(result).toMatch(/0\.4f/);
-      expect(result).toMatch(/0\.0f/);
-      expect(result).toMatch(/0\.2f/);
-      expect(result).toMatch(/1\.0f/);
-    });
-
-    it('should generate PiecewiseLinearEasing for linear easing tokens', () => {
-      const result = builder.generateEasingTokens(easingTokens);
-
-      // Should generate the class
-      expect(result).toContain('class PiecewiseLinearEasing(private val stops: List<Pair<Float, Float>>) : Easing');
-      // Should generate the constant
-      expect(result).toContain('val EasingGlideDecelerate = PiecewiseLinearEasing(listOf(');
-      // Should use Kotlin Pair syntax
-      expect(result).toMatch(/0f to 0f/);
-    });
-  });
-
-  describe('generateScaleTokens', () => {
-    it('should generate Kotlin scale constants', () => {
-      const result = builder.generateScaleTokens(scaleTokens);
-
-      // Should contain object declaration
-      expect(result).toContain('object Scale {');
-
-      // Should generate all scale constants
-      expect(result).toContain('val Scale088 = 0.88f');
-      expect(result).toContain('val Scale092 = 0.92f');
-      expect(result).toContain('val Scale096 = 0.96f');
-      expect(result).toContain('val Scale100 = 1.0f');
-      expect(result).toContain('val Scale104 = 1.04f');
-      expect(result).toContain('val Scale108 = 1.08f');
-
-      // Should include comments
-      expect(result).toContain('/** scale088: 0.88 */');
-      expect(result).toContain('/** scale100: 1 */');
-    });
-
-    it('should use float literals (f suffix) for scale values', () => {
-      const result = builder.generateScaleTokens(scaleTokens);
-
-      // All scale values should have 'f' suffix for Kotlin float literals
-      expect(result).toMatch(/0\.88f/);
-      expect(result).toMatch(/1\.0f/);
-      expect(result).toMatch(/1\.04f/);
-    });
-  });
-
-  describe('generateSemanticMotionTokens', () => {
-    it('should generate Kotlin objects for semantic motion tokens', () => {
-      const result = builder.generateSemanticMotionTokens(motionTokens);
-
-      // Should contain object declaration for motion.floatLabel
-      expect(result).toContain('object MotionFloatLabel {');
-
-      // Should reference duration primitive
-      expect(result).toContain('val duration = Duration.Duration250');
-
-      // Should reference easing primitive
-      expect(result).toContain('val easing = Easing.EasingStandard');
-
-      // Should include description comment
-      expect(result).toContain('/** Float label animation for text input fields');
-    });
-
-    it('should compose primitive token references correctly', () => {
-      const result = builder.generateSemanticMotionTokens(motionTokens);
-
-      // Should use PascalCase for type names
-      expect(result).toContain('Duration.Duration250');
-      expect(result).toContain('Easing.EasingStandard');
-
-      // Should not include raw values (only token references)
-      expect(result).not.toContain('= 250');
-      expect(result).not.toContain('cubic-bezier');
-    });
-
-    it('should handle optional scale references', () => {
-      // Create a motion token with scale reference
-      const motionWithScale = {
-        'motion.testWithScale': {
-          name: 'motion.testWithScale',
-          primitiveReferences: {
-            duration: 'duration250',
-            easing: 'easingStandard',
-            scale: 'scale088'
-          },
-          description: 'Test motion with scale'
-        }
-      };
-
-      const result = builder.generateSemanticMotionTokens(motionWithScale);
-
-      // Should include scale reference
-      expect(result).toContain('val scale = Scale.Scale088');
-    });
-  });
-
-  describe('Kotlin naming conventions', () => {
-    it('should convert token names to PascalCase for types', () => {
-      const result = builder.generateDurationTokens(durationTokens);
-
-      // Type names should be PascalCase
-      expect(result).toContain('Duration150');
-      expect(result).toContain('Duration250');
-      expect(result).toContain('Duration350');
-    });
-
-    it('should handle dotted names correctly', () => {
-      const result = builder.generateSemanticMotionTokens(motionTokens);
-
-      // motion.floatLabel should become MotionFloatLabel
-      expect(result).toContain('MotionFloatLabel');
-    });
-  });
-
-  describe('Cross-platform consistency', () => {
-    it('should maintain mathematical equivalence with web platform', () => {
-      const androidDurations = builder.generateDurationTokens(durationTokens);
-
-      // Android uses milliseconds (same as web)
-      expect(androidDurations).toContain('150');
-      expect(androidDurations).toContain('250');
-      expect(androidDurations).toContain('350');
-    });
-
-    it('should use same cubic-bezier values as other platforms', () => {
-      const androidEasings = builder.generateEasingTokens(easingTokens);
-
-      // Should use Material Design standard curves
-      expect(androidEasings).toContain('0.4f, 0.0f, 0.2f, 1.0f'); // Standard
-      expect(androidEasings).toContain('0.0f, 0.0f, 0.2f, 1.0f'); // Decelerate
-      expect(androidEasings).toContain('0.4f, 0.0f, 1.0f, 1.0f'); // Accelerate
-    });
-
-    it('should use same scale values as other platforms', () => {
-      const androidScales = builder.generateScaleTokens(scaleTokens);
-
-      // Scale values should match web and iOS
-      expect(androidScales).toContain('0.88f');
-      expect(androidScales).toContain('0.92f');
-      expect(androidScales).toContain('0.96f');
-      expect(androidScales).toContain('1.0f');
-      expect(androidScales).toContain('1.04f');
-      expect(androidScales).toContain('1.08f');
-    });
-  });
-
-  describe('Kotlin syntax correctness', () => {
-    it('should use correct Kotlin object syntax', () => {
-      const result = builder.generateDurationTokens(durationTokens);
-
-      // Should use 'object' keyword for singleton objects
-      expect(result).toContain('object Duration {');
-      expect(result).toMatch(/}\s*$/); // Should close with }
-    });
-
-    it('should use correct Kotlin val syntax', () => {
-      const result = builder.generateDurationTokens(durationTokens);
-
-      // Should use 'val' for immutable constants
-      expect(result).toMatch(/val Duration\d+ = \d+/);
-    });
-
-    it('should use correct Kotlin comment syntax', () => {
-      const result = builder.generateDurationTokens(durationTokens);
-
-      // Should use /** */ for documentation comments
-      expect(result).toContain('/**');
-      expect(result).toContain('*/');
-    });
-  });
-});