cocos2d-cli 1.4.0 → 1.5.1

package/src/lib/cc/CCTrs.js

@@ -0,0 +1,74 @@
+/**
+ * Cocos Creator 变换数据类 (TRS = Translation, Rotation, Scale)
+ * array: [posX, posY, posZ, rotX, rotY, rotZ, rotW, scaleX, scaleY, scaleZ]
+ */
+class CCTrs {
+    constructor() {
+        this.__type__ = 'TypedArray';
+        this.ctor = 'Float64Array';
+        this.array = [0, 0, 0, 0, 0, 0, 1, 1, 1, 1];
+    }
+
+    // Position
+    get x() { return this.array[0]; }
+    set x(v) { this.array[0] = v; }
+
+    get y() { return this.array[1]; }
+    set y(v) { this.array[1] = v; }
+
+    get z() { return this.array[2]; }
+    set z(v) { this.array[2] = v; }
+
+    // Scale
+    get scaleX() { return this.array[7]; }
+    set scaleX(v) { this.array[7] = v; }
+
+    get scaleY() { return this.array[8]; }
+    set scaleY(v) { this.array[8] = v; }
+
+    get scaleZ() { return this.array[9]; }
+    set scaleZ(v) { this.array[9] = v; }
+
+    // Rotation (四元数)
+    get rotX() { return this.array[3]; }
+    set rotX(v) { this.array[3] = v; }
+
+    get rotY() { return this.array[4]; }
+    set rotY(v) { this.array[4] = v; }
+
+    get rotZ() { return this.array[5]; }
+    set rotZ(v) { this.array[5] = v; }
+
+    get rotW() { return this.array[6]; }
+    set rotW(v) { this.array[6] = v; }
+
+    /**
+     * 设置位置
+     */
+    setPosition(x, y, z = 0) {
+        this.array[0] = x;
+        this.array[1] = y;
+        this.array[2] = z;
+        return this;
+    }
+
+    /**
+     * 设置缩放
+     */
+    setScale(x, y = x, z = 1) {
+        this.array[7] = x;
+        this.array[8] = y;
+        this.array[9] = z;
+        return this;
+    }
+
+    toJSON() {
+        return {
+            __type__: this.__type__,
+            ctor: this.ctor,
+            array: [...this.array]
+        };
+    }
+}
+
+module.exports = CCTrs;

package/src/lib/cc/CCVec2.js

@@ -0,0 +1,26 @@
+/**
+ * Cocos Creator 二维向量类
+ */
+class CCVec2 {
+    constructor(x = 0, y = 0) {
+        this.__type__ = 'cc.Vec2';
+        this.x = x;
+        this.y = y;
+    }
+
+    set(x, y) {
+        this.x = x;
+        this.y = y;
+        return this;
+    }
+
+    toJSON() {
+        return {
+            __type__: this.__type__,
+            x: this.x,
+            y: this.y
+        };
+    }
+}
+
+module.exports = CCVec2;

package/src/lib/cc/CCVec3.js

@@ -0,0 +1,29 @@
+/**
+ * Cocos Creator 三维向量类
+ */
+class CCVec3 {
+    constructor(x = 0, y = 0, z = 0) {
+        this.__type__ = 'cc.Vec3';
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+
+    set(x, y, z = 0) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+        return this;
+    }
+
+    toJSON() {
+        return {
+            __type__: this.__type__,
+            x: this.x,
+            y: this.y,
+            z: this.z
+        };
+    }
+}
+
+module.exports = CCVec3;

package/src/lib/cc/CCWidget.js

