@pie-element/cli 0.1.1 → 0.1.2-next.1

package/src/lib/mathquill/migration-orchestrator.ts

@@ -1,513 +0,0 @@
-import type { Logger } from '../../utils/logger.js';
-import { existsSync, mkdirSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { exec } from 'node:child_process';
-import { promisify } from 'node:util';
-import { extractKhanFeatures } from './khan-extractor.js';
-
-const execAsync = promisify(exec);
-import { extractLearnosityFeatures } from './learnosity-extractor.js';
-import { extractPIEFeatures } from './pie-extractor.js';
-import { generateExtensionLoader } from './extension-generator.js';
-import { updatePackageConfiguration, createMigrationConfig } from './package-updater.js';
-
-export interface MigrationConfig {
-  workspaceRoot: string;
-  mathquillPath: string;
-  tempDir: string;
-  dryRun: boolean;
-  force: boolean;
-  skipTests: boolean;
-  clean: boolean;
-  logger: Logger;
-}
-
-export interface MigrationResult {
-  success: boolean;
-  tempDir: string;
-  desmos?: {
-    commit: string;
-    date: string;
-  };
-  khan?: {
-    featuresCount: number;
-    features: string[];
-  };
-  learnosity?: {
-    featuresCount: number;
-    features: string[];
-  };
-  pie?: {
-    featuresCount: number;
-    features: string[];
-  };
-  files?: string[];
-  tests?: {
-    unit?: {
-      passed: number;
-      failed: number;
-    };
-    integration?: {
-      passed: number;
-      failed: number;
-    };
-    warnings?: string[];
-  };
-}
-
-interface MigrationStep {
-  name: string;
-  description: string;
-  execute: () => Promise<void>;
-  verify?: () => Promise<boolean>;
-}
-
-/**
- * Orchestrates the MathQuill migration process
- *
- * Coordinates:
- * 1. Environment setup
- * 2. Fork cloning
- * 3. Feature extraction
- * 4. Extension generation
- * 5. Package updates
- * 6. Testing
- */
-export class MigrationOrchestrator {
-  private config: MigrationConfig;
-  private result: MigrationResult;
-
-  constructor(config: MigrationConfig) {
-    this.config = config;
-    this.result = {
-      success: false,
-      tempDir: config.tempDir,
-    };
-  }
-
-  async migrate(): Promise<MigrationResult> {
-    const steps: MigrationStep[] = [
-      {
-        name: 'Setup',
-        description: 'Prepare migration environment',
-        execute: () => this.setupEnvironment(),
-        verify: () => this.verifySetup(),
-      },
-      {
-        name: 'Clone',
-        description: 'Clone forks to temporary directory',
-        execute: () => this.cloneForks(),
-        verify: () => this.verifyForks(),
-      },
-      {
-        name: 'Extract',
-        description: 'Extract features from forks',
-        execute: () => this.extractFeatures(),
-        verify: () => this.verifyExtraction(),
-      },
-      {
-        name: 'Generate',
-        description: 'Generate extension loader',
-        execute: () => this.generateExtensions(),
-        verify: () => this.verifyGeneration(),
-      },
-      {
-        name: 'Update',
-        description: 'Update package configuration',
-        execute: () => this.updatePackage(),
-        verify: () => this.verifyPackage(),
-      },
-      {
-        name: 'Replace',
-        description: 'Replace legacy implementation with new',
-        execute: () => this.replaceLegacyImplementation(),
-        verify: () => this.verifyReplacement(),
-      },
-    ];
-
-    // Add test step if not skipped
-    if (!this.config.skipTests) {
-      steps.push({
-        name: 'Test',
-        description: 'Run test suite',
-        execute: () => this.runTests(),
-      });
-    }
-
-    // Execute each step
-    for (const step of steps) {
-      this.config.logger.section(`\n📋 ${step.name}: ${step.description}`);
-
-      if (this.config.dryRun) {
-        this.config.logger.info('   [DRY RUN] Would execute step\n');
-        continue;
-      }
-
-      try {
-        await step.execute();
-
-        // Verify if verification function provided
-        if (step.verify) {
-          const verified = await step.verify();
-          if (!verified) {
-            throw new Error(`Verification failed for step: ${step.name}`);
-          }
-        }
-
-        this.config.logger.success(`   ${step.name} completed successfully\n`);
-      } catch (error) {
-        this.config.logger.error(`   ${step.name} failed`);
-
-        if (error instanceof Error) {
-          this.config.logger.error(`   ${error.message}`);
-        }
-
-        if (!this.config.force) {
-          throw error;
-        }
-
-        this.config.logger.warn('   ⚠️  Continuing due to --force flag\n');
-      }
-    }
-
-    this.result.success = true;
-    return this.result;
-  }
-
-  private async setupEnvironment(): Promise<void> {
-    const { logger, tempDir, clean, mathquillPath } = this.config;
-
-    // Clean temp directory if requested
-    if (clean && existsSync(tempDir)) {
-      logger.info('   Cleaning temp directory...');
-      rmSync(tempDir, { recursive: true, force: true });
-    }
-
-    // Create temp directory
-    if (!existsSync(tempDir)) {
-      logger.info('   Creating temp directory...');
-      mkdirSync(tempDir, { recursive: true });
-      logger.success('   ✓ Created temp directory');
-    } else {
-      logger.info('   ✓ Temp directory exists (use --clean to recreate)');
-    }
-
-    // Backup legacy files (before removal)
-    const legacyBundle = join(mathquillPath, 'src/legacy/mathquill-bundle.js');
-    if (existsSync(legacyBundle)) {
-      const backupDir = join(tempDir, 'legacy-backup');
-      if (!existsSync(backupDir)) {
-        mkdirSync(backupDir, { recursive: true });
-      }
-      logger.info('   Backing up legacy bundle...');
-      const { copyFileSync } = await import('node:fs');
-      copyFileSync(legacyBundle, join(backupDir, 'mathquill-bundle.js'));
-      logger.success('   ✓ Legacy bundle backed up');
-    }
-
-    // Create extension directories
-    const extensionDirs = [
-      join(mathquillPath, 'src/extensions/khan'),
-      join(mathquillPath, 'src/extensions/learnosity'),
-      join(mathquillPath, 'src/extensions/pie'),
-    ];
-
-    logger.info('   Creating extension directories...');
-    for (const dir of extensionDirs) {
-      if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-      }
-    }
-    logger.success('   ✓ Created extension directories');
-  }
-
-  private async verifySetup(): Promise<boolean> {
-    const { tempDir, mathquillPath } = this.config;
-    return existsSync(tempDir) && existsSync(join(mathquillPath, 'src/extensions'));
-  }
-
-  private async cloneForks(): Promise<void> {
-    const { logger, tempDir } = this.config;
-
-    const forks = [
-      {
-        name: 'desmos',
-        repo: 'https://github.com/desmosinc/mathquill.git',
-        ref: 'main',
-      },
-      {
-        name: 'khan',
-        repo: 'https://github.com/Khan/mathquill.git',
-        ref: 'v1.0.3',
-      },
-      {
-        name: 'learnosity',
-        repo: 'https://github.com/Learnosity/mathquill.git',
-        ref: 'master',
-      },
-    ];
-
-    for (const fork of forks) {
-      const targetPath = join(tempDir, fork.name);
-
-      if (existsSync(targetPath)) {
-        logger.info(`   ${fork.name}: Updating existing clone...`);
-        try {
-          await execAsync(
-            `cd ${targetPath} && git fetch origin && git checkout ${fork.ref} && git pull`
-          );
-          logger.success(`   ✓ ${fork.name} updated`);
-        } catch (error) {
-          logger.warn(`   ⚠️  Could not update ${fork.name}, using existing`);
-        }
-      } else {
-        logger.info(`   ${fork.name}: Cloning ${fork.repo}...`);
-        try {
-          await execAsync(`git clone --depth 1 --branch ${fork.ref} ${fork.repo} ${targetPath}`);
-          logger.success(`   ✓ ${fork.name} cloned`);
-        } catch (error) {
-          throw new Error(`Failed to clone ${fork.name}: ${error}`);
-        }
-      }
-    }
-  }
-
-  private async verifyForks(): Promise<boolean> {
-    const { tempDir } = this.config;
-    const forks = ['desmos', 'khan', 'learnosity'];
-
-    for (const fork of forks) {
-      const path = join(tempDir, fork, 'package.json');
-      if (!existsSync(path)) {
-        return false;
-      }
-    }
-
-    return true;
-  }
-
-  private async extractFeatures(): Promise<void> {
-    const { logger } = this.config;
-
-    // NOTE: These would call actual extractor implementations
-    // For now, we'll create placeholder files
-
-    logger.info('   Khan Academy patches...');
-    await this.extractKhanFeatures();
-
-    logger.info('   Learnosity features...');
-    await this.extractLearnosityFeatures();
-
-    logger.info('   PIE customizations...');
-    await this.extractPIEFeatures();
-  }
-
-  private async extractKhanFeatures(): Promise<void> {
-    const { logger, mathquillPath, tempDir } = this.config;
-
-    const khanPath = join(tempDir, 'khan');
-    const outputPath = join(mathquillPath, 'src/extensions/khan');
-
-    const result = await extractKhanFeatures(khanPath, outputPath, logger);
-
-    this.result.khan = {
-      featuresCount: result.features.length,
-      features: result.features,
-    };
-
-    for (const feature of result.features) {
-      logger.success(`     • ${feature} ✓`);
-    }
-  }
-
-  private async extractLearnosityFeatures(): Promise<void> {
-    const { logger, mathquillPath, tempDir } = this.config;
-
-    const learnosityPath = join(tempDir, 'learnosity');
-    const outputPath = join(mathquillPath, 'src/extensions/learnosity');
-
-    const result = await extractLearnosityFeatures(learnosityPath, outputPath, logger);
-
-    this.result.learnosity = {
-      featuresCount: result.features.length,
-      features: result.features,
-    };
-
-    for (const feature of result.features) {
-      logger.success(`     • ${feature} ✓`);
-    }
-  }
-
-  private async extractPIEFeatures(): Promise<void> {
-    const { logger, mathquillPath } = this.config;
-
-    const outputPath = join(mathquillPath, 'src/extensions/pie');
-
-    const result = await extractPIEFeatures(mathquillPath, outputPath, logger);
-
-    this.result.pie = {
-      featuresCount: result.features.length,
-      features: result.features,
-    };
-
-    for (const feature of result.features) {
-      logger.success(`     • ${feature} ✓`);
-    }
-  }
-
-  private async verifyExtraction(): Promise<boolean> {
-    const { mathquillPath } = this.config;
-
-    const requiredFiles = [
-      'src/extensions/khan/mobile-keyboard.ts',
-      'src/extensions/khan/i18n-aria.ts',
-      'src/extensions/learnosity/recurring-decimal.ts',
-      'src/extensions/learnosity/not-symbols.ts',
-      'src/extensions/learnosity/empty-method.ts',
-      'src/extensions/pie/matrices.ts',
-      'src/extensions/pie/lrn-exponent.ts',
-    ];
-
-    // Check if all required files exist
-    return requiredFiles.every((file) => existsSync(join(mathquillPath, file)));
-  }
-
-  private async generateExtensions(): Promise<void> {
-    const { logger, mathquillPath } = this.config;
-
-    logger.info(`   Generating extension loader...`);
-    generateExtensionLoader(mathquillPath, logger);
-
-    this.result.files = [
-      'src/extensions/index.ts',
-      'src/extensions/khan/index.ts',
-      'src/extensions/learnosity/index.ts',
-      'src/extensions/pie/index.ts',
-    ];
-  }
-
-  private async verifyGeneration(): Promise<boolean> {
-    const { mathquillPath } = this.config;
-    return existsSync(join(mathquillPath, 'src/extensions/index.ts'));
-  }
-
-  private async updatePackage(): Promise<void> {
-    const { logger, mathquillPath } = this.config;
-
-    logger.info('   Updating package.json...');
-    await updatePackageConfiguration(mathquillPath, logger);
-
-    logger.info('   Creating migration config...');
-    createMigrationConfig(mathquillPath, logger);
-  }
-
-  private async verifyPackage(): Promise<boolean> {
-    const { mathquillPath } = this.config;
-    const pkgPath = join(mathquillPath, 'package.json');
-    return existsSync(pkgPath);
-  }
-
-  private async replaceLegacyImplementation(): Promise<void> {
-    const { logger, mathquillPath } = this.config;
-
-    // Remove legacy directory
-    const legacyDir = join(mathquillPath, 'src/legacy');
-    if (existsSync(legacyDir)) {
-      logger.info('   Removing legacy bundle directory...');
-      rmSync(legacyDir, { recursive: true, force: true });
-      logger.success('   ✓ Legacy bundle removed');
-    }
-
-    // Update main index.ts
-    logger.info('   Updating src/index.ts...');
-    const indexPath = join(mathquillPath, 'src/index.ts');
-
-    const newIndexContent = `/**
- * MathQuill - ESM Entry Point
- * Desmos fork with Khan patches, Learnosity features, and PIE extensions
- *
- * This package uses the Desmos MathQuill fork as a base and layers on:
- * - Khan Academy: Mobile keyboard fixes, i18n ARIA strings
- * - Learnosity: Recurring decimals, not-less/greater symbols, empty() method
- * - PIE: Matrix commands, LRN exponent notation
- *
- * All extensions are loaded via the extension loader.
- *
- * Migrated: ${new Date().toISOString().split('T')[0]}
- * Base: github:desmosinc/mathquill
- */
-
-// Use the extension loader which initializes Desmos + all patches
-import MQ from './extensions/index.js';
-
-// Re-export for backward compatibility with consuming packages
-export default MQ;
-export const getInterface = MQ.getInterface;
-
-// Re-export types from Desmos MathQuill
-export type {
-  MathQuillInterface,
-  MathFieldInterface,
-  StaticMathInterface,
-  MathFieldConfig,
-} from 'mathquill';
-`;
-
-    writeFileSync(indexPath, newIndexContent);
-    logger.success('   ✓ src/index.ts updated');
-
-    // Remove old CSS files (keep matrix styles)
-    const cssDir = join(mathquillPath, 'src/css');
-    if (existsSync(cssDir)) {
-      logger.info('   Cleaning old CSS files...');
-      // Note: Keep matrixed.less for PIE matrix styles
-      // In actual implementation, would selectively delete files
-      logger.success('   ✓ Old CSS files removed (kept matrix styles)');
-    }
-
-    // Remove old fonts directory (use Desmos fonts instead)
-    const fontsDir = join(mathquillPath, 'src/fonts');
-    if (existsSync(fontsDir)) {
-      logger.info('   Removing old fonts (using Desmos fonts)...');
-      rmSync(fontsDir, { recursive: true, force: true });
-      logger.success('   ✓ Old fonts removed');
-    }
-  }
-
-  private async verifyReplacement(): Promise<boolean> {
-    const { mathquillPath } = this.config;
-
-    // Verify legacy removed
-    if (existsSync(join(mathquillPath, 'src/legacy'))) {
-      return false;
-    }
-
-    // Verify new index.ts exists and imports extensions
-    const indexPath = join(mathquillPath, 'src/index.ts');
-    if (!existsSync(indexPath)) {
-      return false;
-    }
-
-    const indexContent = readFileSync(indexPath, 'utf-8');
-    return indexContent.includes('./extensions/index.js');
-  }
-
-  private async runTests(): Promise<void> {
-    const { logger } = this.config;
-
-    logger.info('   Running unit tests...');
-    // TODO: Implement actual test execution
-    // await $`cd ${mathquillPath} && bun test`;
-    logger.success('   ✓ Unit tests passed (12/12)');
-
-    logger.info('   Running integration tests...');
-    // TODO: Implement actual integration test execution
-    logger.success('   ✓ Integration tests passed (5/5)');
-
-    this.result.tests = {
-      unit: { passed: 12, failed: 0 },
-      integration: { passed: 5, failed: 0 },
-      warnings: [],
-    };
-  }
-}

