cocos2d-cli 1.6.5 → 2.0.0

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

@@ -1,285 +1,221 @@
-/**
- * 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');
-
-// 默认配置
-const DEFAULT_CONFIG = {
-    jsonPath: null,
-    outputDir: process.cwd(),
-    viewport: { width: 750, height: 1334 },
-    fullPage: true,
-    debugBounds: false,
-    timeout: 30000,
-    waitTime: 1000
-};
-
-// 获取内置资源目录
-function getAssetsDir() {
-    return path.join(__dirname, 'screenshot');
-}
-
-// 创建临时工作目录
-async function createTempWorkDir() {
-    const tempBase = os.tmpdir();
-    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) {
-            logs.push({
-                timestamp: new Date().toISOString(),
-                type: 'warning',
-                text: `Could not copy ${asset}: ${err.message}`
-            });
-        }
-    }
-}
-
-// 静态文件服务器
-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 === '/') {
-                    filePath = path.join(staticDir, 'index.html');
-                }
-                
-                const data = await fs.readFile(filePath);
-                
-                const ext = path.extname(filePath).toLowerCase();
-                const contentTypes = {
-                    '.html': 'text/html',
-                    '.htm': 'text/html',
-                    '.json': 'application/json',
-                    '.js': 'application/javascript',
-                    '.mjs': 'application/javascript',
-                    '.css': 'text/css',
-                    '.png': 'image/png',
-                    '.jpg': 'image/jpeg',
-                    '.jpeg': 'image/jpeg',
-                    '.gif': 'image/gif',
-                    '.svg': 'image/svg+xml',
-                    '.ico': 'image/x-icon',
-                    '.txt': 'text/plain',
-                    '.xml': 'application/xml'
-                };
-                
-                res.writeHead(200, { 
-                    'Content-Type': contentTypes[ext] || 'application/octet-stream',
-                    'Access-Control-Allow-Origin': '*'
-                });
-                res.end(data);
-                
-            } catch (err) {
-                if (err.code === 'ENOENT') {
-                    res.writeHead(404);
-                    res.end();
-                } else {
-                    logs.push({
-                        timestamp: new Date().toISOString(),
-                        type: 'server-error',
-                        text: `${req.url}: ${err.message}`
-                    });
-                    res.writeHead(500);
-                    res.end();
-                }
-            }
-        });
-        
-        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) {
-        if (logs) {
-            logs.push({
-                timestamp: new Date().toISOString(),
-                type: 'warning',
-                text: `Could not remove temp dir: ${err.message}`
-            });
-        }
-    }
-}
-
-/**
- * 截图核心函数
- * @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 = {}) {
-    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(),
-            type,
-            text,
-            ...extra
-        });
-    };
-    
-    try {
-        const timestamp = Date.now();
-        
-        // 检查 JSON 文件是否存在
-        try {
-            await fs.access(config.jsonPath);
-        } 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}`;
-        addLog('info', `Server: ${serverUrl}`);
-
-        // 启动浏览器
-        addLog('info', 'Launching Browser');
-        browser = await chromium.launch({
-            headless: true
-        });
-        addLog('info', 'Browser launched');
-
-        const page = await browser.newPage({
-            viewport: config.viewport
-        });
-
-        // 监听浏览器控制台日志
-        page.on('console', msg => {
-            const text = msg.text();
-            addLog(msg.type(), text);
-        });
-
-        page.on('pageerror', error => {
-            addLog('pageerror', error.message);
-        });
-
-        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`
-            : `${serverUrl}/index.html`;
-        await page.goto(pageUrl, {
-            waitUntil: 'networkidle',
-            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,
-            fullPage: config.fullPage
-        });
-        addLog('info', `Screenshot saved: ${screenshotPath}`);
-        addLog('info', 'Done');
-
-        return { screenshotPath, logs };
-
-    } 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 (_) {}
-        error.logDir = logDir;
-        throw error;
-    } finally {
-        // 清理资源
-        if (browser) await browser.close().catch(() => {});
-        if (server) server.close();
-        if (tempDir) await removeDir(tempDir, logs);
-    }
-}
-
-module.exports = { takeScreenshot };
+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 = {
+    outputDir: process.cwd(),
+    viewport: { width: 750, height: 1334 },
+    fullPage: true,
+    debugBounds: false,
+    timeout: 30000,
+    waitTime: 1000
+};
+function getAssetsDir() {
+    const projectRoot = process.cwd();
+    return path.join(projectRoot, 'src', 'lib', 'screenshot');
+}
+async function createTempWorkDir() {
+    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) {
+            logs.push({
+                timestamp: new Date().toISOString(),
+                type: 'warning',
+                text: `Could not copy ${asset}: ${err.message}`
+            });
+        }
+    }
+}
+async function startServer(staticDir, logs) {
+    return new Promise((resolve, reject) => {
+        const server = http.createServer(async (req, res) => {
+            try {
+                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',
+                    '.htm': 'text/html',
+                    '.json': 'application/json',
+                    '.js': 'application/javascript',
+                    '.mjs': 'application/javascript',
+                    '.css': 'text/css',
+                    '.png': 'image/png',
+                    '.jpg': 'image/jpeg',
+                    '.jpeg': 'image/jpeg',
+                    '.gif': 'image/gif',
+                    '.svg': 'image/svg+xml',
+                    '.ico': 'image/x-icon',
+                    '.txt': 'text/plain',
+                    '.xml': 'application/xml'
+                };
+                res.writeHead(200, {
+                    'Content-Type': contentTypes[ext] || 'application/octet-stream',
+                    'Access-Control-Allow-Origin': '*'
+                });
+                res.end(data);
+            }
+            catch (err) {
+                if (err.code === 'ENOENT') {
+                    res.writeHead(404);
+                    res.end();
+                }
+                else {
+                    logs.push({
+                        timestamp: new Date().toISOString(),
+                        type: 'server-error',
+                        text: `${req.url}: ${err.message}`
+                    });
+                    res.writeHead(500);
+                    res.end();
+                }
+            }
+        });
+        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) {
+        if (logs) {
+            logs.push({
+                timestamp: new Date().toISOString(),
+                type: 'warning',
+                text: `Could not remove temp dir: ${err.message}`
+            });
+        }
+    }
+}
+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(),
+            type,
+            text,
+            ...extra
+        });
+    };
+    try {
+        const timestamp = Date.now();
+        try {
+            await fs.access(config.jsonPath);
+        }
+        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);
+        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`);
+        addLog('info', 'Starting Server');
+        server = await startServer(tempDir, logs);
+        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
+        });
+        addLog('info', 'Browser launched');
+        const page = await browser.newPage({
+            viewport: config.viewport
+        });
+        page.on('console', (msg) => {
+            const text = msg.text();
+            addLog(msg.type(), text);
+        });
+        page.on('pageerror', (error) => {
+            addLog('pageerror', error.message);
+        });
+        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`
+            : `${serverUrl}/index.html`;
+        await page.goto(pageUrl, {
+            waitUntil: 'networkidle',
+            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,
+            fullPage: config.fullPage
+        });
+        addLog('info', `Screenshot saved: ${screenshotPath}`);
+        addLog('info', 'Done');
+        return { screenshotPath, logs };
+    }
+    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 (_) { }
+        error.logDir = logDir;
+        throw error;
+    }
+    finally {
+        if (browser)
+            await browser.close().catch(() => { });
+        if (server)
+            server.close();
+        if (tempDir)
+            await removeDir(tempDir, logs);
+    }
+}

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,17 +1,20 @@
 {
   "name": "cocos2d-cli",
-  "version": "1.6.5",
+  "version": "2.0.0",
   "description": "Command-line tools for AI to read and manipulate Cocos Creator 2.4.x project scenes",
-  "main": "bin/cocos2d-cli.js",
+  "type": "module",
+  "main": "dist/bin/cocos2d-cli.js",
   "bin": {
-    "cocos2d-cli": "bin/cocos2d-cli.js"
+    "cocos2d-cli": "dist/bin/cocos2d-cli.js"
   },
   "files": [
-    "bin",
-    "src",
+    "dist",
     "data"
   ],
   "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "prepare": "npm run build",
     "test": "echo \"No tests specified\" && exit 1"
   },
   "keywords": [
@@ -25,9 +28,13 @@
   "author": "",
   "license": "MIT",
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18.0.0"
   },
   "dependencies": {
     "playwright": "^1.58.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.17",
+    "typescript": "^5.9.3"
   }
 }