@veltra/sheet 2.5.6 → 2.5.8

package/src/components/sheet/popups/functions-popup.vue

@@ -0,0 +1,141 @@
+<template>
+  <div ref="panelRef" :class="cls.e('functions-panel')" @keydown="handleKeydown">
+    <nav :class="cls.e('functions-nav')">
+      <button
+        v-for="cat in FUNCTION_POPUP_CATEGORIES"
+        :key="cat"
+        type="button"
+        :class="[cls.e('functions-nav-item'), bem.is('active', cat === activeCategory)]"
+        @click="selectCategory(cat)"
+      >
+        {{ cat }}
+      </button>
+    </nav>
+    <div :class="cls.e('functions-main')">
+      <u-input
+        v-model="keyword"
+        :placeholder="'搜索函数名或描述'"
+        size="small"
+        :class="cls.e('functions-search')"
+      />
+      <!-- 滚动用 desktop UScroll（自定义滚动条），同字号面板 -->
+      <u-scroll :height="320" :class="cls.e('functions-scroll')">
+        <div v-if="visible.length > 0" :class="cls.e('functions-list')">
+          <div
+            v-for="(fn, index) in visible"
+            :key="fn.name"
+            :class="[cls.e('functions-item'), bem.is('active', index === activeIndex)]"
+            @click="emit('select', fn.name)"
+            @mouseenter="activeIndex = index"
+          >
+            <span :class="cls.e('functions-signature')">{{
+              formatFunctionSignature(fn.name, fn.params)
+            }}</span>
+            <span v-if="fn.description" :class="cls.e('functions-description')">{{
+              fn.description
+            }}</span>
+          </div>
+        </div>
+        <div v-else :class="cls.e('functions-empty')">无匹配函数</div>
+      </u-scroll>
+    </div>
+  </div>
+</template>
+
+<script lang="ts" setup>
+import { UInput, UScroll } from '@veltra/desktop'
+import {
+  listFormulaFunctions,
+  type FormulaFunctionMeta
+} from '@veltra/sheet-core/core/formula/functions.js'
+import { bem } from '@veltra/utils'
+import { computed, onMounted, ref, useTemplateRef, watch } from 'vue'
+
+import {
+  COMMON_FORMULA_NAMES,
+  formatFunctionSignature,
+  FUNCTION_POPUP_CATEGORIES,
+  moveSuggestIndex,
+  type FunctionPopupCategory
+} from '../use-formula-suggest'
+
+defineOptions({ name: 'USheetFunctionsPopup' })
+
+/**
+ * 函数弹框（分类导航 + 搜索 + 可选择）：fx 按钮与工具栏「函数」共用。
+ * 列出全部已注册函数（内置 + 宿主经 registerFormulaFunction 注册的自定义函数），
+ * 选中仅 emit select(name)，由公式栏接管（进入编辑态输出 =NAME()），不写模型。
+ * 弹框随 v-if 挂载 / 销毁，每次打开都是全新状态（关键词清空、回到「常用」）。
+ */
+
+type FunctionItem = { name: string } & FormulaFunctionMeta
+
+const emit = defineEmits<{ select: [name: string] }>()
+
+const cls = bem('sheet')
+
+const panelRef = useTemplateRef<HTMLElement>('panelRef')
+
+const keyword = ref('')
+const activeCategory = ref<FunctionPopupCategory>('常用')
+/** 键盘 / 悬停高亮下标（点击即确认不高亮） */
+const activeIndex = ref(0)
+
+/** 打开时快照一次注册表（弹框存活期间注册表变化不追踪，重开即刷新） */
+const all: FunctionItem[] = listFormulaFunctions()
+
+/** 关键词大小写不敏感子串匹配：名称或中文描述；跨分类（未分类函数也可搜到） */
+function searchResult(key: string): FunctionItem[] {
+  return all.filter(
+    (fn) => fn.name.toLowerCase().includes(key) || fn.description.toLowerCase().includes(key)
+  )
+}
+
+/** 当前展示列表：搜索优先；否则按分类导航过滤 */
+const visible = computed<FunctionItem[]>(() => {
+  const key = keyword.value.trim().toLowerCase()
+  if (key) return searchResult(key)
+  if (activeCategory.value === '全部') return all
+  if (activeCategory.value === '常用') {
+    // 固定清单（顺序即 COMMON_FORMULA_NAMES 顺序）；注册表中缺失的名称跳过
+    const byName = new Map(all.map((fn) => [fn.name, fn]))
+    return COMMON_FORMULA_NAMES.map((name) => byName.get(name)).filter(
+      (fn): fn is FunctionItem => fn != null
+    )
+  }
+  // 分类项只列声明了该 category 的函数（未分类函数不进任何分类）
+  return all.filter((fn) => fn.category === activeCategory.value)
+})
+
+watch(visible, () => {
+  activeIndex.value = 0
+})
+
+function selectCategory(cat: FunctionPopupCategory): void {
+  activeCategory.value = cat
+}
+
+/** 键盘路径：↑↓ 移动高亮（循环），Enter 确认选中（Esc 交由外层弹框关闭） */
+function handleKeydown(event: KeyboardEvent): void {
+  if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+    event.preventDefault()
+    activeIndex.value = moveSuggestIndex(
+      activeIndex.value,
+      visible.value.length,
+      event.key === 'ArrowDown' ? 1 : -1
+    )
+    return
+  }
+  if (event.key === 'Enter') {
+    const fn = visible.value[activeIndex.value]
+    if (!fn) return
+    event.preventDefault()
+    emit('select', fn.name)
+  }
+}
+
+// 打开即聚焦搜索框，键盘可直接检索 / 导航（查 DOM 而非组件 expose，stub 环境同样可用）
+onMounted(() => {
+  panelRef.value?.querySelector('input')?.focus()
+})
+</script>

