@3fn/core 14.1.0 → 15.0.0

package/src/assets/fonts/__tests__/fontLoading.test.ts

@@ -1,341 +0,0 @@
-/**
- * @category evergreen
- * @purpose Verify fontLoading functionality works correctly
- */
-/**
- * Web Font Loading Tests
- * 
- * Tests for font loading behavior, fallback handling, and FOIT prevention.
- * 
- * Requirements: 6.1, 6.2, 6.5
- */
-
-import { describe, it, expect, beforeAll, afterEach } from '@jest/globals';
-
-describe('Web Font Loading', () => {
-  // Mock document.fonts API for testing
-  let mockFonts: Map<string, boolean>;
-  let originalFonts: any;
-
-  beforeAll(() => {
-    // Store original document.fonts
-    originalFonts = (global as any).document?.fonts;
-
-    // Create mock fonts API
-    mockFonts = new Map();
-    
-    (global as any).document = {
-      ...(global as any).document,
-      fonts: {
-        check: (fontSpec: string): boolean => {
-          const fontFamily = fontSpec.match(/['"]?([^'"]+)['"]?/)?.[1] || '';
-          return mockFonts.get(fontFamily) || false;
-        },
-        load: async (fontSpec: string): Promise<void> => {
-          const fontFamily = fontSpec.match(/['"]?([^'"]+)['"]?/)?.[1] || '';
-          mockFonts.set(fontFamily, true);
-        },
-        ready: Promise.resolve(),
-        size: mockFonts.size,
-        status: 'loaded' as FontFaceSetLoadStatus
-      }
-    };
-  });
-
-  afterEach(() => {
-    // Clear mock fonts between tests
-    mockFonts.clear();
-  });
-
-  describe('Rajdhani Font Loading', () => {
-    it('should load Rajdhani Regular (400) successfully', async () => {
-      // Simulate font loading
-      await document.fonts.load('16px Rajdhani');
-      
-      // Verify font is available
-      const isLoaded = document.fonts.check('16px Rajdhani');
-      expect(isLoaded).toBe(true);
-    });
-
-    it('should load Rajdhani Medium (500) successfully', async () => {
-      await document.fonts.load('500 16px Rajdhani');
-      
-      const isLoaded = document.fonts.check('500 16px Rajdhani');
-      expect(isLoaded).toBe(true);
-    });
-
-    it('should load Rajdhani SemiBold (600) successfully', async () => {
-      await document.fonts.load('600 16px Rajdhani');
-      
-      const isLoaded = document.fonts.check('600 16px Rajdhani');
-      expect(isLoaded).toBe(true);
-    });
-
-    it('should load Rajdhani Bold (700) successfully', async () => {
-      await document.fonts.load('700 16px Rajdhani');
-      
-      const isLoaded = document.fonts.check('700 16px Rajdhani');
-      expect(isLoaded).toBe(true);
-    });
-
-    it('should load all Rajdhani weights', async () => {
-      const weights = [400, 500, 600, 700];
-      
-      for (const weight of weights) {
-        await document.fonts.load(`${weight} 16px Rajdhani`);
-      }
-      
-      // Verify all weights loaded
-      for (const weight of weights) {
-        const isLoaded = document.fonts.check(`${weight} 16px Rajdhani`);
-        expect(isLoaded).toBe(true);
-      }
-    });
-  });
-
-  describe('Inter Font Loading', () => {
-    it('should load Inter Regular (400) successfully', async () => {
-      await document.fonts.load('16px Inter');
-      
-      const isLoaded = document.fonts.check('16px Inter');
-      expect(isLoaded).toBe(true);
-    });
-
-    it('should load Inter Medium (500) successfully', async () => {
-      await document.fonts.load('500 16px Inter');
-      
-      const isLoaded = document.fonts.check('500 16px Inter');
-      expect(isLoaded).toBe(true);
-    });
-
-    it('should load Inter SemiBold (600) successfully', async () => {
-      await document.fonts.load('600 16px Inter');
-      
-      const isLoaded = document.fonts.check('600 16px Inter');
-      expect(isLoaded).toBe(true);
-    });
-
-    it('should load Inter Bold (700) successfully', async () => {
-      await document.fonts.load('700 16px Inter');
-      
-      const isLoaded = document.fonts.check('700 16px Inter');
-      expect(isLoaded).toBe(true);
-    });
-
-    it('should load all Inter weights', async () => {
-      const weights = [400, 500, 600, 700];
-      
-      for (const weight of weights) {
-        await document.fonts.load(`${weight} 16px Inter`);
-      }
-      
-      // Verify all weights loaded
-      for (const weight of weights) {
-        const isLoaded = document.fonts.check(`${weight} 16px Inter`);
-        expect(isLoaded).toBe(true);
-      }
-    });
-  });
-
-  describe('Fallback Font Behavior', () => {
-    it('should use fallback fonts when Rajdhani unavailable', () => {
-      // Don't load Rajdhani
-      const fontStack = 'Rajdhani, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif';
-      
-      // Check if Rajdhani is available
-      const rajdhaniLoaded = document.fonts.check('16px Rajdhani');
-      expect(rajdhaniLoaded).toBe(false);
-      
-      // Verify fallback fonts are in stack
-      expect(fontStack).toContain('-apple-system');
-      expect(fontStack).toContain('BlinkMacSystemFont');
-      expect(fontStack).toContain('Segoe UI');
-      expect(fontStack).toContain('Roboto');
-      expect(fontStack).toContain('sans-serif');
-    });
-
-    it('should use fallback fonts when Inter unavailable', () => {
-      // Don't load Inter
-      const fontStack = 'Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif';
-      
-      // Check if Inter is available
-      const interLoaded = document.fonts.check('16px Inter');
-      expect(interLoaded).toBe(false);
-      
-      // Verify fallback fonts are in stack
-      expect(fontStack).toContain('-apple-system');
-      expect(fontStack).toContain('BlinkMacSystemFont');
-      expect(fontStack).toContain('Segoe UI');
-      expect(fontStack).toContain('Roboto');
-      expect(fontStack).toContain('sans-serif');
-    });
-
-    it('should gracefully degrade to system fonts', () => {
-      // Simulate custom fonts not loading
-      const rajdhaniLoaded = document.fonts.check('16px Rajdhani');
-      const interLoaded = document.fonts.check('16px Inter');
-      
-      expect(rajdhaniLoaded).toBe(false);
-      expect(interLoaded).toBe(false);
-      
-      // System fonts should always be available (implicit in font stack)
-      const displayStack = 'Rajdhani, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif';
-      const bodyStack = 'Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif';
-      
-      // Verify fallback structure
-      expect(displayStack.split(',').length).toBeGreaterThan(1);
-      expect(bodyStack.split(',').length).toBeGreaterThan(1);
-    });
-  });
-
-  describe('Font-Display: Swap (FOIT Prevention)', () => {
-    it('should use font-display: swap for Rajdhani fonts', () => {
-      // This test verifies the CSS configuration
-      // In actual CSS: font-display: swap;
-      
-      // Verify swap behavior: text visible immediately with fallback
-      const fontDisplayValue = 'swap';
-      expect(fontDisplayValue).toBe('swap');
-      
-      // Swap means:
-      // - Text visible immediately with fallback font
-      // - Custom font swapped in when loaded
-      // - No invisible text period (FOIT prevented)
-    });
-
-    it('should use font-display: swap for Inter fonts', () => {
-      // This test verifies the CSS configuration
-      // In actual CSS: font-display: swap;
-      
-      const fontDisplayValue = 'swap';
-      expect(fontDisplayValue).toBe('swap');
-      
-      // Swap prevents FOIT by showing fallback immediately
-    });
-
-    it('should prevent FOIT (Flash of Invisible Text)', () => {
-      // FOIT occurs when text is invisible while custom font loads
-      // font-display: swap prevents this by showing fallback immediately
-      
-      const fontDisplayStrategy = 'swap';
-      
-      // Verify swap strategy is used (not 'block' which causes FOIT)
-      expect(fontDisplayStrategy).not.toBe('block');
-      expect(fontDisplayStrategy).toBe('swap');
-      
-      // With swap:
-      // 1. Text visible immediately with fallback
-      // 2. Custom font swaps in when loaded
-      // 3. No invisible text period
-    });
-
-    it('should show text immediately with fallback fonts', () => {
-      // Simulate font not loaded yet
-      const rajdhaniLoaded = document.fonts.check('16px Rajdhani');
-      expect(rajdhaniLoaded).toBe(false);
-      
-      // With font-display: swap, text should be visible with fallback
-      const fontStack = 'Rajdhani, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif';
-      const fallbackFonts = fontStack.split(',').slice(1).map(f => f.trim());
-      
-      // Verify fallback fonts available
-      expect(fallbackFonts.length).toBeGreaterThan(0);
-      expect(fallbackFonts).toContain('-apple-system');
-      
-      // Text visible immediately with fallback (swap behavior)
-    });
-  });
-
-  describe('Font Format Priority', () => {
-    it('should prioritize WOFF2 format for Rajdhani', () => {
-      // Verify WOFF2 is listed first in @font-face src
-      const fontSrc = `
-        url('./Rajdhani-Regular.woff2') format('woff2'),
-        url('./Rajdhani-Regular.woff') format('woff'),
-        url('./Rajdhani-Regular.ttf') format('truetype')
-      `;
-      
-      // WOFF2 should appear before WOFF and TTF
-      const woff2Index = fontSrc.indexOf('woff2');
-      const woffIndex = fontSrc.indexOf("format('woff')");
-      const ttfIndex = fontSrc.indexOf('truetype');
-      
-      expect(woff2Index).toBeLessThan(woffIndex);
-      expect(woff2Index).toBeLessThan(ttfIndex);
-    });
-
-    it('should prioritize WOFF2 format for Inter', () => {
-      // Verify WOFF2 is listed first in @font-face src
-      const fontSrc = `
-        url('./Inter-Regular.woff2') format('woff2'),
-        url('./Inter-Regular.ttf') format('truetype')
-      `;
-      
-      // WOFF2 should appear before TTF
-      const woff2Index = fontSrc.indexOf('woff2');
-      const ttfIndex = fontSrc.indexOf('truetype');
-      
-      expect(woff2Index).toBeLessThan(ttfIndex);
-    });
-
-    it('should provide TTF fallback for broader compatibility', () => {
-      // Both fonts should have TTF format as fallback
-      const rajdhaniFontSrc = `
-        url('./Rajdhani-Regular.woff2') format('woff2'),
-        url('./Rajdhani-Regular.woff') format('woff'),
-        url('./Rajdhani-Regular.ttf') format('truetype')
-      `;
-      
-      const interFontSrc = `
-        url('./Inter-Regular.woff2') format('woff2'),
-        url('./Inter-Regular.ttf') format('truetype')
-      `;
-      
-      // Verify TTF format present
-      expect(rajdhaniFontSrc).toContain('truetype');
-      expect(interFontSrc).toContain('truetype');
-    });
-  });
-
-  describe('Font Stack Configuration', () => {
-    it('should have correct display font stack', () => {
-      const displayStack = 'Rajdhani, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif';
-      
-      // Verify Rajdhani is primary
-      expect(displayStack.startsWith('Rajdhani')).toBe(true);
-      
-      // Verify system font fallbacks
-      expect(displayStack).toContain('-apple-system');
-      expect(displayStack).toContain('BlinkMacSystemFont');
-      expect(displayStack).toContain('Segoe UI');
-      expect(displayStack).toContain('Roboto');
-      expect(displayStack).toContain('sans-serif');
-    });
-
-    it('should have correct body font stack', () => {
-      const bodyStack = 'Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif';
-      
-      // Verify Inter is primary
-      expect(bodyStack.startsWith('Inter')).toBe(true);
-      
-      // Verify system font fallbacks
-      expect(bodyStack).toContain('-apple-system');
-      expect(bodyStack).toContain('BlinkMacSystemFont');
-      expect(bodyStack).toContain('Segoe UI');
-      expect(bodyStack).toContain('Roboto');
-      expect(bodyStack).toContain('sans-serif');
-    });
-
-    it('should have identical fallback chains for display and body', () => {
-      const displayStack = 'Rajdhani, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif';
-      const bodyStack = 'Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif';
-      
-      // Extract fallback portions (everything after first comma)
-      const displayFallbacks = displayStack.split(',').slice(1).join(',');
-      const bodyFallbacks = bodyStack.split(',').slice(1).join(',');
-      
-      // Fallback chains should be identical
-      expect(displayFallbacks).toBe(bodyFallbacks);
-    });
-  });
-});

