cocos2d-cli 1.6.4 → 2.0.0

package/{src → dist/src}/lib/screenshot-core.js

@@ -1,18 +1,10 @@
-/**
- * Screenshot Core Module  
- * 渲染 JSON 数据并使用 Playwright 截图
- */
-
-const { chromium } = require('playwright');
-const fs = require('fs').promises;
-const path = require('path');
-const http = require('http');
-const url = require('url');
-const os = require('os');
-
-// 默认配置
+import { chromium } from 'playwright';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as http from 'http';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const DEFAULT_CONFIG = {
-    jsonPath: null,
     outputDir: process.cwd(),
     viewport: { width: 750, height: 1334 },
     fullPage: true,
@@ -20,32 +12,27 @@ const DEFAULT_CONFIG = {
     timeout: 30000,
     waitTime: 1000
 };
-
-// 获取内置资源目录
 function getAssetsDir() {
-    return path.join(__dirname, 'screenshot');
+    const projectRoot = process.cwd();
+    return path.join(projectRoot, 'src', 'lib', 'screenshot');
 }
-
-// 创建临时工作目录
 async function createTempWorkDir() {
-    const tempBase = os.tmpdir();
+    const tempBase = process.env.TEMP || process.env.TMP || '/tmp';
     const timestamp = Date.now();
     const tempDir = path.join(tempBase, `cocos2d-screenshot-${timestamp}`);
     await fs.mkdir(tempDir, { recursive: true });
     return tempDir;
 }
-
-// 复制内置资源到临时目录
 async function copyBuiltInAssets(tempDir, logs) {
     const assetsDir = getAssetsDir();
     const assets = ['index.html', 'favicon.ico'];
-    
     for (const asset of assets) {
         const src = path.join(assetsDir, asset);
         const dest = path.join(tempDir, asset);
         try {
             await fs.copyFile(src, dest);
-        } catch (err) {
+        }
+        catch (err) {
             logs.push({
                 timestamp: new Date().toISOString(),
                 type: 'warning',
@@ -54,21 +41,16 @@ async function copyBuiltInAssets(tempDir, logs) {
         }
     }
 }
-
-// 静态文件服务器
 async function startServer(staticDir, logs) {
     return new Promise((resolve, reject) => {
         const server = http.createServer(async (req, res) => {
             try {
-                const parsedUrl = url.parse(req.url);
-                let filePath = path.join(staticDir, parsedUrl.pathname);
-                
-                if (parsedUrl.pathname === '/') {
+                const reqUrl = new URL(req.url || '/', `http://${req.headers.host}`);
+                let filePath = path.join(staticDir, reqUrl.pathname);
+                if (reqUrl.pathname === '/') {
                     filePath = path.join(staticDir, 'index.html');
                 }
-                
                 const data = await fs.readFile(filePath);
-                
                 const ext = path.extname(filePath).toLowerCase();
                 const contentTypes = {
                     '.html': 'text/html',
@@ -86,18 +68,18 @@ async function startServer(staticDir, logs) {
                     '.txt': 'text/plain',
                     '.xml': 'application/xml'
                 };
-                
-                res.writeHead(200, { 
+                res.writeHead(200, {
                     'Content-Type': contentTypes[ext] || 'application/octet-stream',
                     'Access-Control-Allow-Origin': '*'
                 });
                 res.end(data);
-                
-            } catch (err) {
+            }
+            catch (err) {
                 if (err.code === 'ENOENT') {
                     res.writeHead(404);
                     res.end();
-                } else {
+                }
+                else {
                     logs.push({
                         timestamp: new Date().toISOString(),
                         type: 'server-error',
@@ -108,16 +90,14 @@ async function startServer(staticDir, logs) {
                 }
             }
         });
-        
         server.listen(0, '127.0.0.1', () => resolve(server));
     });
 }
-
-// 递归删除目录
 async function removeDir(dirPath, logs) {
     try {
         await fs.rm(dirPath, { recursive: true, force: true });
-    } catch (err) {
+    }
+    catch (err) {
         if (logs) {
             logs.push({
                 timestamp: new Date().toISOString(),
@@ -127,32 +107,17 @@ async function removeDir(dirPath, logs) {
         }
     }
 }
-
-/**
- * 截图核心函数
- * @param {Object} userConfig - 配置选项
- * @param {string} userConfig.jsonPath - JSON 文件路径
- * @param {string} userConfig.outputDir - 输出目录
- * @param {Object} userConfig.viewport - 视口大小 {width, height}
- * @param {boolean} userConfig.fullPage - 是否全页截图
- * @param {number} userConfig.timeout - 超时时间（毫秒）
- * @param {number} userConfig.waitTime - 等待时间（毫秒）
- * @returns {Promise<{screenshotPath: string, logs: Array}>}
- */
-async function takeScreenshot(userConfig = {}) {
+export async function takeScreenshot(userConfig = {}) {
     const config = { ...DEFAULT_CONFIG, ...userConfig };
-    
     if (!config.jsonPath) {
         throw new Error('JSON file path is required');
     }
-    
     let server = null;
     let browser = null;
     let tempDir = null;
     const logs = [];
     let screenshotPath = null;
     let logDir = null;
-    
     const addLog = (type, text, extra = {}) => {
         logs.push({
             timestamp: new Date().toISOString(),
@@ -161,70 +126,47 @@ async function takeScreenshot(userConfig = {}) {
             ...extra
         });
     };
-    
     try {
         const timestamp = Date.now();
-        
-        // 检查 JSON 文件是否存在
         try {
             await fs.access(config.jsonPath);
-        } catch (error) {
+        }
+        catch (error) {
             throw new Error(`JSON file not found: ${config.jsonPath}`);
         }
-        
-        // 确保输出目录存在
         await fs.mkdir(config.outputDir, { recursive: true });
-        
-        // 创建临时工作目录
         tempDir = await createTempWorkDir();
         addLog('info', `Temp dir: ${tempDir}`);
-
-        // 复制内置资源到临时目录
         await copyBuiltInAssets(tempDir, logs);
- 
-        // 复制用户的 JSON 文件到临时目录
         const destJsonPath = path.join(tempDir, 'data.json');
         await fs.copyFile(config.jsonPath, destJsonPath);
         addLog('info', `JSON: ${config.jsonPath}`);
-
-        // 截图输出路径
         screenshotPath = path.join(config.outputDir, `screenshot-${timestamp}.png`);
-
-        // 启动HTTP服务器
         addLog('info', 'Starting Server');
         server = await startServer(tempDir, logs);
-        const serverUrl = `http://127.0.0.1:${server.address().port}`;
+        const address = server.address();
+        const serverUrl = `http://127.0.0.1:${address.port}`;
         addLog('info', `Server: ${serverUrl}`);
-
-        // 启动浏览器
         addLog('info', 'Launching Browser');
         browser = await chromium.launch({
-            headless: true,
-            channel: 'chrome'
+            headless: true
         });
         addLog('info', 'Browser launched');
-
         const page = await browser.newPage({
             viewport: config.viewport
         });
-
-        // 监听浏览器控制台日志
-        page.on('console', msg => {
+        page.on('console', (msg) => {
             const text = msg.text();
             addLog(msg.type(), text);
         });
-
-        page.on('pageerror', error => {
+        page.on('pageerror', (error) => {
             addLog('pageerror', error.message);
         });
-
-        page.on('requestfailed', request => {
+        page.on('requestfailed', (request) => {
             const failure = request.failure();
             const errorText = failure ? failure.errorText : 'Unknown error';
             addLog('requestfailed', request.url(), { error: errorText });
         });
-
-        // 加载页面
         addLog('info', 'Loading Page');
         const pageUrl = config.debugBounds
             ? `${serverUrl}/index.html?debugBounds=true`
@@ -234,13 +176,9 @@ async function takeScreenshot(userConfig = {}) {
             timeout: config.timeout
         });
         addLog('info', 'Page loaded');
-
-        // 等待渲染
         addLog('info', 'Waiting for Render');
         await page.waitForTimeout(config.waitTime);
         addLog('info', 'Wait complete');
-
-        // 截图
         addLog('info', 'Taking Screenshot');
         await page.screenshot({
             path: screenshotPath,
@@ -248,39 +186,36 @@ async function takeScreenshot(userConfig = {}) {
         });
         addLog('info', `Screenshot saved: ${screenshotPath}`);
         addLog('info', 'Done');
-
         return { screenshotPath, logs };
-
-    } catch (error) {
+    }
+    catch (error) {
         addLog('error', error.message);
         try {
             logDir = path.join(config.outputDir, `screenshot-logs-${Date.now()}`);
             await fs.mkdir(logDir, { recursive: true });
-            await fs.writeFile(
-                path.join(logDir, 'logs.json'),
-                JSON.stringify({
-                    error: error.message,
-                    jsonPath: config.jsonPath,
-                    outputDir: config.outputDir,
-                    viewport: config.viewport,
-                    fullPage: config.fullPage,
-                    debugBounds: config.debugBounds,
-                    timeout: config.timeout,
-                    waitTime: config.waitTime,
-                    screenshotPath,
-                    logs
-                }, null, 2),
-                'utf8'
-            );
-        } catch (_) {}
+            await fs.writeFile(path.join(logDir, 'logs.json'), JSON.stringify({
+                error: error.message,
+                jsonPath: config.jsonPath,
+                outputDir: config.outputDir,
+                viewport: config.viewport,
+                fullPage: config.fullPage,
+                debugBounds: config.debugBounds,
+                timeout: config.timeout,
+                waitTime: config.waitTime,
+                screenshotPath,
+                logs
+            }, null, 2), 'utf8');
+        }
+        catch (_) { }
         error.logDir = logDir;
         throw error;
-    } finally {
-        // 清理资源
-        if (browser) await browser.close().catch(() => {});
-        if (server) server.close();
-        if (tempDir) await removeDir(tempDir, logs);
+    }
+    finally {
+        if (browser)
+            await browser.close().catch(() => { });
+        if (server)
+            server.close();
+        if (tempDir)
+            await removeDir(tempDir, logs);
     }
 }
-
-module.exports = { takeScreenshot };

package/dist/src/lib/templates.js

@@ -0,0 +1,17 @@
+import CCNode from './cc/CCNode.js';
+import CCScene from './cc/CCScene.js';
+import CCSceneAsset from './cc/CCSceneAsset.js';
+import { CCPrefab, CCPrefabInfo } from './cc/CCPrefab.js';
+export function createPrefab(name = 'Prefab') {
+    const prefab = new CCPrefab();
+    const root = new CCNode(name);
+    prefab.setRoot(root);
+    return prefab;
+}
+export function createScene(name = 'NewScene') {
+    const asset = new CCSceneAsset();
+    const scene = new CCScene(name);
+    asset._scene = scene;
+    return asset;
+}
+export { CCNode, CCScene, CCSceneAsset, CCPrefab, CCPrefabInfo };

package/dist/src/lib/utils.js

@@ -0,0 +1,81 @@
+import * as crypto from 'crypto';
+export function parseColor(color) {
+    if (!color)
+        return null;
+    if (color.startsWith('#')) {
+        const hex = color.slice(1);
+        if (hex.length === 6 || hex.length === 8) {
+            return {
+                r: parseInt(hex.slice(0, 2), 16),
+                g: parseInt(hex.slice(2, 4), 16),
+                b: parseInt(hex.slice(4, 6), 16),
+                a: hex.length === 8 ? parseInt(hex.slice(6, 8), 16) : 255
+            };
+        }
+    }
+    const rgbMatch = color.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*([\d.]+))?\)/);
+    if (rgbMatch) {
+        return {
+            r: parseInt(rgbMatch[1]),
+            g: parseInt(rgbMatch[2]),
+            b: parseInt(rgbMatch[3]),
+            a: rgbMatch[4] ? Math.round(parseFloat(rgbMatch[4]) * 255) : 255
+        };
+    }
+    return null;
+}
+export function parseColorToCcColor(color) {
+    const parsed = parseColor(color);
+    if (!parsed)
+        return null;
+    return { __type__: 'cc.Color', ...parsed };
+}
+export function colorToHex(r, g, b, a = 255) {
+    return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}${a !== 255 ? a.toString(16).padStart(2, '0') : ''}`;
+}
+export function generateUUID() {
+    return crypto.randomUUID().replace(/-/g, '');
+}
+export function compressUUID(uuid) {
+    const hex = uuid.replace(/-/g, '');
+    const bytes = Buffer.from(hex, 'hex');
+    return bytes.toString('base64url').slice(0, 22);
+}
+export function generateCompressedUUID() {
+    return compressUUID(generateUUID());
+}
+export function generateId() {
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+    let result = '';
+    for (let i = 0; i < 22; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+export function parseOptions(args) {
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            const nextArg = args[i + 1];
+            if (nextArg && !nextArg.startsWith('--')) {
+                options[key] = nextArg;
+                i++;
+            }
+            else {
+                options[key] = true;
+            }
+        }
+    }
+    return options;
+}
+export function outputJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+export function outputError(message) {
+    console.log(JSON.stringify({ error: message }));
+}
+export function outputSuccess(message) {
+    console.log(JSON.stringify({ success: message }));
+}

package/package.json

@@ -1,33 +1,40 @@
-{
-  "name": "cocos2d-cli",
-  "version": "1.6.4",
-  "description": "Command-line tools for AI to read and manipulate Cocos Creator 2.4.x project scenes",
-  "main": "bin/cocos2d-cli.js",
-  "bin": {
-    "cocos2d-cli": "bin/cocos2d-cli.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "data"
-  ],
-  "scripts": {
-    "test": "echo \"No tests specified\" && exit 1"
-  },
-  "keywords": [
-    "cocos",
-    "cocos-creator",
-    "cli",
-    "scene",
-    "fire",
-    "screenshot"
-  ],
-  "author": "",
-  "license": "MIT",
-  "engines": {
-    "node": ">=14.0.0"
-  },
-  "dependencies": {
-    "playwright": "^1.58.2"
-  }
-}
+{
+  "name": "cocos2d-cli",
+  "version": "2.0.0",
+  "description": "Command-line tools for AI to read and manipulate Cocos Creator 2.4.x project scenes",
+  "type": "module",
+  "main": "dist/bin/cocos2d-cli.js",
+  "bin": {
+    "cocos2d-cli": "dist/bin/cocos2d-cli.js"
+  },
+  "files": [
+    "dist",
+    "data"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "prepare": "npm run build",
+    "test": "echo \"No tests specified\" && exit 1"
+  },
+  "keywords": [
+    "cocos",
+    "cocos-creator",
+    "cli",
+    "scene",
+    "fire",
+    "screenshot"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "playwright": "^1.58.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.17",
+    "typescript": "^5.9.3"
+  }
+}

package/bin/cocos2d-cli.js

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-/**       
- * Cocos Creator CLI
- * Command-line tools for AI to read and manipulate Cocos Creator 2.4.x project scenes
- */
-
-const path = require('path');
-
-// 命令映射
-const commands = {
-    tree: '../src/commands/tree',
-    get: '../src/commands/get',
-    set: '../src/commands/set',
-    'set-component': '../src/commands/set-component',
-    add: '../src/commands/add',
-    'add-component': '../src/commands/add-component',
-    'remove-component': '../src/commands/remove-component',
-    'remove': '../src/commands/remove',
-    build: '../src/commands/build',
-    'create-prefab': '../src/commands/prefab-create',
-    'create-scene': '../src/commands/create-scene',
-    'screenshot': '../src/commands/screenshot'
-};
-
-// 帮助信息
-function showHelp() {
-    console.log(`
-Cocos Creator CLI - 场景/预制体操作工具集
-
-用法:
-  cocos2d-cli <command> [options]
-
-命令:
-  tree <场景.fire | 预制体.prefab>              查看节点树
-  get <场景.fire | 预制体.prefab> <节点路径> [属性名|组件类型]  获取节点或组件属性
-  set <场景.fire | 预制体.prefab> <节点路径> <属性名> <值>     修改节点属性
-  set-component <文件> <节点路径> <组件类型> <属性名> <值>     修改组件属性
-  add <场景.fire | 预制体.prefab> <父节点路径> <名称>          添加节点
-  add-component <文件> <节点路径> <类型>        给节点添加组件
-  remove-component <文件> <节点路径> <类型>     删除节点组件
-  remove <文件> <节点路径>                      删除节点
-  build <项目目录>                              构建组件映射
-  create-prefab [JSON文件路径] <输出.prefab>    创建预制体（不传JSON则创建默认）
-  create-scene [JSON文件路径] <输出.fire>       创建场景（不传JSON则创建默认）
-  screenshot <json文件> [选项]                  渲染JSON并截图
-
-节点路径格式:
-  Canvas                    - 根节点下的 Canvas
-  Canvas/MidNode            - Canvas 下的 MidNode
-  Canvas/GameScene/NodeA    - 多层嵌套路径
-
-set 支持的节点属性:
-  name          节点名称
-  active        激活状态 (true/false)
-  x             X 坐标
-  y             Y 坐标
-  width         宽度
-  height        高度
-  anchorX       锚点 X (0-1)
-  anchorY       锚点 Y (0-1)
-  opacity       透明度 (0-255)
-  scaleX        X 缩放
-  scaleY        Y 缩放
-  rotation      旋转角度
-
-set-component 示例:
-  cocos2d-cli set-component xxx.fire Canvas/Label Label string "Hello"
-  cocos2d-cli set-component xxx.fire Canvas/Label Label fontSize 32
-  cocos2d-cli set-component xxx.fire Canvas/Sprite Sprite sizeMode 0
-
-add 支持的选项:
-  --x=<数值>             设置 X 坐标
-  --y=<数值>             设置 Y 坐标
-  --width=<数值>         设置宽度
-  --height=<数值>        设置高度
-  --scaleX=<数值>        设置 X 缩放
-  --scaleY=<数值>        设置 Y 缩放
-  --rotation=<角度>      设置旋转角度
-  --active=true/false    设置激活状态
-  --type=sprite/label/button  添加节点时指定组件类型
-  --string=<文字>        Label 文字内容 (配合 --type=label)
-  --fontSize=<数值>      Label 字体大小 (配合 --type=label)
-
-JSON 格式:
-  详见 SKILL.md 完整文档。简要示例：
-  {
-    "name": "Node",
-    "width": 400, "height": 300,
-    "x": 0, "y": 0,
-    "anchorX": 0, "color": "#336699",
-    "components": [
-      { "type": "label", "string": "Hello", "horizontalAlign": "left" },
-      { "type": "richText", "string": "<color=#3cb034>绿色</color>" }
-    ],
-    "children": [...]
-  }
-
-  提示：配合 anchorX + horizontalAlign 实现靠左/靠右布局（见 SKILL.md）
-
-示例:
-  cocos2d-cli tree assets/main.fire
-  cocos2d-cli get assets/main.fire Canvas/MidNode
-  cocos2d-cli get assets/main.fire Canvas/MidNode x
-  cocos2d-cli get assets/main.fire Canvas/MidNode Label
-  cocos2d-cli set assets/main.fire Canvas/MidNode x 100
-  cocos2d-cli set assets/main.fire Canvas/MidNode width 200
-  cocos2d-cli set-component assets/main.fire Canvas/Label Label string "Hello World"
-  cocos2d-cli add assets/main.fire Canvas NewSprite --type=sprite --x=100
-  cocos2d-cli add-component assets/main.fire Canvas/MidNode label
-  cocos2d-cli remove-component assets/main.fire Canvas/MidNode label
-  cocos2d-cli remove assets/main.fire Canvas/MidNode
-
-  # 从 JSON 文件创建场景
-  cocos2d-cli create-scene scene.json assets/scene.fire
-
-  # 从 JSON 文件创建预制体
-  cocos2d-cli create-prefab panel.json assets/panel.prefab
-
-  # 创建默认预制体（不传JSON）
-  cocos2d-cli create-prefab assets/NewNode.prefab
-
-  # 截图
-  cocos2d-cli screenshot data.json
-  cocos2d-cli screenshot data.json -o ./screenshots --width 1080 --height 1920
-`);
-}
-
-// 解析参数
-const args = process.argv.slice(2);
-
-if (args.length === 0 || args[0] === '--help' || args[0] === '-h' || args[0] === 'help') {
-    showHelp();
-    process.exit(0);
-}
-
-const commandName = args[0];
-const commandPath = commands[commandName];
-
-if (!commandPath) {
-    console.error(`未知命令: ${commandName}`);
-    console.error('运行 cocos2d-cli --help 查看可用命令');
-    process.exit(1);
-}
-
-// 加载并执行命令
-try {
-    const command = require(commandPath);
-    command.run(args.slice(1));
-} catch (err) {
-    console.error(`命令执行失败: ${err.message}`);
-    process.exit(1);
-}