@veltra/sheet 4.1.1 → 4.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/dist/components/sheet/formula-bar.js +95 -11
  2. package/dist/components/sheet/sheet.js +5 -3
  3. package/dist/components/sheet/use-formula-ref-select.js +11 -3
  4. package/dist/components/sheet/use-sheet-grid.js +11 -3
  5. package/dist/components/sheet/use-sheet-state.js +1 -1
  6. package/dist/index.js +1 -2
  7. package/dist/tools/builtin.js +307 -305
  8. package/dist/tools/registry.d.ts +3 -1
  9. package/dist/tools/registry.js +7 -2
  10. package/package.json +4 -8
  11. package/src/components/sheet/__test__/canvas-mock.ts +3 -1
  12. package/src/components/sheet/__test__/find-shortcut-anchor.test.ts +2 -0
  13. package/src/components/sheet/__test__/formula-bar.test.ts +205 -0
  14. package/src/components/sheet/__test__/formula-capability.test.ts +2 -0
  15. package/src/components/sheet/__test__/functions-popup.test.ts +2 -0
  16. package/src/components/sheet/__test__/hyperlink-popup.test.ts +2 -0
  17. package/src/components/sheet/__test__/import-file.test.ts +2 -0
  18. package/src/components/sheet/__test__/insert-count-menu-item.test.ts +2 -0
  19. package/src/components/sheet/__test__/insert-image-popup.test.ts +2 -0
  20. package/src/components/sheet/__test__/insert-image.test.ts +2 -0
  21. package/src/components/sheet/__test__/sheet-component.test.ts +4 -1
  22. package/src/components/sheet/__test__/sheet-grow-on-scroll.test.ts +2 -0
  23. package/src/components/sheet/__test__/sheet-scrollbar.test.ts +2 -0
  24. package/src/components/sheet/__test__/sheet-theme.test.ts +2 -0
  25. package/src/components/sheet/__test__/use-formula-ref-select.test.ts +12 -1
  26. package/src/components/sheet/formula-bar.vue +106 -14
  27. package/src/components/sheet/sheet.vue +28 -26
  28. package/src/components/sheet/use-formula-ref-select.ts +13 -0
  29. package/src/components/sheet/use-sheet-grid.ts +26 -7
  30. package/src/index.ts +1 -3
  31. package/src/tools/__test__/builtin.test.ts +2 -2
  32. package/src/tools/builtin.ts +345 -344
  33. package/src/tools/registry.ts +8 -2
  34. package/src/tools/index.ts +0 -3
@@ -1,3 +1,4 @@
1
+ import { BUILTIN_TOOLS } from "./builtin.js";
1
2
  import { TypedEventEmitter } from "infinitable/sheet";
2
3
  //#region src/tools/registry.ts
3
4
  /** 缺省分组名 */
