@jmruthers/pace-core 0.6.10 → 0.6.11

package/scripts/install-eslint-config.cjs

@@ -1,349 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Installation Script for pace-core ESLint Config
- * @package @jmruthers/pace-core
- * @module Scripts/install-eslint-config
- * 
- * Sets up pace-core ESLint configuration in consuming apps.
- * Adds pace-core ESLint config to consuming app's ESLint configuration.
- * 
- * This is an opt-in script - it does NOT run automatically via postinstall.
- * 
- * Usage:
- *   node install-eslint-config.cjs        # Setup ESLint config
- *   node install-eslint-config.cjs --force # Force update even if already configured
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// Check for safety guards
-function checkSafetyGuards() {
-  // Check environment variable
-  if (process.env.PACE_ESLINT_CONFIG_DISABLED === '1') {
-    console.log(`${colors.yellow}Skipping ESLint config installation: PACE_ESLINT_CONFIG_DISABLED=1${colors.reset}`);
-    process.exit(0);
-  }
-  
-  // Check for .git folder (safety guard for CI)
-  const cwd = process.cwd();
-  if (!fs.existsSync(path.join(cwd, '.git'))) {
-    console.log(`${colors.yellow}Skipping ESLint config installation: No .git folder found${colors.reset}`);
-    console.log(`${colors.yellow}This is a safety guard. If you want to install anyway, run with --force${colors.reset}`);
-    if (!process.argv.includes('--force')) {
-      process.exit(0);
-    }
-  }
-}
-
-// ANSI color codes for terminal output
-const colors = {
-  reset: '\x1b[0m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  cyan: '\x1b[36m',
-  bold: '\x1b[1m',
-  red: '\x1b[31m'
-};
-
-// Find existing ESLint config file
-function findESLintConfig() {
-  const cwd = process.cwd();
-  const possibleConfigs = [
-    'eslint.config.js',
-    'eslint.config.cjs',
-    'eslint.config.mjs',
-    '.eslintrc.js',
-    '.eslintrc.cjs',
-    '.eslintrc.json',
-    '.eslintrc.yaml',
-    '.eslintrc.yml',
-  ];
-  
-  for (const configFile of possibleConfigs) {
-    const configPath = path.join(cwd, configFile);
-    if (fs.existsSync(configPath)) {
-      return { path: configPath, name: configFile, isESM: configFile.endsWith('.js') || configFile.endsWith('.mjs') };
-    }
-  }
-  
-  return null;
-}
-
-// Check if pace-core config is already included
-function hasPaceCoreConfig(configContent) {
-  // Check for pace-core config import/require
-  const paceCorePatterns = [
-    /@jmruthers\/pace-core\/eslint-config/,
-    /pace-core\/eslint-config/,
-    /paceCoreConfig/,
-    /pace-core-compliance/,
-  ];
-  
-  return paceCorePatterns.some(pattern => pattern.test(configContent));
-}
-
-// Detect if file is ES module
-function isESModule(filePath, content) {
-  if (filePath.endsWith('.mjs')) return true;
-  if (filePath.endsWith('.cjs')) return false;
-  if (filePath.endsWith('.js')) {
-    // Check for ES module indicators
-    return /^import\s+.*from|^export\s+default/.test(content.trim());
-  }
-  return false;
-}
-
-// Detect if config uses tseslint.config() wrapper
-function usesTseslintConfig(content) {
-  return /tseslint\.config\s*\(/.test(content);
-}
-
-// Validate ESLint config structure
-function validateConfig(configPath, content) {
-  try {
-    // Basic validation - check for common syntax errors
-    // Check for balanced brackets
-    const openBrackets = (content.match(/\[/g) || []).length;
-    const closeBrackets = (content.match(/\]/g) || []).length;
-    if (openBrackets !== closeBrackets) {
-      return { valid: false, error: `Unbalanced brackets: ${openBrackets} open, ${closeBrackets} close` };
-    }
-    
-    // Check for balanced parentheses
-    const openParens = (content.match(/\(/g) || []).length;
-    const closeParens = (content.match(/\)/g) || []).length;
-    if (openParens !== closeParens) {
-      return { valid: false, error: `Unbalanced parentheses: ${openParens} open, ${closeParens} close` };
-    }
-    
-    // Check that paceCoreConfig is spread correctly
-    if (content.includes('...paceCoreConfig')) {
-      // Should be spread in an array or tseslint.config()
-      if (!content.includes('[...paceCoreConfig') && !content.includes('tseslint.config(...paceCoreConfig')) {
-        return { valid: false, error: 'paceCoreConfig must be spread in an array or tseslint.config()' };
-      }
-    }
-    
-    return { valid: true };
-  } catch (error) {
-    return { valid: false, error: error.message };
-  }
-}
-
-// Backup file before modification
-function backupFile(filePath) {
-  const backupPath = `${filePath}.backup.${Date.now()}`;
-  fs.copyFileSync(filePath, backupPath);
-  return backupPath;
-}
-
-// Setup ESLint configuration
-function setupESLintConfig(force = false) {
-  const cwd = process.cwd();
-  const existingConfig = findESLintConfig();
-  
-  if (existingConfig) {
-    // Read existing config
-    let content = fs.readFileSync(existingConfig.path, 'utf8');
-    const isESM = isESModule(existingConfig.path, content);
-    const format = isESM ? 'ES Module' : 'CommonJS';
-    
-    console.log(`${colors.cyan}Found ESLint config:${colors.reset} ${existingConfig.name} (${format})`);
-    
-    // Check if already configured
-    if (hasPaceCoreConfig(content)) {
-      if (!force) {
-        console.log(`${colors.blue}○${colors.reset} ${existingConfig.name} already includes pace-core rules`);
-        console.log(`${colors.blue}  Use --force to update.${colors.reset}`);
-        return { action: 'skipped', file: existingConfig.name, format };
-      }
-      
-      console.log(`${colors.yellow}Updating existing ESLint config...${colors.reset}`);
-    } else {
-      console.log(`${colors.cyan}Adding pace-core config to ${existingConfig.name}...${colors.reset}`);
-    }
-    
-    // Backup before modification
-    const backupPath = backupFile(existingConfig.path);
-    console.log(`${colors.cyan}  Backed up to ${path.basename(backupPath)}${colors.reset}`);
-    
-    // Add pace-core config
-    if (isESM) {
-      // ES Module format
-      if (!content.includes('import paceCoreConfig')) {
-        // Add import at top (after other imports if they exist)
-        const importLines = content.match(/^(import\s+[^;]+;?\s*\n)+/m);
-        if (importLines) {
-          // Add after existing imports
-          content = content.replace(
-            importLines[0],
-            `${importLines[0]}import paceCoreConfig from '@jmruthers/pace-core/eslint-config';\n`
-          );
-        } else {
-          // Add at the beginning
-          content = `import paceCoreConfig from '@jmruthers/pace-core/eslint-config';\n${content}`;
-        }
-      }
-      
-      // Handle tseslint.config() wrapper
-      if (usesTseslintConfig(content)) {
-        // Config uses tseslint.config() - spread paceCoreConfig as first argument
-        if (!content.includes('...paceCoreConfig')) {
-          // Find tseslint.config( and add paceCoreConfig as first argument
-          // Handle both cases: tseslint.config(...) and tseslint.config(\n...)
-          if (content.match(/tseslint\.config\s*\(\s*[^\n]/)) {
-            // Has content on same line, add after opening paren
-            content = content.replace(
-              /(tseslint\.config\s*\()\s*/,
-              '$1\n    ...paceCoreConfig,\n    '
-            );
-          } else {
-            // Has content on new line, add as first line
-            content = content.replace(
-              /(tseslint\.config\s*\(\s*\n)\s*/,
-              '$1    ...paceCoreConfig,\n    '
-            );
-          }
-        }
-      } else if (content.includes('export default [')) {
-        // Already an array, add paceCoreConfig at the beginning
-        if (!content.includes('...paceCoreConfig')) {
-          content = content.replace(
-            /(export\s+default\s*\[)\s*/,
-            '$1\n  ...paceCoreConfig,'
-          );
-        }
-      } else if (content.includes('export default')) {
-        // Not an array, wrap it
-        const exportMatch = content.match(/(export\s+default\s+)(.+?)(;?\s*$)/s);
-        if (exportMatch) {
-          content = content.replace(
-            exportMatch[0],
-            `${exportMatch[1]}[\n  ...paceCoreConfig,\n  ${exportMatch[2]}\n];`
-          );
-        }
-      }
-    } else {
-      // CommonJS format
-      if (!content.includes('require(\'@jmruthers/pace-core/eslint-config\')')) {
-        // Add require at top (after other requires if they exist)
-        const requireLines = content.match(/^(const\s+\w+\s*=\s*require\([^)]+\);\s*\n)+/m);
-        if (requireLines) {
-          content = content.replace(
-            requireLines[0],
-            `${requireLines[0]}const paceCoreConfig = require('@jmruthers/pace-core/eslint-config');\n`
-          );
-        } else {
-          content = `const paceCoreConfig = require('@jmruthers/pace-core/eslint-config');\n${content}`;
-        }
-      }
-      
-      // Add to module.exports
-      if (content.includes('module.exports = [')) {
-        // Already an array, add paceCoreConfig at the beginning
-        if (!content.includes('...paceCoreConfig')) {
-          content = content.replace(
-            /(module\.exports\s*=\s*\[)\s*/,
-            '$1\n  ...paceCoreConfig,'
-          );
-        }
-      } else if (content.includes('module.exports =')) {
-        // Not an array, wrap it
-        const exportMatch = content.match(/(module\.exports\s*=\s*)(.+?)(;?\s*$)/s);
-        if (exportMatch) {
-          content = content.replace(
-            exportMatch[0],
-            `${exportMatch[1]}[\n  ...paceCoreConfig,\n  ${exportMatch[2]}\n];`
-          );
-        }
-      }
-    }
-    
-    // Validate config before writing
-    const validation = validateConfig(existingConfig.path, content);
-    if (!validation.valid) {
-      console.error(`${colors.red}✗${colors.reset} Config validation failed: ${validation.error}`);
-      console.error(`${colors.yellow}  Restoring backup...${colors.reset}`);
-      fs.copyFileSync(backupPath, existingConfig.path);
-      throw new Error(`Invalid ESLint config structure: ${validation.error}`);
-    }
-    
-    // Write updated config
-    fs.writeFileSync(existingConfig.path, content, 'utf8');
-    console.log(`${colors.green}✓${colors.reset} Updated ${existingConfig.name}`);
-    return { action: 'updated', file: existingConfig.name, backup: backupPath, format };
-  } else {
-    // Create new ESLint config (default to ES modules)
-    const configPath = path.join(cwd, 'eslint.config.js');
-    const configContent = `import paceCoreConfig from '@jmruthers/pace-core/eslint-config';
-
-export default [
-  ...paceCoreConfig,
-  // Your app-specific ESLint configuration
-  {
-    // Add your rules here
-  },
-];
-`;
-    
-    console.log(`${colors.cyan}No ESLint config found. Creating eslint.config.js...${colors.reset}`);
-    fs.writeFileSync(configPath, configContent, 'utf8');
-    console.log(`${colors.green}✓${colors.reset} Created eslint.config.js`);
-    console.log(`${colors.cyan}  Edit eslint.config.js to add your app-specific ESLint rules.${colors.reset}`);
-    return { action: 'created', file: 'eslint.config.js', format: 'ES Module' };
-  }
-}
-
-// Main execution
-function main() {
-  checkSafetyGuards();
-  
-  const force = process.argv.includes('--force');
-  
-  if (force) {
-    console.log(`${colors.yellow}Warning: --force flag is set. This will overwrite existing configurations.${colors.reset}\n`);
-  }
-  
-  try {
-    console.log(`${colors.cyan}Setting up ESLint configuration from pace-core...${colors.reset}\n`);
-    const result = setupESLintConfig(force);
-    
-    // Summary
-    console.log(`\n${colors.bold}Setup Summary:${colors.reset}`);
-    if (result.action === 'created') {
-      console.log(`  ${colors.green}ESLint Config:${colors.reset} Created ${result.file} (${result.format})`);
-    } else if (result.action === 'updated') {
-      console.log(`  ${colors.green}ESLint Config:${colors.reset} Updated ${result.file} (${result.format})`);
-      console.log(`  ${colors.yellow}Backup:${colors.reset} ${path.basename(result.backup)}`);
-    } else {
-      console.log(`  ${colors.blue}ESLint Config:${colors.reset} Already configured (${result.file}, ${result.format})`);
-    }
-    
-    console.log(`\n${colors.cyan}ESLint configuration is now available${colors.reset}`);
-    console.log(`\n${colors.cyan}Next steps:${colors.reset}`);
-    console.log(`  • Run ${colors.bold}npm run lint${colors.reset} to verify ESLint is working`);
-    console.log(`  • Edit your ESLint config to add app-specific rules`);
-    console.log(`  • See ${colors.bold}packages/core/docs/standards/${colors.reset} for complete standards documentation`);
-    
-  } catch (error) {
-    console.error(`${colors.red}Error during setup:${colors.reset}`);
-    console.error(error.message);
-    if (error.stack) {
-      console.error(error.stack);
-    }
-    process.exit(1);
-  }
-}
-
-// Run if called directly
-if (require.main === module) {
-  main();
-}
-
-module.exports = { 
-  setupESLintConfig,
-  findESLintConfig
-};

package/scripts/setup-build-cache.js

@@ -1,73 +0,0 @@
-
-/**
- * Build Cache Setup Script
- * Configures optimal caching for faster builds in CI/CD
- */
-
-import { writeFile, readFile } from 'fs/promises';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { existsSync } from 'fs';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const packageRoot = join(__dirname, '..');
-
-console.log('🚀 Setting up build caching configuration...');
-console.log();
-console.log('📋 Setting up build caching...');
-
-async function setupBuildCache() {
-  try {
-    // Read current tsconfig.json
-    const tsconfigPath = join(packageRoot, 'tsconfig.json');
-    if (existsSync(tsconfigPath)) {
-      const tsconfigContent = await readFile(tsconfigPath, 'utf-8');
-      const tsconfig = JSON.parse(tsconfigContent);
-      
-      // Ensure incremental compilation is enabled
-      if (!tsconfig.compilerOptions) {
-        tsconfig.compilerOptions = {};
-      }
-      
-      tsconfig.compilerOptions.incremental = true;
-      tsconfig.compilerOptions.tsBuildInfoFile = './tsconfig.tsbuildinfo';
-      
-      await writeFile(tsconfigPath, JSON.stringify(tsconfig, null, 2));
-      console.log('✅ TypeScript incremental compilation enabled');
-    }
-
-    console.log('✅ tsup build cache configured');
-    console.log('✅ Vitest cache optimized');
-    console.log('✅ GitHub Actions caching ready');
-
-  } catch (error) {
-    console.warn('⚠️ Could not update build cache configuration:', error.message);
-  }
-
-  console.log();
-  console.log('📊 Cache Configuration Summary:');
-  console.log('  🔧 TypeScript incremental compilation enabled');
-  console.log('  📦 tsup build cache configured');
-  console.log('  🧪 Vitest cache optimized');
-  console.log('  ⚡ GitHub Actions caching ready');
-
-  console.log();
-  console.log('💡 Cache Optimization Tips:');
-  console.log('  - Use npm ci instead of npm install in CI');
-  console.log('  - Cache node_modules based on package-lock.json hash');
-  console.log('  - Cache build outputs based on source file hashes');
-  console.log('  - Restore partial caches when exact match not found');
-
-  console.log();
-  console.log('🚀 Next Steps:');
-  console.log('  1. Commit the updated configuration files');
-  console.log('  2. Push to GitHub to activate workflow caching');
-  console.log('  3. Monitor build times in CI/CD pipeline');
-  console.log('  4. Adjust cache keys if needed for optimal performance');
-}
-
-// Run cache setup
-setupBuildCache().catch(error => {
-  console.error('❌ Cache setup failed:', error);
-  process.exit(1);
-});

package/scripts/validate-pre-publish.js

@@ -1,145 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Pre-publish Validation Script
- * Now uses standardized test execution consistent with npm run test
- * Simplified to rely on vitest exit codes rather than output parsing
- */
-
-import { join } from 'path';
-import { existsSync } from 'fs';
-import {
-  runCommand,
-  runStandardizedTests,
-} from './utils/command-runner.js';
-import { getPackageRoot, getRepoRoot } from './utils/path-helpers.js';
-import { getDefaultTimeout, getTestTimeout } from './utils/env.js';
-import { logger } from './utils/logger.js';
-
-const packageRoot = getPackageRoot(import.meta.url);
-const repoRoot = getRepoRoot(import.meta.url);
-const DEFAULT_TIMEOUT = getDefaultTimeout(30000, 120000);
-const TEST_TIMEOUT = getTestTimeout(300000, 300000);
-
-logger.header('Running pre-publish validation');
-
-// Check if typedoc and its plugins are installed
-function checkTypedocInstallation() {
-  const requiredPackages = [
-    'typedoc',
-    'typedoc-plugin-markdown',
-    'typedoc-plugin-merge-modules'
-  ];
-
-  logger.info('Checking TypeDoc installation...');
-  
-  // Check for specific packages
-  const missingPackages = requiredPackages.filter(pkg => {
-    const pkgPath = join(packageRoot, 'node_modules', pkg);
-    return !existsSync(pkgPath);
-  });
-
-  if (missingPackages.length > 0) {
-    logger.error(`Missing required packages: ${missingPackages.join(', ')}`);
-    logger.info(`Please run: npm install --save-dev ${missingPackages.join(' ')}`);
-    return false;
-  }
-
-  logger.success('TypeDoc installation verified');
-  return true;
-}
-
-// Main validation function
-async function runPrePublishValidation() {
-  try {
-    logger.info('Running validation steps...');
-    logger.newline();
-
-    // Step 1: Type check
-    logger.step('Step 1: Type check');
-    const typeCheck = await runCommand('npm', ['run', 'type-check'], {
-      cwd: packageRoot,
-      timeout: DEFAULT_TIMEOUT,
-    });
-    if (!typeCheck.success) {
-      logger.error('Type check failed');
-      return false;
-    }
-
-    // Step 2: Build validation
-    logger.newline();
-    logger.step('Step 2: Build validation');
-    const build = await runCommand('npm', ['run', 'build'], {
-      cwd: packageRoot,
-      timeout: getDefaultTimeout(60000, 180000),
-    });
-    if (!build.success) {
-      logger.error('Build failed');
-      return false;
-    }
-
-    // Step 3: Test validation - now uses standardized test execution
-    logger.newline();
-    logger.step('Step 3: Test validation');
-    const tests = await runStandardizedTests(packageRoot, repoRoot, TEST_TIMEOUT);
-    if (!tests.success) {
-      logger.error('Tests failed');
-      return false;
-    }
-
-    // Step 4: Documentation generation
-    logger.newline();
-    logger.step('Step 4: Documentation generation');
-    if (!checkTypedocInstallation()) {
-      logger.error('TypeDoc validation failed');
-      return false;
-    }
-
-    const docs = await runCommand('npm', ['run', 'build:docs'], {
-      cwd: packageRoot,
-      timeout: getDefaultTimeout(120000, 240000),
-    });
-    if (!docs.success) {
-      logger.error('Documentation generation failed');
-      return false;
-    }
-
-    // Step 5: Format validation
-    logger.newline();
-    logger.step('Step 5: Format validation');
-    const format = await runCommand('npm', ['run', 'format:check'], {
-      cwd: packageRoot,
-      timeout: DEFAULT_TIMEOUT,
-    });
-    if (!format.success) {
-      logger.error('Format validation failed');
-      return false;
-    }
-
-    logger.newline();
-    logger.header('PRE-PUBLISH VALIDATION SUMMARY');
-    logger.success('All validation steps passed successfully!');
-    logger.success('Package meets publication requirements');
-    return true;
-  } catch (error) {
-    logger.error(`Pre-publish validation error: ${error.message}`);
-    return false;
-  }
-}
-
-// Run the validation
-(async () => {
-  const success = await runPrePublishValidation();
-  if (!success) {
-    logger.newline();
-    logger.info('Required fixes:');
-    logger.info('- Fix validation failures');
-    logger.info('- Resolve build or type check errors');
-    process.exit(1);
-  } else {
-    process.exit(0);
-  }
-})().catch(error => {
-  logger.error(`Pre-publish validation error: ${error.message}`);
-  process.exit(1);
-});

package/src/__tests__/integration/UserProfile.test.tsx

@@ -1,124 +0,0 @@
-/**
- * @file User Profile Integration Tests
- * @description Example integration test patterns
- */
-
-import React from 'react';
-import { screen, waitFor } from '@testing-library/react';
-import userEvent from '@testing-library/user-event';
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { renderWithProviders } from '../helpers/test-utils';
-import { testData } from '../fixtures/mocks';
-
-// Mock components for demonstration
-const UserProfile = ({ userId }: { userId: string }) => {
-  const [user, setUser] = React.useState<any>(null);
-  const [loading, setLoading] = React.useState(true);
-  const [error, setError] = React.useState<string | null>(null);
-
-  React.useEffect(() => {
-    // Simulate API call
-    const fetchUser = async () => {
-      try {
-        setLoading(true);
-        const userData = testData.users.find(u => u.id === userId);
-        if (userData) {
-          setUser(userData);
-        } else {
-          setError('User not found');
-        }
-      } catch (_err) {
-        setError('Failed to fetch user');
-      } finally {
-        setLoading(false);
-      }
-    };
-
-    fetchUser();
-  }, [userId]);
-
-  if (loading) return <p>Loading...</p>;
-  if (error) return <p>Error: {error}</p>;
-  if (!user) return <p>No user found</p>;
-
-  return (
-    <section data-testid="user-profile">
-      <h1>{user.name}</h1>
-      <p>{user.email}</p>
-      <button onClick={() => setUser({ ...user, name: 'Updated Name' })}>
-        Update Name
-      </button>
-    </section>
-  );
-};
-
-describe('User Profile Integration Tests', () => {
-    describe('Data Loading', () => {
-    it('loads and displays user data', async () => {
-      renderWithProviders(<UserProfile userId="1" />);
-      
-      // The component loads data synchronously in this mock, so we just check the final state
-      await waitFor(() => {
-        expect(screen.getByText('John Doe')).toBeDefined();
-      });
-      
-      expect(screen.getByText('john@example.com')).toBeDefined();
-    });
-
-    it('handles user not found', async () => {
-      renderWithProviders(<UserProfile userId="999" />);
-      
-      await waitFor(() => {
-        expect(screen.getByText('Error: User not found')).toBeDefined();
-      });
-    });
-  });
-
-  describe('User Interactions', () => {
-    it('allows updating user name', async () => {
-      const user = userEvent.setup();
-      renderWithProviders(<UserProfile userId="1" />);
-      
-      await waitFor(() => {
-        expect(screen.getByText('John Doe')).toBeDefined();
-      });
-      
-      await user.click(screen.getByText('Update Name'));
-      
-      expect(screen.getByText('Updated Name')).toBeDefined();
-      expect(screen.queryByText('John Doe')).toBeNull();
-    });
-  });
-
-  describe('Component State Management', () => {
-    it('maintains state across re-renders', async () => {
-      const { rerender } = renderWithProviders(<UserProfile userId="1" />);
-      
-      await waitFor(() => {
-        expect(screen.getByText('John Doe')).toBeDefined();
-      });
-      
-      rerender(<UserProfile userId="1" />);
-      
-      expect(screen.getByText('John Doe')).toBeDefined();
-    });
-  });
-});
-
-// Example of testing with different user IDs
-describe('User Profile - Different Users', () => {
-  const testCases = [
-    { userId: '1', expectedName: 'John Doe' },
-    { userId: '2', expectedName: 'Jane Smith' },
-  ];
-
-  testCases.forEach(({ userId, expectedName }) => {
-    it(`displays correct data for user ${userId}`, async () => {
-      renderWithProviders(<UserProfile userId={userId} />);
-      
-      await waitFor(() => {
-        expect(screen.getByText(expectedName)).toBeDefined();
-      });
-    });
-  });
-});