dolphindb 3.0.32 → 3.0.33

package/docs.js

@@ -0,0 +1,191 @@
+import { fread_json } from 'xshell';
+import { constants, keywords } from './language.js';
+function is_completion_match(target, search) {
+    let j = 0;
+    for (const c of search) {
+        j = target.indexOf(c, j) + 1;
+        if (!j)
+            return false;
+    }
+    return true;
+}
+export class DocsAnalyser {
+    /** 文档原始信息 */
+    docs;
+    /** 函数名列表 */
+    funcs = [];
+    /** 转化成小写字母的函数名列表 */
+    lower_funcs = [];
+    update_docs(docs) {
+        this.docs = docs;
+        this.funcs = Object.keys(docs);
+        this.lower_funcs = this.funcs.map(func => func.toLowerCase());
+    }
+    async load_docs_async(provider) {
+        let docs;
+        if (typeof provider === 'function')
+            docs = await provider();
+        else if (typeof provider === 'string')
+            docs = await fread_json(provider);
+        else
+            throw new Error('Invalid docs provider');
+        this.update_docs(docs);
+    }
+    get_function_markdown(name) {
+        return this.docs[name]?.markdown;
+    }
+    get_signatures(name) {
+        return this.docs[name]?.signatures;
+    }
+    /** 查询补全项（包括关键字、常量和函数）
+        @param query
+        @returns  */
+    search_completion_items(query) {
+        const query_lower = query.toLowerCase();
+        return {
+            keywords: keywords.filter(keyword => keyword.startsWith(query)),
+            constants: constants.filter(constant => is_completion_match(constant, query_lower)),
+            functions: this.funcs.filter((func, i) => is_completion_match(this.lower_funcs[i], query_lower)),
+        };
+    }
+}
+const FUNC_NAME_CHAR_REG_EXP = /[a-zA-Z0-9!_]/;
+function reverse_search_func(text) {
+    let depth = 0;
+    let param_start_at = -1;
+    for (let i = text.length; i >= 0; i--) {
+        const char = text[i];
+        // 遇到右括号，入栈
+        if (char === ')') {
+            depth++;
+            continue;
+        }
+        // 遇到左括号，出栈
+        else if (char === '(') {
+            depth--;
+            continue;
+        }
+        // 栈深度小于0，且遇到合法函数名字符，跳出括号语境，搜索结束：参数搜索开始位置
+        if (FUNC_NAME_CHAR_REG_EXP.test(char) && depth < 0) {
+            param_start_at = i;
+            break;
+        }
+    }
+    // 找不到参数搜索开始位置，返回null
+    if (param_start_at === -1)
+        return null;
+    // 往前找函数名
+    let func_name_end = -1;
+    let func_name_start = 0;
+    for (let i = param_start_at; i >= 0; i--) {
+        const char = text[i];
+        // 空字符跳过
+        if (func_name_end === -1 && char === ' ')
+            continue;
+        // 合法函数名字字符，继续往前找
+        if (FUNC_NAME_CHAR_REG_EXP.test(char)) {
+            // 标记函数名字末尾位置
+            if (func_name_end === -1)
+                func_name_end = i;
+            continue;
+        }
+        // 不合法函数名字符，标记函数名字开头位置
+        func_name_start = i + 1;
+        break;
+    }
+    // 找不到函数名
+    if (func_name_end === -1)
+        return null;
+    return {
+        param_start_at: param_start_at + 1,
+        func_name: text.slice(func_name_start, func_name_end + 1),
+    };
+}
+// 栈 token 匹配表
+const PAIR_TOKEN_MAP = {
+    ')': '(',
+    '}': '{',
+    ']': '[',
+};
+const PAIR_START_TOKENS = new Set(Object.values(PAIR_TOKEN_MAP));
+const LAST_IDENTIFIER_NAME_REGEXP = /[a-zA-Z_\u4e00-\u9fa5][\w\u4e00-\u9fa5]*!?$/;
+/** 根据函数参数开始位置分析参数语义，提取出当前参数索引 */
+function find_active_param_index(text, param_start_at) {
+    let index = 0;
+    const stack = [];
+    let commas_count = 0;
+    // 是否在转义符作用范围内
+    let is_escaping_string = false;
+    // 搜索
+    for (let i = param_start_at; i < text.length; i++) {
+        const char = text[i];
+        // 空字符跳过
+        if (/\s/.test(char))
+            continue;
+        // 转义符作用范围下一个字符直接忽略
+        if (is_escaping_string) {
+            is_escaping_string = false;
+            continue;
+        }
+        const last_stack = stack[stack.length - 1];
+        // 字符串内除引号全部忽略
+        if (last_stack === '"' || last_stack === "'") {
+            // 进入转义符作用范围
+            if (char === '\\') {
+                is_escaping_string = true;
+                continue;
+            }
+            // 遇到相同引号
+            if (char === last_stack)
+                stack.pop();
+            continue;
+        }
+        // 开括号入栈
+        if (PAIR_START_TOKENS.has(char) || char === '"' || char === "'") {
+            stack.push(char);
+            continue;
+        }
+        else if (char in PAIR_TOKEN_MAP)
+            if (last_stack === PAIR_TOKEN_MAP[char]) {
+                // 括号匹配，出栈
+                stack.pop();
+                continue;
+            }
+            else
+                return -1;
+        // 栈深度为1 且为左小括号：当前语境
+        if (stack.length === 1 && stack[0] === '(' && char === ',')
+            commas_count++;
+        // 根据逗号数量判断高亮参数索引值
+        index = commas_count;
+    }
+    const caller = text.slice(0, param_start_at);
+    /** 匹配当前函数名的正则, 并捕获该函数名 */
+    const match = LAST_IDENTIFIER_NAME_REGEXP.exec(caller);
+    const is_member_call = match && caller[param_start_at - 1 /* 去掉括号 */ - match[0].length] === '.';
+    // 是否为对象方法调用，若是，参数索引+1（对象会变成第一个参数）
+    return is_member_call ? index + 1 : index;
+}
+export function parse_signature_help_from_text(text, docsAnalyser) {
+    const caller = reverse_search_func(text);
+    if (!caller)
+        return;
+    const { func_name, param_start_at } = caller;
+    const cursor_param_index = find_active_param_index(text, param_start_at);
+    if (cursor_param_index === -1)
+        return;
+    const signatures = docsAnalyser.get_signatures(func_name);
+    if (!signatures)
+        return;
+    const signature = signatures[0];
+    const params_length = signature.parameters.length;
+    // 如果输入参数数量超出了签名内声明的参数数量，active_parameter 为 undefined
+    const active_parameter = cursor_param_index > params_length - 1 ? undefined : cursor_param_index;
+    const documentation_md = docsAnalyser.get_function_markdown(func_name);
+    return {
+        signature,
+        active_parameter,
+        documentation_md,
+    };
+}
+//# sourceMappingURL=docs.js.map

