@linyjs/cli 0.0.2

package/dist/utils/builder.js

@@ -0,0 +1,383 @@
+/**
+ * Smart builder for plugin projects
+ *
+ * Design Philosophy:
+ * - Zero configuration required
+ * - CLI handles all build details automatically
+ * - Users just write TypeScript/TSX code
+ * - Sensible defaults and optimizations out of the box
+ */
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import chalk from 'chalk';
+import ora from 'ora';
+/**
+ * Detect build system and execute build
+ */
+export async function buildProject(options) {
+    const startTime = Date.now();
+    const { projectRoot, verbose } = options;
+    const spinner = ora('Detecting build system...').start();
+    // Step 1: Detect build system
+    const buildSystem = detectBuildSystem(projectRoot);
+    if (!buildSystem) {
+        spinner.fail('No build system detected');
+        console.error(chalk.red('\nPlease add a build script to package.json:'));
+        console.error(chalk.gray('  "scripts": { "build": "tsc" }'));
+        process.exit(1);
+    }
+    spinner.succeed(`Build system detected: ${buildSystem.name}`);
+    if (verbose) {
+        console.log(chalk.gray('  Type:'), buildSystem.type);
+        console.log(chalk.gray('  Config:'), buildSystem.configFile || 'none');
+    }
+    // Step 2: Execute build
+    const buildSpinner = ora('Building project...').start();
+    try {
+        let outputDir;
+        // DEFAULT: Always use esbuild for optimal bundles
+        // Users don't need to configure webpack/rollup themselves
+        if (buildSystem.type === 'typescript' || buildSystem.type === 'custom') {
+            // Even if project has tsc, we use esbuild for better optimization
+            if (verbose) {
+                console.log(chalk.yellow('\n💡 Using esbuild for optimized bundle (ignoring tsc config)'));
+            }
+            outputDir = await buildWithEsbuild(projectRoot, buildSystem, options, verbose);
+        }
+        else if (buildSystem.type === 'esbuild') {
+            // Project already uses esbuild, use it directly
+            outputDir = await buildWithEsbuild(projectRoot, buildSystem, options, verbose);
+        }
+        else {
+            // For webpack/rollup, still prefer our esbuild approach
+            if (verbose) {
+                console.log(chalk.yellow('\n💡 Using CLI built-in esbuild (ignoring webpack/rollup config)'));
+            }
+            outputDir = await buildWithEsbuild(projectRoot, buildSystem, options, verbose);
+        }
+        // Step 3: Collect output files
+        const files = collectOutputFiles(outputDir);
+        const size = calculateTotalSize(files);
+        const duration = Date.now() - startTime;
+        buildSpinner.succeed(`Build completed in ${duration}ms`);
+        if (verbose) {
+            console.log(chalk.gray('  Output directory:'), outputDir);
+            console.log(chalk.gray('  Total files:'), files.length);
+            console.log(chalk.gray('  Total size:'), formatFileSize(size));
+        }
+        return {
+            success: true,
+            outputDir,
+            files,
+            size,
+            duration
+        };
+    }
+    catch (error) {
+        buildSpinner.fail('Build failed');
+        if (error instanceof Error) {
+            console.error(chalk.red('\nBuild error:'));
+            console.error(error.message);
+            if (verbose && 'stdout' in error) {
+                console.error(chalk.gray('\nDetailed output:'));
+                console.error(error.stdout?.toString());
+            }
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Detect build system from project configuration
+ */
+function detectBuildSystem(projectRoot) {
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+        return null;
+    }
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+    const buildScript = packageJson.scripts?.build || '';
+    // Check for TypeScript
+    if (fs.existsSync(path.join(projectRoot, 'tsconfig.json'))) {
+        if (buildScript.includes('tsc') || buildScript.includes('typescript')) {
+            return {
+                type: 'typescript',
+                name: 'TypeScript Compiler',
+                configFile: 'tsconfig.json',
+                command: buildScript
+            };
+        }
+    }
+    // Check for esbuild
+    if (buildScript.includes('esbuild')) {
+        return {
+            type: 'esbuild',
+            name: 'esbuild',
+            configFile: null,
+            command: buildScript
+        };
+    }
+    // Check for webpack
+    if (fs.existsSync(path.join(projectRoot, 'webpack.config.js')) ||
+        fs.existsSync(path.join(projectRoot, 'webpack.config.ts'))) {
+        return {
+            type: 'webpack',
+            name: 'Webpack',
+            configFile: 'webpack.config.js',
+            command: buildScript
+        };
+    }
+    // Check for rollup
+    if (fs.existsSync(path.join(projectRoot, 'rollup.config.js'))) {
+        return {
+            type: 'rollup',
+            name: 'Rollup',
+            configFile: 'rollup.config.js',
+            command: buildScript
+        };
+    }
+    // Default to npm run build
+    if (buildScript) {
+        return {
+            type: 'custom',
+            name: 'Custom Build Script',
+            configFile: null,
+            command: buildScript
+        };
+    }
+    return null;
+}
+/**
+ * Build with TypeScript compiler
+ */
+async function buildWithTsc(projectRoot, buildSystem, verbose) {
+    // Read tsconfig.json to get output directory
+    const tsconfigPath = path.join(projectRoot, 'tsconfig.json');
+    const tsconfig = JSON.parse(fs.readFileSync(tsconfigPath, 'utf-8'));
+    const outputDir = tsconfig.compilerOptions?.outDir || 'dist';
+    // Execute tsc
+    execSync('npx tsc', {
+        stdio: verbose ? 'inherit' : 'pipe',
+        cwd: projectRoot
+    });
+    return path.join(projectRoot, outputDir);
+}
+/**
+ * Build with esbuild (DEFAULT strategy)
+ * This is the recommended approach for production builds
+ */
+async function buildWithEsbuild(projectRoot, buildSystem, options, verbose) {
+    const outputDir = path.join(projectRoot, 'dist');
+    // Ensure output directory exists
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    // Detect entry points (smart detection)
+    const serverEntry = findEntryFile(projectRoot, 'server');
+    const clientEntry = findEntryFile(projectRoot, 'client');
+    if (!serverEntry && !clientEntry) {
+        throw new Error('No entry files found. Expected src/server/index.ts or src/client/index.tsx');
+    }
+    // Default external dependencies (Ling framework provides these)
+    const defaultExternal = [
+        'react',
+        'react-dom',
+        'express',
+        '@linyjs/*',
+        '@ling/*'
+    ];
+    const externalDeps = options.external || defaultExternal;
+    // Build server bundle (if exists)
+    if (serverEntry) {
+        const serverOutput = path.join(outputDir, 'server', 'index.js');
+        const serverCmd = [
+            'npx esbuild',
+            serverEntry,
+            '--bundle',
+            `--outfile=${serverOutput}`,
+            '--format=esm',
+            '--platform=node',
+            '--target=node18',
+            ...externalDeps.map(dep => `--external:${dep}`),
+            options.minify !== false ? '--minify' : '', // Default to minify
+            '--sourcemap',
+            '--log-level=warning'
+        ].filter(Boolean).join(' ');
+        if (verbose) {
+            console.log(chalk.cyan('\n🔨 Building server bundle...'));
+            console.log(chalk.gray('  Entry:'), serverEntry);
+            console.log(chalk.gray('  Output:'), serverOutput);
+            console.log(chalk.gray('  Command:'), serverCmd);
+        }
+        try {
+            execSync(serverCmd, {
+                stdio: verbose ? 'inherit' : 'pipe',
+                cwd: projectRoot
+            });
+            if (verbose) {
+                const size = fs.statSync(serverOutput).size;
+                console.log(chalk.green('  ✓ Server bundle created'), chalk.gray(`(${formatFileSize(size)})`));
+            }
+        }
+        catch (error) {
+            throw new Error(`Server build failed: ${error.message}`);
+        }
+    }
+    // Build client bundle (if exists)
+    if (clientEntry) {
+        const clientOutput = path.join(outputDir, 'client', 'index.js');
+        // For client bundle, we need different external dependencies
+        // Server-only packages should NOT be bundled in client
+        const clientExternal = [
+            // ⚠️ IMPORTANT: React and ReactDOM MUST be externalized
+            // All plugins must share the SAME React instance to avoid:
+            // - Context identity issues (createContext from different React instances are not equal)
+            // - Hook ordering problems (different React versions have different internal structures)
+            // - Memory leaks (multiple React renderers running simultaneously)
+            // - Dependency injection failures (contexts/services created by one React can't be used by another)
+            'react', // Provided by SSR host application
+            'react-dom', // Provided by SSR host application
+            'react-dom/client', // Provided by SSR host application
+            // UI slots interface is type-only, safe to external
+            '@linyjs/ui-slots-interface',
+            // Explicitly exclude server-only packages
+            // These should never appear in client code, but just in case:
+            'express',
+            '@linyjs/server-module-interface', // Server-only interface (type-only)
+            '@linyjs/mongodb', // Server-only service
+            // NOTE: @linyjs/client-module-interface is NOT externalized
+            // because it contains runtime values (React Context, Hooks)
+            // that must be included in the client bundle
+        ];
+        // Merge with user-provided externals (if any)
+        if (options.external) {
+            options.external.forEach(dep => {
+                if (!clientExternal.includes(dep)) {
+                    clientExternal.push(dep);
+                }
+            });
+        }
+        const clientCmd = [
+            'npx esbuild',
+            clientEntry,
+            '--bundle',
+            `--outfile=${clientOutput}`,
+            '--format=esm',
+            '--platform=browser',
+            '--target=es2020',
+            ...clientExternal.map(dep => `--external:${dep}`),
+            options.minify !== false ? '--minify' : '',
+            '--sourcemap',
+            '--log-level=warning'
+        ].filter(Boolean).join(' ');
+        if (verbose) {
+            console.log(chalk.cyan('\n🔨 Building client bundle...'));
+            console.log(chalk.gray('  Entry:'), clientEntry);
+            console.log(chalk.gray('  Output:'), clientOutput);
+            console.log(chalk.gray('  Command:'), clientCmd);
+        }
+        try {
+            execSync(clientCmd, {
+                stdio: verbose ? 'inherit' : 'pipe',
+                cwd: projectRoot
+            });
+            if (verbose) {
+                const size = fs.statSync(clientOutput).size;
+                console.log(chalk.green('  ✓ Client bundle created'), chalk.gray(`(${formatFileSize(size)})`));
+            }
+        }
+        catch (error) {
+            throw new Error(`Client build failed: ${error.message}`);
+        }
+    }
+    return outputDir;
+}
+/**
+ * Build with npm run build (fallback)
+ */
+async function buildWithNpm(projectRoot, verbose) {
+    execSync('npm run build', {
+        stdio: verbose ? 'inherit' : 'pipe',
+        cwd: projectRoot
+    });
+    // Try to detect output directory
+    const possibleDirs = ['dist', 'build', 'lib'];
+    for (const dir of possibleDirs) {
+        const fullPath = path.join(projectRoot, dir);
+        if (fs.existsSync(fullPath)) {
+            return fullPath;
+        }
+    }
+    return path.join(projectRoot, 'dist');
+}
+/**
+ * Find entry file for server or client
+ */
+function findEntryFile(projectRoot, type) {
+    const possibleEntries = [
+        `src/${type}/index.ts`,
+        `src/${type}/index.tsx`,
+        `src/${type}.ts`,
+        `src/${type}.tsx`,
+        `${type}/index.ts`
+    ];
+    for (const entry of possibleEntries) {
+        const fullPath = path.join(projectRoot, entry);
+        if (fs.existsSync(fullPath)) {
+            return entry;
+        }
+    }
+    return null;
+}
+/**
+ * Collect all output files
+ */
+function collectOutputFiles(outputDir) {
+    const files = [];
+    function walk(dir) {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Skip node_modules and .git
+                if (entry.name === 'node_modules' || entry.name === '.git') {
+                    continue;
+                }
+                walk(fullPath);
+            }
+            else {
+                files.push(fullPath);
+            }
+        }
+    }
+    walk(outputDir);
+    return files;
+}
+/**
+ * Calculate total size of files
+ */
+function calculateTotalSize(files) {
+    return files.reduce((total, file) => {
+        try {
+            const stats = fs.statSync(file);
+            return total + stats.size;
+        }
+        catch {
+            return total;
+        }
+    }, 0);
+}
+/**
+ * Format file size
+ */
+function formatFileSize(bytes) {
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let size = bytes;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    return `${size.toFixed(2)} ${units[unitIndex]}`;
+}
+//# sourceMappingURL=builder.js.map

