@linyjs/cli 0.0.2

package/src/commands/init.ts

@@ -0,0 +1,75 @@
+/**
+ * Init command - Create a new plugin project from template
+ * 
+ * Downloads the default template from npm and sets up a new project
+ */
+
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import { execSync } from 'child_process';
+
+interface InitOptions {
+  name?: string;
+  verbose: boolean;
+}
+
+/**
+ * Initialize a new plugin project
+ */
+export async function initPlugin(options: InitOptions) {
+  const targetDir = options.name || 'my-plugin';
+  const absolutePath = path.resolve(process.cwd(), targetDir);
+  
+  console.log(chalk.blue('🚀 Ling Plugin Project Creator\n'));
+  
+  // Check if directory already exists
+  if (fs.existsSync(absolutePath)) {
+    console.error(chalk.red(`Error: Directory "${targetDir}" already exists`));
+    process.exit(1);
+  }
+  
+  const spinner1 = ora('Downloading template from npm...').start();
+  
+  try {
+    // Download template using npm create
+    const npmCommand = `npm create @linyjs/plugin-templates@latest ${targetDir}`;
+    
+    if (options.verbose) {
+      console.log(chalk.gray('Running:'), npmCommand);
+    }
+    
+    execSync(npmCommand, {
+      stdio: options.verbose ? 'inherit' : 'pipe',
+      cwd: process.cwd()
+    });
+    
+    spinner1.succeed('Template downloaded');
+    
+    // Show next steps
+    console.log('\n' + chalk.green('✓ Project created successfully!\n'));
+    console.log(chalk.cyan('Next steps:'));
+    console.log(`  1. Navigate to your project:`);
+    console.log(`     ${chalk.gray(`cd ${targetDir}`)}`);
+    console.log(`  2. Install dependencies:`);
+    console.log(`     ${chalk.gray('npm install')}`);
+    console.log(`  3. Start development:`);
+    console.log(`     ${chalk.gray('npm run dev')}`);
+    console.log(`  4. Pack for deployment:`);
+    console.log(`     ${chalk.gray('npx @linyjs/cli pack')}\n`);
+    
+    console.log(chalk.cyan('Learn more:'));
+    console.log(`  - Plugin Development Guide: https://github.com/linyjs/ling/blob/main/spec/插件开发指南.md`);
+    console.log(`  - CLI Documentation: https://github.com/linyjs/ling/blob/main/packages/cli/README.md\n`);
+    
+  } catch (error) {
+    spinner1.fail('Failed to create project');
+    console.error(chalk.red('\nError:'), error instanceof Error ? error.message : error);
+    console.error(chalk.yellow('\nTroubleshooting:'));
+    console.error('  - Make sure you have Node.js >= 18 installed');
+    console.error('  - Check your internet connection');
+    console.error('  - Try again with --verbose flag for more details');
+    process.exit(1);
+  }
+}

package/src/commands/pack.ts