@@ -6,6 +7,10 @@ var ToolRegistry = class {
6
7
  entries = /* @__PURE__ */ new Map();
7
8
  seq = 0;
8
9
  emitter = new TypedEventEmitter();
10
+ /** 装入初始工具(仍经 register 校验);缺省空表 */
11
+ constructor(tools = []) {
12
+ for (const tool of tools) this.register(tool);
13
+ }
9
14
  /** 注册工具;同 id 重复注册 = 替换定义并保留原注册位置 */
10
15
  register(tool) {
11
16
  if (!tool.id) throw new Error("工具注册失败:id 不能为空");
@@ -59,10 +64,10 @@ var ToolRegistry = class {
59
64
  }
60
65
  };
61
66
  /**
62
- * 全局默认注册表(USheet 默认渲染这里的工具;内置工具也注册于此)。
67
+ * 全局默认注册表(USheet 默认渲染这里的工具;内置工具在构造时装入)。
63
68
  * 工具是应用级扩展:注册一次,所有 USheet 实例共享。
64
69
  */
65
- const defaultToolRegistry = new ToolRegistry();
70
+ const defaultToolRegistry = new ToolRegistry(BUILTIN_TOOLS);
66
71
  /** 注册工具到默认注册表 */
67
72
  function registerTool(tool) {
68
73
  defaultToolRegistry.register(tool);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@veltra/sheet",
3
- "version": "4.1.1",
3
+ "version": "4.1.3",
4
4
  "homepage": "https://github.com/cabinet-fe/ultra-ui#readme",
5
5
  "bugs": {
6
6
  "url": "https://github.com/cabinet-fe/ultra-ui/issues"
@@ -18,10 +18,8 @@
18
18
  "sideEffects": [
19
19
  "src/**/style.ts",
20
20
  "src/**/*.scss",
21
- "src/tools/builtin.ts",
22
21
  "dist/**/style.js",
23
- "dist/**/*.css",
24
- "dist/tools/builtin.js"
22
+ "dist/**/*.css"
25
23
  ],
26
24
  "exports": {
27
25
  ".": {
@@ -33,9 +31,6 @@
33
31
  "import": "./dist/*"
34
32
  }
35
33
  },
36
- "dependencies": {
37
- "infinitable": "^0.1.8"
38
- },
39
34
  "peerDependencies": {
40
35
  "@cat-kit/core": ">=1.2.1",
41
36
  "@cat-kit/fe": ">=1.2.1",
@@ -43,6 +38,7 @@
43
38
  "@veltra/icons": "^1.5.0",
44
39
  "@veltra/styles": "^1.7.14",
45
40
  "@veltra/utils": "^1.7.14",
46
- "vue": ">=3.5.43"
41
+ "infinitable": "^0.2.3",
42
+ "vue": ">=3.5.44"
47
43
  }
48
44
  }
@@ -33,8 +33,10 @@ function createContext2dMock(canvas: HTMLCanvasElement): Context2dMock {
33
33
  })
34
34
  }
35
35
 