@@ -0,0 +1,98 @@
+const CCComponent = require('./CCComponent');
+
+/**
+ * Cocos Creator Widget 组件
+ */
+class CCWidget extends CCComponent {
+    constructor() {
+        super();
+        this.__type__ = 'cc.Widget';
+        
+        this.alignMode = 1;
+        this._target = null;
+        this._alignFlags = 45;
+        this._left = 0;
+        this._right = 0;
+        this._top = 0;
+        this._bottom = 0;
+        this._verticalCenter = 0;
+        this._horizontalCenter = 0;
+        this._isAbsLeft = true;
+        this._isAbsRight = true;
+        this._isAbsTop = true;
+        this._isAbsBottom = true;
+        this._isAbsHorizontalCenter = true;
+        this._isAbsVerticalCenter = true;
+        this._originalWidth = 0;
+        this._originalHeight = 0;
+    }
+
+    /**
+     * 设置对齐标志
+     * 45 = 左 + 右 + 上 + 下 (全对齐)
+     */
+    setAlignFlags(flags) {
+        this._alignFlags = flags;
+        return this;
+    }
+
+    /**
+     * 设置边距
+     */
+    setMargins(left, right, top, bottom) {
+        this._left = left;
+        this._right = right;
+        this._top = top;
+        this._bottom = bottom;
+        return this;
+    }
+
+    /**
+     * 转换为属性面板显示格式
+     */
+    toPanelJSON() {
+        return {
+            ...super.toPanelJSON(),
+            top: this._top,
+            bottom: this._bottom,
+            left: this._left,
+            right: this._right,
+            horizontalCenter: this._horizontalCenter,
+            verticalCenter: this._verticalCenter,
+            isAbsLeft: this._isAbsLeft,
+            isAbsRight: this._isAbsRight,
+            isAbsTop: this._isAbsTop,
+            isAbsBottom: this._isAbsBottom
+        };
+    }
+
+    toJSON() {
+        return {
+            __type__: this.__type__,
+            _name: this._name,
+            _objFlags: this._objFlags,
+            node: this.node,
+            _enabled: this._enabled,
+            alignMode: this.alignMode,
+            _target: this._target,
+            _alignFlags: this._alignFlags,
+            _left: this._left,
+            _right: this._right,
+            _top: this._top,
+            _bottom: this._bottom,
+            _verticalCenter: this._verticalCenter,
+            _horizontalCenter: this._horizontalCenter,
+            _isAbsLeft: this._isAbsLeft,
+            _isAbsRight: this._isAbsRight,
+            _isAbsTop: this._isAbsTop,
+            _isAbsBottom: this._isAbsBottom,
+            _isAbsHorizontalCenter: this._isAbsHorizontalCenter,
+            _isAbsVerticalCenter: this._isAbsVerticalCenter,
+            _originalWidth: this._originalWidth,
+            _originalHeight: this._originalHeight,
+            _id: this._id
+        };
+    }
+}
+
+module.exports = CCWidget;

package/src/lib/cc/index.js

@@ -0,0 +1,40 @@
+const CCObject = require('./CCObject');
+const CCNode = require('./CCNode');
+const CCScene = require('./CCScene');
+const CCSceneAsset = require('./CCSceneAsset');
+const { CCPrefab, CCPrefabInfo } = require('./CCPrefab');
+const CCColor = require('./CCColor');
+const CCSize = require('./CCSize');
+const CCVec2 = require('./CCVec2');
+const CCVec3 = require('./CCVec3');
+const CCTrs = require('./CCTrs');
+const CCRect = require('./CCRect');
+const CCComponent = require('./CCComponent');
+const CCCanvas = require('./CCCanvas');
+const CCWidget = require('./CCWidget');
+const CCCamera = require('./CCCamera');
+const CCSprite = require('./CCSprite');
+const CCLabel = require('./CCLabel');
+const CCButton = require('./CCButton');
+
+module.exports = {
+    CCObject,
+    CCNode,
+    CCScene,
+    CCSceneAsset,
+    CCPrefab,
+    CCPrefabInfo,
+    CCColor,
+    CCSize,
+    CCVec2,
+    CCVec3,
+    CCTrs,
+    CCRect,
+    CCComponent,
+    CCCanvas,
+    CCWidget,
+    CCCamera,
+    CCSprite,
+    CCLabel,
+    CCButton
+};

package/src/lib/fire-utils.js