package/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["docs.ts"],"names":[],"mappings":"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","sourcesContent":["import { fread_json } from 'xshell'\n\nimport { constants, keywords } from './language.js'\n\n\nexport interface FunctionSignature {\n    full: string\n    name: string\n    parameters: {\n        full: string\n        name: string\n        optional?: boolean\n        default?: string\n    }[]\n}\n\nexport interface FunctionItem {\n    /** 文档的公网链接 */\n    href: string\n    /** 部分函数存在多个签名，例如 append! 和 x.append!, eachPre 和 func:P 这两组，最好在分析阶段就处理好 */\n    signatures: FunctionSignature[] | null\n    /** 文档内容 */\n    markdown: string\n}\n\ntype Docs = Record<string, FunctionItem>\n\nfunction is_completion_match (target: string, search: string) {\n    let j = 0\n    for (const c of search) {\n        j = target.indexOf(c, j) + 1\n        if (!j)\n            return false\n    }\n    \n    return true\n}\n\nexport class DocsAnalyser {\n    /** 文档原始信息 */\n    docs?: Docs\n    \n    /** 函数名列表 */\n    funcs: string[] = [ ]\n    \n    /** 转化成小写字母的函数名列表 */\n    lower_funcs: string[] = [ ]\n    \n    \n    update_docs (docs: Docs) {\n        this.docs = docs\n        this.funcs = Object.keys(docs)\n        this.lower_funcs = this.funcs.map(func => func.toLowerCase())\n    }\n    \n    \n    async load_docs_async (provider: string | (() => Promise<Docs>)) {\n        let docs: Docs\n        if (typeof provider === 'function')\n            docs = await provider()\n        else if (typeof provider === 'string')\n            docs = await fread_json(provider)\n        else\n            throw new Error('Invalid docs provider')\n        \n        this.update_docs(docs)\n    }\n    \n    \n    get_function_markdown (name: string) {\n        return this.docs[name]?.markdown\n    }\n    \n    \n    get_signatures (name: string) {\n        return this.docs[name]?.signatures\n    }\n    \n    \n    /** 查询补全项（包括关键字、常量和函数）\n        @param query\n        @returns  */\n    search_completion_items (query: string) {\n        const query_lower = query.toLowerCase()\n        \n        return {\n            keywords: keywords.filter(keyword => keyword.startsWith(query)),\n            constants: constants.filter(constant => is_completion_match(constant, query_lower)),\n            functions: this.funcs.filter((func, i) => is_completion_match(this.lower_funcs[i], query_lower)),\n        }\n    }\n}\n\n\nconst FUNC_NAME_CHAR_REG_EXP = /[a-zA-Z0-9!_]/\n\nfunction reverse_search_func (text: string): null | {\n    param_start_at: number\n    func_name: string\n} {\n    let depth = 0\n    let param_start_at = -1\n    \n    for (let i = text.length;  i >= 0;  i--) {\n        const char = text[i]\n        \n        // 遇到右括号，入栈\n        if (char === ')') {\n            depth++\n            continue\n        }\n        // 遇到左括号，出栈\n        else if (char === '(') {\n            depth--\n            continue\n        }\n        \n        // 栈深度小于0，且遇到合法函数名字符，跳出括号语境，搜索结束：参数搜索开始位置\n        if (FUNC_NAME_CHAR_REG_EXP.test(char) && depth < 0) {\n            param_start_at = i\n            break\n        }\n    }\n    \n    // 找不到参数搜索开始位置，返回null\n    if (param_start_at === -1)\n        return null\n        \n        \n    // 往前找函数名\n    let func_name_end = -1\n    let func_name_start = 0\n    for (let i = param_start_at;  i >= 0;  i--) {\n        const char = text[i]\n        \n        // 空字符跳过\n        if (func_name_end === -1 && char === ' ')\n            continue\n        \n        // 合法函数名字字符，继续往前找\n        if (FUNC_NAME_CHAR_REG_EXP.test(char)) {\n            // 标记函数名字末尾位置\n            if (func_name_end === -1)\n                func_name_end = i\n                \n            continue\n        }\n        \n        // 不合法函数名字符，标记函数名字开头位置\n        func_name_start = i + 1\n        break\n    }\n    \n    // 找不到函数名\n    if (func_name_end === -1)\n        return null\n        \n        \n    return {\n        param_start_at: param_start_at + 1,\n        func_name: text.slice(func_name_start, func_name_end + 1),\n    }\n}\n\n\n// 栈 token 匹配表\nconst PAIR_TOKEN_MAP: Record<string, string> = {\n    ')': '(',\n    '}': '{',\n    ']': '[',\n}\n\nconst PAIR_START_TOKENS = new Set(Object.values(PAIR_TOKEN_MAP))\n\nconst LAST_IDENTIFIER_NAME_REGEXP = /[a-zA-Z_\\u4e00-\\u9fa5][\\w\\u4e00-\\u9fa5]*!?$/\n\n\n/** 根据函数参数开始位置分析参数语义，提取出当前参数索引 */\nfunction find_active_param_index (text: string, param_start_at: number) {\n    let index = 0\n    const stack = [ ]\n    \n    let commas_count = 0\n    \n    // 是否在转义符作用范围内\n    let is_escaping_string = false\n    \n    // 搜索\n    for (let i = param_start_at;  i < text.length;  i++) {\n        const char = text[i]\n        \n        // 空字符跳过\n        if (/\\s/.test(char))\n            continue\n        \n        // 转义符作用范围下一个字符直接忽略\n        if (is_escaping_string) {\n            is_escaping_string = false\n            continue\n        }\n        \n        const last_stack = stack[stack.length - 1]\n        // 字符串内除引号全部忽略\n        if (last_stack === '\"' || last_stack === \"'\") {\n            // 进入转义符作用范围\n            if (char === '\\\\') {\n                is_escaping_string = true\n                continue\n            }\n            \n            // 遇到相同引号\n            if (char === last_stack)\n                stack.pop()\n            \n            \n            continue\n        }\n        \n        // 开括号入栈\n        if (PAIR_START_TOKENS.has(char) || char === '\"' || char === \"'\") {\n            stack.push(char)\n            continue\n        } else if (char in PAIR_TOKEN_MAP)\n            if (last_stack === PAIR_TOKEN_MAP[char]) {\n                // 括号匹配，出栈\n                stack.pop()\n                continue\n            } else\n                return -1\n        \n        \n        \n        // 栈深度为1 且为左小括号：当前语境\n        if (stack.length === 1 && stack[0] === '(' && char === ',')\n            commas_count++\n        \n        \n        // 根据逗号数量判断高亮参数索引值\n        index = commas_count\n    }\n    \n    const caller = text.slice(0, param_start_at)\n    /** 匹配当前函数名的正则, 并捕获该函数名 */\n    const match = LAST_IDENTIFIER_NAME_REGEXP.exec(caller)\n    \n    const is_member_call = match && caller[param_start_at - 1 /* 去掉括号 */ - match[0].length] === '.'\n    \n    // 是否为对象方法调用，若是，参数索引+1（对象会变成第一个参数）\n    return is_member_call ? index + 1 : index\n}\n\n\nexport function parse_signature_help_from_text (text: string, docsAnalyser: DocsAnalyser) {\n    const caller = reverse_search_func(text)\n    if (!caller)\n        return\n    const { func_name, param_start_at } = caller\n    \n    const cursor_param_index = find_active_param_index(text, param_start_at)\n    if (cursor_param_index === -1)\n        return\n    const signatures = docsAnalyser.get_signatures(func_name)\n    if (!signatures)\n        return\n    const signature = signatures[0]\n    const params_length = signature.parameters.length\n    // 如果输入参数数量超出了签名内声明的参数数量，active_parameter 为 undefined\n    const active_parameter = cursor_param_index > params_length - 1 ? undefined : cursor_param_index\n    const documentation_md = docsAnalyser.get_function_markdown(func_name)\n    \n    return {\n        signature,\n        active_parameter,\n        documentation_md,\n    }\n}\n\n"]}