@@ -0,0 +1,315 @@
+/**
+ * Pack plugin into .mpk file
+ */
+
+import fs from 'fs';
+import path from 'path';
+import archiver from 'archiver';
+import chalk from 'chalk';
+import ora from 'ora';
+import { buildProject, type BuildOptions } from '../utils/builder.js';
+
+interface PackOptions {
+  output: string;
+  name?: string;
+  version?: string | boolean;
+  build: boolean;
+  manifest?: string;
+  verbose: boolean;
+}
+
+export async function packPlugin(options: PackOptions) {
+  const projectRoot = process.cwd();
+  
+  console.log(chalk.blue('📦 Ling Plugin Packer\n'));
+  
+  // Step 1: Read package.json
+  const spinner1 = ora('Reading package.json...').start();
+  const packageJsonPath = path.join(projectRoot, 'package.json');
+  
+  if (!fs.existsSync(packageJsonPath)) {
+    spinner1.fail('package.json not found');
+    console.error(chalk.red('\nPlease run this command in a plugin project directory.'));
+    process.exit(1);
+  }
+  
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+  spinner1.succeed('Package.json loaded');
+  
+  if (options.verbose) {
+    console.log(chalk.gray('  Name:'), packageJson.name);
+    console.log(chalk.gray('  Version:'), packageJson.version);
+  }
+  
+  // Step 2: Build project (if needed)
+  if (options.build) {
+    const buildOptions: BuildOptions = {
+      projectRoot,
+      verbose: options.verbose,
+      // esbuild is used by default - no need for users to configure webpack/rollup
+      // CLI handles all build optimization automatically
+      minify: true, // Always minify for production bundles
+      external: [
+        'react',
+        'react-dom',
+        'express',
+        '@linyjs/*',
+        '@ling/*'
+      ]
+    };
+    
+    const buildResult = await buildProject(buildOptions);
+    
+    if (options.verbose) {
+      console.log(chalk.gray('\n📊 Build Statistics:'));
+      console.log(chalk.gray('  Duration:'), `${buildResult.duration}ms`);
+      console.log(chalk.gray('  Files:'), buildResult.files.length);
+      console.log(chalk.gray('  Size:'), formatFileSize(buildResult.size));
+      console.log(chalk.gray('  Output:'), buildResult.outputDir);
+    }
+  } else {
+    console.log(chalk.yellow('⚠ Skipping build step (--no-build)'));
+  }
+  
+  // Step 3: Generate manifest.json
+  const spinner3 = ora('Generating manifest.json...').start();
+  const distDir = path.join(projectRoot, 'dist');
+  
+  if (!fs.existsSync(distDir)) {
+    spinner3.fail('dist/ directory not found');
+    console.error(chalk.red('\nPlease build the project first or remove --no-build flag.'));
+    process.exit(1);
+  }
+  
+  const manifest = {
+    name: options.name || packageJson.name,
+    version: options.version || packageJson.version,
+    description: packageJson.description || '',
+    author: typeof packageJson.author === 'string' 
+      ? packageJson.author 
+      : packageJson.author?.name || '',
+    serverEntry: detectEntry(distDir, 'server'),
+    clientEntry: detectEntry(distDir, 'client'),
+    dependencies: extractDependencies(packageJson),
+    permissions: extractPermissions(packageJson)
+  };
+  
+  // Write manifest.json to dist/
+  const manifestPath = path.join(distDir, 'manifest.json');
+  fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+  spinner3.succeed('Manifest generated');
+  
+  if (options.verbose) {
+    console.log(chalk.gray('  Server entry:'), manifest.serverEntry);
+    console.log(chalk.gray('  Client entry:'), manifest.clientEntry);
+  }
+  
+  // Step 4: Validate structure
+  const spinner4 = ora('Validating plugin structure...').start();
+  const validationErrors = validatePluginStructure(distDir, manifest);
+  
+  if (validationErrors.length > 0) {
+    spinner4.fail('Validation failed');
+    console.error(chalk.red('\nValidation errors:'));
+    validationErrors.forEach(err => {
+      console.error(chalk.red(`  - ${err}`));
+    });
+    process.exit(1);
+  }
+  
+  spinner4.succeed('Structure validated');
+  
+  // Step 5: Pack to .mpk
+  const outputDir = path.resolve(options.output);
+  const outputFile = path.join(outputDir, `${manifest.name}-${manifest.version}.mpk`);
+  
+  // Ensure output directory exists
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+  
+  const spinner5 = ora('Packing plugin...').start();
+  
+  try {
+    await createZipArchive(distDir, outputFile);
+    spinner5.succeed('Plugin packed successfully');
+  } catch (error) {
+    spinner5.fail('Pack failed');
+    console.error(chalk.red('\nPack error:'));
+    if (error instanceof Error) {
+      console.error(error.message);
+    }
+    process.exit(1);
+  }
+  
+  // Step 6: Show result
+  const stats = fs.statSync(outputFile);
+  const fileSize = formatFileSize(stats.size);
+  
+  console.log('\n' + chalk.green('✓ Plugin ready!'));
+  console.log(chalk.gray('  File:'), chalk.cyan(outputFile));
+  console.log(chalk.gray('  Size:'), chalk.cyan(fileSize));
+  console.log(chalk.gray('  Version:'), chalk.cyan(manifest.version));
+  
+  console.log('\n' + chalk.blue('Next steps:'));
+  console.log('  1. Test the plugin:');
+  console.log(chalk.gray('     cp ' + outputFile + ' /path/to/ling/packages/ssr/extensions/'));
+  console.log('  2. Restart SSR server:');
+  console.log(chalk.gray('     cd packages/ssr && npx tsx src/demo/dev-server-with-pkg.tsx'));
+  console.log('  3. Validate the plugin:');
+  console.log(chalk.gray('     npx @linyjs/cli validate ' + outputFile));
+}
+
+/**
+ * Detect entry file in dist directory
+ */
+function detectEntry(distDir: string, type: 'server' | 'client'): string {
+  const entryPath = path.join(distDir, type, 'index.js');
+  
+  if (fs.existsSync(entryPath)) {
+    return `${type}/index.js`;
+  }
+  
+  // Try other common patterns
+  const alternatives = [
+    `${type}.js`,
+    `${type}/index.ts`,
+    `index.${type}.js`
+  ];
+  
+  for (const alt of alternatives) {
+    if (fs.existsSync(path.join(distDir, alt))) {
+      return alt;
+    }
+  }
+  
+  throw new Error(`Cannot find ${type} entry file in dist/`);
+}
+
+/**
+ * Extract dependencies from package.json
+ */
+function extractDependencies(packageJson: any): string[] {
+  const deps: string[] = [];
+  
+  // Check dependencies
+  if (packageJson.dependencies) {
+    Object.keys(packageJson.dependencies).forEach(dep => {
+      if (dep.startsWith('@linyjs/') || dep.startsWith('@ling/')) {
+        deps.push(`${dep}@${packageJson.dependencies[dep]}`);
+      }
+    });
+  }
+  
+  return deps;
+}
+
+/**
+ * Extract permissions from package.json keywords or custom field
+ */
+function extractPermissions(packageJson: any): string[] {
+  // Check for custom permissions field
+  if (packageJson.ling?.permissions) {
+    return packageJson.ling.permissions;
+  }
+  
+  // Or extract from keywords
+  if (packageJson.keywords) {
+    return packageJson.keywords
+      .filter((k: string) => k.startsWith('permission:'))
+      .map((k: string) => k.replace('permission:', ''));
+  }
+  
+  return [];
+}
+
+/**
+ * Validate plugin structure
+ */
+function validatePluginStructure(distDir: string, manifest: any): string[] {
+  const errors: string[] = [];
+  
+  // Check manifest.json
+  if (!fs.existsSync(path.join(distDir, 'manifest.json'))) {
+    errors.push('manifest.json is missing');
+  }
+  
+  // Check server entry
+  if (manifest.serverEntry) {
+    const serverPath = path.join(distDir, manifest.serverEntry);
+    if (!fs.existsSync(serverPath)) {
+      errors.push(`Server entry not found: ${manifest.serverEntry}`);
+    }
+  }
+  
+  // Check client entry
+  if (manifest.clientEntry) {
+    const clientPath = path.join(distDir, manifest.clientEntry);
+    if (!fs.existsSync(clientPath)) {
+      errors.push(`Client entry not found: ${manifest.clientEntry}`);
+    }
+  }
+  
+  // Check for required fields
+  if (!manifest.name) {
+    errors.push('Plugin name is required');
+  }
+  
+  if (!manifest.version) {
+    errors.push('Plugin version is required');
+  }
+  
+  return errors;
+}
+
+/**
+ * Create ZIP archive
+ */
+function createZipArchive(sourceDir: string, outputPath: string): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const output = fs.createWriteStream(outputPath);
+    const archive = archiver('zip', {
+      zlib: { level: 9 } // Maximum compression
+    });
+    
+    output.on('close', () => {
+      resolve();
+    });
+    
+    archive.on('error', (err: Error) => {
+      reject(err);
+    });
+    
+    archive.pipe(output);
+    
+    // Add all files from dist directory
+    archive.directory(sourceDir, false, (entry: any) => {
+      // Exclude unnecessary files
+      if (entry.name.includes('node_modules') || 
+          entry.name.includes('.git') ||
+          entry.name.endsWith('.test.js') ||
+          entry.name.endsWith('.spec.js')) {
+        return false;
+      }
+      return entry;
+    });
+    
+    archive.finalize();
+  });
+}
+
+/**
+ * Format file size
+ */
+function formatFileSize(bytes: number): string {
+  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]}`;
+}

package/src/index.ts

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+/**
+ * @linyjs/cli - Ling 框架命令行工具
+ * 
+ * 提供插件打包、开发、发布等实用功能
+ * 
+ * 使用 Cleye 作为 CLI 框架
+ * - 零配置 TypeScript
+ * - 自动类型推断
+ * - 简洁的函数式 API
+ */
+
+import { cli } from 'cleye';
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+
+// Main CLI with subcommands
+cli(
+  {
+    name: '@linyjs/cli',
+    version: packageJson.version,
+  },
+  async (argv: any) => {
+    // Get the command from argv._
+    const command = argv._[0];
+    
+    switch (command) {
+      case 'pack':
+        const { packPlugin } = await import('./commands/pack.js');
+        await packPlugin({
+          output: argv.flags.output || '.',
+          name: argv.flags.name,
+          version: argv.flags.version,
+          build: argv.flags.build !== false,
+          manifest: argv.flags.manifest,
+          verbose: argv.flags.verbose || false
+        });
+        break;
+        
+      case 'dev':
+        const { devPlugin } = await import('./commands/dev.js');
+        await devPlugin({
+          target: argv.flags.target,
+          verbose: argv.flags.verbose || false
+        });
+        break;
+        
+      case 'init':
+        const { initPlugin } = await import('./commands/init.js');
+        await initPlugin({
+          name: argv._[1],
+          verbose: argv.flags.verbose || false
+        });
+        break;
+        
+      default:
+        // Show help if no command or unknown command
+        console.log(`
+📦 @linyjs/cli v${packageJson.version}
+
+Usage:
+  npx @linyjs/cli <command> [options]
+
+Commands:
+  pack     Pack a plugin project into .mpk file
+  dev      Quick development workflow (pack + install + register)
+  init     Create a new plugin project from template
+
+Examples:
+  npx @linyjs/cli pack                    # Pack plugin
+  npx @linyjs/cli pack -o ./releases      # Specify output directory
+  npx @linyjs/cli dev                     # Dev mode (pack + install)
+  npx @linyjs/cli dev --target /path      # Specify extensions directory
+  npx @linyjs/cli init my-plugin          # Create new plugin project
+
+Run 'npx @linyjs/cli <command> --help' for more information.
+        `.trim());
+        break;
+    }
+  }
+);