@linyjs/cli 0.0.3 → 0.0.5

package/src/commands/init.ts

@@ -1,75 +0,0 @@
-/**
- * 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

@@ -1,315 +0,0 @@
-/**
- * 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

@@ -1,84 +0,0 @@
-#!/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;
-    }
-  }
-);