36
- /** 补丁 HTMLCanvasElement,使 getContext('2d') 返回可用 mock */
36
+ /** 补丁 HTMLCanvasElement,使 getContext('2d') 返回可用 mock;node 环境无该全局,直接跳过 */
37
37
  export function setupCanvasMock(): void {
38
+ if (typeof HTMLCanvasElement === 'undefined') return
39
+
38
40
  const getContext = function (this: HTMLCanvasElement, contextId: string): unknown {
39
41
  if (contextId !== '2d') return null
40
42
  return createContext2dMock(this)
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
2
4
  import { createApp, h, nextTick, type App } from 'vue'
3
5
 
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import { parseRange } from 'infinitable/sheet'
2
4
  import { Workbook } from 'infinitable/sheet'
3
5
  import type { SheetGrid } from 'infinitable/sheet'
@@ -631,6 +633,78 @@ describe('USheet 公式栏:函数补全与引用选择', () => {
631
633
  expect(fxInput(el).value).toBe('=A1+B1')
632
634
  })
633
635
 
636
+ it('shift 扩展:替换上次插入的引用(extend 回交),连续扩展锚点不重置', async () => {
637
+ const sheet = new Workbook().activeSheet
638
+ const { el, exposed } = mountFormulaBar(sheet)
639
+ await nextTick()
640
+ sheet.selectCell({ row: 2, col: 0 })
641
+ await nextTick()
642
+
643
+ setFxText(el, '=SUM(')
644
+ await nextTick()
645
+ exposed.value!.handleRefSelect(parseRange('A1'))
646
+ await nextTick()
647
+ expect(fxInput(el).value).toBe('=SUM(A1')
648
+ // 插入后光标离开触发位(上下文断裂),拾取延续仍成立
649
+ expect(exposed.value!.hasRefInsert()).toBe(true)
650
+
651
+ // shift+点选扩展(引擎 extend 回交):A1 被替换为 A1:C3 而非追加
652
+ exposed.value!.handleRefSelect(parseRange('A1:C3'))
653
+ await nextTick()
654
+ expect(fxInput(el).value).toBe('=SUM(A1:C3')
655
+ expect(fxInput(el).selectionStart).toBe('=SUM(A1:C3'.length)
656
+
657
+ // 连续扩展:引擎锚点恒为首次拾取锚点,A1:C3 整体替换为 A1:D5
658
+ exposed.value!.handleRefSelect(parseRange('A1:D5'))
659
+ await nextTick()
660
+ expect(fxInput(el).value).toBe('=SUM(A1:D5')
661
+ })
662
+
663
+ it('shift 扩展无上次插入(无 extend 上下文)时按普通插入处理', async () => {
664
+ const sheet = new Workbook().activeSheet
665
+ const { el, exposed } = mountFormulaBar(sheet)
666
+ await nextTick()
667
+ sheet.selectCell({ row: 2, col: 0 })
668
+ await nextTick()
669
+
670
+ setFxText(el, '=SUM(')
671
+ await nextTick()
672
+ exposed.value!.handleRefSelect(parseRange('B2'))
673
+ await nextTick()
674
+ expect(fxInput(el).value).toBe('=SUM(B2')
675
+ })
676
+
677
+ it('用户手动输入 / 提交后引用拾取延续终止:extend 不再替换', async () => {
678
+ const sheet = new Workbook().activeSheet
679
+ const { el, exposed } = mountFormulaBar(sheet)
680
+ await nextTick()
681
+ sheet.selectCell({ row: 2, col: 0 })
682
+ await nextTick()
683
+
684
+ setFxText(el, '=SUM(')
685
+ await nextTick()
686
+ exposed.value!.handleRefSelect(parseRange('A1'))
687
+ await nextTick()
688
+ expect(exposed.value!.hasRefInsert()).toBe(true)
689
+
690
+ // 用户输入逗号(input 事件):延续状态清除,回到光标上下文判定
691
+ const input = fxInput(el)
692
+ input.value = '=SUM(A1,'
693
+ input.setSelectionRange(9, 9)
694
+ input.dispatchEvent(new Event('input', { bubbles: true }))
695
+ await nextTick()
696
+ expect(exposed.value!.hasRefInsert()).toBe(false)
697
+ exposed.value!.handleRefSelect(parseRange('B2'))
698
+ await nextTick()
699
+ // 光标在逗号后处于引用上下文 → 普通插入 B2,而非替换 A1
700
+ expect(fxInput(el).value).toBe('=SUM(A1,B2')
701
+
702
+ // Enter 提交:会话结束,延续状态随编辑态一并清除
703
+ input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }))
704
+ await nextTick()
705
+ expect(exposed.value!.hasRefInsert()).toBe(false)
706
+ })
707
+
634
708
  it('多行文本:默认保持单行高度,鼠标进入展开,移出后收起', async () => {
635
709
  const workbook = new Workbook()
636
710
  const sheet = workbook.activeSheet
@@ -661,6 +735,137 @@ describe('USheet 公式栏:函数补全与引用选择', () => {
661
735
  })
662
736
  })
663
737
 