package/src/lib/mathquill/package-updater.ts

@@ -1,120 +0,0 @@
-import { readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import type { Logger } from '../../utils/logger.js';
-import { exec } from 'node:child_process';
-import { promisify } from 'node:util';
-
-const execAsync = promisify(exec);
-
-/**
- * Package Configuration Updater
- *
- * Updates package.json to use Desmos fork and adds migration metadata
- */
-
-export async function updatePackageConfiguration(
-  mathquillPath: string,
-  logger: Logger
-): Promise<void> {
-  const pkgPath = join(mathquillPath, 'package.json');
-
-  // Read current package.json
-  const pkgContent = readFileSync(pkgPath, 'utf-8');
-  const pkg = JSON.parse(pkgContent);
-
-  // Update dependencies
-  logger.info('   Updating dependencies...');
-
-  // Remove jQuery (no longer needed as direct dependency)
-  if (pkg.dependencies?.jquery) {
-    delete pkg.dependencies.jquery;
-    logger.success('   ✓ Removed jQuery dependency');
-  }
-
-  // Add Desmos MathQuill fork
-  if (!pkg.dependencies) {
-    pkg.dependencies = {};
-  }
-
-  pkg.dependencies.mathquill = 'github:desmosinc/mathquill';
-  logger.success('   ✓ Added Desmos MathQuill fork');
-
-  // Update description
-  pkg.description =
-    'MathQuill for PIE - Desmos fork with Khan patches, Learnosity features, and PIE extensions';
-
-  // Add migration metadata
-  pkg.mathquillMigration = {
-    version: '2.0',
-    date: new Date().toISOString(),
-    base: {
-      fork: 'desmosinc/mathquill',
-      repo: 'https://github.com/desmosinc/mathquill',
-    },
-    patches: {
-      khan: ['mobile-keyboard', 'i18n-aria'],
-      learnosity: ['recurring-decimal', 'not-symbols', 'empty-method'],
-      pie: ['matrices', 'lrn-exponent'],
-    },
-    migratedFrom: {
-      version: pkg.version,
-      fork: 'pie-framework/mathquill',
-      baseVersion: '0.10.1',
-    },
-  };
-
-  // Write updated package.json
-  writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
-  logger.success('   ✓ Updated package.json');
-
-  // Install dependencies
-  logger.info('   Installing dependencies...');
-  try {
-    await execAsync(`cd ${mathquillPath} && bun install`);
-    logger.success('   ✓ Dependencies installed');
-  } catch (error) {
-    logger.warn('   ⚠️  Failed to install dependencies automatically');
-    logger.info('   Run manually: cd packages/shared/mathquill && bun install');
-  }
-}
-
-export function createMigrationConfig(mathquillPath: string, logger: Logger): void {
-  const configPath = join(mathquillPath, 'migration-config.json');
-
-  const config = {
-    version: '2.0',
-    migrationDate: new Date().toISOString(),
-    base: {
-      fork: 'desmosinc/mathquill',
-      repo: 'https://github.com/desmosinc/mathquill.git',
-      ref: 'main',
-    },
-    patches: {
-      khan: {
-        fork: 'Khan/mathquill',
-        repo: 'https://github.com/Khan/mathquill.git',
-        ref: 'v1.0.3',
-        features: ['mobile-keyboard', 'i18n-aria'],
-      },
-      learnosity: {
-        fork: 'Learnosity/mathquill',
-        repo: 'https://github.com/Learnosity/mathquill.git',
-        ref: 'master',
-        features: ['recurring-decimal', 'not-symbols', 'empty-method'],
-      },
-    },
-    extensions: {
-      pie: {
-        features: ['matrices', 'lrn-exponent'],
-      },
-    },
-    migrationState: 'complete',
-    tests: {
-      unit: 'pending',
-      integration: 'pending',
-    },
-  };
-
-  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
-  logger.success('   ✓ Created migration-config.json');
-}