@visactor/vtable-sheet 1.20.0-alpha.0

package/cjs/formula/formula-autocomplete.d.ts

@@ -0,0 +1,39 @@
+import type VTableSheet from '../components/vtable-sheet';
+interface AutocompleteItem {
+    type: 'function' | 'cell' | 'range';
+    value: string;
+    label: string;
+    description?: string;
+    signature?: string;
+}
+export declare class FormulaAutocomplete {
+    private container;
+    private dropdown;
+    private items;
+    private selectedIndex;
+    private isVisible;
+    private inputElement;
+    private sheet;
+    private onSelectCallback?;
+    private customPositioning?;
+    constructor(container: HTMLElement, sheet: VTableSheet);
+    private createDropdown;
+    attachTo(input: HTMLInputElement, onSelect?: (item: AutocompleteItem) => void, customPositioning?: () => void): void;
+    private handleInput;
+    private parseInputContext;
+    private updateSuggestions;
+    private generateCellSuggestions;
+    private getFunctionDescription;
+    private getFunctionSignature;
+    private renderDropdown;
+    private groupItems;
+    private getGroupTitle;
+    private getTypeLabel;
+    private positionDropdown;
+    private handleKeydown;
+    private selectItem;
+    private show;
+    private hide;
+    release(): void;
+}
+export {};

package/cjs/formula/formula-autocomplete.js

