plusui-native 0.2.0

package/src/doctor/reporter.js

@@ -0,0 +1,219 @@
+import chalk from 'chalk';
+import os from 'os';
+
+export class DoctorReporter {
+  formatResults(results) {
+    let output = '';
+
+    // System Information
+    output += chalk.bold('\nSystem Information\n');
+    output += '==================\n';
+    output += `OS:           ${os.type()} ${os.release()}\n`;
+    output += `Platform:     ${results.platform} ${os.arch()}\n`;
+    output += `CPUs:         ${os.cpus()[0].model} (${os.cpus().length} cores)\n`;
+    output += `Memory:       ${Math.round(os.totalmem() / (1024 ** 3))} GB\n`;
+
+    // Required Tools
+    output += chalk.bold('\n\nRequired Tools\n');
+    output += '==============\n';
+
+    // Node.js
+    if (results.nodejs.found) {
+      if (results.nodejs.valid) {
+        output += chalk.green(`✓ Node.js     v${results.nodejs.version}\n`);
+      } else {
+        output += chalk.yellow(`⚠ Node.js     v${results.nodejs.version} (requires >= ${results.nodejs.requiredVersion})\n`);
+      }
+    } else {
+      output += chalk.red(`✗ Node.js     Not found (requires >= ${results.nodejs.requiredVersion})\n`);
+    }
+
+    // npm
+    if (results.nodejs.npm.found) {
+      if (results.nodejs.npm.valid) {
+        output += chalk.green(`✓ npm         v${results.nodejs.npm.version}\n`);
+      } else {
+        output += chalk.yellow(`⚠ npm         v${results.nodejs.npm.version} (requires >= ${results.nodejs.npm.requiredVersion})\n`);
+      }
+    } else {
+      output += chalk.red(`✗ npm         Not found\n`);
+    }
+
+    // CMake
+    if (results.cmake.found) {
+      if (results.cmake.valid) {
+        output += chalk.green(`✓ CMake       ${results.cmake.version}`);
+        if (results.cmake.path !== 'cmake') {
+          output += chalk.gray(` (${results.cmake.path})`);
+        }
+        output += '\n';
+      } else {
+        output += chalk.yellow(`⚠ CMake       ${results.cmake.version} (requires >= ${results.cmake.requiredVersion})\n`);
+      }
+    } else {
+      output += chalk.red(`✗ CMake       Not found (requires >= ${results.cmake.requiredVersion})\n`);
+    }
+
+    // Compiler
+    if (results.compiler.found) {
+      if (results.compiler.valid) {
+        output += chalk.green(`✓ ${results.compiler.name}`);
+        if (results.compiler.version) {
+          output += `  ${results.compiler.version}`;
+        }
+        output += '\n';
+      } else {
+        output += chalk.yellow(`⚠ ${results.compiler.name} (incomplete installation)\n`);
+      }
+    } else {
+      output += chalk.red(`✗ ${results.compiler.name}\n`);
+    }
+
+    // Just
+    if (results.just.found) {
+      if (results.just.valid) {
+        output += chalk.green(`✓ Just        v${results.just.version}\n`);
+      } else {
+        output += chalk.yellow(`⚠ Just        v${results.just.version} (requires >= ${results.just.requiredVersion})\n`);
+      }
+    } else {
+      output += chalk.red(`✗ Just        Not found\n`);
+    }
+
+    // WebView2
+    if (results.webview2.platform === 'win32') {
+        if (results.webview2.found) {
+            output += chalk.green(`✓ WebView2    v${results.webview2.version}\n`);
+        } else {
+             output += chalk.red(`✗ WebView2    Runtime Not Found (Required for Windows)\n`);
+        }
+    }
+
+    // Installation instructions for missing tools
+    const missingTools = [];
+
+    if (!results.nodejs.found || !results.nodejs.valid) {
+      missingTools.push({ name: 'nodejs', info: results.nodejs });
+    }
+    if (!results.cmake.found || !results.cmake.valid) {
+      missingTools.push({ name: 'cmake', info: results.cmake });
+    }
+    if (!results.compiler.found || !results.compiler.valid) {
+      missingTools.push({ name: 'compiler', info: results.compiler });
+    }
+    if (!results.just.found || !results.just.valid) {
+      missingTools.push({ name: 'just', info: results.just });
+    }
+    if (results.webview2.platform === 'win32' && !results.webview2.found) {
+         missingTools.push({ name: 'webview2', info: results.webview2 });
+    }
+
+    if (missingTools.length > 0) {
+      output += chalk.bold('\n\nInstallation Instructions\n');
+      output += '=========================\n';
+
+      for (const tool of missingTools) {
+        output += this.formatInstallInstructions(tool.name, results.platform);
+      }
+
+      output += '\n' + chalk.yellow('Or run: plusui doctor --fix (to attempt automatic installation)\n');
+    }
+
+    // Summary
+    output += chalk.bold('\n\nSummary\n');
+    output += '=======\n';
+
+    if (missingTools.length === 0) {
+      output += chalk.green('Status: ✓ Ready to build PlusUI apps!\n');
+    } else {
+      output += chalk.red(`Status: ✗ Needs Setup\n`);
+      output += `Missing: ${missingTools.length} required tool(s)\n`;
+    }
+
+    console.log(output);
+
+    return missingTools.length === 0;
+  }
+
+  formatInstallInstructions(toolName, platform) {
+    let output = '\n';
+
+    switch (toolName) {
+      case 'nodejs':
+        output += chalk.bold('Node.js\n');
+        if (platform === 'win32') {
+          output += '  Install: winget install -e --id OpenJS.NodeJS\n';
+          output += '  Or download from: https://nodejs.org/\n';
+        } else if (platform === 'darwin') {
+          output += '  Install: brew install node\n';
+          output += '  Or download from: https://nodejs.org/\n';
+        } else {
+          output += '  Ubuntu/Debian: sudo apt install -y nodejs npm\n';
+          output += '  Fedora: sudo dnf install -y nodejs\n';
+          output += '  Or download from: https://nodejs.org/\n';
+        }
+        break;
+
+      case 'cmake':
+        output += chalk.bold('CMake\n');
+        if (platform === 'win32') {
+          output += '  Install: winget install -e --id Kitware.CMake\n';
+          output += '  Or download from: https://cmake.org/download/\n';
+        } else if (platform === 'darwin') {
+          output += '  Install: brew install cmake\n';
+          output += '  Or download from: https://cmake.org/download/\n';
+        } else {
+          output += '  Ubuntu/Debian: sudo apt install -y cmake\n';
+          output += '  Fedora: sudo dnf install -y cmake\n';
+          output += '  Or download from: https://cmake.org/download/\n';
+        }
+        break;
+
+      case 'compiler':
+        output += chalk.bold('C++ Compiler\n');
+        if (platform === 'win32') {
+          output += '  Visual Studio 2022 with C++ workload is required.\n\n';
+          output += '  Installation:\n';
+          output += '    1. Download from: https://visualstudio.microsoft.com/downloads/\n';
+          output += '    2. Run the installer\n';
+          output += '    3. Select "Desktop development with C++" workload\n';
+          output += '    4. Include these components:\n';
+          output += '       - MSVC v143 - VS 2022 C++ x64/x86 build tools\n';
+          output += '       - Windows 11 SDK (10.0.22621.0 or later)\n';
+          output += '       - CMake tools for Windows\n';
+        } else if (platform === 'darwin') {
+          output += '  Install: xcode-select --install\n';
+          output += '  This will install Xcode Command Line Tools with clang++\n';
+        } else {
+          output += '  Ubuntu/Debian: sudo apt install -y build-essential\n';
+          output += '  Fedora: sudo dnf groupinstall -y "Development Tools"\n';
+          output += '  Arch: sudo pacman -S --noconfirm base-devel\n';
+        }
+        break;
+
+      case 'just':
+        output += chalk.bold('Just Command Runner\n');
+        if (platform === 'win32') {
+          output += '  Install: winget install -e --id casey.just\n';
+          output += '  Or download from: https://github.com/casey/just/releases\n';
+        } else if (platform === 'darwin') {
+          output += '  Install: brew install just\n';
+          output += '  Or download from: https://github.com/casey/just/releases\n';
+        } else {
+          output += '  Ubuntu/Debian: sudo apt install -y just\n';
+          output += '  Fedora: sudo dnf install -y just\n';
+          output += '  Or download from: https://github.com/casey/just/releases\n';
+        }
+        break;
+
+      case 'webview2':
+         output += chalk.bold('WebView2 Runtime\n');
+         output += '  Install: Download and run the Evergreen Bootstrapper:\n';
+         output += '  https://developer.microsoft.com/en-us/microsoft-edge/webview2/#download-section\n';
+         output += '  (Or run `plusui doctor --fix`)\n';
+         break;
+    }
+
+    return output;
+  }
+}