738
+ describe('USheet 公式栏:Point mode 拾取会话(Excel 语义)', () => {
739
+ it('拾取会话中普通点选画布:替换上次引用、编辑不中断、blur 不提交;Enter 提交替换后公式', async () => {
740
+ const workbook = new Workbook()
741
+ const sheet = workbook.activeSheet
742
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
743
+ const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }), exposed)
744
+ await nextTick()
745
+ sheet.selectCell({ row: 2, col: 0 })
746
+ await nextTick()
747
+
748
+ const input = setFxText(el, '=SUM(')
749
+ await nextTick()
750
+
751
+ // 首拾取 A4(引擎选区事件管线:pointerdown 起手 → pointerup 收敛回交)
752
+ const gridEl = gridEventTarget(el)
753
+ const pick = (x: number, y: number) => {
754
+ gridEl.dispatchEvent(
755
+ new PointerEvent('pointerdown', { clientX: x, clientY: y, bubbles: true })
756
+ )
757
+ gridEl.dispatchEvent(new PointerEvent('pointerup', { clientX: x, clientY: y, bubbles: true }))
758
+ }
759
+ pick(51, 117)
760
+ await nextTick()
761
+ expect(input.value).toBe('=SUM(A4')
762
+
763
+ // 普通点选 C3(画布几何:行号列 46、列头 28、列宽 80、行高 28)→ 替换 A4 而非追加
764
+ pick(211, 89)
765
+ await nextTick()
766
+ expect(input.value).toBe('=SUM(C3')
767
+
768
+ // 编辑未中断:模型未写入(真实 blur 已在第二次 pointerdown 时被挂起并消费)
769
+ expect(sheet.getCellData({ row: 2, col: 0 })).toBeUndefined()
770
+ expect(input.value).toBe('=SUM(C3')
771
+
772
+ // Enter 提交替换后的公式
773
+ input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }))
774
+ await nextTick()
775
+ expect(sheet.getCellData({ row: 2, col: 0 })).toMatchObject({ f: 'SUM(C3' })
776
+ })
777
+
778
+ it('拾取会话中点选被编辑格自身:忽略不替换(防循环引用),会话延续', async () => {
779
+ const sheet = new Workbook().activeSheet
780
+ const { el, exposed } = mountFormulaBar(sheet)
781
+ await nextTick()
782
+ sheet.selectCell({ row: 2, col: 0 })
783
+ await nextTick()
784
+
785
+ setFxText(el, '=SUM(')
786
+ await nextTick()
787
+ exposed.value!.handleRefSelect(parseRange('A1'))
788
+ await nextTick()
789
+ expect(fxInput(el).value).toBe('=SUM(A1')
790
+
791
+ // 被编辑格 = A3:拾取视作无操作
792
+ exposed.value!.handleRefSelect(parseRange('A3'))
793
+ await nextTick()
794
+ expect(fxInput(el).value).toBe('=SUM(A1')
795
+ expect(exposed.value!.hasRefInsert()).toBe(true)
796
+ })
797
+ })
798
+
799
+ describe('USheet 公式栏:引用染色框(画布视觉反馈)', () => {
800
+ function mountFormulaBarWithHighlights(
801
+ sheet: Workbook['activeSheet'],
802
+ onHighlights: (items: { range: ReturnType<typeof parseRange>; color: string }[]) => void
803
+ ) {
804
+ const el = document.createElement('div')
805
+ document.body.appendChild(el)
806
+ containers.push(el)
807
+ const exposed: { value: InstanceType<typeof UFormulaBar> | undefined } = { value: undefined }
808
+ const app = createApp({
809
+ render: () =>
810
+ h(UFormulaBar, {
811
+ sheet,
812
+ context: createSheetContext(sheet),
813
+ setRefHighlights: onHighlights,
814
+ ref: (value: unknown) => {
815
+ exposed.value = value as InstanceType<typeof UFormulaBar> | undefined
816
+ }
817
+ })
818
+ })
819
+ app.mount(el)
820
+ apps.push(app)
821
+ return { el, exposed }
822
+ }
823
+
824
+ it('公式编辑中按文本扫描逐引用上框(出现顺序循环取色);手输/拾取替换/会话结束同步', async () => {
825
+ const sheet = new Workbook().activeSheet
826
+ const highlights: { range: ReturnType<typeof parseRange>; color: string }[][] = []
827
+ const { el, exposed } = mountFormulaBarWithHighlights(sheet, (items) => highlights.push(items))
828
+ await nextTick()
829
+ sheet.selectCell({ row: 5, col: 5 })
830
+ await nextTick()
831
+
832
+ // 手输多引用:蓝 / 绿按出现顺序(B2:C4 → (1,1)-(3,2))
833
+ setFxText(el, '=SUM(A1,B2:C4)')
834
+ await nextTick()
835
+ expect(highlights.at(-1)).toEqual([
836
+ { range: { start: { row: 0, col: 0 }, end: { row: 0, col: 0 } }, color: '#2563eb' },
837
+ { range: { start: { row: 1, col: 1 }, end: { row: 3, col: 2 } }, color: '#16a34a' }
838
+ ])
839
+
840
+ // 非公式文本:清除
841
+ setFxText(el, 'plain')
842
+ await nextTick()
843
+ expect(highlights.at(-1)).toEqual([])
844
+
845
+ // 拾取会话:插入 B2:C4 → 染色;普通点选 D1 替换 → 染色跟随(仍单引用、蓝色)
846
+ setFxText(el, '=SUM(')
847
+ await nextTick()
848
+ expect(highlights.at(-1)).toEqual([])
849
+ exposed.value!.handleRefSelect(parseRange('B2:C4'))
850
+ await nextTick()
851
+ expect(highlights.at(-1)).toEqual([
852
+ { range: { start: { row: 1, col: 1 }, end: { row: 3, col: 2 } }, color: '#2563eb' }
853
+ ])
854
+ exposed.value!.handleRefSelect(parseRange('D1'))
855
+ await nextTick()
856
+ expect(fxInput(el).value).toBe('=SUM(D1')
857
+ expect(highlights.at(-1)).toEqual([
858
+ { range: { start: { row: 0, col: 3 }, end: { row: 0, col: 3 } }, color: '#2563eb' }
859
+ ])
860
+
861
+ // 提交(编辑态结束):清除
862
+ expect(highlights.at(-1)).toHaveLength(1)
863
+ fxInput(el).dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }))
864
+ await nextTick()
865
+ expect(highlights.at(-1)).toEqual([])
866
+ })
867
+ })
868
+
664
869
  // ─── 目标格选区高亮保持(弹框打开与参数点选期间)──────────────