@@ -5,6 +5,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const crypto = require('crypto');
 
 /**
  * 检测是否为预制体文件
@@ -232,7 +233,7 @@ function installPlugin(scenePath) {
             fs.mkdirSync(packagesPath, { recursive: true });
         }
         
-        const cliPluginPath = path.join(__dirname, '..', '..', 'editor-plugin', 'cocos2d-cli-helper');
+        const cliPluginPath = path.join(__dirname, '..', '..', 'editor-plugin');
         
         if (!fs.existsSync(cliPluginPath)) return false;
         
@@ -277,6 +278,72 @@ function getPrefabRootIndex(data) {
     return 1;
 }
 
+/**
+ * 生成 UUID
+ */
+function generateUUID() {
+    return crypto.randomUUID();
+}
+
+/**
+ * 生成预制体的 meta 对象
+ * @param {string} uuid - 可选的 UUID，不传则自动生成
+ * @returns {object}
+ */
+function createPrefabMeta(uuid) {
+    return {
+        ver: '1.3.2',
+        uuid: uuid || generateUUID(),
+        importer: 'prefab',
+        optimizationPolicy: 'AUTO',
+        asyncLoadAssets: false,
+        readonly: false,
+        subMetas: {}
+    };
+}
+
+/**
+ * 生成场景的 meta 对象
+ * @param {string} uuid - 可选的 UUID，不传则自动生成
+ * @returns {object}
+ */
+function createSceneMeta(uuid) {
+    return {
+        ver: '1.3.2',
+        uuid: uuid || generateUUID(),
+        importer: 'scene',
+        asyncLoadAssets: false,
+        autoReleaseAssets: false,
+        subMetas: {}
+    };
+}
+
+/**
+ * 保存 meta 文件
+ * @param {string} filePath - 资源文件路径（.prefab 或 .fire）
+ * @param {object} meta - meta 对象
+ */
+function saveMetaFile(filePath, meta) {
+    const metaPath = filePath + '.meta';
+    fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2), 'utf8');
+    return metaPath;
+}
+
+/**
+ * 加载 meta 文件
+ * @param {string} filePath - 资源文件路径
+ * @returns {object|null}
+ */
+function loadMetaFile(filePath) {
+    const metaPath = filePath + '.meta';
+    try {
+        if (fs.existsSync(metaPath)) {
+            return JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+        }
+    } catch (e) {}
+    return null;
+}
+
 module.exports = {
     // 文件操作
     loadScene,
@@ -293,6 +360,13 @@ module.exports = {
     installPlugin,
     checkPluginStatus,
     
+    // Meta 文件管理
+    generateUUID,
+    createPrefabMeta,
+    createSceneMeta,
+    saveMetaFile,
+    loadMetaFile,
+    
     // 工具函数
     loadScriptMap,
     generateFileId,

package/src/lib/json-parser.js

@@ -0,0 +1,166 @@
+/**
+ * JSON 解析器
+ * 将简化JSON转换为CCNode对象树
+ */
+
+const { CCNode, CCCanvas, CCWidget, CCSprite, CCLabel, CCButton, CCCamera } = require('./cc');
+const { parseColor } = require('./utils');
+
+/**
+ * 创建组件实例
+ */
+function createComponent(type) {
+    switch (type.toLowerCase()) {
+        case 'canvas': return new CCCanvas();
+        case 'widget': return new CCWidget();
+        case 'sprite': return new CCSprite();
+        case 'label': return new CCLabel();
+        case 'button': return new CCButton();
+        case 'camera': return new CCCamera();
+        default: return null;
+    }
+}
+
+/**
+ * 解析组件定义
+ */
+function parseComponent(compDef) {
+    if (typeof compDef === 'string') {
+        return { type: compDef, props: {} };
+    }
+    if (typeof compDef === 'object' && compDef.type) {
+        const props = { ...compDef };
+        delete props.type;
+        return { type: compDef.type, props };
+    }
+    return null;
+}
+
+/**
+ * 应用组件属性
+ */
+function applyComponentProps(comp, props, node) {
+    if (!props) return;
+    
+    for (const [key, value] of Object.entries(props)) {
+        switch (key) {
+            case 'string':
+                if (comp._string !== undefined) {
+                    comp._string = value;
+                    if (comp._N$string !== undefined) comp._N$string = value;
+                }
+                break;
+            case 'fontSize':
+                if (comp._fontSize !== undefined) comp._fontSize = value;
+                break;
+            case 'lineHeight':
+                if (comp._lineHeight !== undefined) comp._lineHeight = value;
+                break;
+            case 'sizeMode':
+                if (comp._sizeMode !== undefined) comp._sizeMode = value;
+                break;
+            case 'color':
+                if (node) {
+                    const parsed = parseColor(value);
+                    if (parsed && node._color) {
+                        node._color.r = parsed.r;
+                        node._color.g = parsed.g;
+                        node._color.b = parsed.b;
+                        node._color.a = parsed.a;
+                    }
+                }
+                break;
+            default:
+                if (comp[key] !== undefined) {
+                    comp[key] = value;
+                }
+        }
+    }
+}
+
+/**
+ * 应用属性到节点
+ */
+function applyNodeProps(node, def) {
+    if (def.name) node._name = def.name;
+    if (def.active !== undefined) node._active = def.active;
+    if (def.opacity !== undefined) node._opacity = def.opacity;
+    if (def.width !== undefined) node._contentSize.width = def.width;
+    if (def.height !== undefined) node._contentSize.height = def.height;
+    if (def.x !== undefined) node._trs.array[0] = def.x;
+    if (def.y !== undefined) node._trs.array[1] = def.y;
+    if (def.rotation !== undefined) {
+        node._trs.array[5] = def.rotation * Math.PI / 180;
+        node._eulerAngles.z = def.rotation;
+    }
+    if (def.scaleX !== undefined) node._trs.array[7] = def.scaleX;
+    if (def.scaleY !== undefined) node._trs.array[8] = def.scaleY;
+    if (def.anchorX !== undefined) node._anchorPoint.x = def.anchorX;
+    if (def.anchorY !== undefined) node._anchorPoint.y = def.anchorY;
+    if (def.color) {
+        const parsed = parseColor(def.color);
+        if (parsed) {
+            node._color.set(parsed.r, parsed.g, parsed.b, parsed.a);
+        }
+    }
+}
+
+/**
+ * 解析节点定义（递归）
+ * @param {Object} def - 节点定义
+ * @returns {CCNode}
+ */
+function parseNode(def) {
+    const node = new CCNode(def.name || 'Node');
+    
+    // 应用属性
+    applyNodeProps(node, def);
+    
+    // 添加组件
+    if (def.components && def.components.length > 0) {
+        node._components = [];
+        for (const compDef of def.components) {
+            const parsed = parseComponent(compDef);
+            if (parsed) {
+                const comp = createComponent(parsed.type);
+                if (comp) {
+                    applyComponentProps(comp, parsed.props, node);
+                    comp.node = node;
+                    node._components.push(comp);
+                }
+            }
+        }
+    }
+    
+    // 递归处理子节点
+    if (def.children && def.children.length > 0) {
+        node._children = [];
+        for (const childDef of def.children) {
+            const child = parseNode(childDef);
+            child._parent = node;
+            node._children.push(child);
+        }
+    }
+    
+    return node;
+}
+
+/**
+ * 从简化JSON解析为CCNode树
+ * @param {Object|string} json - JSON对象或字符串
+ * @returns {CCNode}
+ */
+function fromJSON(json) {
+    if (typeof json === 'string') {
+        json = JSON.parse(json.replace(/^\uFEFF/, '').trim());
+    }
+    
+    const rootDef = Array.isArray(json) ? json[0] : json;
+    return parseNode(rootDef);
+}
+
+module.exports = {
+    fromJSON,
+    parseNode,
+    applyNodeProps
+};

package/src/lib/node-utils.js

@@ -147,9 +147,20 @@ function setNodeProperties(node, options) {
  * @returns {object} 节点状态
  */
 function getNodeState(data, node, nodeIndex) {
-    const { extractComponentProps } = require('./components');
     const trs = node._trs?.array || [0, 0, 0, 0, 0, 0, 1, 1, 1, 1];
-    const components = (node._components || []).map(ref => extractComponentProps(data[ref.__id__]));
+    
+    // 组件使用 toPanelJSON
+    const components = {};
+    if (node._components && node._components.length > 0) {
+        node._components.forEach(ref => {
+            const comp = data[ref.__id__];
+            if (comp && comp.toPanelJSON) {
+                const typeName = comp.__type__.replace('cc.', '');
+                components[typeName] = comp.toPanelJSON();
+            }
+        });
+    }
+    
     const children = (node._children || []).map(ref => data[ref.__id__]?._name || '(unknown)');
 
     const result = {
@@ -166,7 +177,7 @@ function getNodeState(data, node, nodeIndex) {
     };
 
     if (children.length > 0) result.children = children;
-    if (components.length > 0) result.components = components;
+    if (Object.keys(components).length > 0) result.components = components;
 
     return result;
 }
@@ -261,6 +272,31 @@ function deleteNode(data, nodeIndex, rebuildReferences) {
     };
 }
 
+/**
+ * 构建组件信息字符串
+ */
+function buildComponentInfo(data, node, scriptMap, uuidRegex) {
+    if (!node._components || node._components.length === 0) return '';
+    
+    const comps = node._components.map(c => {
+        const comp = data[c.__id__];
+        if (!comp) return '?';
+        const typeName = comp.__type__;
+        let displayName;
+        if (uuidRegex.test(typeName)) {
+            const scriptInfo = scriptMap[typeName];
+            displayName = (scriptInfo && scriptInfo.name) ? scriptInfo.name : '[MissingScript]';
+        } else if (typeName === 'MissingScript') {
+            displayName = '[MissingScript]';
+        } else {
+            displayName = typeName.replace('cc.', '');
+        }
+        return displayName;
+    }).join(', ');
+    
+    return ` (${comps})`;
+}
+
 /**
  * 构建节点树输出
  * @param {Array} data - 场景数据
@@ -276,46 +312,46 @@ function buildTree(data, scriptMap, nodeIndex, prefix = '', isLast = true, isRoo
     if (!node) return '';
     
     const isSceneRoot = node.__type__ === 'cc.Scene';
-    const nodeName = isRoot ? 'Root' : (node._name || '(unnamed)');
+    const isPrefabRoot = node.__type__ === 'cc.Prefab';
+    const nodeName = node._name || '(unnamed)';
     const active = node._active !== false ? '●' : '○';
     const uuidRegex = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i;
     
     let result = '';
     
     if (isSceneRoot) {
-        result = prefix + '[Scene]\n';
-    } else {
-        result = prefix + (isRoot ? '' : active + ' ') + nodeName + ' #' + nodeIndex;
+        result = '[Scene]\n';
+    } else if (isPrefabRoot) {
+        // 预制体直接显示根节点
+        const prefabNode = data[1];
+        if (!prefabNode) return '';
         
-        // 添加组件信息
-        if (node._components && node._components.length > 0) {
-            const comps = node._components.map(c => {
-                const comp = data[c.__id__];
-                if (!comp) return `? #${c.__id__}`;
-                const typeName = comp.__type__;
-                let displayName;
-                if (uuidRegex.test(typeName)) {
-                    const scriptInfo = scriptMap[typeName];
-                    displayName = (scriptInfo && scriptInfo.name) ? scriptInfo.name : '[MissingScript]';
-                } else if (typeName === 'MissingScript') {
-                    displayName = '[MissingScript]';
-                } else {
-                    displayName = typeName.replace('cc.', '');
-                }
-                return `${displayName} #${c.__id__}`;
-            }).join(', ');
-            result += ` (${comps})`;
-        }
+        const prefabActive = prefabNode._active !== false ? '●' : '○';
+        result = prefabActive + ' ' + (prefabNode._name || 'Root');
+        result += buildComponentInfo(data, prefabNode, scriptMap, uuidRegex);
+        result += '\n';
         
+        // 处理子节点
+        if (prefabNode._children && prefabNode._children.length > 0) {
+            prefabNode._children.forEach((childRef, idx) => {
+                const childIsLast = idx === prefabNode._children.length - 1;
+                result += buildTree(data, scriptMap, childRef.__id__, '', childIsLast, false);
+            });
+        }
+        return result;
+    } else {
+        const connector = isRoot ? '' : (isLast ? '└── ' : '├── ');
+        result = prefix + connector + (isRoot ? '' : active + ' ') + nodeName;
+        result += buildComponentInfo(data, node, scriptMap, uuidRegex);
         result += '\n';
     }
     
     // 处理子节点
     if (node._children && node._children.length > 0) {
+        const childPrefix = prefix + (isSceneRoot ? '' : (isRoot ? '' : (isLast ? '    ' : '│   ')));
         node._children.forEach((childRef, idx) => {
             const childIsLast = idx === node._children.length - 1;
-            const childPrefix = prefix + (isSceneRoot ? '' : (isRoot ? '' : (isLast ? '    ' : '│   ')));
-            result += buildTree(data, scriptMap, childRef.__id__, childPrefix, childIsLast, isSceneRoot);
+            result += buildTree(data, scriptMap, childRef.__id__, childPrefix, childIsLast, false);
         });
     }