package/dist/utils/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/utils/builder.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@linyjs/cli",
+  "version": "0.0.2",
+  "type": "module",
+  "bin": {
+    "ling": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "cleye": "^1.3.0",
+    "archiver": "^6.0.0",
+    "chalk": "^5.0.0",
+    "fs-extra": "^11.0.0",
+    "ora": "^7.0.0",
+    "esbuild": "^0.20.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/archiver": "^6.0.0",
+    "@types/fs-extra": "^11.0.0"
+  }
+}

package/src/commands/dev.ts

@@ -0,0 +1,191 @@
+/**
+ * Dev command - Quick plugin development workflow
+ * 
+ * Packs the plugin, copies to extensions folder, and registers in packages.json
+ */
+
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import { packPlugin } from './pack.js';
+
+interface DevOptions {
+  target?: string;
+  verbose: boolean;
+}
+
+/**
+ * Execute dev workflow: pack -> copy -> register
+ */
+export async function devPlugin(options: DevOptions) {
+  const projectRoot = process.cwd();
+  
+  console.log(chalk.blue('🚀 Ling Plugin Dev Mode\n'));
+  
+  // Step 1: Pack the plugin
+  const spinner1 = ora('Packing plugin...').start();
+  
+  try {
+    // Create temporary output directory
+    const tempOutputDir = path.join(projectRoot, '.ling-tmp');
+    
+    await packPlugin({
+      output: tempOutputDir,
+      build: true,
+      verbose: options.verbose
+    });
+    
+    // Find the generated .mpk file
+    const mpkFiles = fs.readdirSync(tempOutputDir).filter(f => f.endsWith('.mpk'));
+    
+    if (mpkFiles.length === 0) {
+      spinner1.fail('No .mpk file generated');
+      process.exit(1);
+    }
+    
+    const mpkFile = mpkFiles[0];
+    const mpkPath = path.join(tempOutputDir, mpkFile);
+    
+    spinner1.succeed(`Plugin packed: ${mpkFile}`);
+    
+    // Step 2: Determine target extensions directory
+    const targetDir = options.target || findExtensionsDir(projectRoot);
+    
+    if (!targetDir) {
+      spinner1.fail('Cannot find extensions directory');
+      console.error(chalk.red('\nPlease specify target directory with --target option:'));
+      console.error(chalk.gray('  npx @linyjs/cli dev --target /path/to/ling/packages/ssr/extensions'));
+      process.exit(1);
+    }
+    
+    // Step 3: Extract and copy to extensions
+    const spinner2 = ora('Installing to extensions...').start();
+    
+    const pluginName = mpkFile.replace('.mpk', '').replace(/-\d+\.\d+\.\d+$/, '');
+    const installPath = path.join(targetDir, pluginName);
+    
+    // Remove old installation if exists
+    if (fs.existsSync(installPath)) {
+      fs.rmSync(installPath, { recursive: true, force: true });
+    }
+    
+    // Create installation directory
+    fs.mkdirSync(installPath, { recursive: true });
+    
+    // Extract .mpk file (it's a ZIP)
+    await extractMpk(mpkPath, installPath);
+    
+    spinner2.succeed(`Installed to: ${installPath}`);
+    
+    // Step 4: Register in packages.json
+    const spinner3 = ora('Registering plugin...').start();
+    
+    const packagesJsonPath = path.join(targetDir, 'packages.json');
+    
+    let packages: any[] = [];
+    
+    if (fs.existsSync(packagesJsonPath)) {
+      const content = fs.readFileSync(packagesJsonPath, 'utf-8');
+      packages = JSON.parse(content);
+    }
+    
+    // Read manifest from installed plugin
+    const manifestPath = path.join(installPath, 'manifest.json');
+    let manifest: any = {};
+    
+    if (fs.existsSync(manifestPath)) {
+      manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    }
+    
+    // Check if already registered
+    const existingIndex = packages.findIndex(p => p.name === pluginName);
+    
+    const packageInfo = {
+      name: pluginName,
+      version: manifest.version || '1.0.0',
+      installPath: `extensions/${pluginName}`,
+      status: 'enabled',
+      installTime: Date.now(),
+      manifest: {
+        name: manifest.name || pluginName,
+        version: manifest.version || '1.0.0',
+        description: manifest.description || '',
+        author: manifest.author || '',
+        serverEntry: manifest.serverEntry || 'server/index.js',
+        clientEntry: manifest.clientEntry || 'client/index.js'
+      }
+    };
+    
+    if (existingIndex >= 0) {
+      packages[existingIndex] = packageInfo;
+      spinner3.succeed(`Plugin updated in packages.json`);
+    } else {
+      packages.push(packageInfo);
+      spinner3.succeed(`Plugin registered in packages.json`);
+    }
+    
+    // Write packages.json
+    fs.writeFileSync(packagesJsonPath, JSON.stringify(packages, null, 2) + '\n', 'utf-8');
+    
+    // Cleanup temporary files
+    if (fs.existsSync(tempOutputDir)) {
+      fs.rmSync(tempOutputDir, { recursive: true, force: true });
+    }
+    
+    // Show success message
+    console.log('\n' + chalk.green('✓ Development setup complete!\n'));
+    console.log(chalk.cyan('Plugin installed:'));
+    console.log(`  Name: ${chalk.bold(pluginName)}`);
+    console.log(`  Path: ${chalk.gray(installPath)}`);
+    console.log(`  Status: ${chalk.green('enabled')}\n`);
+    
+    console.log(chalk.cyan('Next steps:'));
+    console.log(`  1. Restart SSR server:`);
+    console.log(`     ${chalk.gray('cd packages/ssr && npx tsx src/demo/dev-server-with-pkg.tsx')}`);
+    console.log(`  2. Or use hot reload (if supported)`);
+    console.log(`  3. Test your plugin in the browser\n`);
+    
+  } catch (error) {
+    spinner1.fail('Dev workflow failed');
+    console.error(chalk.red('\nError:'), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+}
+
+/**
+ * Find extensions directory relative to project root
+ */
+function findExtensionsDir(projectRoot: string): string | null {
+  // Try common paths
+  const candidates = [
+    path.join(projectRoot, '..', 'ssr', 'extensions'),
+    path.join(projectRoot, '..', '..', 'packages', 'ssr', 'extensions'),
+    path.join(projectRoot, 'packages', 'ssr', 'extensions'),
+  ];
+  
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  
+  return null;
+}
+
+/**
+ * Extract .mpk file (ZIP format) to target directory
+ */
+async function extractMpk(mpkPath: string, targetDir: string): Promise<void> {
+  // Use unzipper or similar library
+  // For now, use system unzip command
+  const { execSync } = await import('child_process');
+  
+  try {
+    execSync(`unzip -o "${mpkPath}" -d "${targetDir}"`, {
+      stdio: 'pipe'
+    });
+  } catch (error) {
+    throw new Error('Failed to extract .mpk file. Make sure unzip is installed.');
+  }
+}