665
870
 
666
871
  type GridTable = ReturnType<SheetGrid['getTable']>
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  /**
2
4
  * 公式能力可达性(spec 第 4 项 / 下游 meta 报表合计场景):
3
5
  * 写公式(setCellFormula / setCellValue '=' 前缀)、读公式(getCellData().f)、
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import { listFormulaFunctions, registerFormulaFunction } from 'infinitable'
2
4
  import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
3
5
  import { createApp, h, nextTick, type App } from 'vue'
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
2
4
  import { createApp, h, type App } from 'vue'
3
5
 
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import type { Sheet } from 'infinitable/sheet'
2
4
  import { Workbook } from 'infinitable/sheet'
3
5
  import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import { ContextmenuRootDIKey } from '@veltra/desktop'
2
4
  import { describe, expect, it, vi } from 'vite-plus/test'
3
5
  import { createApp, h, nextTick } from 'vue'
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import { Sheet } from 'infinitable/sheet'
2
4
  import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
3
5
  import { createApp, h, type App } from 'vue'
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import { Sheet } from 'infinitable/sheet'
2
4
  import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
3
5
 
@@ -1,12 +1,15 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import type { FloatObject, SceneEvent } from 'infinitable'
2
4
  import { createRange } from 'infinitable/sheet'
3
5
  import { Workbook } from 'infinitable/sheet'
4
6
  import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
5
7
  import { createApp, h, nextTick, ref, type App, type Component } from 'vue'
6
8
 
7
- import { USheet } from '../../../index'
8
9
  import { registerTool, unregisterTool } from '../../../tools/registry'
9
10
  import type { FloatContextMenuPayload, SheetExposed } from '../../../types'
11
+ // 从组件目录导入:内置工具由注册表构造时装入,不依赖包入口副作用
12
+ import { USheet } from '../index'
10
13
  import { buildColHeaderMenus, buildRowHeaderMenus } from '../sheet-context-menu'
11
14
  // 引擎指针事件模拟与画布几何(cellX/cellY):setup 已跨包引用同目录 setup.ts
12
15
  import { cellX, cellY, fire, gridEventTarget } from './grid-test-utils'
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import { Workbook } from 'infinitable/sheet'
2
4
  import { afterEach, describe, expect, it } from 'vite-plus/test'
3
5
  import { createApp, h, nextTick, ref, type App } from 'vue'
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import { Workbook } from 'infinitable/sheet'
2
4
  import { afterEach, describe, expect, it } from 'vite-plus/test'
3
5
  import { createApp, h, nextTick, ref, type App } from 'vue'
@@ -1,3 +1,5 @@
1
+ // @vitest-environment happy-dom
2
+
1
3
  import { currentTheme, lightTheme } from '@veltra/styles/theme'
2
4
  import { Workbook } from 'infinitable/sheet'
3
5
  import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
@@ -1,6 +1,6 @@
1
1
  import { describe, expect, it } from 'vite-plus/test'
2
2
 
3
- import { insertRefText, isRefSelectContext } from '../use-formula-ref-select'
3
+ import { insertRefText, isRefSelectContext, replaceRefText } from '../use-formula-ref-select'
4
4
 
5
5
  describe('isRefSelectContext', () => {
6
6
  it('运算符 / ( / , / = 之后可插入引用', () => {
@@ -33,3 +33,14 @@ describe('insertRefText', () => {
33
33
  expect(insertRefText('=SUM(XX)', 5, 'A1', 7)).toEqual({ text: '=SUM(A1)', cursor: 7 })
34
34
  })
35
35
  })
36
+
37
+ describe('replaceRefText', () => {
38
+ it('替换区间为引用文本,光标落替换文本后(shift 扩展语义)', () => {
39
+ expect(replaceRefText('=SUM(A1', 5, 7, 'A1:C3')).toEqual({ text: '=SUM(A1:C3', cursor: 10 })
40
+ expect(replaceRefText('=SUM(A1:C3', 5, 10, 'A1:D5')).toEqual({ text: '=SUM(A1:D5', cursor: 10 })
41
+ })
42
+
43
+ it('区间收缩为空等价插入', () => {
44
+ expect(replaceRefText('=SUM(', 5, 5, 'B2')).toEqual({ text: '=SUM(B2', cursor: 7 })
45
+ })
46
+ })
@@ -96,6 +96,7 @@
96
96
  <script lang="ts" setup>
97
97
  import { message, UDropdown } from '@veltra/desktop'
98
98
  import { bem } from '@veltra/utils'
99
+ import { scanFormulaReferences, type ScannedReference } from 'infinitable'
99
100
  import {
100
101
  formatAddress,
101
102
  formatRange,
@@ -119,7 +120,12 @@ import {
119
120
  import type { SheetContext } from '../../tools/context'
120
121
  import UFormulaSuggestList from './formula-suggest-list.vue'
121
122
  import USheetFunctionsPopup from './popups/functions-popup.vue'
122
- import { insertRefText, isRefSelectContext } from './use-formula-ref-select'
123
+ import {
124
+ REF_HIGHLIGHT_COLORS,
125
+ insertRefText,
126
+ isRefSelectContext,
127
+ replaceRefText
128
+ } from './use-formula-ref-select'
123
129
  import {
124
130
  applySuggest,
125
131
  filterFormulaSuggestions,
@@ -145,6 +151,8 @@ const props = defineProps<{
145
151
  context: SheetContext
146
152
  /** fx 编辑会话置/清引擎选区锚点(use-sheet-grid 经活动实例透传;缺省静默) */