@@ -0,0 +1,239 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.FormulaAutocomplete = void 0;
+
+class FormulaAutocomplete {
+    constructor(container, sheet) {
+        this.dropdown = null, this.items = [], this.selectedIndex = -1, this.isVisible = !1, 
+        this.inputElement = null, this.container = container, this.sheet = sheet, this.createDropdown();
+    }
+    createDropdown() {
+        this.dropdown = document.createElement("div"), this.dropdown.className = "vtable-formula-autocomplete", 
+        this.dropdown.style.display = "none", this.container.appendChild(this.dropdown);
+    }
+    attachTo(input, onSelect, customPositioning) {
+        this.inputElement = input, this.onSelectCallback = onSelect, this.customPositioning = customPositioning, 
+        input.addEventListener("input", this.handleInput.bind(this)), input.addEventListener("keydown", this.handleKeydown.bind(this)), 
+        input.addEventListener("blur", (() => {
+            setTimeout((() => this.hide()), 200);
+        }));
+    }
+    handleInput(event) {
+        const input = event.target, value = input.value, cursorPos = input.selectionStart || 0, context = this.parseInputContext(value, cursorPos);
+        context.shouldShowAutocomplete ? (this.updateSuggestions(context), this.show()) : this.hide();
+    }
+    parseInputContext(value, cursorPos) {
+        if (!value.startsWith("=")) return {
+            shouldShowAutocomplete: !1,
+            searchTerm: "",
+            type: "all",
+            insertPosition: 0
+        };
+        const textBeforeCursor = value.substring(1, cursorPos), lastOperatorMatch = textBeforeCursor.match(/[\+\-\*\/\(\,\s]([A-Za-z0-9]*)$/);
+        return lastOperatorMatch && "" !== lastOperatorMatch[1] ? {
+            shouldShowAutocomplete: !0,
+            searchTerm: lastOperatorMatch[1],
+            type: /^[A-Za-z]/.test(lastOperatorMatch[1]) ? "function" : "cell",
+            insertPosition: cursorPos - lastOperatorMatch[1].length
+        } : textBeforeCursor.match(/^[A-Za-z0-9]*$/) ? {
+            shouldShowAutocomplete: !0,
+            searchTerm: textBeforeCursor,
+            type: "all",
+            insertPosition: 1
+        } : {
+            shouldShowAutocomplete: !1,
+            searchTerm: "",
+            type: "all",
+            insertPosition: 0
+        };
+    }
+    updateSuggestions(context) {
+        const {searchTerm: searchTerm, type: type} = context;
+        if (this.items = [], "function" === type || "all" === type) {
+            const functionItems = this.sheet.formulaManager.getAvailableFunctions().filter((fn => fn.toUpperCase().startsWith(searchTerm.toUpperCase()))).slice(0, 10).map((fn => ({
+                type: "function",
+                value: fn,
+                label: fn,
+                description: this.getFunctionDescription(fn),
+                signature: this.getFunctionSignature(fn)
+            })));
+            this.items.push(...functionItems);
+        }
+        if ("cell" === type || "all" === type) {
+            const cellSuggestions = this.generateCellSuggestions(searchTerm);
+            this.items.push(...cellSuggestions);
+        }
+        this.renderDropdown();
+    }
+    generateCellSuggestions(searchTerm) {
+        const suggestions = [], cellMatch = searchTerm.match(/^([A-Za-z]*)([0-9]*)$/);
+        if (cellMatch) {
+            const [, colPart, rowPart] = cellMatch;
+            if (colPart && !rowPart) for (let row = 1; row <= 5; row++) suggestions.push({
+                type: "cell",
+                value: `${colPart.toUpperCase()}${row}`,
+                label: `${colPart.toUpperCase()}${row}`,
+                description: "单元格引用"
+            });
+            if (colPart && rowPart) {
+                const address = `${colPart.toUpperCase()}${rowPart}`;
+                suggestions.push({
+                    type: "cell",
+                    value: address,
+                    label: address,
+                    description: "单元格引用"
+                }), suggestions.push({
+                    type: "range",
+                    value: `${address}:`,
+                    label: `${address}:...`,
+                    description: "开始选择范围"
+                });
+            }
+        }
+        return suggestions.slice(0, 5);
+    }
+    getFunctionDescription(functionName) {
+        return {
+            SUM: "计算数值总和",
+            AVERAGE: "计算平均值",
+            COUNT: "计数数值单元格",
+            MAX: "返回最大值",
+            MIN: "返回最小值",
+            IF: "条件判断",
+            VLOOKUP: "垂直查找",
+            CONCATENATE: "连接文本"
+        }[functionName] || "";
+    }
+    getFunctionSignature(functionName) {
+        return {
+            SUM: "(number1, [number2], ...)",
+            AVERAGE: "(number1, [number2], ...)",
+            COUNT: "(value1, [value2], ...)",
+            MAX: "(number1, [number2], ...)",
+            MIN: "(number1, [number2], ...)",
+            IF: "(logical_test, value_if_true, value_if_false)",
+            VLOOKUP: "(lookup_value, table_array, col_index_num, [range_lookup])",
+            CONCATENATE: "(text1, [text2], ...)"
+        }[functionName] || "()";
+    }
+    renderDropdown() {
+        if (!this.dropdown) return;
+        if (this.dropdown.innerHTML = "", 0 === this.items.length) {
+            const emptyEl = document.createElement("div");
+            return emptyEl.className = "vtable-formula-autocomplete-empty", emptyEl.textContent = "没有匹配的函数", 
+            void this.dropdown.appendChild(emptyEl);
+        }
+        const groups = this.groupItems(this.items);
+        groups.forEach((group => {
+            if (groups.length > 1) {
+                const groupEl = document.createElement("div");
+                groupEl.className = "vtable-formula-autocomplete-group", groupEl.textContent = this.getGroupTitle(group.type), 
+                this.dropdown.appendChild(groupEl);
+            }
+            group.items.forEach(((item, index) => {
+                const globalIndex = this.items.indexOf(item), itemEl = document.createElement("div");
+                itemEl.className = "vtable-formula-autocomplete-item", globalIndex === this.selectedIndex && itemEl.classList.add("selected");
+                const nameEl = document.createElement("div");
+                nameEl.className = "item-name";
+                const labelEl = document.createElement("span");
+                labelEl.textContent = item.label, nameEl.appendChild(labelEl);
+                const typeEl = document.createElement("span");
+                if (typeEl.className = `item-type ${item.type}`, typeEl.textContent = this.getTypeLabel(item.type), 
+                nameEl.appendChild(typeEl), itemEl.appendChild(nameEl), item.signature) {
+                    const signatureEl = document.createElement("div");
+                    signatureEl.className = "item-signature", signatureEl.textContent = item.signature, 
+                    itemEl.appendChild(signatureEl);
+                }
+                if (item.description) {
+                    const descEl = document.createElement("div");
+                    descEl.className = "item-description", descEl.textContent = item.description, itemEl.appendChild(descEl);
+                }
+                itemEl.addEventListener("click", (() => this.selectItem(globalIndex))), itemEl.addEventListener("mouseenter", (() => {
+                    this.selectedIndex = globalIndex, this.renderDropdown();
+                })), this.dropdown.appendChild(itemEl);
+            }));
+        }));
+        const footerEl = document.createElement("div");
+        footerEl.className = "vtable-formula-autocomplete-footer", footerEl.innerHTML = '\n    <div class="shortcut">\n      <span class="key">↑↓</span>\n      <span>选择</span>\n    </div>\n    <div class="shortcut">\n      <span class="key">Enter</span>\n      <span>确认</span>\n    </div>\n    <div class="shortcut">\n      <span class="key">Esc</span>\n      <span>取消</span>\n    </div>\n  ', 
+        this.dropdown.appendChild(footerEl), this.positionDropdown();
+    }
+    groupItems(items) {
+        const groups = {};
+        items.forEach((item => {
+            groups[item.type] || (groups[item.type] = []), groups[item.type].push(item);
+        }));
+        return [ "function", "cell", "range" ].filter((type => groups[type])).map((type => ({
+            type: type,
+            items: groups[type]
+        })));
+    }
+    getGroupTitle(type) {
+        return {
+            function: "函数",
+            cell: "单元格",
+            range: "范围"
+        }[type] || type;
+    }
+    getTypeLabel(type) {
+        return {
+            function: "fx",
+            cell: "A1",
+            range: "A:B"
+        }[type] || type;
+    }
+    positionDropdown() {
+        if (this.customPositioning) return void this.customPositioning();
+        if (!this.dropdown || !this.inputElement) return;
+        const inputRect = this.inputElement.getBoundingClientRect(), containerRect = this.container.getBoundingClientRect();
+        this.dropdown.style.position = "absolute", this.dropdown.style.left = inputRect.left - containerRect.left + "px", 
+        this.dropdown.style.top = inputRect.bottom - containerRect.top + 2 + "px", this.dropdown.style.width = `${Math.max(300, inputRect.width)}px`;
+    }
+    handleKeydown(event) {
+        if (this.isVisible) switch (event.key) {
+          case "ArrowDown":
+            event.preventDefault(), this.selectedIndex = Math.min(this.selectedIndex + 1, this.items.length - 1), 
+            this.renderDropdown();
+            break;
+
+          case "ArrowUp":
+            event.preventDefault(), this.selectedIndex = Math.max(this.selectedIndex - 1, 0), 
+            this.renderDropdown();
+            break;
+
+          case "Enter":
+          case "Tab":
+            this.selectedIndex >= 0 && (event.preventDefault(), this.selectItem(this.selectedIndex));
+            break;
+
+          case "Escape":
+            this.hide();
+        }
+    }
+    selectItem(index) {
+        const item = this.items[index];
+        if (item && this.inputElement) {
+            if (this.onSelectCallback) this.onSelectCallback(item); else {
+                const value = this.inputElement.value, cursorPos = this.inputElement.selectionStart || 0, context = this.parseInputContext(value, cursorPos), newValue = value.substring(0, context.insertPosition) + item.value + ("function" === item.type ? "(" : "") + value.substring(cursorPos);
+                this.inputElement.value = newValue;
+                const newCursorPos = context.insertPosition + item.value.length + ("function" === item.type ? 1 : 0);
+                this.inputElement.setSelectionRange(newCursorPos, newCursorPos);
+            }
+            this.hide();
+        }
+    }
+    show() {
+        this.dropdown && this.items.length > 0 && (this.dropdown.style.display = "block", 
+        this.isVisible = !0, this.selectedIndex = 0, this.renderDropdown());
+    }
+    hide() {
+        this.dropdown && (this.dropdown.style.display = "none", this.isVisible = !1, this.selectedIndex = -1);
+    }
+    release() {
+        this.dropdown && this.dropdown.parentNode && this.dropdown.parentNode.removeChild(this.dropdown);
+    }
+}
+
+exports.FormulaAutocomplete = FormulaAutocomplete;
+//# sourceMappingURL=formula-autocomplete.js.map

package/cjs/formula/formula-autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/formula/formula-autocomplete.ts"],"names":[],"mappings":"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","file":"formula-autocomplete.js","sourcesContent":["import type VTableSheet from '../components/vtable-sheet';\n\ninterface AutocompleteItem {\n  type: 'function' | 'cell' | 'range';\n  value: string;\n  label: string;\n  description?: string;\n  signature?: string;\n}\n\nexport class FormulaAutocomplete {\n  private container: HTMLElement;\n  private dropdown: HTMLElement | null = null;\n  private items: AutocompleteItem[] = [];\n  private selectedIndex: number = -1;\n  private isVisible: boolean = false;\n  private inputElement: HTMLInputElement | null = null;\n  private sheet: VTableSheet;\n  private onSelectCallback?: (item: AutocompleteItem) => void;\n\n  private customPositioning?: () => void;\n\n  constructor(container: HTMLElement, sheet: VTableSheet) {\n    this.container = container;\n    this.sheet = sheet;\n    this.createDropdown();\n  }\n\n  /**\n   * 创建下拉框元素\n   */\n  private createDropdown(): void {\n    this.dropdown = document.createElement('div');\n    this.dropdown.className = 'vtable-formula-autocomplete';\n    this.dropdown.style.display = 'none';\n    this.container.appendChild(this.dropdown);\n  }\n\n  /**\n   * 绑定到输入框\n   */\n  attachTo(input: HTMLInputElement, onSelect?: (item: AutocompleteItem) => void, customPositioning?: () => void): void {\n    this.inputElement = input;\n    this.onSelectCallback = onSelect;\n    this.customPositioning = customPositioning;\n\n    // 绑定事件\n    input.addEventListener('input', this.handleInput.bind(this));\n    input.addEventListener('keydown', this.handleKeydown.bind(this));\n    input.addEventListener('blur', () => {\n      setTimeout(() => this.hide(), 200);\n    });\n  }\n\n  /**\n   * 处理输入事件\n   */\n  private handleInput(event: Event): void {\n    const input = event.target as HTMLInputElement;\n    const value = input.value;\n    const cursorPos = input.selectionStart || 0;\n\n    // 解析当前输入上下文\n    const context = this.parseInputContext(value, cursorPos);\n\n    if (context.shouldShowAutocomplete) {\n      this.updateSuggestions(context);\n      this.show();\n    } else {\n      this.hide();\n    }\n  }\n\n  /**\n   * 解析输入上下文\n   */\n  private parseInputContext(\n    value: string,\n    cursorPos: number\n  ): {\n    shouldShowAutocomplete: boolean;\n    searchTerm: string;\n    type: 'function' | 'cell' | 'all';\n    insertPosition: number;\n  } {\n    // 如果不是公式，不显示\n    if (!value.startsWith('=')) {\n      return { shouldShowAutocomplete: false, searchTerm: '', type: 'all', insertPosition: 0 };\n    }\n\n    // 获取光标前的文本\n    const textBeforeCursor = value.substring(1, cursorPos); // 去掉 '='\n\n    // 查找最后一个函数或操作符\n    const lastOperatorMatch = textBeforeCursor.match(/[\\+\\-\\*\\/\\(\\,\\s]([A-Za-z0-9]*)$/);\n\n    if (lastOperatorMatch && lastOperatorMatch[1] !== '') {\n      return {\n        shouldShowAutocomplete: true,\n        searchTerm: lastOperatorMatch[1],\n        type: /^[A-Za-z]/.test(lastOperatorMatch[1]) ? 'function' : 'cell',\n        insertPosition: cursorPos - lastOperatorMatch[1].length\n      };\n    }\n\n    // 公式开始位置\n    if (textBeforeCursor.match(/^[A-Za-z0-9]*$/)) {\n      return {\n        shouldShowAutocomplete: true,\n        searchTerm: textBeforeCursor,\n        type: 'all',\n        insertPosition: 1\n      };\n    }\n\n    return { shouldShowAutocomplete: false, searchTerm: '', type: 'all', insertPosition: 0 };\n  }\n\n  /**\n   * 更新建议列表\n   */\n  private updateSuggestions(context: any): void {\n    const { searchTerm, type } = context;\n    this.items = [];\n\n    // 获取函数列表\n    if (type === 'function' || type === 'all') {\n      const functions = this.sheet.formulaManager.getAvailableFunctions();\n      const functionItems = functions\n        .filter(fn => fn.toUpperCase().startsWith(searchTerm.toUpperCase()))\n        .slice(0, 10) // 限制数量\n        .map(fn => ({\n          type: 'function' as const,\n          value: fn,\n          label: fn,\n          description: this.getFunctionDescription(fn),\n          signature: this.getFunctionSignature(fn)\n        }));\n      this.items.push(...functionItems);\n    }\n\n    // 添加单元格引用建议\n    if (type === 'cell' || type === 'all') {\n      const cellSuggestions = this.generateCellSuggestions(searchTerm);\n      this.items.push(...cellSuggestions);\n    }\n    console.log('updateSuggestions', context, this.items);\n    this.renderDropdown();\n  }\n\n  /**\n   * 生成单元格引用建议\n   */\n  private generateCellSuggestions(searchTerm: string): AutocompleteItem[] {\n    const suggestions: AutocompleteItem[] = [];\n\n    // 如果是有效的部分单元格地址\n    const cellMatch = searchTerm.match(/^([A-Za-z]*)([0-9]*)$/);\n    if (cellMatch) {\n      const [, colPart, rowPart] = cellMatch;\n\n      // 生成列建议\n      if (colPart && !rowPart) {\n        // A -> A1, A2, A3...\n        for (let row = 1; row <= 5; row++) {\n          suggestions.push({\n            type: 'cell',\n            value: `${colPart.toUpperCase()}${row}`,\n            label: `${colPart.toUpperCase()}${row}`,\n            description: '单元格引用'\n          });\n        }\n      }\n\n      // 生成完整单元格建议\n      if (colPart && rowPart) {\n        const address = `${colPart.toUpperCase()}${rowPart}`;\n        suggestions.push({\n          type: 'cell',\n          value: address,\n          label: address,\n          description: '单元格引用'\n        });\n\n        // 添加范围建议\n        suggestions.push({\n          type: 'range',\n          value: `${address}:`,\n          label: `${address}:...`,\n          description: '开始选择范围'\n        });\n      }\n    }\n\n    return suggestions.slice(0, 5); // 限制建议数量\n  }\n\n  /**\n   * 获取函数描述\n   */\n  private getFunctionDescription(functionName: string): string {\n    const descriptions: Record<string, string> = {\n      SUM: '计算数值总和',\n      AVERAGE: '计算平均值',\n      COUNT: '计数数值单元格',\n      MAX: '返回最大值',\n      MIN: '返回最小值',\n      IF: '条件判断',\n      VLOOKUP: '垂直查找',\n      CONCATENATE: '连接文本'\n      // ... 更多函数描述\n    };\n    return descriptions[functionName] || '';\n  }\n\n  /**\n   * 获取函数签名\n   */\n  private getFunctionSignature(functionName: string): string {\n    const signatures: Record<string, string> = {\n      SUM: '(number1, [number2], ...)',\n      AVERAGE: '(number1, [number2], ...)',\n      COUNT: '(value1, [value2], ...)',\n      MAX: '(number1, [number2], ...)',\n      MIN: '(number1, [number2], ...)',\n      IF: '(logical_test, value_if_true, value_if_false)',\n      VLOOKUP: '(lookup_value, table_array, col_index_num, [range_lookup])',\n      CONCATENATE: '(text1, [text2], ...)'\n      // ... 更多函数签名\n    };\n    return signatures[functionName] || '()';\n  }\n\n  /**\n   * 渲染下拉框\n   */\n  private renderDropdown(): void {\n    if (!this.dropdown) {\n      return;\n    }\n\n    this.dropdown.innerHTML = '';\n\n    if (this.items.length === 0) {\n      // 无结果提示\n      const emptyEl = document.createElement('div');\n      emptyEl.className = 'vtable-formula-autocomplete-empty';\n      emptyEl.textContent = '没有匹配的函数';\n      this.dropdown.appendChild(emptyEl);\n      return;\n    }\n\n    // 按类型分组\n    const groups = this.groupItems(this.items);\n\n    groups.forEach(group => {\n      // 添加分组标题\n      if (groups.length > 1) {\n        const groupEl = document.createElement('div');\n        groupEl.className = 'vtable-formula-autocomplete-group';\n        groupEl.textContent = this.getGroupTitle(group.type);\n        this.dropdown.appendChild(groupEl);\n      }\n\n      // 渲染组内项目\n      group.items.forEach((item, index) => {\n        const globalIndex = this.items.indexOf(item);\n        const itemEl = document.createElement('div');\n        itemEl.className = 'vtable-formula-autocomplete-item';\n\n        if (globalIndex === this.selectedIndex) {\n          itemEl.classList.add('selected');\n        }\n\n        // 函数名和类型标签\n        const nameEl = document.createElement('div');\n        nameEl.className = 'item-name';\n\n        const labelEl = document.createElement('span');\n        labelEl.textContent = item.label;\n        nameEl.appendChild(labelEl);\n\n        const typeEl = document.createElement('span');\n        typeEl.className = `item-type ${item.type}`;\n        typeEl.textContent = this.getTypeLabel(item.type);\n        nameEl.appendChild(typeEl);\n\n        itemEl.appendChild(nameEl);\n\n        // 函数签名\n        if (item.signature) {\n          const signatureEl = document.createElement('div');\n          signatureEl.className = 'item-signature';\n          signatureEl.textContent = item.signature;\n          itemEl.appendChild(signatureEl);\n        }\n\n        // 描述\n        if (item.description) {\n          const descEl = document.createElement('div');\n          descEl.className = 'item-description';\n          descEl.textContent = item.description;\n          itemEl.appendChild(descEl);\n        }\n\n        itemEl.addEventListener('click', () => this.selectItem(globalIndex));\n        itemEl.addEventListener('mouseenter', () => {\n          this.selectedIndex = globalIndex;\n          this.renderDropdown();\n        });\n\n        this.dropdown.appendChild(itemEl);\n      });\n    });\n\n    // 添加快捷键提示\n    const footerEl = document.createElement('div');\n    footerEl.className = 'vtable-formula-autocomplete-footer';\n    footerEl.innerHTML = `\n    <div class=\"shortcut\">\n      <span class=\"key\">↑↓</span>\n      <span>选择</span>\n    </div>\n    <div class=\"shortcut\">\n      <span class=\"key\">Enter</span>\n      <span>确认</span>\n    </div>\n    <div class=\"shortcut\">\n      <span class=\"key\">Esc</span>\n      <span>取消</span>\n    </div>\n  `;\n    this.dropdown.appendChild(footerEl);\n\n    this.positionDropdown();\n  }\n\n  /**\n   * 对项目进行分组\n   */\n  private groupItems(items: AutocompleteItem[]): Array<{ type: string; items: AutocompleteItem[] }> {\n    const groups: Record<string, AutocompleteItem[]> = {};\n\n    items.forEach(item => {\n      if (!groups[item.type]) {\n        groups[item.type] = [];\n      }\n      groups[item.type].push(item);\n    });\n\n    // 按照优先级排序：function > cell > range\n    const priority = ['function', 'cell', 'range'];\n    return priority.filter(type => groups[type]).map(type => ({ type, items: groups[type] }));\n  }\n\n  /**\n   * 获取分组标题\n   */\n  private getGroupTitle(type: string): string {\n    const titles: Record<string, string> = {\n      function: '函数',\n      cell: '单元格',\n      range: '范围'\n    };\n    return titles[type] || type;\n  }\n\n  /**\n   * 获取类型标签\n   */\n  private getTypeLabel(type: string): string {\n    const labels: Record<string, string> = {\n      function: 'fx',\n      cell: 'A1',\n      range: 'A:B'\n    };\n    return labels[type] || type;\n  }\n\n  /**\n   * 定位下拉框\n   */\n  private positionDropdown(): void {\n    if (this.customPositioning) {\n      this.customPositioning();\n      return;\n    }\n    if (!this.dropdown || !this.inputElement) {\n      return;\n    }\n\n    const inputRect = this.inputElement.getBoundingClientRect();\n    const containerRect = this.container.getBoundingClientRect();\n\n    this.dropdown.style.position = 'absolute';\n    this.dropdown.style.left = `${inputRect.left - containerRect.left}px`;\n    this.dropdown.style.top = `${inputRect.bottom - containerRect.top + 2}px`;\n    this.dropdown.style.width = `${Math.max(300, inputRect.width)}px`;\n  }\n\n  /**\n   * 处理键盘事件\n   */\n  private handleKeydown(event: KeyboardEvent): void {\n    if (!this.isVisible) {\n      return;\n    }\n\n    switch (event.key) {\n      case 'ArrowDown':\n        event.preventDefault();\n        this.selectedIndex = Math.min(this.selectedIndex + 1, this.items.length - 1);\n        this.renderDropdown();\n        break;\n      case 'ArrowUp':\n        event.preventDefault();\n        this.selectedIndex = Math.max(this.selectedIndex - 1, 0);\n        this.renderDropdown();\n        break;\n      case 'Enter':\n        if (this.selectedIndex >= 0) {\n          event.preventDefault();\n          this.selectItem(this.selectedIndex);\n        }\n        break;\n      case 'Escape':\n        this.hide();\n        break;\n      case 'Tab':\n        if (this.selectedIndex >= 0) {\n          event.preventDefault();\n          this.selectItem(this.selectedIndex);\n        }\n        break;\n    }\n  }\n\n  /**\n   * 选择项目\n   */\n  private selectItem(index: number): void {\n    const item = this.items[index];\n    if (!item || !this.inputElement) {\n      return;\n    }\n\n    if (this.onSelectCallback) {\n      this.onSelectCallback(item);\n    } else {\n      // 默认插入行为\n      const value = this.inputElement.value;\n      const cursorPos = this.inputElement.selectionStart || 0;\n      const context = this.parseInputContext(value, cursorPos);\n\n      const newValue =\n        value.substring(0, context.insertPosition) +\n        item.value +\n        (item.type === 'function' ? '(' : '') +\n        value.substring(cursorPos);\n\n      this.inputElement.value = newValue;\n\n      // 设置光标位置\n      const newCursorPos = context.insertPosition + item.value.length + (item.type === 'function' ? 1 : 0);\n      this.inputElement.setSelectionRange(newCursorPos, newCursorPos);\n    }\n\n    this.hide();\n  }\n\n  /**\n   * 显示下拉框\n   */\n  private show(): void {\n    if (this.dropdown && this.items.length > 0) {\n      this.dropdown.style.display = 'block';\n      this.isVisible = true;\n      this.selectedIndex = 0;\n      this.renderDropdown();\n    }\n  }\n\n  /**\n   * 隐藏下拉框\n   */\n  private hide(): void {\n    if (this.dropdown) {\n      this.dropdown.style.display = 'none';\n      this.isVisible = false;\n      this.selectedIndex = -1;\n    }\n  }\n\n  /**\n   * 销毁组件\n   */\n  release(): void {\n    if (this.dropdown && this.dropdown.parentNode) {\n      this.dropdown.parentNode.removeChild(this.dropdown);\n    }\n  }\n}\n"]}

package/cjs/formula/formula-editor.d.ts

@@ -0,0 +1,21 @@
+import * as VTable_editors from '@visactor/vtable-editors';
+import type VTableSheet from '../components/vtable-sheet';
+import type { EditContext } from '@visactor/vtable-editors';
+export declare class FormulaInputEditor extends VTable_editors.InputEditor {
+    private formulaAutocomplete;
+    private sheet;
+    private eventHandlers;
+    setSheet(sheet: VTableSheet): void;
+    getInputElement(): HTMLElement;
+    targetIsOnEditor(target: HTMLElement): boolean;
+    createElement(): void;
+    private handleFormulaInput;
+    private initAutocomplete;
+    onStart(context: EditContext<string>): void;
+    beforeEnd(): void;
+    onEnd(): void;
+    getValue(): string;
+    validateValue(newValue?: any, oldValue?: any, position?: VTable_editors.CellAddress, table?: any, isClickOnTable?: boolean): boolean | VTable_editors.ValidateEnum;
+    private getCellRangeString;
+}
+export declare const formulaEditor: FormulaInputEditor;

package/cjs/formula/formula-editor.js

@@ -0,0 +1,162 @@
+"use strict";
+
+var __createBinding = this && this.__createBinding || (Object.create ? function(o, m, k, k2) {
+    void 0 === k2 && (k2 = k);
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    desc && !("get" in desc ? !m.__esModule : desc.writable || desc.configurable) || (desc = {
+        enumerable: !0,
+        get: function() {
+            return m[k];
+        }
+    }), Object.defineProperty(o, k2, desc);
+} : function(o, m, k, k2) {
+    void 0 === k2 && (k2 = k), o[k2] = m[k];
+}), __setModuleDefault = this && this.__setModuleDefault || (Object.create ? function(o, v) {
+    Object.defineProperty(o, "default", {
+        enumerable: !0,
+        value: v
+    });
+} : function(o, v) {
+    o.default = v;
+}), __importStar = this && this.__importStar || function(mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (null != mod) for (var k in mod) "default" !== k && Object.prototype.hasOwnProperty.call(mod, k) && __createBinding(result, mod, k);
+    return __setModuleDefault(result, mod), result;
+};
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.formulaEditor = exports.FormulaInputEditor = void 0;
+
+const VTable_editors = __importStar(require("@visactor/vtable-editors")), formula_autocomplete_1 = require("./formula-autocomplete"), formula_helper_1 = require("./formula-helper");
+
+class FormulaInputEditor extends VTable_editors.InputEditor {
+    constructor() {
+        super(...arguments), this.formulaAutocomplete = null, this.sheet = null, this.eventHandlers = [];
+    }
+    setSheet(sheet) {
+        this.sheet = sheet;
+    }
+    getInputElement() {
+        return this.element;
+    }
+    targetIsOnEditor(target) {
+        return target === this.element || target === this.sheet.formulaUIManager.formulaInput;
+    }
+    createElement() {
+        if (super.createElement(), this.element && this.sheet) {
+            [ "click", "mouseup", "keyup", "select", "input", "focus" ].forEach((eventType => {
+                const handler = e => {
+                    const cursorPos = this.element.selectionStart;
+                    null != cursorPos && (this.sheet.formulaManager.lastKnownCursorPosInFormulaInput = cursorPos, 
+                    this.sheet.formulaManager.inputingElement = this.element);
+                };
+                this.element.addEventListener(eventType, handler), this.eventHandlers.push({
+                    type: eventType,
+                    handler: handler
+                });
+            }));
+            const inputHandler = e => {
+                this.handleFormulaInput(e);
+            };
+            this.element.addEventListener("input", inputHandler), this.eventHandlers.push({
+                type: "input",
+                handler: inputHandler
+            }), setTimeout((() => {
+                this.initAutocomplete();
+            }), 50);
+        }
+    }
+    handleFormulaInput(event) {
+        if (!this.sheet || !this.element) return;
+        const value = this.element.value;
+        this.sheet.formulaUIManager.formulaInput.value = value;
+        const highlightManager = this.sheet.formulaManager.cellHighlightManager;
+        highlightManager && (value.startsWith("=") ? highlightManager.highlightFormulaCells(value) : highlightManager.clearHighlights());
+    }
+    initAutocomplete() {
+        if (!this.sheet || !this.element) return;
+        this.formulaAutocomplete && (this.formulaAutocomplete.release(), this.formulaAutocomplete = null);
+        const tableContainer = this.sheet.getContentElement();
+        this.formulaAutocomplete = new formula_autocomplete_1.FormulaAutocomplete(tableContainer, this.sheet);
+        this.formulaAutocomplete.attachTo(this.element, void 0, (() => {
+            if (!this.formulaAutocomplete || !this.element) return;
+            const inputRect = this.element.getBoundingClientRect(), containerRect = tableContainer.getBoundingClientRect(), windowHeight = window.innerHeight, relativeLeft = inputRect.left - containerRect.left, idealWidth = Math.max(300, inputRect.width);
+            let relativeTop = inputRect.bottom - containerRect.top + 2;
+            const spaceBelow = windowHeight - inputRect.bottom, spaceAbove = inputRect.top;
+            spaceBelow < 250 && spaceAbove > spaceBelow && (relativeTop = inputRect.top - containerRect.top - 250 - 2);
+            const bottomOverflow = relativeTop + 250 - containerRect.height;
+            bottomOverflow > 0 && (relativeTop = Math.max(0, relativeTop - bottomOverflow)), 
+            relativeTop < 0 && (relativeTop = 0);
+            const dropdown = this.formulaAutocomplete.dropdown;
+            dropdown && (dropdown.style.position = "absolute", dropdown.style.left = `${Math.max(0, relativeLeft)}px`, 
+            dropdown.style.top = `${relativeTop}px`, dropdown.style.width = `${idealWidth}px`, 
+            dropdown.style.maxHeight = "250px", dropdown.style.overflowY = "auto", dropdown.style.zIndex = "10000", 
+            dropdown.style.boxShadow = "0 2px 8px rgba(0, 0, 0, 0.15)");
+        }));
+    }
+    onStart(context) {
+        var _a, _b;
+        const formula = this.sheet.formulaManager.getCellFormula({
+            sheet: (null === (_a = this.sheet.getActiveSheet()) || void 0 === _a ? void 0 : _a.getKey()) || "",
+            row: context.row,
+            col: context.col
+        });
+        if (formula && (context.value = formula), super.onStart(context), this.sheet.formulaManager.inputingElement = this.element, 
+        this.sheet && "string" == typeof context.value) {
+            const formula = this.sheet.formulaManager.getCellFormula({
+                sheet: (null === (_b = this.sheet.getActiveSheet()) || void 0 === _b ? void 0 : _b.getKey()) || "",
+                row: context.row,
+                col: context.col
+            });
+            if (formula) {
+                this.setValue(formula);
+                const highlightManager = this.sheet.formulaManager.cellHighlightManager;
+                highlightManager && highlightManager.highlightFormulaCells(formula);
+            }
+        }
+    }
+    beforeEnd() {
+        this.sheet.formulaManager.formulaWorkingOnCell = null;
+    }
+    onEnd() {
+        if (this.formulaAutocomplete && (this.formulaAutocomplete.release(), this.formulaAutocomplete = null), 
+        this.sheet) {
+            const highlightManager = this.sheet.formulaManager.cellHighlightManager;
+            highlightManager && highlightManager.clearHighlights();
+        }
+        this.eventHandlers.forEach((({type: type, handler: handler}) => {
+            this.element.removeEventListener(type, handler);
+        })), super.onEnd();
+    }
+    getValue() {
+        var _a;
+        return (null === (_a = this.element) || void 0 === _a ? void 0 : _a.value) || "";
+    }
+    validateValue(newValue, oldValue, position, table, isClickOnTable) {
+        var _a;
+        if (isClickOnTable && newValue && newValue.startsWith("=")) {
+            if (this.sheet) {
+                const formulaInput = this.element;
+                return this.sheet.formulaManager.inputIsParamMode = (0, formula_helper_1.detectFunctionParameterPosition)(formulaInput.value, this.sheet.formulaManager.lastKnownCursorPosInFormulaInput), 
+                this.sheet.formulaManager.inputIsParamMode.inParamMode ? (this.sheet.formulaManager.formulaWorkingOnCell = null === (_a = this.sheet.getActiveSheet()) || void 0 === _a ? void 0 : _a.editingCell, 
+                VTable_editors.ValidateEnum.validateNotExit) : VTable_editors.ValidateEnum.validateExit;
+            }
+            if ((newValue.match(/\(/g) || []).length !== (newValue.match(/\)/g) || []).length) return VTable_editors.ValidateEnum.validateNotExit;
+        }
+        return !0;
+    }
+    getCellRangeString(range) {
+        if (!range || !range.start || !range.end) return "";
+        const colToLetter = col => {
+            let letter = "";
+            for (;col >= 0; ) letter = String.fromCharCode(65 + col % 26) + letter, col = Math.floor(col / 26) - 1;
+            return letter;
+        }, startCol = colToLetter(range.start.col), startRow = range.start.row + 1, endCol = colToLetter(range.end.col), endRow = range.end.row + 1;
+        return startCol === endCol && startRow === endRow ? `${startCol}${startRow}` : `${startCol}${startRow}:${endCol}${endRow}`;
+    }
+}
+
+exports.FormulaInputEditor = FormulaInputEditor, exports.formulaEditor = new FormulaInputEditor;
+//# sourceMappingURL=formula-editor.js.map

package/cjs/formula/formula-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/formula/formula-editor.ts"],"names":[],"mappings":"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","file":"formula-editor.js","sourcesContent":["import * as VTable_editors from '@visactor/vtable-editors';\nimport { FormulaAutocomplete } from './formula-autocomplete';\nimport type VTableSheet from '../components/vtable-sheet';\nimport type { EditContext } from '@visactor/vtable-editors';\nimport { detectFunctionParameterPosition } from './formula-helper';\n\nexport class FormulaInputEditor extends VTable_editors.InputEditor {\n  private formulaAutocomplete: FormulaAutocomplete | null = null;\n  private sheet: VTableSheet | null = null;\n  // 定义存储事件处理函数的数组\n  private eventHandlers: Array<{ type: string; handler: EventListener }> = [];\n  /**\n   * 设置 Sheet 实例\n   */\n  setSheet(sheet: VTableSheet): void {\n    this.sheet = sheet;\n  }\n  getInputElement(): HTMLElement {\n    return this.element;\n  }\n  targetIsOnEditor(target: HTMLElement): boolean {\n    return target === this.element || target === this.sheet.formulaUIManager.formulaInput;\n  }\n  /**\n   * 创建编辑器元素\n   * 重写父类方法以添加自动补全功能\n   */\n  createElement(): void {\n    super.createElement();\n\n    if (this.element && this.sheet) {\n      const events = ['click', 'mouseup', 'keyup', 'select', 'input', 'focus'];\n      events.forEach(eventType => {\n        const handler = (e: Event) => {\n          const cursorPos = this.element.selectionStart;\n          if (cursorPos !== null && cursorPos !== undefined) {\n            console.log(\n              'event',\n              e,\n              'old',\n              this.sheet.formulaManager.lastKnownCursorPosInFormulaInput,\n              'new',\n              cursorPos\n            );\n            this.sheet.formulaManager.lastKnownCursorPosInFormulaInput = cursorPos;\n            this.sheet.formulaManager.inputingElement = this.element;\n          }\n        };\n\n        this.element.addEventListener(eventType, handler);\n        this.eventHandlers.push({ type: eventType, handler });\n      });\n\n      // 添加输入事件监听\n      const inputHandler = (e: Event) => {\n        this.handleFormulaInput(e);\n      };\n      this.element.addEventListener('input', inputHandler);\n      this.eventHandlers.push({ type: 'input', handler: inputHandler });\n\n      // 延迟初始化自动补全\n      setTimeout(() => {\n        this.initAutocomplete();\n      }, 50);\n    }\n  }\n\n  /**\n   * 处理公式输入\n   */\n  private handleFormulaInput(event: Event): void {\n    if (!this.sheet || !this.element) {\n      return;\n    }\n\n    const value = this.element.value;\n    console.log('handleFormulaInput', value);\n    // 同步内容到顶部输入栏\n    this.sheet.formulaUIManager.formulaInput.value = value;\n    // const inputEvent = new Event('input', { bubbles: true });\n    // Object.defineProperty(inputEvent, 'isFormulaInsertion', { value: true });\n    // this.sheet.formulaUIManager.formulaInput.dispatchEvent(inputEvent);\n    // 获取高亮管理器\n    const highlightManager = this.sheet.formulaManager.cellHighlightManager;\n\n    if (highlightManager) {\n      if (value.startsWith('=')) {\n        highlightManager.highlightFormulaCells(value);\n      } else {\n        highlightManager.clearHighlights();\n      }\n    }\n  }\n\n  /**\n   * 初始化自动补全\n   */\n  private initAutocomplete(): void {\n    if (!this.sheet || !this.element) {\n      return;\n    }\n\n    // 清理之前的实例\n    if (this.formulaAutocomplete) {\n      this.formulaAutocomplete.release();\n      this.formulaAutocomplete = null;\n    }\n\n    const tableContainer = this.sheet.getContentElement();\n\n    this.formulaAutocomplete = new FormulaAutocomplete(tableContainer, this.sheet);\n\n    // 自定义定位逻辑\n    const customPositioning = () => {\n      if (!this.formulaAutocomplete || !this.element) {\n        return;\n      }\n\n      // 获取编辑器元素和容器的位置信息\n      const inputRect = this.element.getBoundingClientRect();\n      const containerRect = tableContainer.getBoundingClientRect();\n      const windowHeight = window.innerHeight;\n\n      // 计算相对于表格容器的位置\n      const relativeLeft = inputRect.left - containerRect.left;\n\n      // 计算下拉框的最大高度和理想宽度\n      const maxDropdownHeight = 250; // 最大高度限制\n      const idealWidth = Math.max(300, inputRect.width); // 理想宽度\n\n      // 计算下拉框在下方显示时的顶部位置\n      let relativeTop = inputRect.bottom - containerRect.top + 2;\n\n      // 检查是否有足够空间在下方显示下拉框\n      const spaceBelow = windowHeight - inputRect.bottom;\n      const spaceAbove = inputRect.top;\n\n      // 判断应该将下拉框放在输入框的上方还是下方\n      if (spaceBelow < maxDropdownHeight && spaceAbove > spaceBelow) {\n        // 空间不足且上方空间更大，则放在上方\n        relativeTop = inputRect.top - containerRect.top - maxDropdownHeight - 2;\n      }\n\n      // 确保下拉框不会超出容器底部\n      const bottomOverflow = relativeTop + maxDropdownHeight - containerRect.height;\n      if (bottomOverflow > 0) {\n        relativeTop = Math.max(0, relativeTop - bottomOverflow);\n      }\n\n      // 确保下拉框不会超出容器顶部\n      if (relativeTop < 0) {\n        relativeTop = 0;\n      }\n\n      // 设置下拉框位置和样式\n      const dropdown = (this.formulaAutocomplete as any).dropdown;\n      if (dropdown) {\n        dropdown.style.position = 'absolute';\n        dropdown.style.left = `${Math.max(0, relativeLeft)}px`;\n        dropdown.style.top = `${relativeTop}px`;\n        dropdown.style.width = `${idealWidth}px`;\n        dropdown.style.maxHeight = `${maxDropdownHeight}px`;\n        dropdown.style.overflowY = 'auto';\n        dropdown.style.zIndex = '10000';\n        dropdown.style.boxShadow = '0 2px 8px rgba(0, 0, 0, 0.15)';\n      }\n    };\n\n    // 附加自动补全到输入框\n    this.formulaAutocomplete.attachTo(this.element, undefined, customPositioning);\n  }\n\n  /**\n   * 开始编辑\n   * 重写父类方法\n   */\n  onStart(context: EditContext<string>): void {\n    // 获取公式\n    const formula = this.sheet.formulaManager.getCellFormula({\n      sheet: this.sheet.getActiveSheet()?.getKey() || '',\n      row: context.row,\n      col: context.col\n    });\n    if (formula) {\n      context.value = formula;\n    }\n    super.onStart(context);\n    this.sheet.formulaManager.inputingElement = this.element;\n    // 如果是公式，显示公式而不是计算结果\n    if (this.sheet && typeof context.value === 'string') {\n      const formula = this.sheet.formulaManager.getCellFormula({\n        sheet: this.sheet.getActiveSheet()?.getKey() || '',\n        row: context.row,\n        col: context.col\n      });\n\n      if (formula) {\n        this.setValue(formula);\n        // 触发高亮\n        const highlightManager = this.sheet.formulaManager.cellHighlightManager;\n        if (highlightManager) {\n          highlightManager.highlightFormulaCells(formula);\n        }\n      }\n    }\n  }\n  beforeEnd(): void {\n    this.sheet.formulaManager.formulaWorkingOnCell = null;\n  }\n  /**\n   * 结束编辑\n   * 重写父类方法以清理自动补全\n   */\n  onEnd(): void {\n    if (this.formulaAutocomplete) {\n      this.formulaAutocomplete.release();\n      this.formulaAutocomplete = null;\n    }\n    if (this.sheet) {\n      const highlightManager = this.sheet.formulaManager.cellHighlightManager;\n      if (highlightManager) {\n        highlightManager.clearHighlights();\n      }\n    }\n    //解绑所有事件\n    // 解绑事件（在需要解绑的地方）\n    this.eventHandlers.forEach(({ type, handler }) => {\n      this.element.removeEventListener(type, handler);\n    });\n    super.onEnd();\n  }\n\n  /**\n   * 获取编辑器的值\n   */\n  getValue(): string {\n    return this.element?.value || '';\n  }\n\n  validateValue(\n    newValue?: any,\n    oldValue?: any,\n    position?: VTable_editors.CellAddress,\n    table?: any,\n    isClickOnTable?: boolean\n  ): boolean | VTable_editors.ValidateEnum {\n    // 判断点击到表格其他单元格，且输入了公式，则检查公式是否完整\n    if (isClickOnTable && newValue && newValue.startsWith('=')) {\n      // 如果有sheet实例，使用FormulaManager检查公式完整性\n      if (this.sheet) {\n        const formulaInput = this.element;\n        this.sheet.formulaManager.inputIsParamMode = detectFunctionParameterPosition(\n          formulaInput.value,\n          this.sheet.formulaManager.lastKnownCursorPosInFormulaInput\n        );\n        console.log('test formula complete', newValue, this.sheet.formulaManager.inputIsParamMode);\n        if (this.sheet.formulaManager.inputIsParamMode.inParamMode) {\n          // // 如果公式不完整，不退出编辑状态  TODO 这里不应该只判断完整性，如这种情况下按住ctrl连续点选 =SUM(H5) 这种情况应该允许继续编辑输入点选单元格范围\n          // if (!formulaManager.isFormulaComplete(newValue)) {\n\n          this.sheet.formulaManager.formulaWorkingOnCell = this.sheet.getActiveSheet()?.editingCell;\n\n          return VTable_editors.ValidateEnum.validateNotExit;\n        }\n        return VTable_editors.ValidateEnum.validateExit;\n      }\n      // 如果没有sheet实例，使用简单的括号匹配检查\n      const openParenCount = (newValue.match(/\\(/g) || []).length;\n      const closeParenCount = (newValue.match(/\\)/g) || []).length;\n      if (openParenCount !== closeParenCount) {\n        return VTable_editors.ValidateEnum.validateNotExit;\n      }\n    }\n    return true;\n  }\n\n  /**\n   * 将选中的单元格范围转换为公式引用字符串\n   * 例如：A1:B3\n   */\n  private getCellRangeString(range: {\n    start: { col: number; row: number };\n    end: { col: number; row: number };\n  }): string {\n    if (!range || !range.start || !range.end) {\n      return '';\n    }\n\n    // 将列索引转换为字母表示（0->A, 1->B, 等）\n    const colToLetter = (col: number): string => {\n      let letter = '';\n      while (col >= 0) {\n        letter = String.fromCharCode(65 + (col % 26)) + letter;\n        col = Math.floor(col / 26) - 1;\n      }\n      return letter;\n    };\n\n    const startCol = colToLetter(range.start.col);\n    const startRow = range.start.row + 1; // 行索引从1开始\n    const endCol = colToLetter(range.end.col);\n    const endRow = range.end.row + 1;\n\n    // 如果是单个单元格\n    if (startCol === endCol && startRow === endRow) {\n      return `${startCol}${startRow}`;\n    }\n\n    // 如果是范围\n    return `${startCol}${startRow}:${endCol}${endRow}`;\n  }\n}\n\nexport const formulaEditor = new FormulaInputEditor();\n"]}

package/cjs/formula/formula-helper.d.ts

@@ -0,0 +1,8 @@
+export declare const supportedFunctions: string[];
+export declare function detectFunctionParameterPosition(formula: string, cursorPosition: number): {
+    inParamMode: boolean;
+    functionParamPosition: {
+        start: number;
+        end: number;
+    } | null;
+};

package/cjs/formula/formula-helper.js

@@ -0,0 +1,66 @@
+"use strict";
+
+function findMatchingCloseParen(formula, openParenIndex) {
+    let depth = 1;
+    for (let i = openParenIndex + 1; i < formula.length; i++) if ("(" === formula[i]) depth++; else if (")" === formula[i] && (depth--, 
+    0 === depth)) return i;
+    return -1;
+}
+
+function detectFunctionParameterPosition(formula, cursorPosition) {
+    if (!formula.startsWith("=")) return {
+        inParamMode: !1,
+        functionParamPosition: null
+    };
+    const functionRegex = /([A-Za-z]+)\s*\(/g;
+    let match, positionBeforeCursor = -1;
+    for (;null !== (match = functionRegex.exec(formula)); ) {
+        match[1].toUpperCase();
+        const functionStart = match.index, openParenIndex = formula.indexOf("(", functionStart);
+        if (openParenIndex < cursorPosition && openParenIndex > positionBeforeCursor) {
+            const closeParenIndex = findMatchingCloseParen(formula, openParenIndex);
+            if (cursorPosition > openParenIndex && (-1 === closeParenIndex || cursorPosition <= closeParenIndex)) return {
+                inParamMode: !0,
+                functionParamPosition: {
+                    start: openParenIndex + 1,
+                    end: cursorPosition
+                }
+            };
+            if (cursorPosition === openParenIndex + 1) return {
+                inParamMode: !0,
+                functionParamPosition: {
+                    start: openParenIndex + 1,
+                    end: cursorPosition
+                }
+            };
+            positionBeforeCursor = openParenIndex;
+        }
+    }
+    if (cursorPosition > 1 && cursorPosition <= formula.length) {
+        const prevChar = formula[cursorPosition - 1];
+        if ([ "+", "-", "*", "/", "=", ">", "<", "&", "|", "^", "(", "," ].includes(prevChar)) return {
+            inParamMode: !0,
+            functionParamPosition: {
+                start: cursorPosition,
+                end: cursorPosition
+            }
+        };
+    }
+    return 1 === cursorPosition && "=" === formula[0] ? {
+        inParamMode: !0,
+        functionParamPosition: {
+            start: cursorPosition,
+            end: cursorPosition
+        }
+    } : {
+        inParamMode: !1,
+        functionParamPosition: null
+    };
+}
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.detectFunctionParameterPosition = exports.supportedFunctions = void 0, 
+exports.supportedFunctions = [ "SUM", "AVERAGE", "MAX", "MIN", "COUNT", "COUNTA", "IF", "AND", "OR", "NOT", "ROUND", "FLOOR", "CEILING", "ABS", "SQRT", "POWER", "MOD", "INT", "RAND", "TODAY", "NOW", "YEAR", "MONTH", "DAY", "HOUR", "MINUTE", "SECOND" ], 
+exports.detectFunctionParameterPosition = detectFunctionParameterPosition;
+//# sourceMappingURL=formula-helper.js.map