plusui-native 0.2.108 → 0.2.109

package/src/index.js

@@ -1,1358 +1,1358 @@
 #!/usr/bin/env node
-
-import { mkdir, readFile, stat, rm, readdir, writeFile, copyFile } from 'fs/promises';
-import { existsSync, watch, statSync, mkdirSync } from 'fs';
-import { exec, spawn, execSync } from 'child_process';
-import { join, dirname, basename, resolve } from 'path';
-import { fileURLToPath } from 'url';
-import { createInterface } from 'readline';
-import { createServer as createViteServer } from 'vite';
-import { runDoctor } from './doctor/index.js';
-import { TemplateManager } from '../templates/manager.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Load package.json for version info
-const cliPackageJson = JSON.parse(
-    await readFile(join(__dirname, '..', 'package.json'), 'utf8')
-);
-
-const COLORS = {
-    reset: '\x1b[0m',
-    bright: '\x1b[1m',
-    dim: '\x1b[2m',
-    green: '\x1b[32m',
-    blue: '\x1b[34m',
-    yellow: '\x1b[33m',
-    red: '\x1b[31m',
-    cyan: '\x1b[36m',
-    magenta: '\x1b[35m',
-};
-
-function log(msg, color = 'reset') {
-    console.log(`${COLORS[color]}${msg}${COLORS.reset}`);
-}
-
-function logSection(title) {
-    console.log(`\n${COLORS.bright}${COLORS.blue}=== ${title} ===${COLORS.reset}\n`);
-}
-
-function error(msg) {
-    console.error(`${COLORS.red}Error: ${msg}${COLORS.reset}`);
-    process.exit(1);
-}
-
-function checkTools() {
-    const platform = process.platform;
-    const required = [];
-
-    const cmakePaths = [
-        'cmake',
-        'C:\\Program Files\\CMake\\bin\\cmake.exe',
-        'C:\\Program Files (x86)\\CMake\\bin\\cmake.exe',
-        '/usr/local/bin/cmake',
-        '/usr/bin/cmake'
-    ];
-
-    let cmakeFound = false;
-    for (const p of cmakePaths) {
-        try {
-            execSync(`"${p}" --version`, { stdio: 'ignore' });
-            cmakeFound = true;
-            break;
-        } catch { }
-    }
-
-    if (!cmakeFound) {
-        if (platform === 'win32') {
-            required.push({ name: 'CMake', install: 'winget install Kitware.CMake', auto: 'winget install -e --id Kitware.CMake' });
-        } else if (platform === 'darwin') {
-            required.push({ name: 'CMake', install: 'brew install cmake', auto: 'brew install cmake' });
-        } else {
-            required.push({ name: 'CMake', install: 'sudo apt install cmake', auto: 'sudo apt install cmake' });
-        }
-    }
-
-    // Compiler / build tools check
-    if (platform === 'win32') {
-        // Use vswhere.exe first (same detection as `plusui doctor`)
-        let vsFound = false;
-        const vswherePath = 'C:\\Program Files (x86)\\Microsoft Visual Studio\\Installer\\vswhere.exe';
-        if (existsSync(vswherePath)) {
-            try {
-                const output = execSync(
-                    `"${vswherePath}" -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath`,
-                    { stdio: ['pipe', 'pipe', 'pipe'], encoding: 'utf8', timeout: 10000 }
-                ).trim();
-                if (output) vsFound = true;
-            } catch { }
-        }
-
-        // Fallback: check common VS paths for years 2019–2026
-        if (!vsFound) {
-            const vsYears = ['2026', '2025', '2024', '2023', '2022', '2019'];
-            const vsEditions = ['Community', 'Professional', 'Enterprise', 'BuildTools'];
-            for (const year of vsYears) {
-                for (const edition of vsEditions) {
-                    if (existsSync(`C:\\Program Files\\Microsoft Visual Studio\\${year}\\${edition}\\VC\\Tools\\MSVC`)) {
-                        vsFound = true;
-                        break;
-                    }
-                }
-                if (vsFound) break;
-            }
-        }
-
-        if (!vsFound) {
-            required.push({ name: 'Visual Studio (C++ workload)', install: 'Download from visualstudio.microsoft.com with C++ workload', auto: null });
-        }
-    } else if (platform === 'darwin') {
-        try {
-            execSync('clang++ --version', { stdio: 'ignore' });
-        } catch {
-            required.push({ name: 'Xcode', install: 'xcode-select --install', auto: 'xcode-select --install' });
-        }
-    } else {
-        try {
-            execSync('g++ --version', { stdio: 'ignore' });
-        } catch {
-            required.push({ name: 'GCC/Clang', install: 'sudo apt install build-essential', auto: 'sudo apt install build-essential' });
-        }
-    }
-
-    if (required.length > 0) {
-        log('\n=== Missing Required Tools ===', 'yellow');
-
-        for (const tool of required) {
-            log(`\n  ${tool.name}`, 'bright');
-            log(`  Install: ${tool.install}`, 'reset');
-            if (tool.auto) {
-                log(`  Run:     ${tool.auto}`, 'green');
-            }
-        }
-
-        log('\n');
-        return { missing: required };
-    }
-    return null;
-}
-
-const USAGE = `
-${COLORS.bright}${cliPackageJson.name}${COLORS.reset} v${cliPackageJson.version} - Build C++ desktop apps with web tech
-
-${COLORS.bright}Usage:${COLORS.reset}
-  plusui doctor              Check development environment
-  plusui doctor --fix        Check and auto-install missing tools
-  plusui create <name>       Create a new PlusUI project
-  plusui dev                 Run in development mode (Vite HMR + C++ app)
-  plusui build               Build for current platform (production)
-  plusui build:frontend      Build frontend only
-  plusui build:backend       Build C++ backend only
-  plusui build:all           Build for all platforms
-    plusui run                 Run the built application
-    plusui clean               Clean build artifacts
-    plusui connect             Generate connection bindings for current app (aliases: bind, bindgen)
-  plusui update              Update all PlusUI packages to latest versions
-  plusui help                Show this help message
-
-${COLORS.bright}Platform Builds:${COLORS.reset}
-  plusui build:windows       Build for Windows
-  plusui build:macos         Build for macOS
-  plusui build:linux         Build for Linux
-
-${COLORS.bright}Asset Commands:${COLORS.reset}
-  plusui icons [input]       Generate platform icons from source icon
-  plusui embed [platform]    Embed resources for platform (win32/darwin/linux/all)
-
-${COLORS.bright}Options:${COLORS.reset}
-  -h, --help                 Show this help message
-  -v, --version              Show version number
-  -t, --template             Specify template (solid, react)
-
-${COLORS.bright}Assets:${COLORS.reset}
-  Place assets/icon.png (512x512+ recommended) for automatic icon generation.
-  All assets in "assets/" are embedded into the binary for single-exe distribution.
-  Embedded resources are accessible via plusui::resources::getResource("path").
-`;
-
-// Platform configuration
-const PLATFORMS = {
-    win32: { name: 'Windows', folder: 'Windows', ext: '.exe', generator: null },
-    darwin: { name: 'macOS', folder: 'MacOS', ext: '', generator: 'Xcode' },
-    linux: { name: 'Linux', folder: 'Linux', ext: '', generator: 'Ninja' },
-    android: { name: 'Android', folder: 'Android', ext: '.apk', generator: 'Ninja' },
-    ios: { name: 'iOS', folder: 'iOS', ext: '.app', generator: 'Xcode' },
-};
-
-function getProjectName() {
-    try {
-        const pkg = JSON.parse(execSync('npm pkg get name', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }));
-        return typeof pkg === 'string' ? pkg.replace(/"/g, '') : basename(process.cwd());
-    } catch {
-        return basename(process.cwd());
-    }
-}
-
-function getCMakePath() {
-    const paths = [
-        'cmake',
-        'C:\\Program Files\\CMake\\bin\\cmake.exe',
-        'C:\\Program Files (x86)\\CMake\\bin\\cmake.exe',
-        '/usr/local/bin/cmake',
-        '/usr/bin/cmake'
-    ];
-    for (const p of paths) {
-        try {
-            execSync(`"${p}" --version`, { stdio: 'ignore' });
-            return p;
-        } catch { }
-    }
-    return 'cmake';
-}
-
-// Find vcvarsall.bat for Windows builds (needed for Ninja generator)
-let _vcvarsallCache = undefined;
-function findVcvarsall() {
-    if (_vcvarsallCache !== undefined) return _vcvarsallCache;
-
-    const vswherePath = 'C:\\Program Files (x86)\\Microsoft Visual Studio\\Installer\\vswhere.exe';
-    if (existsSync(vswherePath)) {
-        try {
-            const installPath = execSync(
-                `"${vswherePath}" -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath`,
-                { stdio: ['pipe', 'pipe', 'pipe'], encoding: 'utf8', timeout: 10000 }
-            ).trim();
-            if (installPath) {
-                const vcvars = join(installPath, 'VC', 'Auxiliary', 'Build', 'vcvarsall.bat');
-                if (existsSync(vcvars)) {
-                    _vcvarsallCache = vcvars;
-                    return vcvars;
-                }
-            }
-        } catch { }
-    }
-
-    // Fallback: scan known paths
-    const vsYears = ['2026', '2025', '2024', '2023', '2022', '2019'];
-    const vsEditions = ['Community', 'Professional', 'Enterprise', 'BuildTools'];
-    for (const year of vsYears) {
-        for (const edition of vsEditions) {
-            const vcvars = `C:\\Program Files\\Microsoft Visual Studio\\${year}\\${edition}\\VC\\Auxiliary\\Build\\vcvarsall.bat`;
-            if (existsSync(vcvars)) {
-                _vcvarsallCache = vcvars;
-                return vcvars;
-            }
-        }
-    }
-
-    _vcvarsallCache = null;
-    return null;
-}
-
-// Capture the full environment from vcvarsall.bat (cached per session)
-let _vcEnvCache = undefined;
-function getVcEnvironment() {
-    if (_vcEnvCache !== undefined) return _vcEnvCache;
-
-    if (process.platform !== 'win32') {
-        _vcEnvCache = null;
-        return null;
-    }
-
-    const vcvarsall = findVcvarsall();
-    if (!vcvarsall) {
-        _vcEnvCache = null;
-        return null;
-    }
-
-    try {
-        // Run vcvarsall and dump all environment variables
-        const output = execSync(
-            `cmd /c ""${vcvarsall}" x64 >nul 2>&1 && set"`,
-            { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 30000, shell: true }
-        );
-
-        // Parse "KEY=VALUE" lines into an env object
-        const env = {};
-        for (const line of output.split(/\r?\n/)) {
-            const idx = line.indexOf('=');
-            if (idx > 0) {
-                env[line.substring(0, idx)] = line.substring(idx + 1);
-            }
-        }
-
-        // Sanity check: we should have PATH and INCLUDE set
-        if (env.PATH && env.INCLUDE) {
-            _vcEnvCache = env;
-            return env;
-        }
-    } catch { }
-
-    _vcEnvCache = null;
-    return null;
-}
-
-function runCMake(args, options = {}) {
-    const cmake = getCMakePath();
-
-    // On Windows, use the captured vcvarsall environment so cl.exe + ninja are in PATH
-    if (process.platform === 'win32') {
-        const vcEnv = getVcEnvironment();
-        if (vcEnv) {
-            return execSync(`"${cmake}" ${args}`, { stdio: 'inherit', env: vcEnv, ...options });
-        }
-    }
-
-    return execSync(`"${cmake}" ${args}`, { stdio: 'inherit', ...options });
-}
-
-function getInstalledPackageVersion(packageName) {
-    try {
-        const result = execSync(`npm list ${packageName} --depth=0 --json`, {
-            encoding: 'utf8',
-            stdio: ['pipe', 'pipe', 'ignore']
-        });
-        const json = JSON.parse(result);
-        if (json.dependencies && json.dependencies[packageName]) {
-            return json.dependencies[packageName].version;
-        }
-    } catch {
-        // Package not installed locally
-    }
-
-    // Try global installation
-    try {
-        const result = execSync(`npm list -g ${packageName} --depth=0 --json`, {
-            encoding: 'utf8',
-            stdio: ['pipe', 'pipe', 'ignore']
-        });
-        const json = JSON.parse(result);
-        if (json.dependencies && json.dependencies[packageName]) {
-            return json.dependencies[packageName].version;
-        }
-    } catch {
-        return null;
-    }
-
-    return null;
-}
-
-function getLatestPackageVersion(packageName) {
-    try {
-        const result = execSync(`npm view ${packageName} version`, {
-            encoding: 'utf8',
-            stdio: ['pipe', 'pipe', 'ignore']
-        });
-        return result.trim();
-    } catch {
-        return null;
-    }
-}
-
-function compareVersions(v1, v2) {
-    const parts1 = v1.split('.').map(Number);
-    const parts2 = v2.split('.').map(Number);
-
-    for (let i = 0; i < 3; i++) {
-        if (parts1[i] > parts2[i]) return 1;
-        if (parts1[i] < parts2[i]) return -1;
-    }
-    return 0;
-}
-
-function showVersionInfo() {
-    const packages = [
-        cliPackageJson.name,
-        'plusui-native-core',
-        'plusui-native-builder',
-        'plusui-native-connect'
-    ];
-
-    logSection('PlusUI Package Versions');
-
-    packages.forEach(pkg => {
-        let version;
-        if (pkg === cliPackageJson.name) {
-            version = cliPackageJson.version;
-            log(`${pkg}: ${COLORS.green}v${version}${COLORS.reset} ${COLORS.dim}(current)${COLORS.reset}`, 'reset');
-        } else {
-            version = getInstalledPackageVersion(pkg);
-            if (version) {
-                log(`${pkg}: ${COLORS.green}v${version}${COLORS.reset}`, 'reset');
-            } else {
-                log(`${pkg}: ${COLORS.dim}not installed${COLORS.reset}`, 'reset');
-            }
-        }
-    });
-
-    console.log('');
-}
-
-async function updatePlusUIPackages() {
-    logSection('Updating PlusUI Packages');
-
-    const packages = [
-        cliPackageJson.name,
-        'plusui-native-core',
-        'plusui-native-builder',
-        'plusui-native-connect'
-    ];
-
-    log('Checking for updates...\n', 'blue');
-
-    // Check if packages are installed locally or globally
-    const isInProject = existsSync(join(process.cwd(), 'package.json'));
-
-    if (isInProject) {
-        let updatedCount = 0;
-        let upToDateCount = 0;
-        let installedCount = 0;
-
-        for (const pkg of packages) {
-            const currentVersion = getInstalledPackageVersion(pkg);
-
-            if (!currentVersion) {
-                const latestVersion = getLatestPackageVersion(pkg);
-
-                if (!latestVersion) {
-                    log(`${COLORS.yellow}${pkg}: not installed (couldn't resolve latest version)${COLORS.reset}`);
-                    continue;
-                }
-
-                try {
-                    log(`${COLORS.blue}${pkg}: not installed → ${latestVersion}${COLORS.reset}`);
-                    execSync(`npm install ${pkg}@${latestVersion}`, {
-                        stdio: ['ignore', 'ignore', 'pipe'],
-                        encoding: 'utf8'
-                    });
-                    log(`${COLORS.green}✓ ${pkg} installed${COLORS.reset}`);
-                    installedCount++;
-                } catch (e) {
-                    log(`${COLORS.red}✗ ${pkg} install failed${COLORS.reset}`);
-                }
-                continue;
-            }
-
-            // Get latest version from npm
-            const latestVersion = getLatestPackageVersion(pkg);
-
-            if (!latestVersion) {
-                log(`${COLORS.yellow}${pkg}: couldn't check for updates${COLORS.reset}`);
-                continue;
-            }
-
-            const comparison = compareVersions(latestVersion, currentVersion);
-
-            if (comparison > 0) {
-                // Newer version available
-                try {
-                    log(`${COLORS.blue}${pkg}: ${currentVersion} → ${latestVersion}${COLORS.reset}`);
-                    execSync(`npm install ${pkg}@${latestVersion}`, {
-                        stdio: ['ignore', 'ignore', 'pipe'],
-                        encoding: 'utf8'
-                    });
-                    log(`${COLORS.green}✓ ${pkg} updated${COLORS.reset}`);
-                    updatedCount++;
-                } catch (e) {
-                    log(`${COLORS.red}✗ ${pkg} update failed${COLORS.reset}`);
-                }
-            } else {
-                // Already up to date
-                log(`${COLORS.green}✓ ${pkg} v${currentVersion} (up to date)${COLORS.reset}`);
-                upToDateCount++;
-            }
-        }
-
-        console.log('');
-        if (updatedCount > 0) {
-            log(`Updated ${updatedCount} package${updatedCount !== 1 ? 's' : ''}`, 'green');
-        }
-        if (installedCount > 0) {
-            log(`Installed ${installedCount} missing package${installedCount !== 1 ? 's' : ''}`, 'green');
-        }
-        if (upToDateCount > 0) {
-            log(`${upToDateCount} package${upToDateCount !== 1 ? 's' : ''} already up to date`, 'dim');
-        }
-    } else {
-        log('Updating global CLI package...', 'cyan');
-
-        const currentVersion = cliPackageJson.version;
-        const latestVersion = getLatestPackageVersion(cliPackageJson.name);
-
-        if (!latestVersion) {
-            log('Couldn\'t check for updates', 'yellow');
-            return;
-        }
-
-        const comparison = compareVersions(latestVersion, currentVersion);
-
-        if (comparison > 0) {
-            try {
-                log(`${COLORS.blue}${cliPackageJson.name}: ${currentVersion} → ${latestVersion}${COLORS.reset}`);
-                execSync(`npm install -g ${cliPackageJson.name}@${latestVersion}`, { stdio: 'inherit' });
-                log(`✓ ${cliPackageJson.name} updated successfully`, 'green');
-            } catch (e) {
-                log(`Failed to update ${cliPackageJson.name}`, 'red');
-            }
-        } else {
-            log(`✓ ${cliPackageJson.name} v${currentVersion} (already up to date)`, 'green');
-        }
-    }
-
-    console.log('');
-}
-
-function getAppBindgenPaths() {
-    return {
-        featuresDir: join(process.cwd(), 'src', 'features'),
-        // Connections/ is now at the project root — shared by C++ and TS
-        outputDir: join(process.cwd(), 'Connections'),
-    };
-}
-
-function findLikelyProjectDirs(baseDir) {
-    try {
-        const entries = execSync('npm pkg get name', { cwd: baseDir, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
-        if (entries) {
-            // noop; just to ensure cwd is a Node project when possible
-        }
-    } catch { }
-
-    const candidates = [];
-    try {
-        const dirs = execSync(process.platform === 'win32' ? 'dir /b /ad' : 'ls -1 -d */', {
-            cwd: baseDir,
-            encoding: 'utf8',
-            stdio: ['ignore', 'pipe', 'ignore'],
-            shell: true,
-        })
-            .split(/\r?\n/)
-            .map(s => s.trim().replace(/[\\/]$/, ''))
-            .filter(Boolean);
-
-        for (const dirName of dirs) {
-            const fullDir = join(baseDir, dirName);
-            if (existsSync(join(fullDir, 'CMakeLists.txt')) && existsSync(join(fullDir, 'package.json'))) {
-                candidates.push(dirName);
-            }
-        }
-    } catch { }
-
-    return candidates;
-}
-
-function ensureProjectRoot(commandName) {
-    const hasCMake = existsSync(join(process.cwd(), 'CMakeLists.txt'));
-    const hasPackage = existsSync(join(process.cwd(), 'package.json'));
-
-    if (hasCMake && hasPackage) {
-        return;
-    }
-
-    const likelyDirs = findLikelyProjectDirs(process.cwd());
-    let hint = '';
-
-    if (likelyDirs.length === 1) {
-        hint = `\n\nHint: you may be in a parent folder. Try:\n  cd ${likelyDirs[0]}\n  plusui ${commandName}`;
-    } else if (likelyDirs.length > 1) {
-        hint = `\n\nHint: run this command from your app folder (one containing CMakeLists.txt and package.json).`;
-    }
-
-    error(`This command must be run from a PlusUI project root (missing CMakeLists.txt and/or package.json in ${process.cwd()}).${hint}`);
-}
-
-function ensureBuildLayout() {
-    const buildRoot = join(process.cwd(), 'build');
-    for (const platform of Object.values(PLATFORMS)) {
-        mkdirSync(join(buildRoot, platform.folder), { recursive: true });
-    }
-}
-
-function getDevBuildDir() {
-    const platformFolder = PLATFORMS[process.platform]?.folder || 'Windows';
-    return join('.plusui', 'dev', platformFolder);
-}
-
-function resolveBindgenScriptPath() {
-    const candidates = [
-        resolve(__dirname, '../../plusui-connect/src/connect.js'),
-        resolve(__dirname, '../../plusui-connect/src/index.js'),
-        resolve(__dirname, '../../plusui-native-connect/src/connect.js'),
-        resolve(__dirname, '../../plusui-native-connect/src/index.js'),
-        resolve(__dirname, '../../plusui-native-bindgen/src/index.js'),
-        resolve(__dirname, '../../../plusui-native-connect/src/connect.js'),
-        resolve(__dirname, '../../../plusui-native-connect/src/index.js'),
-        resolve(__dirname, '../../../plusui-native-bindgen/src/index.js'),
-        resolve(process.cwd(), 'node_modules', 'plusui-native-connect', 'src', 'connect.js'),
-        resolve(process.cwd(), 'node_modules', 'plusui-native-connect', 'src', 'index.js'),
-        resolve(process.cwd(), 'node_modules', 'plusui-native-bindgen', 'src', 'index.js'),
-    ];
-
-    for (const candidate of candidates) {
-        if (existsSync(candidate)) {
-            return candidate;
-        }
-    }
-
-    return null;
-}
-
-async function syncGeneratedTsBindings(backendOutputDir, frontendOutputDir) {
-    const generatedTsPath = join(backendOutputDir, 'bindings.gen.ts');
-    if (!existsSync(generatedTsPath)) {
-        return;
-    }
-
-    await mkdir(frontendOutputDir, { recursive: true });
-    const frontendTsPath = join(frontendOutputDir, 'bindings.gen.ts');
-    await copyFile(generatedTsPath, frontendTsPath);
-    log(`Synced TS bindings: ${frontendTsPath}`, 'dim');
-}
-
-function promptTemplateSelection() {
-    return new Promise((resolve) => {
-        const rl = createInterface({
-            input: process.stdin,
-            output: process.stdout
-        });
-
-        console.log(`\n${COLORS.bright}Select a template:${COLORS.reset}`);
-        console.log(`  ${COLORS.cyan}1)${COLORS.reset} solid   - SolidJS + TypeScript (lightweight, reactive)`);
-        console.log(`  ${COLORS.cyan}2)${COLORS.reset} react   - React + TypeScript (popular, familiar)`);
-
-        rl.question(`\n${COLORS.yellow}Enter choice [1-2] (default: solid):${COLORS.reset} `, (answer) => {
-            rl.close();
-            const choice = answer.trim() || '1';
-            const templates = { '1': 'solid', '2': 'react' };
-            const template = templates[choice] || 'solid';
-            console.log(`${COLORS.green}✓${COLORS.reset} Selected: ${COLORS.cyan}${template}${COLORS.reset}\n`);
-            resolve(template);
-        });
-    });
-}
-
-async function createProject(name, options = {}) {
-    try {
-        const templateManager = new TemplateManager();
-        await templateManager.create(name, options);
-    } catch (e) {
-        error(e.message);
-    }
-}
-
-// ============================================================
-// BUILD FUNCTIONS
-// ============================================================
-
-function buildFrontend() {
-    ensureProjectRoot('build:frontend');
-    logSection('Building Frontend');
-
-    if (existsSync('frontend')) {
-        log('Running Vite build...', 'blue');
-        execSync('cd frontend && npm run build', { stdio: 'inherit', shell: true });
-        log('Frontend built successfully!', 'green');
-    } else {
-        log('No frontend directory found, skipping...', 'yellow');
-    }
-}
-
-function buildBackend(platform = null, devMode = false) {
-    ensureProjectRoot(devMode ? 'dev:backend' : 'build:backend');
-    const targetPlatform = platform || process.platform;
-    const platformConfig = PLATFORMS[targetPlatform] || PLATFORMS[Object.keys(PLATFORMS).find(k => PLATFORMS[k].folder.toLowerCase() === targetPlatform?.toLowerCase())];
-
-    if (!platformConfig) {
-        error(`Unsupported platform: ${targetPlatform}`);
-    }
-
-    logSection(`Building Backend (${platformConfig.name})`);
-
-    const buildDir = `build/${platformConfig.folder}`;
-
-    ensureBuildLayout();
-
-    // Create build directory
-    if (!existsSync(buildDir)) {
-        execSync(`mkdir -p "${buildDir}"`, { stdio: 'ignore', shell: true });
-    }
-
-    // CMake configure
-    let cmakeArgs = `-S . -B "${buildDir}" -DCMAKE_BUILD_TYPE=Release`;
-
-    if (devMode) {
-        cmakeArgs += ' -DPLUSUI_DEV_MODE=ON';
-    } else {
-        cmakeArgs += ' -DPLUSUI_DEV_MODE=OFF';
-    }
-
-    if (platformConfig.generator) {
-        cmakeArgs += ` -G "${platformConfig.generator}"`;
-    } else if (process.platform === 'win32') {
-        // Use embedded debug info (/Z7) to avoid VS 2026 PDB creation bug (C1041)
-        cmakeArgs += ' -DCMAKE_MSVC_DEBUG_INFORMATION_FORMAT=Embedded';
-    }
-
-    log(`Configuring CMake...`, 'blue');
-    runCMake(cmakeArgs);
-
-    // CMake build
-    log(`Building...`, 'blue');
-    runCMake(`--build "${buildDir}" --config Release`);
-
-    log(`Backend built: ${buildDir}`, 'green');
-
-    return buildDir;
-}
-
-async function generateIcons(inputPath = null) {
-    ensureProjectRoot('icons');
-    logSection('Generating Platform Icons');
-
-    const { IconGenerator } = await import('./assets/icon-generator.js');
-    const generator = new IconGenerator();
-
-    const srcIcon = inputPath || join(process.cwd(), 'assets', 'icon.png');
-    const outputBase = join(process.cwd(), 'assets', 'icons');
-
-    if (!existsSync(srcIcon)) {
-        log(`Icon not found: ${srcIcon}`, 'yellow');
-        log('Place a 512x512+ PNG icon at assets/icon.png', 'dim');
-        return;
-    }
-
-    await generator.generate(srcIcon, outputBase);
-}
-
-async function embedResources(platform = null) {
-    ensureProjectRoot('embed');
-    const targetPlatform = platform || process.platform;
-    logSection(`Embedding Resources (${targetPlatform})`);
-
-    const { ResourceEmbedder } = await import('./assets/resource-embedder.js');
-    const embedder = new ResourceEmbedder({ verbose: true });
-
-    const frontendDist = join(process.cwd(), 'frontend', 'dist');
-    const outputDir = join(process.cwd(), 'generated', 'resources');
-
-    if (!existsSync(frontendDist)) {
-        log('Frontend not built yet. Run: plusui build:frontend', 'yellow');
-        return;
-    }
-
-    if (platform === 'all') {
-        await embedder.embedAll(frontendDist, outputDir);
-    } else {
-        await embedder.embed(frontendDist, outputDir, targetPlatform);
-    }
-}
-
-async function embedAssets() {
-    ensureProjectRoot('build');
-    const assetsDir = join(process.cwd(), 'assets');
-    if (!existsSync(assetsDir)) {
-        try {
-            await mkdir(assetsDir, { recursive: true });
-        } catch (e) { }
-    }
-
-    logSection('Embedding Assets');
-
-    // Always generate the header file, even if empty
-    let headerContent = '#pragma once\n\n';
-    headerContent += '// THIS FILE IS AUTO-GENERATED BY PLUSUI CLI\n';
-    headerContent += '// DO NOT MODIFY MANUALLY\n\n';
-
-    const files = existsSync(assetsDir)
-        ? (await readdir(assetsDir)).filter(f => !statSync(join(assetsDir, f)).isDirectory())
-        : [];
-
-    if (files.length === 0) {
-        log('No assets found in assets/ folder', 'dim');
-    } else {
-        for (const file of files) {
-            const filePath = join(assetsDir, file);
-            log(`Processing ${file}...`, 'dim');
-
-            const varName = file.replace(/[^a-zA-Z0-9]/g, '_').toUpperCase();
-            const data = await readFile(filePath);
-
-            headerContent += `static const unsigned char ASSET_${varName}[] = {`;
-            for (let i = 0; i < data.length; i++) {
-                if (i % 16 === 0) headerContent += '\n  ';
-                headerContent += `0x${data[i].toString(16).padStart(2, '0')}, `;
-            }
-            headerContent += '\n};\n';
-            headerContent += `static const unsigned int ASSET_${varName}_LEN = ${data.length};\n\n`;
-        }
-    }
-
-    const genDir = join(process.cwd(), 'generated');
-    if (!existsSync(genDir)) await mkdir(genDir, { recursive: true });
-
-    await writeFile(join(genDir, 'assets.h'), headerContent);
-    log(`✓ Assets header generated: generated/assets.h`, 'green');
-}
-
-
-
-async function build(production = true) {
-    ensureProjectRoot('build');
-    logSection('Building PlusUI Application');
-
-    // Embed assets
-    await embedAssets();
-
-    // Build frontend first
-    if (production) {
-        buildFrontend();
-    }
-
-    // Build backend
-    const buildDir = buildBackend(null, !production);
-
-    log('\nBuild complete!', 'green');
-    return buildDir;
-}
-
-function buildAll() {
-    ensureProjectRoot('build:all');
-    logSection('Building for All Platforms');
-
-    ensureBuildLayout();
-
-    buildFrontend();
-
-    const supportedPlatforms = ['win32', 'darwin', 'linux'];
-
-    for (const platform of supportedPlatforms) {
-        try {
-            buildBackend(platform, false);
-        } catch (e) {
-            log(`Failed to build for ${PLATFORMS[platform].name}: ${e.message}`, 'yellow');
-        }
-    }
-
-    log('\nAll platform builds complete!', 'green');
-    log('\nOutput directories:', 'bright');
-    log('  build/Windows/', 'cyan');
-    log('  build/MacOS/', 'cyan');
-    log('  build/Linux/', 'cyan');
-    log('  build/Android/', 'cyan');
-    log('  build/iOS/', 'cyan');
-}
-
-function buildPlatform(platform) {
-    logSection(`Building for ${PLATFORMS[platform]?.name || platform}`);
-    buildFrontend();
-    buildBackend(platform, false);
-}
-
-// ============================================================
-// DEVELOPMENT FUNCTIONS
-// ============================================================
-
-let viteServer = null;
-let cppProcess = null;
-
-async function startViteServer() {
-    ensureProjectRoot('dev:frontend');
-    log('Starting Vite dev server...', 'blue');
-
-    viteServer = await createViteServer({
-        root: 'frontend',
-        server: {
-            port: 5173,
-            strictPort: false,
-        },
-    });
-
-    await viteServer.listen();
-
-    const actualPort = viteServer.httpServer?.address()?.port || 5173;
-    log(`Vite server: http://localhost:${actualPort}`, 'green');
-    return viteServer;
-}
-
-async function startBackend() {
-    ensureProjectRoot('dev');
-    logSection('Building C++ Backend (Dev Mode)');
-
-    const projectName = getProjectName();
-    killProcessByName(projectName);
-
-    const buildDir = getDevBuildDir();
-
-    // On Windows, use embedded debug info (/Z7) to avoid VS 2026 PDB creation bug (C1041)
-    let generatorArgs = '';
-    if (process.platform === 'win32') {
-        generatorArgs = ' -DCMAKE_MSVC_DEBUG_INFORMATION_FORMAT=Embedded';
-    }
-
-    // Auto-clean build dir if generator changed (e.g. VS → Ninja)
-    const cacheFile = join(buildDir, 'CMakeCache.txt');
-    if (existsSync(cacheFile)) {
-        try {
-            const cacheContent = execSync(`type "${cacheFile}"`, { encoding: 'utf8', shell: true, stdio: ['pipe', 'pipe', 'ignore'] });
-            const generatorMatch = cacheContent.match(/CMAKE_GENERATOR:INTERNAL=(.*)/);
-            const cachedGenerator = generatorMatch ? generatorMatch[1].trim() : '';
-            const wantNinja = generatorArgs.includes('Ninja');
-            if ((wantNinja && cachedGenerator !== 'Ninja') || (!wantNinja && cachedGenerator === 'Ninja')) {
-                log(`Generator changed (${cachedGenerator} → ${wantNinja ? 'Ninja' : 'default'}), cleaning build dir...`, 'yellow');
-                execSync(process.platform === 'win32' ? `rmdir /s /q "${buildDir}"` : `rm -rf "${buildDir}"`, { stdio: 'ignore', shell: true });
-            }
-        } catch { }
-    }
-
-    // Always configure with dev mode to ensure PLUSUI_DEV_MODE is set correctly
-    log('Configuring CMake...', 'blue');
-    runCMake(`-S . -B "${buildDir}" -DPLUSUI_DEV_MODE=ON${generatorArgs}`);
-
-    log('Compiling...', 'blue');
-    runCMake(`--build "${buildDir}"`);
-
-    // Find executable
-    let exePath;
-    if (process.platform === 'win32') {
-        // Ninja puts exe directly in build dir
-        exePath = join(buildDir, `${projectName}.exe`);
-        if (!existsSync(exePath)) {
-            exePath = join(buildDir, 'bin', `${projectName}.exe`);
-        }
-        // Fallback for VS generator (Debug subfolder)
-        if (!existsSync(exePath)) {
-            exePath = join(buildDir, projectName, 'Debug', `${projectName}.exe`);
-        }
-        if (!existsSync(exePath)) {
-            exePath = join(buildDir, 'Debug', `${projectName}.exe`);
-        }
-    } else {
-        exePath = join(buildDir, projectName);
-        if (!existsSync(exePath)) {
-            exePath = join(buildDir, 'bin', projectName);
-        }
-    }
-
-    if (!existsSync(exePath)) {
-        error(`Executable not found. Expected: ${exePath}`);
-    }
-
-    log('Starting C++ app...', 'blue');
-
-    cppProcess = spawn(exePath, [], {
-        shell: true,
-        stdio: 'inherit',
-        env: { ...process.env, PLUSUI_DEV: '1' }
-    });
-
-    cppProcess.on('error', (err) => {
-        log(`Failed to start app: ${err.message}`, 'red');
-    });
-
-    return cppProcess;
-}
-
-async function killPort(port) {
-    log(`Checking port ${port}...`, 'dim');
-    try {
-        if (process.platform === 'win32') {
-            try {
-                const output = execSync(`netstat -ano | findstr :${port}`, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
-                const lines = output.split('\n').filter(line => line.includes(`:${port}`) && line.includes('LISTENING'));
-
-                for (const line of lines) {
-                    const parts = line.trim().split(/\s+/);
-                    const pid = parts[parts.length - 1];
-                    if (pid && /^\d+$/.test(pid)) {
-                        log(`Killing process ${pid} on port ${port}...`, 'yellow');
-                        try {
-                            execSync(`taskkill /PID ${pid} /F`, { stdio: 'ignore' });
-                        } catch (e) {
-                            // Ignore if already dead
-                        }
-                    }
-                }
-            } catch (e) {
-                // findstr returns exit code 1 if no match found
-            }
-        } else {
-            try {
-                execSync(`lsof -i :${port} -t | xargs kill -9`, { stdio: 'ignore' });
-            } catch {
-                // Ignore if no process found
-            }
-        }
-    } catch (e) {
-        // Ignore general errors
-    }
-}
-
-function killProcessByName(name) {
-    const processName = process.platform === 'win32' ? `${name}.exe` : name;
-    log(`Cleaning up previous instance (${processName})...`, 'dim');
-    try {
-        if (process.platform === 'win32') {
-            execSync(`taskkill /IM "${processName}" /F`, { stdio: 'ignore' });
-        } else {
-            execSync(`pkill -f "${processName}"`, { stdio: 'ignore' });
-        }
-    } catch (e) {
-        // Ignore if process not found
-    }
-}
-
-async function dev() {
-    ensureProjectRoot('dev');
-    logSection('PlusUI Development Mode');
-
-    const toolCheck = checkTools();
-    if (toolCheck && toolCheck.missing) {
-        error('Missing required build tools. Run: plusui doctor --fix');
-    }
-
-    // Embed assets
-    await embedAssets();
-
-    await runBindgen([], { skipIfNoInput: true, source: 'dev' });
-
-    // specific port cleaning
-    await killPort(5173);
-
-    // Start Vite first
-    try {
-        viteServer = await startViteServer();
-    } catch (e) {
-        log(`Vite failed to start: ${e.message}`, 'red');
-        error('Could not start development server');
-    }
-
-    const actualPort = viteServer.httpServer?.address()?.port || 5173;
-
-    // Build and start C++ backend
-    await startBackend();
-
-    log('\n' + '='.repeat(50), 'dim');
-    log('Development mode active', 'green');
-    log('='.repeat(50), 'dim');
-    log(`\nFrontend: http://localhost:${actualPort} (HMR enabled)`, 'cyan');
-    log('Backend:  C++ app running with webview', 'cyan');
-    log('\nEdit frontend/src/* for live reload', 'dim');
-    log('Edit main.cpp and restart for C++ changes', 'dim');
-    log('\nPress Ctrl+C to stop\n', 'yellow');
-
-    // Handle shutdown
-    process.on('SIGINT', async () => {
-        log('\nShutting down...', 'yellow');
-        if (viteServer) await viteServer.close();
-        if (cppProcess) cppProcess.kill();
-        process.exit(0);
-    });
-}
-
-async function devFrontend() {
-    ensureProjectRoot('dev:frontend');
-    logSection('Frontend Development Mode');
-
-    // specific port cleaning
-    await killPort(5173);
-
-    viteServer = await createViteServer({
-        root: 'frontend',
-        server: { port: 5173, strictPort: false },
-    });
-
-    await viteServer.listen();
-
-    const actualPort = viteServer.httpServer?.address()?.port || 5173;
-    log(`Frontend: http://localhost:${actualPort}`, 'green');
-    log('HMR enabled - changes will reflect instantly!\n', 'green');
-
-    process.on('SIGINT', async () => {
-        if (viteServer) await viteServer.close();
-        process.exit(0);
-    });
-}
-
-function devBackend() {
-    ensureProjectRoot('dev:backend');
-    logSection('Backend Development Mode');
-
-    const projectName = getProjectName();
-    killProcessByName(projectName);
-
-    const buildDir = getDevBuildDir();
-
-    // Always configure with dev mode to ensure PLUSUI_DEV_MODE is set correctly
-    log('Configuring CMake...', 'blue');
-    runCMake(`-S . -B "${buildDir}" -DPLUSUI_DEV_MODE=ON`);
-
-    runCMake(`--build "${buildDir}"`);
-
-    let exePath;
-    if (process.platform === 'win32') {
-        exePath = join(buildDir, projectName, 'Debug', `${projectName}.exe`);
-        if (!existsSync(exePath)) exePath = join(buildDir, 'Debug', `${projectName}.exe`);
-        if (!existsSync(exePath)) exePath = join(buildDir, `${projectName}.exe`);
-    } else {
-        exePath = join(buildDir, projectName);
-    }
-
-    function runApp() {
-        if (cppProcess) cppProcess.kill();
-
-        cppProcess = spawn(exePath, [], { shell: true, stdio: 'inherit' });
-
-        cppProcess.on('close', (code) => {
-            if (code !== null && code !== 0) {
-                log(`App exited with code ${code}`, 'yellow');
-            }
-        });
-    }
-
-    runApp();
-
-    log('\nWatching C++ files for changes...', 'yellow');
-    log('Press Ctrl+C to stop\n', 'dim');
-
-    // Watch main.cpp and features/ folder (if exists)
-    const watchItems = ['main.cpp'];
-    if (existsSync('features')) watchItems.push('features');
-
-    const watchers = watchItems.map(item => {
-        const isDir = existsSync(item) && statSync(item).isDirectory();
-        const w = isDir ? watch(item, { recursive: true }) : watch(item);
-        w.on('change', (eventType, filename) => {
-            const file = item === 'main.cpp' ? 'main.cpp' : filename;
-            if (file && (file.endsWith('.cpp') || file.endsWith('.hpp'))) {
-                log(`Changed: ${file}`, 'yellow');
-                log('Rebuilding...', 'blue');
-                try {
-                    killProcessByName(projectName);
-                    runCMake(`--build "${buildDir}"`);
-                    runApp();
-                } catch (e) {
-                    log('Build failed, waiting for fixes...', 'red');
-                }
-            }
-        });
-        return w;
-    });
-
-    process.on('SIGINT', () => {
-        if (cppProcess) cppProcess.kill();
-        watchers.forEach(w => w.close());
-        process.exit(0);
-    });
-}
-
-// ============================================================
-// RUN FUNCTION
-// ============================================================
-
-function run() {
-    ensureProjectRoot('run');
-    const projectName = getProjectName();
-    const platform = PLATFORMS[process.platform];
-    const buildDir = `build/${platform?.folder || 'Windows'}`;
-
-    let exePath;
-    if (process.platform === 'win32') {
-        exePath = join(buildDir, 'Release', `${projectName}.exe`);
-        if (!existsSync(exePath)) exePath = join(buildDir, 'bin', `${projectName}.exe`);
-        if (!existsSync(exePath)) exePath = join(buildDir, `${projectName}.exe`);
-    } else {
-        exePath = join(buildDir, projectName);
-        if (!existsSync(exePath)) exePath = join(buildDir, 'bin', projectName);
-    }
-
-    if (!existsSync(exePath)) {
-        error(`Build not found at ${exePath}. Run "plusui build" first.`);
-    }
-
-    log(`Running: ${exePath}`, 'blue');
-
-    const proc = spawn(exePath, [], { shell: true, stdio: 'inherit' });
-
-    proc.on('close', (code) => {
-        process.exit(code);
-    });
-}
-
-// ============================================================
-// CLEAN FUNCTION
-// ============================================================
-
-async function clean() {
-    ensureProjectRoot('clean');
-    logSection('Cleaning Build Artifacts');
-
-    const dirs = ['build', '.plusui', 'frontend/dist'];
-
-    for (const dir of dirs) {
-        if (existsSync(dir)) {
-            log(`Removing: ${dir}`, 'yellow');
-            await rm(dir, { recursive: true, force: true });
-        }
-    }
-
-    log('\nClean complete!', 'green');
-}
-
-// ============================================================
-// CONNECT GENERATOR FUNCTION
-// ============================================================
-
-async function runBindgen(providedArgs = null, options = {}) {
-    ensureProjectRoot('bindgen');
-    logSection('Running Connection Generator');
-
-    const { skipIfNoInput = false, source = 'manual' } = options;
-
-    const scriptPath = resolveBindgenScriptPath();
-
-    if (!scriptPath) {
-        error(`Connection generator script not found. Please ensure plusui-native-connect is installed.`);
-    }
-
-    log(`Using connect generator: ${scriptPath}`, 'dim');
-
-    // plusui connect [projectRoot] [outputDir]
-    // Defaults to app-local paths when available.
-    const args = providedArgs ?? process.argv.slice(3);
-    let bindgenArgs = [...args];
-
-    let usedDefaultAppMode = false;
-    let defaultOutputDir = null;
-
-    if (bindgenArgs.length === 0) {
-        const { outputDir: appOutputDir } = getAppBindgenPaths();
-        bindgenArgs = [process.cwd(), appOutputDir];
-        usedDefaultAppMode = true;
-        defaultOutputDir = appOutputDir;
-        log(`Project mode: ${process.cwd()} -> ${appOutputDir}`, 'dim');
-    }
-
-    // Spawn node process
-    const proc = spawn(process.execPath, [scriptPath, ...bindgenArgs], {
-        stdio: 'inherit',
-        env: process.env
-    });
-
-    return new Promise((resolve, reject) => {
-        proc.on('close', async (code) => {
-            if (code === 0) {
-                try {
-                    log('\nBindgen complete!', 'green');
-                    resolve();
-                } catch (syncErr) {
-                    reject(syncErr);
-                }
-            } else {
-                reject(new Error(`Connection generator failed with code ${code}`));
-            }
-        });
-    });
-}
-
-// ============================================================
-// MAIN
-// ============================================================
-
-async function main() {
-    const args = process.argv.slice(2);
-    const cmd = args[0];
-
-    switch (cmd) {
-        case 'doctor':
-            await runDoctor({
-                fix: args.includes('--fix'),
-                json: args.includes('--json'),
-                quick: args.includes('--quick')
-            });
-            break;
-        case 'create':
-            if (!args[1] || args[1].startsWith('-')) error('Project name required');
-            const template = await promptTemplateSelection();
-            await createProject(args[1], { template });
-            break;
-        case 'dev':
-            await dev();
-            break;
-        case 'dev:frontend':
-            await devFrontend();
-            break;
-        case 'dev:backend':
-            await runBindgen([], { skipIfNoInput: true, source: 'dev:backend' });
-            devBackend();
-            break;
-        case 'build':
-            await runBindgen([], { skipIfNoInput: true, source: 'build' });
-            await build(true);
-            break;
-        case 'build:frontend':
-            buildFrontend();
-            break;
-        case 'build:backend':
-            await runBindgen([], { skipIfNoInput: true, source: 'build:backend' });
-            buildBackend(null, false);
-            break;
-        case 'build:all':
-            await runBindgen([], { skipIfNoInput: true, source: 'build:all' });
-            buildAll();
-            break;
-        case 'build:windows':
-            await runBindgen([], { skipIfNoInput: true, source: 'build:windows' });
-            buildPlatform('win32');
-            break;
-        case 'build:macos':
-            await runBindgen([], { skipIfNoInput: true, source: 'build:macos' });
-            buildPlatform('darwin');
-            break;
-        case 'build:linux':
-            await runBindgen([], { skipIfNoInput: true, source: 'build:linux' });
-            buildPlatform('linux');
-            break;
-        case 'build:android':
-            await runBindgen([], { skipIfNoInput: true, source: 'build:android' });
-            buildPlatform('android');
-            break;
-        case 'build:ios':
-            await runBindgen([], { skipIfNoInput: true, source: 'build:ios' });
-            buildPlatform('ios');
-            break;
-        case 'run':
-            run();
-            break;
-        case 'clean':
-            await clean();
-            break;
-        case 'connect':
-        case 'bind':
-        case 'bindgen':
-            await runBindgen();
-            break;
-        case 'update':
-            await updatePlusUIPackages();
-            break;
-        case 'icons':
-            await generateIcons(args[1]);
-            break;
-        case 'embed':
-            await embedResources(args[1]);
-            break;
-        case 'help':
-        case '-h':
-        case '--help':
-            console.log(USAGE);
-            break;
-        case '-v':
-        case '--version':
-            showVersionInfo();
-            break;
-        default:
-            console.log(USAGE);
-    }
-}
-
-main().catch(e => error(e.message));
+
+import { mkdir, readFile, stat, rm, readdir, writeFile, copyFile } from 'fs/promises';
+import { existsSync, watch, statSync, mkdirSync } from 'fs';
+import { exec, spawn, execSync } from 'child_process';
+import { join, dirname, basename, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
+import { createServer as createViteServer } from 'vite';
+import { runDoctor } from './doctor/index.js';
+import { TemplateManager } from '../templates/manager.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Load package.json for version info
+const cliPackageJson = JSON.parse(
+    await readFile(join(__dirname, '..', 'package.json'), 'utf8')
+);
+
+const COLORS = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    dim: '\x1b[2m',
+    green: '\x1b[32m',
+    blue: '\x1b[34m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    cyan: '\x1b[36m',
+    magenta: '\x1b[35m',
+};
+
+function log(msg, color = 'reset') {
+    console.log(`${COLORS[color]}${msg}${COLORS.reset}`);
+}
+
+function logSection(title) {
+    console.log(`\n${COLORS.bright}${COLORS.blue}=== ${title} ===${COLORS.reset}\n`);
+}
+
+function error(msg) {
+    console.error(`${COLORS.red}Error: ${msg}${COLORS.reset}`);
+    process.exit(1);
+}
+
+function checkTools() {
+    const platform = process.platform;
+    const required = [];
+
+    const cmakePaths = [
+        'cmake',
+        'C:\\Program Files\\CMake\\bin\\cmake.exe',
+        'C:\\Program Files (x86)\\CMake\\bin\\cmake.exe',
+        '/usr/local/bin/cmake',
+        '/usr/bin/cmake'
+    ];
+
+    let cmakeFound = false;
+    for (const p of cmakePaths) {
+        try {
+            execSync(`"${p}" --version`, { stdio: 'ignore' });
+            cmakeFound = true;
+            break;
+        } catch { }
+    }
+
+    if (!cmakeFound) {
+        if (platform === 'win32') {
+            required.push({ name: 'CMake', install: 'winget install Kitware.CMake', auto: 'winget install -e --id Kitware.CMake' });
+        } else if (platform === 'darwin') {
+            required.push({ name: 'CMake', install: 'brew install cmake', auto: 'brew install cmake' });
+        } else {
+            required.push({ name: 'CMake', install: 'sudo apt install cmake', auto: 'sudo apt install cmake' });
+        }
+    }
+
+    // Compiler / build tools check
+    if (platform === 'win32') {
+        // Use vswhere.exe first (same detection as `plusui doctor`)
+        let vsFound = false;
+        const vswherePath = 'C:\\Program Files (x86)\\Microsoft Visual Studio\\Installer\\vswhere.exe';
+        if (existsSync(vswherePath)) {
+            try {
+                const output = execSync(
+                    `"${vswherePath}" -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath`,
+                    { stdio: ['pipe', 'pipe', 'pipe'], encoding: 'utf8', timeout: 10000 }
+                ).trim();
+                if (output) vsFound = true;
+            } catch { }
+        }
+
+        // Fallback: check common VS paths for years 2019–2026
+        if (!vsFound) {
+            const vsYears = ['2026', '2025', '2024', '2023', '2022', '2019'];
+            const vsEditions = ['Community', 'Professional', 'Enterprise', 'BuildTools'];
+            for (const year of vsYears) {
+                for (const edition of vsEditions) {
+                    if (existsSync(`C:\\Program Files\\Microsoft Visual Studio\\${year}\\${edition}\\VC\\Tools\\MSVC`)) {
+                        vsFound = true;
+                        break;
+                    }
+                }
+                if (vsFound) break;
+            }
+        }
+
+        if (!vsFound) {
+            required.push({ name: 'Visual Studio (C++ workload)', install: 'Download from visualstudio.microsoft.com with C++ workload', auto: null });
+        }
+    } else if (platform === 'darwin') {
+        try {
+            execSync('clang++ --version', { stdio: 'ignore' });
+        } catch {
+            required.push({ name: 'Xcode', install: 'xcode-select --install', auto: 'xcode-select --install' });
+        }
+    } else {
+        try {
+            execSync('g++ --version', { stdio: 'ignore' });
+        } catch {
+            required.push({ name: 'GCC/Clang', install: 'sudo apt install build-essential', auto: 'sudo apt install build-essential' });
+        }
+    }
+
+    if (required.length > 0) {
+        log('\n=== Missing Required Tools ===', 'yellow');
+
+        for (const tool of required) {
+            log(`\n  ${tool.name}`, 'bright');
+            log(`  Install: ${tool.install}`, 'reset');
+            if (tool.auto) {
+                log(`  Run:     ${tool.auto}`, 'green');
+            }
+        }
+
+        log('\n');
+        return { missing: required };
+    }
+    return null;
+}
+
+const USAGE = `
+${COLORS.bright}${cliPackageJson.name}${COLORS.reset} v${cliPackageJson.version} - Build C++ desktop apps with web tech
+
+${COLORS.bright}Usage:${COLORS.reset}
+  plusui doctor              Check development environment
+  plusui doctor --fix        Check and auto-install missing tools
+  plusui create <name>       Create a new PlusUI project
+  plusui dev                 Run in development mode (Vite HMR + C++ app)
+  plusui build               Build for current platform (production)
+  plusui build:frontend      Build frontend only
+  plusui build:backend       Build C++ backend only
+  plusui build:all           Build for all platforms
+    plusui run                 Run the built application
+    plusui clean               Clean build artifacts
+    plusui connect             Generate connection bindings for current app (aliases: bind, bindgen)
+  plusui update              Update all PlusUI packages to latest versions
+  plusui help                Show this help message
+
+${COLORS.bright}Platform Builds:${COLORS.reset}
+  plusui build:windows       Build for Windows
+  plusui build:macos         Build for macOS
+  plusui build:linux         Build for Linux
+
+${COLORS.bright}Asset Commands:${COLORS.reset}
+  plusui icons [input]       Generate platform icons from source icon
+  plusui embed [platform]    Embed resources for platform (win32/darwin/linux/all)
+
+${COLORS.bright}Options:${COLORS.reset}
+  -h, --help                 Show this help message
+  -v, --version              Show version number
+  -t, --template             Specify template (solid, react)
+
+${COLORS.bright}Assets:${COLORS.reset}
+  Place assets/icon.png (512x512+ recommended) for automatic icon generation.
+  All assets in "assets/" are embedded into the binary for single-exe distribution.
+  Embedded resources are accessible via plusui::resources::getResource("path").
+`;
+
+// Platform configuration
+const PLATFORMS = {
+    win32: { name: 'Windows', folder: 'Windows', ext: '.exe', generator: null },
+    darwin: { name: 'macOS', folder: 'MacOS', ext: '', generator: 'Xcode' },
+    linux: { name: 'Linux', folder: 'Linux', ext: '', generator: 'Ninja' },
+    android: { name: 'Android', folder: 'Android', ext: '.apk', generator: 'Ninja' },
+    ios: { name: 'iOS', folder: 'iOS', ext: '.app', generator: 'Xcode' },
+};
+
+function getProjectName() {
+    try {
+        const pkg = JSON.parse(execSync('npm pkg get name', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }));
+        return typeof pkg === 'string' ? pkg.replace(/"/g, '') : basename(process.cwd());
+    } catch {
+        return basename(process.cwd());
+    }
+}
+
+function getCMakePath() {
+    const paths = [
+        'cmake',
+        'C:\\Program Files\\CMake\\bin\\cmake.exe',
+        'C:\\Program Files (x86)\\CMake\\bin\\cmake.exe',
+        '/usr/local/bin/cmake',
+        '/usr/bin/cmake'
+    ];
+    for (const p of paths) {
+        try {
+            execSync(`"${p}" --version`, { stdio: 'ignore' });
+            return p;
+        } catch { }
+    }
+    return 'cmake';
+}
+
+// Find vcvarsall.bat for Windows builds (needed for Ninja generator)
+let _vcvarsallCache = undefined;
+function findVcvarsall() {
+    if (_vcvarsallCache !== undefined) return _vcvarsallCache;
+
+    const vswherePath = 'C:\\Program Files (x86)\\Microsoft Visual Studio\\Installer\\vswhere.exe';
+    if (existsSync(vswherePath)) {
+        try {
+            const installPath = execSync(
+                `"${vswherePath}" -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath`,
+                { stdio: ['pipe', 'pipe', 'pipe'], encoding: 'utf8', timeout: 10000 }
+            ).trim();
+            if (installPath) {
+                const vcvars = join(installPath, 'VC', 'Auxiliary', 'Build', 'vcvarsall.bat');
+                if (existsSync(vcvars)) {
+                    _vcvarsallCache = vcvars;
+                    return vcvars;
+                }
+            }
+        } catch { }
+    }
+
+    // Fallback: scan known paths
+    const vsYears = ['2026', '2025', '2024', '2023', '2022', '2019'];
+    const vsEditions = ['Community', 'Professional', 'Enterprise', 'BuildTools'];
+    for (const year of vsYears) {
+        for (const edition of vsEditions) {
+            const vcvars = `C:\\Program Files\\Microsoft Visual Studio\\${year}\\${edition}\\VC\\Auxiliary\\Build\\vcvarsall.bat`;
+            if (existsSync(vcvars)) {
+                _vcvarsallCache = vcvars;
+                return vcvars;
+            }
+        }
+    }
+
+    _vcvarsallCache = null;
+    return null;
+}
+
+// Capture the full environment from vcvarsall.bat (cached per session)
+let _vcEnvCache = undefined;
+function getVcEnvironment() {
+    if (_vcEnvCache !== undefined) return _vcEnvCache;
+
+    if (process.platform !== 'win32') {
+        _vcEnvCache = null;
+        return null;
+    }
+
+    const vcvarsall = findVcvarsall();
+    if (!vcvarsall) {
+        _vcEnvCache = null;
+        return null;
+    }
+
+    try {
+        // Run vcvarsall and dump all environment variables
+        const output = execSync(
+            `cmd /c ""${vcvarsall}" x64 >nul 2>&1 && set"`,
+            { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 30000, shell: true }
+        );
+
+        // Parse "KEY=VALUE" lines into an env object
+        const env = {};
+        for (const line of output.split(/\r?\n/)) {
+            const idx = line.indexOf('=');
+            if (idx > 0) {
+                env[line.substring(0, idx)] = line.substring(idx + 1);
+            }
+        }
+
+        // Sanity check: we should have PATH and INCLUDE set
+        if (env.PATH && env.INCLUDE) {
+            _vcEnvCache = env;
+            return env;
+        }
+    } catch { }
+
+    _vcEnvCache = null;
+    return null;
+}
+
+function runCMake(args, options = {}) {
+    const cmake = getCMakePath();
+
+    // On Windows, use the captured vcvarsall environment so cl.exe + ninja are in PATH
+    if (process.platform === 'win32') {
+        const vcEnv = getVcEnvironment();
+        if (vcEnv) {
+            return execSync(`"${cmake}" ${args}`, { stdio: 'inherit', env: vcEnv, ...options });
+        }
+    }
+
+    return execSync(`"${cmake}" ${args}`, { stdio: 'inherit', ...options });
+}
+
+function getInstalledPackageVersion(packageName) {
+    try {
+        const result = execSync(`npm list ${packageName} --depth=0 --json`, {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore']
+        });
+        const json = JSON.parse(result);
+        if (json.dependencies && json.dependencies[packageName]) {
+            return json.dependencies[packageName].version;
+        }
+    } catch {
+        // Package not installed locally
+    }
+
+    // Try global installation
+    try {
+        const result = execSync(`npm list -g ${packageName} --depth=0 --json`, {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore']
+        });
+        const json = JSON.parse(result);
+        if (json.dependencies && json.dependencies[packageName]) {
+            return json.dependencies[packageName].version;
+        }
+    } catch {
+        return null;
+    }
+
+    return null;
+}
+
+function getLatestPackageVersion(packageName) {
+    try {
+        const result = execSync(`npm view ${packageName} version`, {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore']
+        });
+        return result.trim();
+    } catch {
+        return null;
+    }
+}
+
+function compareVersions(v1, v2) {
+    const parts1 = v1.split('.').map(Number);
+    const parts2 = v2.split('.').map(Number);
+
+    for (let i = 0; i < 3; i++) {
+        if (parts1[i] > parts2[i]) return 1;
+        if (parts1[i] < parts2[i]) return -1;
+    }
+    return 0;
+}
+
+function showVersionInfo() {
+    const packages = [
+        cliPackageJson.name,
+        'plusui-native-core',
+        'plusui-native-builder',
+        'plusui-native-connect'
+    ];
+
+    logSection('PlusUI Package Versions');
+
+    packages.forEach(pkg => {
+        let version;
+        if (pkg === cliPackageJson.name) {
+            version = cliPackageJson.version;
+            log(`${pkg}: ${COLORS.green}v${version}${COLORS.reset} ${COLORS.dim}(current)${COLORS.reset}`, 'reset');
+        } else {
+            version = getInstalledPackageVersion(pkg);
+            if (version) {
+                log(`${pkg}: ${COLORS.green}v${version}${COLORS.reset}`, 'reset');
+            } else {
+                log(`${pkg}: ${COLORS.dim}not installed${COLORS.reset}`, 'reset');
+            }
+        }
+    });
+
+    console.log('');
+}
+
+async function updatePlusUIPackages() {
+    logSection('Updating PlusUI Packages');
+
+    const packages = [
+        cliPackageJson.name,
+        'plusui-native-core',
+        'plusui-native-builder',
+        'plusui-native-connect'
+    ];
+
+    log('Checking for updates...\n', 'blue');
+
+    // Check if packages are installed locally or globally
+    const isInProject = existsSync(join(process.cwd(), 'package.json'));
+
+    if (isInProject) {
+        let updatedCount = 0;
+        let upToDateCount = 0;
+        let installedCount = 0;
+
+        for (const pkg of packages) {
+            const currentVersion = getInstalledPackageVersion(pkg);
+
+            if (!currentVersion) {
+                const latestVersion = getLatestPackageVersion(pkg);
+
+                if (!latestVersion) {
+                    log(`${COLORS.yellow}${pkg}: not installed (couldn't resolve latest version)${COLORS.reset}`);
+                    continue;
+                }
+
+                try {
+                    log(`${COLORS.blue}${pkg}: not installed → ${latestVersion}${COLORS.reset}`);
+                    execSync(`npm install ${pkg}@${latestVersion}`, {
+                        stdio: ['ignore', 'ignore', 'pipe'],
+                        encoding: 'utf8'
+                    });
+                    log(`${COLORS.green}✓ ${pkg} installed${COLORS.reset}`);
+                    installedCount++;
+                } catch (e) {
+                    log(`${COLORS.red}✗ ${pkg} install failed${COLORS.reset}`);
+                }
+                continue;
+            }
+
+            // Get latest version from npm
+            const latestVersion = getLatestPackageVersion(pkg);
+
+            if (!latestVersion) {
+                log(`${COLORS.yellow}${pkg}: couldn't check for updates${COLORS.reset}`);
+                continue;
+            }
+
+            const comparison = compareVersions(latestVersion, currentVersion);
+
+            if (comparison > 0) {
+                // Newer version available
+                try {
+                    log(`${COLORS.blue}${pkg}: ${currentVersion} → ${latestVersion}${COLORS.reset}`);
+                    execSync(`npm install ${pkg}@${latestVersion}`, {
+                        stdio: ['ignore', 'ignore', 'pipe'],
+                        encoding: 'utf8'
+                    });
+                    log(`${COLORS.green}✓ ${pkg} updated${COLORS.reset}`);
+                    updatedCount++;
+                } catch (e) {
+                    log(`${COLORS.red}✗ ${pkg} update failed${COLORS.reset}`);
+                }
+            } else {
+                // Already up to date
+                log(`${COLORS.green}✓ ${pkg} v${currentVersion} (up to date)${COLORS.reset}`);
+                upToDateCount++;
+            }
+        }
+
+        console.log('');
+        if (updatedCount > 0) {
+            log(`Updated ${updatedCount} package${updatedCount !== 1 ? 's' : ''}`, 'green');
+        }
+        if (installedCount > 0) {
+            log(`Installed ${installedCount} missing package${installedCount !== 1 ? 's' : ''}`, 'green');
+        }
+        if (upToDateCount > 0) {
+            log(`${upToDateCount} package${upToDateCount !== 1 ? 's' : ''} already up to date`, 'dim');
+        }
+    } else {
+        log('Updating global CLI package...', 'cyan');
+
+        const currentVersion = cliPackageJson.version;
+        const latestVersion = getLatestPackageVersion(cliPackageJson.name);
+
+        if (!latestVersion) {
+            log('Couldn\'t check for updates', 'yellow');
+            return;
+        }
+
+        const comparison = compareVersions(latestVersion, currentVersion);
+
+        if (comparison > 0) {
+            try {
+                log(`${COLORS.blue}${cliPackageJson.name}: ${currentVersion} → ${latestVersion}${COLORS.reset}`);
+                execSync(`npm install -g ${cliPackageJson.name}@${latestVersion}`, { stdio: 'inherit' });
+                log(`✓ ${cliPackageJson.name} updated successfully`, 'green');
+            } catch (e) {
+                log(`Failed to update ${cliPackageJson.name}`, 'red');
+            }
+        } else {
+            log(`✓ ${cliPackageJson.name} v${currentVersion} (already up to date)`, 'green');
+        }
+    }
+
+    console.log('');
+}
+
+function getAppBindgenPaths() {
+    return {
+        featuresDir: join(process.cwd(), 'src', 'features'),
+        // Connections/ is now at the project root — shared by C++ and TS
+        outputDir: join(process.cwd(), 'Connections'),
+    };
+}
+
+function findLikelyProjectDirs(baseDir) {
+    try {
+        const entries = execSync('npm pkg get name', { cwd: baseDir, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+        if (entries) {
+            // noop; just to ensure cwd is a Node project when possible
+        }
+    } catch { }
+
+    const candidates = [];
+    try {
+        const dirs = execSync(process.platform === 'win32' ? 'dir /b /ad' : 'ls -1 -d */', {
+            cwd: baseDir,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            shell: true,
+        })
+            .split(/\r?\n/)
+            .map(s => s.trim().replace(/[\\/]$/, ''))
+            .filter(Boolean);
+
+        for (const dirName of dirs) {
+            const fullDir = join(baseDir, dirName);
+            if (existsSync(join(fullDir, 'CMakeLists.txt')) && existsSync(join(fullDir, 'package.json'))) {
+                candidates.push(dirName);
+            }
+        }
+    } catch { }
+
+    return candidates;
+}
+
+function ensureProjectRoot(commandName) {
+    const hasCMake = existsSync(join(process.cwd(), 'CMakeLists.txt'));
+    const hasPackage = existsSync(join(process.cwd(), 'package.json'));
+
+    if (hasCMake && hasPackage) {
+        return;
+    }
+
+    const likelyDirs = findLikelyProjectDirs(process.cwd());
+    let hint = '';
+
+    if (likelyDirs.length === 1) {
+        hint = `\n\nHint: you may be in a parent folder. Try:\n  cd ${likelyDirs[0]}\n  plusui ${commandName}`;
+    } else if (likelyDirs.length > 1) {
+        hint = `\n\nHint: run this command from your app folder (one containing CMakeLists.txt and package.json).`;
+    }
+
+    error(`This command must be run from a PlusUI project root (missing CMakeLists.txt and/or package.json in ${process.cwd()}).${hint}`);
+}
+
+function ensureBuildLayout() {
+    const buildRoot = join(process.cwd(), 'Build');
+    for (const platform of Object.values(PLATFORMS)) {
+        mkdirSync(join(buildRoot, platform.folder), { recursive: true });
+    }
+}
+
+function getDevBuildDir() {
+    const platformFolder = PLATFORMS[process.platform]?.folder || 'Windows';
+    return join('Build', platformFolder);
+}
+
+function resolveBindgenScriptPath() {
+    const candidates = [
+        resolve(__dirname, '../../plusui-connect/src/connect.js'),
+        resolve(__dirname, '../../plusui-connect/src/index.js'),
+        resolve(__dirname, '../../plusui-native-connect/src/connect.js'),
+        resolve(__dirname, '../../plusui-native-connect/src/index.js'),
+        resolve(__dirname, '../../plusui-native-bindgen/src/index.js'),
+        resolve(__dirname, '../../../plusui-native-connect/src/connect.js'),
+        resolve(__dirname, '../../../plusui-native-connect/src/index.js'),
+        resolve(__dirname, '../../../plusui-native-bindgen/src/index.js'),
+        resolve(process.cwd(), 'node_modules', 'plusui-native-connect', 'src', 'connect.js'),
+        resolve(process.cwd(), 'node_modules', 'plusui-native-connect', 'src', 'index.js'),
+        resolve(process.cwd(), 'node_modules', 'plusui-native-bindgen', 'src', 'index.js'),
+    ];
+
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+
+    return null;
+}
+
+async function syncGeneratedTsBindings(backendOutputDir, frontendOutputDir) {
+    const generatedTsPath = join(backendOutputDir, 'bindings.gen.ts');
+    if (!existsSync(generatedTsPath)) {
+        return;
+    }
+
+    await mkdir(frontendOutputDir, { recursive: true });
+    const frontendTsPath = join(frontendOutputDir, 'bindings.gen.ts');
+    await copyFile(generatedTsPath, frontendTsPath);
+    log(`Synced TS bindings: ${frontendTsPath}`, 'dim');
+}
+
+function promptTemplateSelection() {
+    return new Promise((resolve) => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+
+        console.log(`\n${COLORS.bright}Select a template:${COLORS.reset}`);
+        console.log(`  ${COLORS.cyan}1)${COLORS.reset} solid   - SolidJS + TypeScript (lightweight, reactive)`);
+        console.log(`  ${COLORS.cyan}2)${COLORS.reset} react   - React + TypeScript (popular, familiar)`);
+
+        rl.question(`\n${COLORS.yellow}Enter choice [1-2] (default: solid):${COLORS.reset} `, (answer) => {
+            rl.close();
+            const choice = answer.trim() || '1';
+            const templates = { '1': 'solid', '2': 'react' };
+            const template = templates[choice] || 'solid';
+            console.log(`${COLORS.green}✓${COLORS.reset} Selected: ${COLORS.cyan}${template}${COLORS.reset}\n`);
+            resolve(template);
+        });
+    });
+}
+
+async function createProject(name, options = {}) {
+    try {
+        const templateManager = new TemplateManager();
+        await templateManager.create(name, options);
+    } catch (e) {
+        error(e.message);
+    }
+}
+
+// ============================================================
+// BUILD FUNCTIONS
+// ============================================================
+
+function buildFrontend() {
+    ensureProjectRoot('build:frontend');
+    logSection('Building Frontend');
+
+    if (existsSync('frontend')) {
+        log('Running Vite build...', 'blue');
+        execSync('cd frontend && npm run build', { stdio: 'inherit', shell: true });
+        log('Frontend built successfully!', 'green');
+    } else {
+        log('No frontend directory found, skipping...', 'yellow');
+    }
+}
+
+function buildBackend(platform = null, devMode = false) {
+    ensureProjectRoot(devMode ? 'dev:backend' : 'build:backend');
+    const targetPlatform = platform || process.platform;
+    const platformConfig = PLATFORMS[targetPlatform] || PLATFORMS[Object.keys(PLATFORMS).find(k => PLATFORMS[k].folder.toLowerCase() === targetPlatform?.toLowerCase())];
+
+    if (!platformConfig) {
+        error(`Unsupported platform: ${targetPlatform}`);
+    }
+
+    logSection(`Building Backend (${platformConfig.name})`);
+
+    const buildDir = `Build/${platformConfig.folder}`;
+
+    ensureBuildLayout();
+
+    // Create build directory
+    if (!existsSync(buildDir)) {
+        execSync(`mkdir -p "${buildDir}"`, { stdio: 'ignore', shell: true });
+    }
+
+    // CMake configure
+    let cmakeArgs = `-S . -B "${buildDir}" -DCMAKE_BUILD_TYPE=Release`;
+
+    if (devMode) {
+        cmakeArgs += ' -DPLUSUI_DEV_MODE=ON';
+    } else {
+        cmakeArgs += ' -DPLUSUI_DEV_MODE=OFF';
+    }
+
+    if (platformConfig.generator) {
+        cmakeArgs += ` -G "${platformConfig.generator}"`;
+    } else if (process.platform === 'win32') {
+        // Use embedded debug info (/Z7) to avoid VS 2026 PDB creation bug (C1041)
+        cmakeArgs += ' -DCMAKE_MSVC_DEBUG_INFORMATION_FORMAT=Embedded';
+    }
+
+    log(`Configuring CMake...`, 'blue');
+    runCMake(cmakeArgs);
+
+    // CMake build
+    log(`Building...`, 'blue');
+    runCMake(`--build "${buildDir}" --config Release`);
+
+    log(`Backend built: ${buildDir}`, 'green');
+
+    return buildDir;
+}
+
+async function generateIcons(inputPath = null) {
+    ensureProjectRoot('icons');
+    logSection('Generating Platform Icons');
+
+    const { IconGenerator } = await import('./assets/icon-generator.js');
+    const generator = new IconGenerator();
+
+    const srcIcon = inputPath || join(process.cwd(), 'assets', 'icon.png');
+    const outputBase = join(process.cwd(), 'assets', 'icons');
+
+    if (!existsSync(srcIcon)) {
+        log(`Icon not found: ${srcIcon}`, 'yellow');
+        log('Place a 512x512+ PNG icon at assets/icon.png', 'dim');
+        return;
+    }
+
+    await generator.generate(srcIcon, outputBase);
+}
+
+async function embedResources(platform = null) {
+    ensureProjectRoot('embed');
+    const targetPlatform = platform || process.platform;
+    logSection(`Embedding Resources (${targetPlatform})`);
+
+    const { ResourceEmbedder } = await import('./assets/resource-embedder.js');
+    const embedder = new ResourceEmbedder({ verbose: true });
+
+    const frontendDist = join(process.cwd(), 'frontend', 'dist');
+    const outputDir = join(process.cwd(), 'generated', 'resources');
+
+    if (!existsSync(frontendDist)) {
+        log('Frontend not built yet. Run: plusui build:frontend', 'yellow');
+        return;
+    }
+
+    if (platform === 'all') {
+        await embedder.embedAll(frontendDist, outputDir);
+    } else {
+        await embedder.embed(frontendDist, outputDir, targetPlatform);
+    }
+}
+
+async function embedAssets() {
+    ensureProjectRoot('build');
+    const assetsDir = join(process.cwd(), 'assets');
+    if (!existsSync(assetsDir)) {
+        try {
+            await mkdir(assetsDir, { recursive: true });
+        } catch (e) { }
+    }
+
+    logSection('Embedding Assets');
+
+    // Always generate the header file, even if empty
+    let headerContent = '#pragma once\n\n';
+    headerContent += '// THIS FILE IS AUTO-GENERATED BY PLUSUI CLI\n';
+    headerContent += '// DO NOT MODIFY MANUALLY\n\n';
+
+    const files = existsSync(assetsDir)
+        ? (await readdir(assetsDir)).filter(f => !statSync(join(assetsDir, f)).isDirectory())
+        : [];
+
+    if (files.length === 0) {
+        log('No assets found in assets/ folder', 'dim');
+    } else {
+        for (const file of files) {
+            const filePath = join(assetsDir, file);
+            log(`Processing ${file}...`, 'dim');
+
+            const varName = file.replace(/[^a-zA-Z0-9]/g, '_').toUpperCase();
+            const data = await readFile(filePath);
+
+            headerContent += `static const unsigned char ASSET_${varName}[] = {`;
+            for (let i = 0; i < data.length; i++) {
+                if (i % 16 === 0) headerContent += '\n  ';
+                headerContent += `0x${data[i].toString(16).padStart(2, '0')}, `;
+            }
+            headerContent += '\n};\n';
+            headerContent += `static const unsigned int ASSET_${varName}_LEN = ${data.length};\n\n`;
+        }
+    }
+
+    const genDir = join(process.cwd(), 'generated');
+    if (!existsSync(genDir)) await mkdir(genDir, { recursive: true });
+
+    await writeFile(join(genDir, 'assets.h'), headerContent);
+    log(`✓ Assets header generated: generated/assets.h`, 'green');
+}
+
+
+
+async function build(production = true) {
+    ensureProjectRoot('build');
+    logSection('Building PlusUI Application');
+
+    // Embed assets
+    await embedAssets();
+
+    // Build frontend first
+    if (production) {
+        buildFrontend();
+    }
+
+    // Build backend
+    const buildDir = buildBackend(null, !production);
+
+    log('\nBuild complete!', 'green');
+    return buildDir;
+}
+
+function buildAll() {
+    ensureProjectRoot('build:all');
+    logSection('Building for All Platforms');
+
+    ensureBuildLayout();
+
+    buildFrontend();
+
+    const supportedPlatforms = ['win32', 'darwin', 'linux'];
+
+    for (const platform of supportedPlatforms) {
+        try {
+            buildBackend(platform, false);
+        } catch (e) {
+            log(`Failed to build for ${PLATFORMS[platform].name}: ${e.message}`, 'yellow');
+        }
+    }
+
+    log('\nAll platform builds complete!', 'green');
+    log('\nOutput directories:', 'bright');
+    log('  Build/Windows/', 'cyan');
+    log('  Build/MacOS/', 'cyan');
+    log('  Build/Linux/', 'cyan');
+    log('  Build/Android/', 'cyan');
+    log('  Build/iOS/', 'cyan');
+}
+
+function buildPlatform(platform) {
+    logSection(`Building for ${PLATFORMS[platform]?.name || platform}`);
+    buildFrontend();
+    buildBackend(platform, false);
+}
+
+// ============================================================
+// DEVELOPMENT FUNCTIONS
+// ============================================================
+
+let viteServer = null;
+let cppProcess = null;
+
+async function startViteServer() {
+    ensureProjectRoot('dev:frontend');
+    log('Starting Vite dev server...', 'blue');
+
+    viteServer = await createViteServer({
+        root: 'frontend',
+        server: {
+            port: 5173,
+            strictPort: false,
+        },
+    });
+
+    await viteServer.listen();
+
+    const actualPort = viteServer.httpServer?.address()?.port || 5173;
+    log(`Vite server: http://localhost:${actualPort}`, 'green');
+    return viteServer;
+}
+
+async function startBackend() {
+    ensureProjectRoot('dev');
+    logSection('Building C++ Backend (Dev Mode)');
+
+    const projectName = getProjectName();
+    killProcessByName(projectName);
+
+    const buildDir = getDevBuildDir();
+
+    // On Windows, use embedded debug info (/Z7) to avoid VS 2026 PDB creation bug (C1041)
+    let generatorArgs = '';
+    if (process.platform === 'win32') {
+        generatorArgs = ' -DCMAKE_MSVC_DEBUG_INFORMATION_FORMAT=Embedded';
+    }
+
+    // Auto-clean build dir if generator changed (e.g. VS → Ninja)
+    const cacheFile = join(buildDir, 'CMakeCache.txt');
+    if (existsSync(cacheFile)) {
+        try {
+            const cacheContent = execSync(`type "${cacheFile}"`, { encoding: 'utf8', shell: true, stdio: ['pipe', 'pipe', 'ignore'] });
+            const generatorMatch = cacheContent.match(/CMAKE_GENERATOR:INTERNAL=(.*)/);
+            const cachedGenerator = generatorMatch ? generatorMatch[1].trim() : '';
+            const wantNinja = generatorArgs.includes('Ninja');
+            if ((wantNinja && cachedGenerator !== 'Ninja') || (!wantNinja && cachedGenerator === 'Ninja')) {
+                log(`Generator changed (${cachedGenerator} → ${wantNinja ? 'Ninja' : 'default'}), cleaning build dir...`, 'yellow');
+                execSync(process.platform === 'win32' ? `rmdir /s /q "${buildDir}"` : `rm -rf "${buildDir}"`, { stdio: 'ignore', shell: true });
+            }
+        } catch { }
+    }
+
+    // Always configure with dev mode to ensure PLUSUI_DEV_MODE is set correctly
+    log('Configuring CMake...', 'blue');
+    runCMake(`-S . -B "${buildDir}" -DPLUSUI_DEV_MODE=ON${generatorArgs}`);
+
+    log('Compiling...', 'blue');
+    runCMake(`--build "${buildDir}"`);
+
+    // Find executable
+    let exePath;
+    if (process.platform === 'win32') {
+        // Ninja puts exe directly in build dir
+        exePath = join(buildDir, `${projectName}.exe`);
+        if (!existsSync(exePath)) {
+            exePath = join(buildDir, 'bin', `${projectName}.exe`);
+        }
+        // Fallback for VS generator (Debug subfolder)
+        if (!existsSync(exePath)) {
+            exePath = join(buildDir, projectName, 'Debug', `${projectName}.exe`);
+        }
+        if (!existsSync(exePath)) {
+            exePath = join(buildDir, 'Debug', `${projectName}.exe`);
+        }
+    } else {
+        exePath = join(buildDir, projectName);
+        if (!existsSync(exePath)) {
+            exePath = join(buildDir, 'bin', projectName);
+        }
+    }
+
+    if (!existsSync(exePath)) {
+        error(`Executable not found. Expected: ${exePath}`);
+    }
+
+    log('Starting C++ app...', 'blue');
+
+    cppProcess = spawn(exePath, [], {
+        shell: true,
+        stdio: 'inherit',
+        env: { ...process.env, PLUSUI_DEV: '1' }
+    });
+
+    cppProcess.on('error', (err) => {
+        log(`Failed to start app: ${err.message}`, 'red');
+    });
+
+    return cppProcess;
+}
+
+async function killPort(port) {
+    log(`Checking port ${port}...`, 'dim');
+    try {
+        if (process.platform === 'win32') {
+            try {
+                const output = execSync(`netstat -ano | findstr :${port}`, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+                const lines = output.split('\n').filter(line => line.includes(`:${port}`) && line.includes('LISTENING'));
+
+                for (const line of lines) {
+                    const parts = line.trim().split(/\s+/);
+                    const pid = parts[parts.length - 1];
+                    if (pid && /^\d+$/.test(pid)) {
+                        log(`Killing process ${pid} on port ${port}...`, 'yellow');
+                        try {
+                            execSync(`taskkill /PID ${pid} /F`, { stdio: 'ignore' });
+                        } catch (e) {
+                            // Ignore if already dead
+                        }
+                    }
+                }
+            } catch (e) {
+                // findstr returns exit code 1 if no match found
+            }
+        } else {
+            try {
+                execSync(`lsof -i :${port} -t | xargs kill -9`, { stdio: 'ignore' });
+            } catch {
+                // Ignore if no process found
+            }
+        }
+    } catch (e) {
+        // Ignore general errors
+    }
+}
+
+function killProcessByName(name) {
+    const processName = process.platform === 'win32' ? `${name}.exe` : name;
+    log(`Cleaning up previous instance (${processName})...`, 'dim');
+    try {
+        if (process.platform === 'win32') {
+            execSync(`taskkill /IM "${processName}" /F`, { stdio: 'ignore' });
+        } else {
+            execSync(`pkill -f "${processName}"`, { stdio: 'ignore' });
+        }
+    } catch (e) {
+        // Ignore if process not found
+    }
+}
+
+async function dev() {
+    ensureProjectRoot('dev');
+    logSection('PlusUI Development Mode');
+
+    const toolCheck = checkTools();
+    if (toolCheck && toolCheck.missing) {
+        error('Missing required build tools. Run: plusui doctor --fix');
+    }
+
+    // Embed assets
+    await embedAssets();
+
+    await runBindgen([], { skipIfNoInput: true, source: 'dev' });
+
+    // specific port cleaning
+    await killPort(5173);
+
+    // Start Vite first
+    try {
+        viteServer = await startViteServer();
+    } catch (e) {
+        log(`Vite failed to start: ${e.message}`, 'red');
+        error('Could not start development server');
+    }
+
+    const actualPort = viteServer.httpServer?.address()?.port || 5173;
+
+    // Build and start C++ backend
+    await startBackend();
+
+    log('\n' + '='.repeat(50), 'dim');
+    log('Development mode active', 'green');
+    log('='.repeat(50), 'dim');
+    log(`\nFrontend: http://localhost:${actualPort} (HMR enabled)`, 'cyan');
+    log('Backend:  C++ app running with webview', 'cyan');
+    log('\nEdit frontend/src/* for live reload', 'dim');
+    log('Edit main.cpp and restart for C++ changes', 'dim');
+    log('\nPress Ctrl+C to stop\n', 'yellow');
+
+    // Handle shutdown
+    process.on('SIGINT', async () => {
+        log('\nShutting down...', 'yellow');
+        if (viteServer) await viteServer.close();
+        if (cppProcess) cppProcess.kill();
+        process.exit(0);
+    });
+}
+
+async function devFrontend() {
+    ensureProjectRoot('dev:frontend');
+    logSection('Frontend Development Mode');
+
+    // specific port cleaning
+    await killPort(5173);
+
+    viteServer = await createViteServer({
+        root: 'frontend',
+        server: { port: 5173, strictPort: false },
+    });
+
+    await viteServer.listen();
+
+    const actualPort = viteServer.httpServer?.address()?.port || 5173;
+    log(`Frontend: http://localhost:${actualPort}`, 'green');
+    log('HMR enabled - changes will reflect instantly!\n', 'green');
+
+    process.on('SIGINT', async () => {
+        if (viteServer) await viteServer.close();
+        process.exit(0);
+    });
+}
+
+function devBackend() {
+    ensureProjectRoot('dev:backend');
+    logSection('Backend Development Mode');
+
+    const projectName = getProjectName();
+    killProcessByName(projectName);
+
+    const buildDir = getDevBuildDir();
+
+    // Always configure with dev mode to ensure PLUSUI_DEV_MODE is set correctly
+    log('Configuring CMake...', 'blue');
+    runCMake(`-S . -B "${buildDir}" -DPLUSUI_DEV_MODE=ON`);
+
+    runCMake(`--build "${buildDir}"`);
+
+    let exePath;
+    if (process.platform === 'win32') {
+        exePath = join(buildDir, projectName, 'Debug', `${projectName}.exe`);
+        if (!existsSync(exePath)) exePath = join(buildDir, 'Debug', `${projectName}.exe`);
+        if (!existsSync(exePath)) exePath = join(buildDir, `${projectName}.exe`);
+    } else {
+        exePath = join(buildDir, projectName);
+    }
+
+    function runApp() {
+        if (cppProcess) cppProcess.kill();
+
+        cppProcess = spawn(exePath, [], { shell: true, stdio: 'inherit' });
+
+        cppProcess.on('close', (code) => {
+            if (code !== null && code !== 0) {
+                log(`App exited with code ${code}`, 'yellow');
+            }
+        });
+    }
+
+    runApp();
+
+    log('\nWatching C++ files for changes...', 'yellow');
+    log('Press Ctrl+C to stop\n', 'dim');
+
+    // Watch main.cpp and features/ folder (if exists)
+    const watchItems = ['main.cpp'];
+    if (existsSync('features')) watchItems.push('features');
+
+    const watchers = watchItems.map(item => {
+        const isDir = existsSync(item) && statSync(item).isDirectory();
+        const w = isDir ? watch(item, { recursive: true }) : watch(item);
+        w.on('change', (eventType, filename) => {
+            const file = item === 'main.cpp' ? 'main.cpp' : filename;
+            if (file && (file.endsWith('.cpp') || file.endsWith('.hpp'))) {
+                log(`Changed: ${file}`, 'yellow');
+                log('Rebuilding...', 'blue');
+                try {
+                    killProcessByName(projectName);
+                    runCMake(`--build "${buildDir}"`);
+                    runApp();
+                } catch (e) {
+                    log('Build failed, waiting for fixes...', 'red');
+                }
+            }
+        });
+        return w;
+    });
+
+    process.on('SIGINT', () => {
+        if (cppProcess) cppProcess.kill();
+        watchers.forEach(w => w.close());
+        process.exit(0);
+    });
+}
+
+// ============================================================
+// RUN FUNCTION
+// ============================================================
+
+function run() {
+    ensureProjectRoot('run');
+    const projectName = getProjectName();
+    const platform = PLATFORMS[process.platform];
+    const buildDir = `Build/${platform?.folder || 'Windows'}`;
+
+    let exePath;
+    if (process.platform === 'win32') {
+        exePath = join(buildDir, 'Release', `${projectName}.exe`);
+        if (!existsSync(exePath)) exePath = join(buildDir, 'bin', `${projectName}.exe`);
+        if (!existsSync(exePath)) exePath = join(buildDir, `${projectName}.exe`);
+    } else {
+        exePath = join(buildDir, projectName);
+        if (!existsSync(exePath)) exePath = join(buildDir, 'bin', projectName);
+    }
+
+    if (!existsSync(exePath)) {
+        error(`Build not found at ${exePath}. Run "plusui build" first.`);
+    }
+
+    log(`Running: ${exePath}`, 'blue');
+
+    const proc = spawn(exePath, [], { shell: true, stdio: 'inherit' });
+
+    proc.on('close', (code) => {
+        process.exit(code);
+    });
+}
+
+// ============================================================
+// CLEAN FUNCTION
+// ============================================================
+
+async function clean() {
+    ensureProjectRoot('clean');
+    logSection('Cleaning Build Artifacts');
+
+    const dirs = ['Build', 'frontend/dist'];
+
+    for (const dir of dirs) {
+        if (existsSync(dir)) {
+            log(`Removing: ${dir}`, 'yellow');
+            await rm(dir, { recursive: true, force: true });
+        }
+    }
+
+    log('\nClean complete!', 'green');
+}
+
+// ============================================================
+// CONNECT GENERATOR FUNCTION
+// ============================================================
+
+async function runBindgen(providedArgs = null, options = {}) {
+    ensureProjectRoot('bindgen');
+    logSection('Running Connection Generator');
+
+    const { skipIfNoInput = false, source = 'manual' } = options;
+
+    const scriptPath = resolveBindgenScriptPath();
+
+    if (!scriptPath) {
+        error(`Connection generator script not found. Please ensure plusui-native-connect is installed.`);
+    }
+
+    log(`Using connect generator: ${scriptPath}`, 'dim');
+
+    // plusui connect [projectRoot] [outputDir]
+    // Defaults to app-local paths when available.
+    const args = providedArgs ?? process.argv.slice(3);
+    let bindgenArgs = [...args];
+
+    let usedDefaultAppMode = false;
+    let defaultOutputDir = null;
+
+    if (bindgenArgs.length === 0) {
+        const { outputDir: appOutputDir } = getAppBindgenPaths();
+        bindgenArgs = [process.cwd(), appOutputDir];
+        usedDefaultAppMode = true;
+        defaultOutputDir = appOutputDir;
+        log(`Project mode: ${process.cwd()} -> ${appOutputDir}`, 'dim');
+    }
+
+    // Spawn node process
+    const proc = spawn(process.execPath, [scriptPath, ...bindgenArgs], {
+        stdio: 'inherit',
+        env: process.env
+    });
+
+    return new Promise((resolve, reject) => {
+        proc.on('close', async (code) => {
+            if (code === 0) {
+                try {
+                    log('\nBindgen complete!', 'green');
+                    resolve();
+                } catch (syncErr) {
+                    reject(syncErr);
+                }
+            } else {
+                reject(new Error(`Connection generator failed with code ${code}`));
+            }
+        });
+    });
+}
+
+// ============================================================
+// MAIN
+// ============================================================
+
+async function main() {
+    const args = process.argv.slice(2);
+    const cmd = args[0];
+
+    switch (cmd) {
+        case 'doctor':
+            await runDoctor({
+                fix: args.includes('--fix'),
+                json: args.includes('--json'),
+                quick: args.includes('--quick')
+            });
+            break;
+        case 'create':
+            if (!args[1] || args[1].startsWith('-')) error('Project name required');
+            const template = await promptTemplateSelection();
+            await createProject(args[1], { template });
+            break;
+        case 'dev':
+            await dev();
+            break;
+        case 'dev:frontend':
+            await devFrontend();
+            break;
+        case 'dev:backend':
+            await runBindgen([], { skipIfNoInput: true, source: 'dev:backend' });
+            devBackend();
+            break;
+        case 'build':
+            await runBindgen([], { skipIfNoInput: true, source: 'build' });
+            await build(true);
+            break;
+        case 'build:frontend':
+            buildFrontend();
+            break;
+        case 'build:backend':
+            await runBindgen([], { skipIfNoInput: true, source: 'build:backend' });
+            buildBackend(null, false);
+            break;
+        case 'build:all':
+            await runBindgen([], { skipIfNoInput: true, source: 'build:all' });
+            buildAll();
+            break;
+        case 'build:windows':
+            await runBindgen([], { skipIfNoInput: true, source: 'build:windows' });
+            buildPlatform('win32');
+            break;
+        case 'build:macos':
+            await runBindgen([], { skipIfNoInput: true, source: 'build:macos' });
+            buildPlatform('darwin');
+            break;
+        case 'build:linux':
+            await runBindgen([], { skipIfNoInput: true, source: 'build:linux' });
+            buildPlatform('linux');
+            break;
+        case 'build:android':
+            await runBindgen([], { skipIfNoInput: true, source: 'build:android' });
+            buildPlatform('android');
+            break;
+        case 'build:ios':
+            await runBindgen([], { skipIfNoInput: true, source: 'build:ios' });
+            buildPlatform('ios');
+            break;
+        case 'run':
+            run();
+            break;
+        case 'clean':
+            await clean();
+            break;
+        case 'connect':
+        case 'bind':
+        case 'bindgen':
+            await runBindgen();
+            break;
+        case 'update':
+            await updatePlusUIPackages();
+            break;
+        case 'icons':
+            await generateIcons(args[1]);
+            break;
+        case 'embed':
+            await embedResources(args[1]);
+            break;
+        case 'help':
+        case '-h':
+        case '--help':
+            console.log(USAGE);
+            break;
+        case '-v':
+        case '--version':
+            showVersionInfo();
+            break;
+        default:
+            console.log(USAGE);
+    }
+}
+
+main().catch(e => error(e.message));