147
153
  setSelectionAnchor?: (addr: CellAddress | null) => void
154
+ /** 公式引用染色框同步(use-sheet-grid 经活动实例透传;空数组清除;缺省静默) */
155
+ setRefHighlights?: (items: { range: CellRange; color: string }[]) => void
148
156
  }>()
149
157
 
150
158
  const cls = bem('sheet')
@@ -182,31 +190,106 @@ function isRefSelecting(): boolean {
182
190
  return editing.value && !mirroring.value && isRefSelectContext(fxDraft.value, fxCursor.value)
183
191
  }
184
192
 
185
- /** 网格 pointerdown(capture)→ 挂起即将到来的 blur 提交 */
193
+ /** 上次引用插入的文本区间(fxDraft 内 [start, end)):插入引用后光标离开触发位、
194
+ * isRefSelectContext 判定失效,拾取会话延续依赖它维持 blur 抑制与替换/扩展语义 */
195
+ let lastRefInsert: { start: number; end: number } | null = null
196
+
197
+ function clearRefInsert(): void {
198
+ lastRefInsert = null
199
+ }
200
+
201
+ /** 引用拾取延续中(上次插入的引用可被后续点选替换/扩展,点击画布不退出编辑) */
202
+ function hasRefInsert(): boolean {
203
+ return lastRefInsert !== null
204
+ }
205
+
206
+ /** 网格 pointerdown(capture)→ 挂起即将到来的 blur 提交;拾取会话延续中
207
+ * (上次插入的引用未被打断)同样挂起——任意点击都消费为引用替换/扩展 */
186
208
  function beginBlurSuppress(): void {
187
- if (!isRefSelecting()) return
209
+ if (!isRefSelecting() && !lastRefInsert) return
188
210
  suppressBlurCommit = true
189
211
  }