package/src/components/sheet/popups/import.worker.ts

@@ -15,7 +15,7 @@
  * 注意：必须用**运行时动态 import**——worker 顶层静态 import 在 vite dev 的
  * worker 上下文中会因模块图加载顺序导致 `Workbook is not defined`（实测）。
  */
-import type { SheetSnapshot } from '@veltra/sheet-core/core/sheet'
+import type { SheetSnapshot } from '@veltra/sheet-core/core/sheet.js'
 
 export type ImportWorkerResponse =
   | { type: 'progress'; done: number; total: number }
@@ -31,7 +31,7 @@ self.onmessage = (e: MessageEvent<{ buffer: ArrayBuffer }>): void => {
   const { buffer } = e.data
   void (async () => {
     try {
-      const { importXlsx } = await import('@veltra/sheet-core/core/io/import')
+      const { importXlsx } = await import('@veltra/sheet-core/core/io/import.js')
       // 分片构建：按 10% 粒度回报进度（避免 196 条/秒的消息风暴与文字跳变过快；
       // 模型构建段约 1s，10 次更新肉眼可见数字推进）
       let lastPercent = -1

package/src/components/sheet/sheet-context-menu.ts

@@ -1,6 +1,6 @@
 import type { ContextmenuItem } from '@veltra/desktop'
-import { createRange, type CellAddress, type CellRange } from '@veltra/sheet-core/core/address'
-import type { NumFmt } from '@veltra/sheet-core/core/style/types'
+import { createRange, type CellAddress, type CellRange } from '@veltra/sheet-core/core/address.js'
+import type { NumFmt } from '@veltra/sheet-core/core/style/types.js'
 import { defineComponent, h } from 'vue'
 
 import type { SheetContext } from '../../tools/context'

package/src/components/sheet/sheet-tabs.vue

@@ -54,8 +54,8 @@
 <script lang="ts" setup>
 import { contextmenu, message, messageConfirm, UIcon } from '@veltra/desktop'
 import { ArrowLeft, ArrowRight } from '@veltra/icons/normal'
-import type { Sheet } from '@veltra/sheet-core/core/sheet'
-import type { Workbook } from '@veltra/sheet-core/core/workbook'
+import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
+import type { Workbook } from '@veltra/sheet-core/core/workbook.js'
 import { bem } from '@veltra/utils'
 import { nextTick, ref, toRef, useTemplateRef } from 'vue'
 

package/src/components/sheet/sheet.vue

@@ -3,7 +3,7 @@
     <div :class="cls.e('toolbar-wrap')">
       <u-sheet-toolbar v-if="showToolbar" :groups="toolGroups" @tool-click="handleToolClick" />
 
-      <!-- 弹层型工具面板（填充/边框/字体色/字号/查找/插入图片/导出）：UDropdown（Teleport 到
+      <!-- 弹层型工具面板（填充/边框/字体色/字号/查找/函数/插入图片/导出）：UDropdown（Teleport 到
            #pop-container + floating-ui 定位：锚点跟随触发按钮、自动翻转/边界位移；
            触发元素滚动/窗口缩放时自动关闭）。面板交互走 SheetContext 命令入口。
            导入无弹层：点击直接系统文件选择（见 handleToolClick → pickAndImportFile） -->
@@ -32,6 +32,10 @@
               :context="context"
               @close="closePopup"
             />
+            <u-sheet-functions-popup
+              v-else-if="popupTool.popup === 'functions'"
+              @select="handleFunctionSelect"
+            />
             <u-sheet-insert-image-popup
               v-else-if="popupTool.popup === 'insert-image'"
               :context="context"
@@ -87,6 +91,7 @@ import USheetFillColorPopup from './popups/fill-color-popup.vue'
 import USheetFindPopup from './popups/find-popup.vue'
 import USheetFontColorPopup from './popups/font-color-popup.vue'
 import USheetFontSizePopup from './popups/font-size-popup.vue'
+import USheetFunctionsPopup from './popups/functions-popup.vue'
 import USheetInsertImagePopup from './popups/insert-image-popup.vue'
 import USheetTabs from './sheet-tabs.vue'
 import USheetToolbar from './sheet-toolbar.vue'
@@ -162,6 +167,12 @@ function handleToolClick(tool: SheetTool, event?: MouseEvent): void {
   openOrRunTool(tool, event)
 }
 
+/** 工具栏「函数」弹框选中 → 关弹层并走公式栏统一插入路径（与 fx 按钮一致） */
+function handleFunctionSelect(name: string): void {
+  closePopup()
+  formulaBarRef.value?.insertFunction(name)
+}
+
 // ─── UDropdown 面板：锚点跟随触发按钮（floating-ui 定位）──────────
 
 const popupDropdownRef = useTemplateRef<InstanceType<typeof UDropdown>>('popupDropdownRef')
@@ -199,7 +210,9 @@ const { rebuildGrid, activateGrid, pruneCache, getGrid } = useSheetGrid({
   gridRef,
   getActiveSheet: () => activeSheet.value,
   context,
-  formulaBarRef
+  formulaBarRef,
+  // 工具栏「函数」弹框打开期间与 fx 入口一致：画布点击不清除目标格高亮
+  isFunctionPopupOpen: () => popupTool.value?.popup === 'functions'
 })
 
 const exposed: _SheetExposed = {

package/src/components/sheet/style.scss

@@ -246,10 +246,25 @@
     flex-shrink: 0;
     align-items: center;
     height: fn.use-var(form-component-height, small);
+    padding: 0 4px;
+    border: none;
+    border-radius: fn.use-var(radius, small);
+    background: transparent;
     color: fn.use-var(text-color, second);
     font-size: fn.use-var(font-size-main, small);
     font-style: italic;
     user-select: none;
+    cursor: pointer;
+
+    &:hover:not(:disabled) {
+      background-color: fn.use-var(bg-color, hover);
+      color: fn.use-var(text-color, main);
+    }
+
+    &:disabled {
+      color: fn.use-var(text-color, disabled);
+      cursor: not-allowed;
+    }
   }
 
   @include m.e(fx-input) {
@@ -531,6 +546,108 @@
     }
   }
 
+  /* ─── 函数弹框（分类导航 + 搜索 + 可选择；fx 按钮与工具栏共用）── */
+
+  @include m.e(functions-popover) {
+    display: flex;
+    flex-direction: column;
+  }
+
+  @include m.e(functions-panel) {
+    display: flex;
+    gap: fn.use-var(gap, small);
+  }
+
+  @include m.e(functions-nav) {
+    display: flex;
+    flex-direction: column;
+    flex-shrink: 0;
+    gap: 2px;
+    padding: 4px;
+    border-right: 1px solid fn.use-var(border, muted-color);
+    min-width: 96px;
+  }
+
+  @include m.e(functions-nav-item) {
+    padding: 4px 8px;
+    border: none;
+    border-radius: fn.use-var(radius, small);
+    background: transparent;
+    color: fn.use-var(text-color, second);
+    font-size: fn.use-var(font-size-main, small);
+    text-align: left;
+    white-space: nowrap;
+    cursor: pointer;
+
+    &:hover {
+      background-color: fn.use-var(bg-color, hover);
+    }
+
+    @include m.is(active) {
+      background-color: fn.use-var(bg-color, hover);
+      color: fn.use-var(color, primary);
+      font-weight: 600;
+    }
+  }
+
+  @include m.e(functions-main) {
+    display: flex;
+    flex-direction: column;
+    gap: 6px;
+    flex: 1;
+    min-width: 0;
+  }
+
+  @include m.e(functions-search) {
+    width: 320px;
+  }
+
+  @include m.e(functions-scroll) {
+    width: 320px;
+  }
+
+  @include m.e(functions-list) {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+  }
+
+  @include m.e(functions-item) {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+    padding: 6px 8px;
+    border-radius: fn.use-var(radius, small);
+    cursor: pointer;
+
+    &:hover {
+      background-color: fn.use-var(bg-color, hover);
+    }
+
+    @include m.is(active) {
+      background-color: fn.use-var(bg-color, hover);
+    }
+  }
+
+  @include m.e(functions-signature) {
+    color: fn.use-var(text-color, main);
+    font-size: fn.use-var(font-size-main, small);
+    font-weight: 600;
+    font-family: 'JetBrains Mono', Consolas, 'Courier New', monospace;
+  }
+
+  @include m.e(functions-description) {
+    color: fn.use-var(text-color, second);
+    font-size: fn.use-var(font-size-assist, small);
+  }
+
+  @include m.e(functions-empty) {
+    padding: 16px 0;
+    color: fn.use-var(text-color, second);
+    font-size: fn.use-var(font-size-main, small);
+    text-align: center;
+  }
+
   @include m.e(insert-image-hint) {
     padding: 8px 10px;
     border: 1px dashed fn.use-var(border, muted-color);

package/src/components/sheet/use-find-replace.ts

@@ -3,15 +3,15 @@ import {
   inferCellType,
   normalizeInputValue,
   type CellData
-} from '@veltra/sheet-core/core/cell-store'
+} from '@veltra/sheet-core/core/cell-store.js'
 import {
   findAll,
   findNextFrom,
   findPrevFrom,
   type FindMatch,
   type FindOptions
-} from '@veltra/sheet-core/core/find'
-import type { Sheet } from '@veltra/sheet-core/core/sheet'
+} from '@veltra/sheet-core/core/find.js'
+import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
 import { computed, ref, shallowRef, watch } from 'vue'
 
 import type { SheetContext } from '../../tools/context'

package/src/components/sheet/use-formula-suggest.ts

@@ -1,7 +1,7 @@
 import {
   listFormulaFunctions,
   type FormulaFunctionMeta
-} from '@veltra/sheet-core/core/formula/functions'
+} from '@veltra/sheet-core/core/formula/functions.js'
 
 /** 补全候选上限 */
 export const FORMULA_SUGGEST_LIMIT = 10
@@ -23,6 +23,25 @@ export const COMMON_FORMULA_NAMES = [
   'OR'
 ] as const
 
+/**
+ * 函数弹框分类导航固定集合（顺序即展示顺序）。
+ * 「常用」「全部」是导航概念（非注册表分类）：常用 = COMMON_FORMULA_NAMES 固定清单，
+ * 全部 = 全部已注册函数；其余与 sheet-core `FormulaFunctionCategory` 对应。
+ */
+export const FUNCTION_POPUP_CATEGORIES = [
+  '常用',
+  '全部',
+  '财务',
+  '日期与时间',
+  '数学',
+  '统计',
+  '查找与引用',
+  '文本',
+  '逻辑'
+] as const
+
+export type FunctionPopupCategory = (typeof FUNCTION_POPUP_CATEGORIES)[number]
+
 /** 函数名 token 前合法的「触发」字符（= / 运算符 / ( / ,） */
 const SUGGEST_TRIGGER_CHARS = new Set(['=', '(', ',', '+', '-', '*', '/', '^', '&', '<', '>'])
 

package/src/components/sheet/use-sheet-grid.ts

@@ -1,6 +1,6 @@
 import { contextmenu } from '@veltra/desktop'
-import type { CellAddress, CellRange } from '@veltra/sheet-core/core/address'
-import type { Sheet } from '@veltra/sheet-core/core/sheet'
+import type { CellAddress, CellRange } from '@veltra/sheet-core/core/address.js'
+import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
 import { SheetGrid, type SheetGridContextMenuInfo } from '@veltra/sheet-core/grid'
 import { onBeforeUnmount, onMounted, watch } from 'vue'
 
@@ -23,6 +23,8 @@ export interface FormulaBarMirror {
   exitMirror: (addr: CellAddress) => void
   /** fx 编辑中且处于可插入引用位置 */
   isRefSelecting: () => boolean
+  /** 函数弹框打开中（fx 入口）——画布点击不清除目标格高亮 */
+  isFunctionPopupOpen: () => boolean
   /** 网格 pointerdown → 挂起 blur 提交 */
   beginBlurSuppress: () => void
   /** 画布选区 → 插入引用文本 */
@@ -35,6 +37,8 @@ interface UseSheetGridOptions {
   getActiveSheet: () => Sheet
   context: SheetContext
   formulaBarRef: ElRef<FormulaBarMirror>
+  /** 函数弹框打开中（宿主侧入口，如工具栏「函数」按钮） */
+  isFunctionPopupOpen?: () => boolean
 }
 
 /** 缓存实例（LRU 淘汰）：每个 sheet 一个独立容器 div，非激活容器 visibility:hidden 堆叠 */
@@ -125,8 +129,12 @@ export function useSheetGrid(options: UseSheetGridOptions) {
       onContextMenu: handleContextMenu,
       onEditStart: (addr) => formulaBarRef.value?.mirrorGridEdit(addr),
       onEditEnd: (addr) => formulaBarRef.value?.exitMirror(addr),
-      // 引用选择：不回写模型选区，序列化为 A1 / A1:B2 交给公式栏
-      interceptSelection: () => formulaBarRef.value?.isRefSelecting() ?? false,
+      // 引用选择：不回写模型选区，序列化为 A1 / A1:B2 交给公式栏；
+      // 函数弹框打开期间（fx / 工具栏两入口）同样拦截，画布点击不离开目标格
+      interceptSelection: () =>
+        (formulaBarRef.value?.isRefSelecting() ?? false) ||
+        (formulaBarRef.value?.isFunctionPopupOpen() ?? false) ||
+        (options.isFunctionPopupOpen?.() ?? false),
       onSelectionIntercept: (range) => formulaBarRef.value?.handleRefSelect(range)
     })
     // 结构变更订阅（vue 层只绑定激活 sheet；隐藏实例必须自持标记，切回时判定过期）

package/src/components/sheet/use-sheet-state.ts

@@ -1,5 +1,5 @@
-import type { Sheet } from '@veltra/sheet-core/core/sheet'
-import { Workbook } from '@veltra/sheet-core/core/workbook'
+import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
+import { Workbook } from '@veltra/sheet-core/core/workbook.js'
 import { computed, onBeforeUnmount, onMounted, ref, shallowRef, watch } from 'vue'
 
 import { createSheetContext } from '../../tools/context'

package/src/components/sheet/use-tool-popup.ts

@@ -9,7 +9,8 @@ type ElRef = { readonly value: HTMLElement | null | undefined }
 /**
  * 面板打开期间的写入是否合并为一个 undo 单元（关闭时提交）：
  * 填充颜色 / 边框 / 字体颜色 / 字号参与事务；查找（每次替换独立 undo）、
- * 导出（下载侧效应，无模型写入）不参与。导入无弹层，不经此路径。
+ * 函数（选中仅进入公式栏编辑态，模型写入待 fx 提交）、导出（下载侧效应，
+ * 无模型写入）不参与。导入无弹层，不经此路径。
  */
 function joinsTransaction(tool: SheetTool): boolean {
   return (
@@ -21,12 +22,13 @@ function joinsTransaction(tool: SheetTool): boolean {
 }
 
 /**
- * 弹层型工具编排（填充颜色 / 边框 / 查找 / 插入图片 / 导出）：
+ * 弹层型工具编排（填充颜色 / 边框 / 查找 / 函数 / 插入图片 / 导出）：
  * - popupTool：当前打开的弹层工具（null = 未打开）
  * - popupAnchor：触发按钮元素（面板定位参照，见 sheet.vue 的 left 计算）
  * - 打开 / 关闭时的事务包裹（面板期间写入合并为一个 undo 单元，关闭时提交）
  * - 点击面板外关闭（面板内 @click.stop 不冒泡到 window）
  * - Ctrl/Cmd+F 开合查找条（与工具按钮同一 toggle 逻辑）
+ * 函数面板选中只进入公式栏编辑态（无直接模型写入），与查找 / 导出一样不参与事务。
  * 导入在 sheet.vue 特殊处理（直接系统文件选择），不经弹层。
  */
 export function useToolPopup(context: SheetContext, rootEl: ElRef) {

package/src/tools/__test__/apply-style.test.ts

@@ -1,5 +1,5 @@
-import { createRange } from '@veltra/sheet-core/core/address'
-import { Sheet } from '@veltra/sheet-core/core/sheet'
+import { createRange } from '@veltra/sheet-core/core/address.js'
+import { Sheet } from '@veltra/sheet-core/core/sheet.js'
 import { describe, expect, it } from 'vitest'
 
 import { classifySelectionStyleTarget, type SelectionStyleTarget } from '../apply-style'

package/src/tools/__test__/builtin.test.ts

@@ -1,8 +1,8 @@
-import { createRange } from '@veltra/sheet-core/core/address'
+import { createRange } from '@veltra/sheet-core/core/address.js'
 
 import '../builtin'
-import { Sheet } from '@veltra/sheet-core/core/sheet'
-import { Workbook } from '@veltra/sheet-core/core/workbook'
+import { Sheet } from '@veltra/sheet-core/core/sheet.js'
+import { Workbook } from '@veltra/sheet-core/core/workbook.js'
 import { describe, expect, it, vi } from 'vitest'
 
 import { createSheetContext } from '../context'
@@ -52,7 +52,7 @@ describe('内置工具（dogfood 扩展机制）', () => {
       'valign-bottom',
       'wrap-text'
     ])
-    expect(groups[3]!.tools.map((tool) => tool.id)).toEqual(['find'])
+    expect(groups[3]!.tools.map((tool) => tool.id)).toEqual(['find', 'functions'])
     expect(groups[4]!.tools.map((tool) => tool.id)).toEqual(['insert-image'])
     expect(groups[5]!.tools.map((tool) => tool.id)).toEqual(['import', 'export'])
 
@@ -214,6 +214,14 @@ describe('内置工具（dogfood 扩展机制）', () => {
     expect(find.disabled).toBeUndefined()
   })
 
+  it('函数工具：弹层型声明（popup: functions），组 edit；纯查看不依赖选区', () => {
+    const tool = mustGet('functions')
+    expect(tool.popup).toBe('functions')
+    expect(tool.group).toBe('edit')
+    expect(tool.icon).toBeTruthy()
+    expect(tool.disabled).toBeUndefined()
+  })
+
   it('插入图片工具：弹层型声明（popup: insert-image），组 insert；无选区禁用', () => {
     const sheet = new Sheet()
     const ctx = createSheetContext(sheet)

package/src/tools/__test__/context.test.ts

@@ -1,5 +1,5 @@
-import { createRange } from '@veltra/sheet-core/core/address'
-import { Sheet } from '@veltra/sheet-core/core/sheet'
+import { createRange } from '@veltra/sheet-core/core/address.js'
+import { Sheet } from '@veltra/sheet-core/core/sheet.js'
 import { describe, expect, it, vi } from 'vitest'
 
 import { createSheetContext } from '../context'

package/src/tools/apply-style.ts

@@ -1,6 +1,6 @@
-import type { CellRange } from '@veltra/sheet-core/core/address'
-import type { SetAxisStyleItem } from '@veltra/sheet-core/core/command/set-axis-style'
-import type { CellStylePatch } from '@veltra/sheet-core/core/style/types'
+import type { CellRange } from '@veltra/sheet-core/core/address.js'
+import type { SetAxisStyleItem } from '@veltra/sheet-core/core/command/set-axis-style.js'
+import type { CellStylePatch } from '@veltra/sheet-core/core/style/types.js'
 
 /** 样式写入目标：整行 / 整列默认样式，或逐格 */
 export type SelectionStyleTarget = 'row' | 'col' | 'cell'

package/src/tools/builtin.ts

@@ -18,13 +18,14 @@ import {
   Underline,
   UnmergeCells,
   Upload,
+  Variable,
   VerticalAlignCenter,
   VerticalAlignLeft,
   VerticalAlignRight,
   Wrap
 } from '@veltra/icons/normal'
-import { rangesEqual } from '@veltra/sheet-core/core/address'
-import type { HorizontalAlign, VerticalAlign } from '@veltra/sheet-core/core/style/types'
+import { rangesEqual } from '@veltra/sheet-core/core/address.js'
+import type { HorizontalAlign, VerticalAlign } from '@veltra/sheet-core/core/style/types.js'
 
 import type { SheetContext } from './context'
 import { registerTool } from './registry'
@@ -365,7 +366,7 @@ registerTool({
   }
 })
 
-// ─── edit（查找）───────────────────────────────────────────
+// ─── edit（查找 / 函数）──────────────────────────────────────
 
 registerTool({
   id: 'find',
@@ -378,6 +379,17 @@ registerTool({
   onClick: () => {}
 })
 
+registerTool({
+  id: 'functions',
+  title: '函数',
+  icon: Variable,
+  tooltip: '按分类浏览并插入函数',
+  group: 'edit',
+  order: 1,
+  popup: 'functions',
+  onClick: () => {}
+})
+
 // ─── insert（插入图片）─────────────────────────────────────
 
 registerTool({

package/src/tools/context.ts

@@ -1,14 +1,14 @@
-import type { CellAddress, CellRange } from '@veltra/sheet-core/core/address'
-import type { CellData, CellValue } from '@veltra/sheet-core/core/cell-store'
-import type { HistoryState } from '@veltra/sheet-core/core/command/history'
-import type { ImageUpdateFields } from '@veltra/sheet-core/core/command/image'
-import type { SetCellValueItem } from '@veltra/sheet-core/core/command/set-cell-value'
-import type { ImageInput, SheetImage } from '@veltra/sheet-core/core/image'
-import type { CellInfo } from '@veltra/sheet-core/core/merge-manager'
-import type { SelectionState } from '@veltra/sheet-core/core/selection'
-import type { FrozenState, Sheet } from '@veltra/sheet-core/core/sheet'
-import type { CellStyle, CellStylePatch } from '@veltra/sheet-core/core/style/types'
-import type { Workbook } from '@veltra/sheet-core/core/workbook'
+import type { CellAddress, CellRange } from '@veltra/sheet-core/core/address.js'
+import type { CellData, CellValue } from '@veltra/sheet-core/core/cell-store.js'
+import type { HistoryState } from '@veltra/sheet-core/core/command/history.js'
+import type { ImageUpdateFields } from '@veltra/sheet-core/core/command/image.js'
+import type { SetCellValueItem } from '@veltra/sheet-core/core/command/set-cell-value.js'
+import type { ImageInput, SheetImage } from '@veltra/sheet-core/core/image.js'
+import type { CellInfo } from '@veltra/sheet-core/core/merge-manager.js'
+import type { SelectionState } from '@veltra/sheet-core/core/selection.js'
+import type { FrozenState, Sheet } from '@veltra/sheet-core/core/sheet.js'
+import type { CellStyle, CellStylePatch } from '@veltra/sheet-core/core/style/types.js'
+import type { Workbook } from '@veltra/sheet-core/core/workbook.js'
 
 import { axisStyleItemsForRange, classifySelectionStyleTarget } from './apply-style'
 

package/src/tools/download.ts

@@ -1,6 +1,6 @@
 import { saveBlob } from '@cat-kit/fe'
-import { exportSheetCsv, exportWorkbookXlsx } from '@veltra/sheet-core/core/io/export'
-import type { Workbook } from '@veltra/sheet-core/core/workbook'
+import { exportSheetCsv, exportWorkbookXlsx } from '@veltra/sheet-core/core/io/export.js'
+import type { Workbook } from '@veltra/sheet-core/core/workbook.js'
 
 import type { SheetContext } from './context'
 import type { ExportWorkerPayload, ExportWorkerResponse } from './export.worker'