@ultikits/cli 1.0.1 → 1.1.0

package/dist/bin/ultikits.js

@@ -7,11 +7,12 @@ import { registerInitCommand } from '../src/commands/init.js';
 import { registerPublishCommand } from '../src/commands/publish.js';
 import { registerModulesCommand } from '../src/commands/modules.js';
 import { registerVersionsCommand } from '../src/commands/versions.js';
+import { registerCreateCommand } from '../src/commands/create.js';
 const program = new Command();
 program
     .name('ultikits')
     .description('CLI for publishing UltiTools plugin modules to UltiCloud')
-    .version('1.0.1');
+    .version('1.1.0');
 registerLoginCommand(program);
 registerLogoutCommand(program);
 registerWhoamiCommand(program);
@@ -19,5 +20,6 @@ registerInitCommand(program);
 registerPublishCommand(program);
 registerModulesCommand(program);
 registerVersionsCommand(program);
+registerCreateCommand(program);
 program.parse();
 //# sourceMappingURL=ultikits.js.map

package/dist/src/commands/create.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerCreateCommand(program: Command): void;

package/dist/src/commands/create.js

@@ -0,0 +1,95 @@
+import inquirer from 'inquirer';
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import * as log from '../lib/logger.js';
+import { derivePackageName, generatePomXml, generatePluginYml, generateMainClass, generateEnLang, generateZhLang, generateReadme, generateGitignore, } from '../lib/templates.js';
+function getGitUserName() {
+    try {
+        return execFileSync('git', ['config', 'user.name'], { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+export function registerCreateCommand(program) {
+    program
+        .command('create')
+        .argument('[directory]', 'Target directory name (defaults to module name)')
+        .description('Scaffold a new UltiTools module project')
+        .action(async (directory) => {
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'moduleName',
+                message: 'Module name (e.g., UltiHome):',
+                validate: (v) => /^[A-Z][a-zA-Z0-9]+$/.test(v)
+                    ? true
+                    : 'Must start with uppercase letter, alphanumeric only',
+            },
+            {
+                type: 'input',
+                name: 'packageName',
+                message: 'Java package name:',
+                default: (prev) => derivePackageName(prev.moduleName),
+                validate: (v) => /^[a-z][a-z0-9_.]*[a-z0-9]$/.test(v)
+                    ? true
+                    : 'Must be a valid Java package name (lowercase, dots)',
+            },
+            {
+                type: 'input',
+                name: 'description',
+                message: 'Short description:',
+                validate: (v) => (v.trim().length > 0 ? true : 'Required'),
+            },
+            {
+                type: 'input',
+                name: 'author',
+                message: 'Author:',
+                default: getGitUserName(),
+                validate: (v) => (v.trim().length > 0 ? true : 'Required'),
+            },
+            {
+                type: 'input',
+                name: 'apiVersion',
+                message: 'UltiTools-API version:',
+                default: '6.2.2',
+            },
+        ]);
+        const params = answers;
+        const targetDir = join(process.cwd(), directory ?? params.moduleName);
+        if (existsSync(targetDir)) {
+            log.error(`Directory already exists: ${targetDir}`);
+            return;
+        }
+        const spin = log.spinner('Creating project...');
+        spin.start();
+        const packagePath = params.packageName.replace(/\./g, '/');
+        const srcMain = join(targetDir, 'src/main/java', packagePath);
+        const srcTest = join(targetDir, 'src/test/java', packagePath);
+        const resources = join(targetDir, 'src/main/resources');
+        const langDir = join(resources, 'lang');
+        mkdirSync(srcMain, { recursive: true });
+        mkdirSync(srcTest, { recursive: true });
+        mkdirSync(langDir, { recursive: true });
+        writeFileSync(join(targetDir, 'pom.xml'), generatePomXml(params));
+        writeFileSync(join(resources, 'plugin.yml'), generatePluginYml(params));
+        writeFileSync(join(srcMain, `${params.moduleName}.java`), generateMainClass(params));
+        writeFileSync(join(langDir, 'en.yml'), generateEnLang(params));
+        writeFileSync(join(langDir, 'zh.yml'), generateZhLang(params));
+        writeFileSync(join(targetDir, 'README.md'), generateReadme(params));
+        writeFileSync(join(targetDir, '.gitignore'), generateGitignore());
+        try {
+            execFileSync('git', ['init'], { cwd: targetDir, stdio: 'ignore' });
+        }
+        catch {
+            log.warn('Could not initialize git repository');
+        }
+        spin.stop();
+        log.success(`Created ${params.moduleName} at ${targetDir}`);
+        log.info('Next steps:');
+        log.info(`  cd ${directory ?? params.moduleName}`);
+        log.info('  mvn compile');
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/src/lib/templates.d.ts

@@ -0,0 +1,9 @@
+import type { CreateParams } from '../types.js';
+export declare function derivePackageName(moduleName: string): string;
+export declare function generatePomXml(params: CreateParams): string;
+export declare function generatePluginYml(params: CreateParams): string;
+export declare function generateMainClass(params: CreateParams): string;
+export declare function generateEnLang(params: CreateParams): string;
+export declare function generateZhLang(params: CreateParams): string;
+export declare function generateReadme(params: CreateParams): string;
+export declare function generateGitignore(): string;

package/dist/src/lib/templates.js

@@ -0,0 +1,251 @@
+export function derivePackageName(moduleName) {
+    const lower = moduleName.toLowerCase();
+    const suffix = lower.startsWith('ulti') ? lower.slice(4) : lower;
+    return `com.ultikits.plugins.${suffix}`;
+}
+export function generatePomXml(params) {
+    const mv = (name) => '${' + name + '}';
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.ultikits.plugins</groupId>
+    <artifactId>${params.moduleName}</artifactId>
+    <version>1.0.0</version>
+    <packaging>jar</packaging>
+
+    <name>${params.moduleName}</name>
+    <description>${params.description}</description>
+
+    <properties>
+        <java.version>1.8</java.version>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <ultitools.version>${params.apiVersion}</ultitools.version>
+    </properties>
+
+    <repositories>
+        <repository>
+            <id>spigot-repo</id>
+            <url>https://hub.spigotmc.org/nexus/content/repositories/snapshots/</url>
+        </repository>
+    </repositories>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.spigotmc</groupId>
+            <artifactId>spigot-api</artifactId>
+            <version>1.20.1-R0.1-SNAPSHOT</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.ultikits</groupId>
+            <artifactId>UltiTools-API</artifactId>
+            <version>${mv('ultitools.version')}</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <version>1.18.30</version>
+            <scope>provided</scope>
+        </dependency>
+
+        <!-- Test dependencies -->
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <version>5.10.0</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-api</artifactId>
+            <version>5.10.0</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-params</artifactId>
+            <version>5.10.0</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.mockito</groupId>
+            <artifactId>mockito-core</artifactId>
+            <version>5.5.0</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.mockito</groupId>
+            <artifactId>mockito-junit-jupiter</artifactId>
+            <version>5.5.0</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.assertj</groupId>
+            <artifactId>assertj-core</artifactId>
+            <version>3.24.2</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>true</filtering>
+            </resource>
+        </resources>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.11.0</version>
+                <configuration>
+                    <source>${mv('java.version')}</source>
+                    <target>${mv('java.version')}</target>
+                    <annotationProcessorPaths>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                            <version>1.18.30</version>
+                        </path>
+                    </annotationProcessorPaths>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <version>3.1.2</version>
+            </plugin>
+            <plugin>
+                <groupId>org.jacoco</groupId>
+                <artifactId>jacoco-maven-plugin</artifactId>
+                <version>0.8.11</version>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>prepare-agent</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>report</id>
+                        <phase>test</phase>
+                        <goals>
+                            <goal>report</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
+`;
+}
+export function generatePluginYml(params) {
+    return `name: ${params.moduleName}
+version: '\${project.version}'
+main: ${params.packageName}.${params.moduleName}
+authors:
+  - ${params.author}
+  - UltiKits Team
+description: ${params.description}
+api-version: 620
+loadAfter: []
+`;
+}
+export function generateMainClass(params) {
+    return `package ${params.packageName};
+
+import com.ultikits.ultitools.abstracts.UltiToolsPlugin;
+import com.ultikits.ultitools.annotations.UltiToolsModule;
+
+import java.util.List;
+import java.util.Arrays;
+
+@UltiToolsModule(scanBasePackages = "${params.packageName}")
+public class ${params.moduleName} extends UltiToolsPlugin {
+
+    @Override
+    public boolean registerSelf() {
+        return true;
+    }
+
+    @Override
+    public void unregisterSelf() {
+    }
+
+    @Override
+    public void reloadSelf() {
+    }
+
+    @Override
+    public List<String> supported() {
+        return Arrays.asList("en", "zh");
+    }
+}
+`;
+}
+export function generateEnLang(params) {
+    return `# ${params.moduleName} - English language file
+
+module_enabled: "${params.moduleName} has been enabled."
+module_disabled: "${params.moduleName} has been disabled."
+`;
+}
+export function generateZhLang(params) {
+    return `# ${params.moduleName} - 中文语言文件
+
+module_enabled: "${params.moduleName} 已启用。"
+module_disabled: "${params.moduleName} 已禁用。"
+`;
+}
+export function generateReadme(params) {
+    return `# ${params.moduleName}
+
+${params.description}
+
+## Installation
+
+1. Download the latest release JAR
+2. Place it in \`plugins/UltiTools/plugins/\` directory
+3. Restart the server
+
+## 安装
+
+1. 下载最新版本的 JAR 文件
+2. 将其放入 \`plugins/UltiTools/plugins/\` 目录
+3. 重启服务器
+
+## Requirements
+
+- Minecraft 1.21+
+- UltiTools-API ${params.apiVersion}+
+
+## License
+
+MIT
+`;
+}
+export function generateGitignore() {
+    return `target/
+*.class
+*.jar
+*.log
+
+# IDE
+.idea/
+*.iml
+.vscode/
+.settings/
+.project
+.classpath
+
+# OS
+.DS_Store
+Thumbs.db
+`;
+}
+//# sourceMappingURL=templates.js.map

package/dist/src/types.d.ts

@@ -36,3 +36,10 @@ export interface ApiResponse<T = any> {
     msg: string;
     data?: T;
 }
+export interface CreateParams {
+    moduleName: string;
+    packageName: string;
+    description: string;
+    author: string;
+    apiVersion: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultikits/cli",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "CLI tool for publishing UltiTools plugin modules to UltiCloud marketplace",
   "type": "module",
   "bin": {