190
212
 
191
- /** 选区拦截回调:插入 A1 / A1:B2 到光标处(仅引用选择模式;弹框打开但非引用上下文时不插入) */
213
+ /** 选区拦截回调:插入 A1 / A1:B2 到光标处(仅引用选择模式;弹框打开但非引用上下文时不插入)。
214
+ * 拾取会话延续(lastRefInsert 存在):替换上次插入的引用——shift 扩展回交(Excel 锚点
215
+ * 恒定连续扩展)与普通点选(Point mode 换目标)同走此路径,编辑不中断 */
192
216
  function handleRefSelect(range: CellRange): void {
193
- if (!isRefSelecting()) return
217
+ // 延续拾取放行:插入后光标离开触发位、isRefSelectContext 失效,延续回交
218
+ // 靠 lastRefInsert 而非光标上下文成立
219
+ if (!isRefSelecting() && !lastRefInsert) return
220
+ // 被编辑格自身不可拾取为引用(Excel 语义:避免循环引用;点中目标格视作无操作)
221
+ if (
222
+ editAddr &&
223
+ range.start.row === range.end.row &&
224
+ range.start.col === range.end.col &&
225
+ range.start.row === editAddr.row &&
226
+ range.start.col === editAddr.col
227
+ ) {
228
+ return
229
+ }
194
230
  const rangeText = formatRange(range)
195
- const el = fxRef.value
196
- const selEnd = el?.selectionEnd ?? fxCursor.value
197
- const result = insertRefText(fxDraft.value, fxCursor.value, rangeText, selEnd)
198
- fxDraft.value = result.text
199
- fxCursor.value = result.cursor
231
+ if (lastRefInsert) {
232
+ const { start } = lastRefInsert
233
+ const result = replaceRefText(fxDraft.value, start, lastRefInsert.end, rangeText)
234
+ fxDraft.value = result.text
235
+ fxCursor.value = result.cursor
236
+ lastRefInsert = { start, end: result.cursor }
237
+ } else {
238
+ const el = fxRef.value
239
+ const selEnd = el?.selectionEnd ?? fxCursor.value
240
+ const result = insertRefText(fxDraft.value, fxCursor.value, rangeText, selEnd)
241
+ fxDraft.value = result.text
242
+ fxCursor.value = result.cursor
243
+ lastRefInsert = { start: result.cursor - rangeText.length, end: result.cursor }
244
+ }
200
245
  closeSuggest()
201
246
  void nextTick(() => {
202
247
  const input = fxRef.value
203
248
  if (!input) return
204
249
  input.focus()
205
- input.setSelectionRange(result.cursor, result.cursor)
250
+ input.setSelectionRange(fxCursor.value, fxCursor.value)
206
251
  autosizeFx()
207
252
  })
208
253
  }
209
254
 
255
+ // ─── 引用染色框(画布视觉反馈) ────────────────────────────
256
+
257
+ /** 公式文本扫描 → 画布染色框:编辑中且 `=` 开头时逐引用上框(颜色按出现顺序循环),
258
+ * 手输/点选/扩展一视同仁(对齐 Excel:编辑公式即染色全部引用);其余状态清除 */
259
+ function syncRefHighlights(): void {
260
+ if (!editing.value || mirroring.value || !fxDraft.value.startsWith('=')) {
261
+ props.setRefHighlights?.([])
262
+ return
263
+ }
264
+ props.setRefHighlights?.(scanFormulaReferences(fxDraft.value).map(refToHighlight))
265
+ }
266
+
267
+ /** 扫描结果 → 染色框条目(RangeRef 展开为区域,单格引用同形) */
268
+ function refToHighlight(
269
+ scanned: ScannedReference,
270
+ index: number
271
+ ): { range: CellRange; color: string } {
272
+ const color = REF_HIGHLIGHT_COLORS[index % REF_HIGHLIGHT_COLORS.length]!
273
+ const ref = scanned.ref
274
+ if (scanned.isRange) {
275
+ return {
276
+ range: {
277
+ start: { row: ref.startRow, col: ref.startCol },
278
+ end: { row: ref.endRow, col: ref.endCol }
279
+ },
280
+ color
281
+ }
282
+ }
283
+ return {
284
+ range: { start: { row: ref.row, col: ref.col }, end: { row: ref.row, col: ref.col } },
285
+ color
286
+ }
287
+ }
288
+
289
+ // 草稿/编辑态/镜像态任一变化即重扫(拾取回交改稿、手输、会话结束都经这三者;
290
+ // 提交同文提交时 fxDraft 不变但 editing 翻转,watch 仍触发完成清除)
291
+ watch([fxDraft, editing, mirroring], syncRefHighlights)
292
+
210
293
  // ─── 显示文本 ──────────────────────────────────────────────
