squirrelVsis/dist/providers/apiParser.js

"use strict";
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    var desc = Object.getOwnPropertyDescriptor(m, k);
    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
      desc = { enumerable: true, get: function() { return m[k]; } };
    }
    Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
    Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
    o["default"] = v;
});
var __importStar = (this && this.__importStar) || (function () {
    var ownKeys = function(o) {
        ownKeys = Object.getOwnPropertyNames || function (o) {
            var ar = [];
            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
            return ar;
        };
        return ownKeys(o);
    };
    return function (mod) {
        if (mod && mod.__esModule) return mod;
        var result = {};
        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
        __setModuleDefault(result, mod);
        return result;
    };
})();
Object.defineProperty(exports, "__esModule", { value: true });
exports.ApiParser = void 0;
const vscode = __importStar(require("vscode"));
const fs = __importStar(require("fs"));
const path = __importStar(require("path"));
// API文档解析器类
class ApiParser {
    constructor() {
        this.functions = []; // 普通函数，不自动填写第一个参数
        this.functionEx = []; // 扩展函数，自动填写所有参数
        this.classes = [];
        this.constants = [];
        // 获取扩展路径并设置JSON文件路径
        const extensionPath = vscode.extensions.getExtension('local.squirrel-nut-explorer')?.extensionPath || __dirname;
        this.jsonFilePath = path.join(extensionPath, 'api-functions.json');
        this.initializeApiDocumentation();
    }
    // 获取单例实例
    static getInstance() {
        if (!ApiParser.instance) {
            ApiParser.instance = new ApiParser();
        }
        return ApiParser.instance;
    }
    // 初始化API文档
    initializeApiDocumentation() {
        try {
            // 检查JSON文件是否存在
            if (fs.existsSync(this.jsonFilePath)) {
                // 读取JSON文件
                const jsonData = fs.readFileSync(this.jsonFilePath, 'utf8');
                const apiData = JSON.parse(jsonData);
                // 加载函数数据
                this.functions = apiData.functions || [];
                this.functionEx = apiData.functionEx || [];
                // 加载类数据
                this.classes = apiData.classes || [];
                // 加载常量数据
                this.constants = apiData.constants || [];
            }
            else {
                // 如果JSON文件不存在，使用默认数据并创建文件
                this.initializeDefaultApiDocumentation();
                //this.saveApiDocumentation();
            }
        }
        catch (error) {
            console.error('读取API函数JSON文件失败:', error);
            // 如果读取失败，使用默认数据
            this.initializeDefaultApiDocumentation();
        }
    }
    // 初始化默认API文档
    initializeDefaultApiDocumentation() {
        // 初始化内置函数
        this.functions = [
            {
                name: 'print',
                description: '打印消息到控制台',
                params: [
                    {
                        name: 'message',
                        type: 'string',
                        description: '要打印的消息'
                    }
                ],
                returns: {
                    type: 'void',
                    description: '无返回值'
                }
            },
            {
                name: 'len',
                description: '返回字符串、数组或表的长度',
                params: [
                    {
                        name: 'obj',
                        type: 'string|table|array',
                        description: '要计算长度的对象'
                    }
                ],
                returns: {
                    type: 'integer',
                    description: '对象的长度'
                }
            },
            {
                name: 'type',
                description: '返回对象的类型',
                params: [
                    {
                        name: 'obj',
                        type: 'any',
                        description: '要检查类型的对象'
                    }
                ],
                returns: {
                    type: 'string',
                    description: '对象的类型字符串'
                }
            },
            {
                name: 'clone',
                description: '创建对象的浅拷贝',
                params: [
                    {
                        name: 'obj',
                        type: 'any',
                        description: '要克隆的对象'
                    }
                ],
                returns: {
                    type: 'any',
                    description: '克隆的对象'
                }
            },
            {
                name: 'tostring',
                description: '将对象转换为字符串',
                params: [
                    {
                        name: 'obj',
                        type: 'any',
                        description: '要转换的对象'
                    }
                ],
                returns: {
                    type: 'string',
                    description: '转换后的字符串'
                }
            },
            {
                name: 'tointeger',
                description: '将对象转换为整数',
                params: [
                    {
                        name: 'obj',
                        type: 'any',
                        description: '要转换的对象'
                    }
                ],
                returns: {
                    type: 'integer',
                    description: '转换后的整数'
                }
            },
            {
                name: 'tofloat',
                description: '将对象转换为浮点数',
                params: [
                    {
                        name: 'obj',
                        type: 'any',
                        description: '要转换的对象'
                    }
                ],
                returns: {
                    type: 'float',
                    description: '转换后的浮点数'
                }
            }
        ];
        // 初始化内置类
        this.classes = [
            {
                name: 'String',
                description: '字符串类，提供字符串操作方法',
                methods: [
                    {
                        name: 'len',
                        description: '返回字符串长度',
                        params: [],
                        returns: {
                            type: 'integer',
                            description: '字符串的长度'
                        }
                    },
                    {
                        name: 'slice',
                        description: '返回字符串的子串',
                        params: [
                            {
                                name: 'start',
                                type: 'integer',
                                description: '起始位置'
                            },
                            {
                                name: 'end',
                                type: 'integer',
                                description: '结束位置（可选）',
                                optional: true
                            }
                        ],
                        returns: {
                            type: 'string',
                            description: '子串'
                        }
                    },
                    {
                        name: 'find',
                        description: '查找子串在字符串中的位置',
                        params: [
                            {
                                name: 'substr',
                                type: 'string',
                                description: '要查找的子串'
                            }
                        ],
                        returns: {
                            type: 'integer',
                            description: '子串的位置，未找到返回-1'
                        }
                    }
                ],
                properties: [
                    {
                        name: 'length',
                        type: 'integer',
                        description: '字符串的长度'
                    }
                ]
            },
            {
                name: 'Array',
                description: '数组类，提供数组操作方法',
                methods: [
                    {
                        name: 'len',
                        description: '返回数组长度',
                        params: [],
                        returns: {
                            type: 'integer',
                            description: '数组的长度'
                        }
                    },
                    {
                        name: 'append',
                        description: '向数组末尾添加元素',
                        params: [
                            {
                                name: 'value',
                                type: 'any',
                                description: '要添加的元素'
                            }
                        ],
                        returns: {
                            type: 'void',
                            description: '无返回值'
                        }
                    },
                    {
                        name: 'pop',
                        description: '移除并返回数组最后一个元素',
                        params: [],
                        returns: {
                            type: 'any',
                            description: '被移除的元素'
                        }
                    }
                ],
                properties: [
                    {
                        name: 'length',
                        type: 'integer',
                        description: '数组的长度'
                    }
                ]
            },
            {
                name: 'Table',
                description: '表类，提供表操作方法',
                methods: [
                    {
                        name: 'len',
                        description: '返回表中键值对的数量',
                        params: [],
                        returns: {
                            type: 'integer',
                            description: '键值对的数量'
                        }
                    },
                    {
                        name: 'rawget',
                        description: '获取指定键的值',
                        params: [
                            {
                                name: 'key',
                                type: 'any',
                                description: '键'
                            }
                        ],
                        returns: {
                            type: 'any',
                            description: '键对应的值'
                        }
                    },
                    {
                        name: 'rawset',
                        description: '设置指定键的值',
                        params: [
                            {
                                name: 'key',
                                type: 'any',
                                description: '键'
                            },
                            {
                                name: 'value',
                                type: 'any',
                                description: '值'
                            }
                        ],
                        returns: {
                            type: 'void',
                            description: '无返回值'
                        }
                    }
                ],
                properties: []
            }
        ];
        // 初始化常量
        this.constants = [
            {
                name: 'PI',
                value: '3.14159',
                description: '圆周率',
                category: 'math'
            },
            {
                name: 'true',
                value: 'true',
                description: '布尔真值',
                category: 'boolean'
            },
            {
                name: 'false',
                value: 'false',
                description: '布尔假值',
                category: 'boolean'
            },
            {
                name: 'null',
                value: 'null',
                description: '空值',
                category: 'general'
            }
        ];
    }
    // 保存API文档到JSON文件
    saveApiDocumentation() {
        try {
            const apiData = {
                functions: this.functions,
                functionEx: this.functionEx,
                classes: this.classes,
                constants: this.constants
            };
            fs.writeFileSync(this.jsonFilePath, JSON.stringify(apiData, null, 2), 'utf8');
        }
        catch (error) {
            console.error('保存API函数JSON文件失败:', error);
        }
    }
    // 重新加载API文档
    reloadApiDocumentation() {
        this.initializeApiDocumentation();
    }
    // 获取所有普通函数
    getFunctions() {
        return this.functions;
    }
    // 获取所有扩展函数
    getFunctionEx() {
        return this.functionEx;
    }
    // 根据名称获取函数（包括普通函数和扩展函数）
    getFunctionByName(name) {
        // 先在普通函数中查找
        let func = this.functions.find(func => func.name === name);
        if (func) {
            return func;
        }
        // 再在扩展函数中查找
        return this.functionEx.find(func => func.name === name);
    }
    // 检查是否是扩展函数
    isFunctionEx(name) {
        return this.functionEx.some(func => func.name === name);
    }
    // 获取所有类
    getClasses() {
        return this.classes;
    }
    // 根据名称获取类
    getClassByName(name) {
        return this.classes.find(cls => cls.name === name);
    }
    // 获取所有常量
    getConstants() {
        return this.constants;
    }
    // 根据类别获取常量
    getConstantsByCategory(category) {
        return this.constants.filter(constant => constant.category === category);
    }
    // 根据名称获取常量
    getConstantByName(name) {
        return this.constants.find(constant => constant.name === name);
    }
    // 生成函数签名
    generateFunctionSignature(func, isFunctionEx = false) {
        // 检查是否是普通函数且有参数
        if (!isFunctionEx && func.params.length > 0) {
            // 对于普通函数，将第一个参数移到函数名前面
            const firstParam = func.params[0];
            const remainingParams = func.params.slice(1);
            const params = remainingParams.map(param => {
                let paramStr = param.name;
                if (param.optional) {
                    paramStr = `[${paramStr}`;
                    if (param.defaultValue) {
                        paramStr += `=${param.defaultValue}`;
                    }
                    paramStr += ']';
                }
                return paramStr;
            }).join(', ');
            const paramPart = params ? `(${params})` : '()';
            return `function ${firstParam.name}.${func.name}${paramPart}${func.returns ? `: ${func.returns.type}` : ': void'}`;
        }
        else {
            // 对于扩展函数或无参数的函数，保持原有格式
            const params = func.params.map(param => {
                let paramStr = param.name;
                if (param.optional) {
                    paramStr = `[${paramStr}`;
                    if (param.defaultValue) {
                        paramStr += `=${param.defaultValue}`;
                    }
                    paramStr += ']';
                }
                return paramStr;
            }).join(', ');
            return `function ${func.name}(${params})${func.returns ? `: ${func.returns.type}` : ': void'}`;
        }
    }
    // 生成类签名
    generateClassSignature(cls) {
        return `class ${cls.name}`;
    }
    // 生成属性签名
    generatePropertySignature(prop) {
        return `property ${prop.name}: ${prop.type}`;
    }
    // 生成方法签名
    generateMethodSignature(method) {
        const params = method.params.map(param => {
            let paramStr = param.name;
            if (param.optional) {
                paramStr = `[${paramStr}`;
                if (param.defaultValue) {
                    paramStr += `=${param.defaultValue}`;
                }
                paramStr += ']';
            }
            return paramStr;
        }).join(', ');
        return `function ${method.name}(${params})${method.returns ? `: ${method.returns.type}` : ': void'}`;
    }
}
exports.ApiParser = ApiParser;
//# sourceMappingURL=apiParser.js.map