package/src/assets/fonts/__tests__/iosFontConfiguration.test.ts

@@ -1,256 +0,0 @@
-/**
- * @category evergreen
- * @purpose Verify iosFontConfiguration functionality works correctly
- */
-/**
- * iOS Font Configuration Tests
- * 
- * Validates that iOS font integration documentation is complete and accurate
- * for Inter and Rajdhani font families.
- * 
- * Requirements: 7.1, 7.2
- */
-
-import { describe, test, expect } from '@jest/globals';
-import * as fs from 'fs';
-import * as path from 'path';
-
-describe('iOS Font Configuration', () => {
-  const docsPath = path.join(__dirname, '../../../../docs/platform-integration/ios-font-setup.md');
-  
-  test('iOS font setup documentation exists', () => {
-    expect(fs.existsSync(docsPath)).toBe(true);
-  });
-
-  test('documentation includes all required Inter font files', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    const requiredInterFonts = [
-      'Inter-Regular.ttf',
-      'Inter-Medium.ttf',
-      'Inter-SemiBold.ttf',
-      'Inter-Bold.ttf'
-    ];
-
-    requiredInterFonts.forEach(fontFile => {
-      expect(content).toContain(fontFile);
-    });
-  });
-
-  test('documentation includes all required Rajdhani font files', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    const requiredRajdhaniFonts = [
-      'Rajdhani-Regular.ttf',
-      'Rajdhani-Medium.ttf',
-      'Rajdhani-SemiBold.ttf',
-      'Rajdhani-Bold.ttf'
-    ];
-
-    requiredRajdhaniFonts.forEach(fontFile => {
-      expect(content).toContain(fontFile);
-    });
-  });
-
-  test('documentation includes UIAppFonts array configuration', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    expect(content).toContain('UIAppFonts');
-    expect(content).toContain('<key>UIAppFonts</key>');
-    expect(content).toContain('<array>');
-  });
-
-  test('documentation includes Info.plist XML example', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    expect(content).toContain('<?xml version="1.0" encoding="UTF-8"?>');
-    expect(content).toContain('<!DOCTYPE plist');
-    expect(content).toContain('<plist version="1.0">');
-  });
-
-  test('documentation includes SwiftUI usage examples', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    expect(content).toContain('SwiftUI');
-    expect(content).toContain('.custom("Rajdhani"');
-    expect(content).toContain('.custom("Inter"');
-  });
-
-  test('documentation includes UIKit usage examples', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    expect(content).toContain('UIKit');
-    expect(content).toContain('UIFont(name: "Rajdhani-');
-    expect(content).toContain('UIFont(name: "Inter-');
-  });
-
-  test('documentation includes font weight mapping', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    const weights = ['400', '500', '600', '700'];
-    weights.forEach(weight => {
-      expect(content).toContain(weight);
-    });
-
-    expect(content).toContain('Regular');
-    expect(content).toContain('Medium');
-    expect(content).toContain('SemiBold');
-    expect(content).toContain('Bold');
-  });
-
-  test('documentation includes fallback font guidance', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    expect(content).toContain('SF Pro Display');
-    expect(content).toContain('SF Pro Text');
-    expect(content).toContain('fallback');
-  });
-
-  test('documentation includes verification code', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    expect(content).toContain('verifyCustomFonts');
-    expect(content).toContain('UIFont(name:');
-  });
-
-  test('documentation includes troubleshooting section', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    expect(content).toContain('Troubleshooting');
-    expect(content).toContain('Fonts Not Loading');
-    expect(content).toContain('Copy Bundle Resources');
-  });
-
-  test('documentation references requirements', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    expect(content).toContain('Requirement 7.1');
-    expect(content).toContain('Requirement 7.2');
-  });
-
-  test('all 8 font files are documented', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    // Count occurrences of each font file in UIAppFonts section
-    const uiAppFontsSection = content.match(/<key>UIAppFonts<\/key>[\s\S]*?<\/array>/);
-    expect(uiAppFontsSection).toBeTruthy();
-    
-    if (uiAppFontsSection) {
-      const fontFileMatches = uiAppFontsSection[0].match(/<string>.*?\.ttf<\/string>/g);
-      expect(fontFileMatches).toHaveLength(8);
-    }
-  });
-
-  test('documentation includes PostScript name reference', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    expect(content).toContain('PostScript');
-    expect(content).toContain('Inter-Regular');
-    expect(content).toContain('Rajdhani-Regular');
-  });
-
-  test('documentation includes Xcode setup instructions', () => {
-    const content = fs.readFileSync(docsPath, 'utf-8');
-    
-    expect(content).toContain('Xcode');
-    expect(content).toContain('Add Files to');
-    expect(content).toContain('Build Phases');
-    expect(content).toContain('Copy items if needed');
-  });
-});
-
-describe('iOS Font File Validation', () => {
-  const interFontPath = path.join(__dirname, '../inter');
-  const rajdhaniFontPath = path.join(__dirname, '../rajdhani');
-
-  test('Inter font directory exists', () => {
-    expect(fs.existsSync(interFontPath)).toBe(true);
-  });
-
-  test('Rajdhani font directory exists', () => {
-    expect(fs.existsSync(rajdhaniFontPath)).toBe(true);
-  });
-
-  test('Inter font files exist', () => {
-    const requiredFiles = [
-      'Inter-Regular.ttf',
-      'Inter-Medium.ttf',
-      'Inter-SemiBold.ttf',
-      'Inter-Bold.ttf'
-    ];
-
-    requiredFiles.forEach(file => {
-      const filePath = path.join(interFontPath, file);
-      expect(fs.existsSync(filePath)).toBe(true);
-    });
-  });
-
-  test('Rajdhani font files exist', () => {
-    const requiredFiles = [
-      'Rajdhani-Regular.ttf',
-      'Rajdhani-Medium.ttf',
-      'Rajdhani-SemiBold.ttf',
-      'Rajdhani-Bold.ttf'
-    ];
-
-    requiredFiles.forEach(file => {
-      const filePath = path.join(rajdhaniFontPath, file);
-      expect(fs.existsSync(filePath)).toBe(true);
-    });
-  });
-
-  test('all font files are TTF format', () => {
-    const interFiles = fs.readdirSync(interFontPath).filter(f => f.endsWith('.ttf'));
-    const rajdhaniFiles = fs.readdirSync(rajdhaniFontPath).filter(f => f.endsWith('.ttf'));
-
-    expect(interFiles.length).toBeGreaterThanOrEqual(4);
-    expect(rajdhaniFiles.length).toBeGreaterThanOrEqual(4);
-  });
-});
-
-describe('iOS Font Configuration Completeness', () => {
-  test('documentation covers all required aspects', () => {
-    const docsPath = path.join(__dirname, '../../../../docs/platform-integration/ios-font-setup.md');
-    const content = fs.readFileSync(docsPath, 'utf-8');
-
-    const requiredSections = [
-      'Overview',
-      'Font Files Required',
-      'Info.plist Configuration',
-      'Xcode Project Setup',
-      'SwiftUI Usage',
-      'UIKit Usage',
-      'Fallback Fonts',
-      'Verification',
-      'Troubleshooting',
-      'Requirements Compliance'
-    ];
-
-    requiredSections.forEach(section => {
-      expect(content).toContain(section);
-    });
-  });
-
-  test('documentation provides complete UIAppFonts array', () => {
-    const docsPath = path.join(__dirname, '../../../../docs/platform-integration/ios-font-setup.md');
-    const content = fs.readFileSync(docsPath, 'utf-8');
-
-    // Extract UIAppFonts array
-    const arrayMatch = content.match(/<key>UIAppFonts<\/key>\s*<array>([\s\S]*?)<\/array>/);
-    expect(arrayMatch).toBeTruthy();
-
-    if (arrayMatch) {
-      const arrayContent = arrayMatch[1];
-      
-      // Verify all 8 fonts are listed
-      expect(arrayContent).toContain('Inter-Regular.ttf');
-      expect(arrayContent).toContain('Inter-Medium.ttf');
-      expect(arrayContent).toContain('Inter-SemiBold.ttf');
-      expect(arrayContent).toContain('Inter-Bold.ttf');
-      expect(arrayContent).toContain('Rajdhani-Regular.ttf');
-      expect(arrayContent).toContain('Rajdhani-Medium.ttf');
-      expect(arrayContent).toContain('Rajdhani-SemiBold.ttf');
-      expect(arrayContent).toContain('Rajdhani-Bold.ttf');
-    }
-  });
-});