211
294
 
212
295
  function nameText(state: SelectionState): string {
@@ -316,6 +399,8 @@ function syncFxCursor(): void {
316
399
  }
317
400
 
318
401
  function handleFxInput(): void {
402
+ // 用户手动编辑使上次插入区间失效(shift 扩展只对未经编辑的插入文本有效)
403
+ clearRefInsert()
319
404
  syncFxCursor()
320
405
  autosizeFx()
321
406
  }
@@ -350,6 +435,7 @@ function confirmSuggest(item?: FormulaSuggestItem): void {
350
435
  const result = applySuggest(fxDraft.value, ctx.start, ctx.end, pick.name)
351
436
  fxDraft.value = result.text
352
437
  fxCursor.value = result.cursor
438
+ clearRefInsert()
353
439
  closeSuggest()
354
440
  void nextTick(() => {
355
441
  const el = fxRef.value
@@ -466,8 +552,9 @@ function commitEdit(): void {
466
552
  editing.value = false
467
553
  editAddr = null
468
554
  suppressBlurCommit = false
469
- // 会话结束清锚点(Enter / ✓ / 失焦同路径)
555
+ // 会话结束清锚点(Enter / ✓ / 失焦同路径)与引用插入延续状态
470
556
  props.setSelectionAnchor?.(null)
557
+ clearRefInsert()
471
558
  closeSuggest()
472
559
  if (addr) {
473
560
  props.context.setCellValue(addr, fxDraft.value)
@@ -485,8 +572,9 @@ function cancelEdit(): void {
485
572
  editing.value = false
486
573
  editAddr = null
487
574
  suppressBlurCommit = false
488
- // 会话结束清锚点(Esc / ✗)
575
+ // 会话结束清锚点(Esc / ✗)与引用插入延续状态
489
576
  props.setSelectionAnchor?.(null)
577
+ clearRefInsert()
490
578
  closeSuggest()
491
579
  refreshFx()
492
580
  }
@@ -524,6 +612,7 @@ function mirrorGridEdit(addr: CellAddress): void {
524
612
  mirroring.value = true
525
613
  mirrorAddr = addr
526
614
  fxDraft.value = cellText(addr)
615
+ clearRefInsert()
527
616
  closeSuggest()
528
617
  }
529
618
 
@@ -601,7 +690,8 @@ function insertFunction(name: string): void {
601
690
  fxDraft.value = text
602
691
  fxCursor.value = cursor
603
692
  suppressBlurCommit = false
604
- // 插入函数即进入引用拾取会话:目标格置选区锚点
693
+ // 插入函数即进入引用拾取会话:目标格置选区锚点,新会话清引用插入延续状态
694
+ clearRefInsert()
605
695
  props.setSelectionAnchor?.(addr)
606
696
  closeSuggest()
607
697
  void nextTick(() => {
@@ -621,6 +711,7 @@ defineExpose({
621
711
  mirrorGridEdit,
622
712
  exitMirror,
623
713
  isRefSelecting,
714
+ hasRefInsert,
624
715
  isFunctionPopupOpen: () => functionsOpen.value,
625
716
  beginBlurSuppress,
626
717
  handleRefSelect,
@@ -647,6 +738,7 @@ watch(
647
738
  mirroring.value = false
648
739
  mirrorAddr = null
649
740
  suppressBlurCommit = false
741
+ clearRefInsert()
650
742
  functionsOpen.value = false
651
743
  closeSuggest()
652
744
  bindSheet(sheet)