@veltra/sheet 2.0.0

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 (137) hide show
  1. package/dist/core/address.d.ts +60 -0
  2. package/dist/core/address.js +142 -0
  3. package/dist/core/address.js.map +1 -0
  4. package/dist/core/cell-store.d.ts +61 -0
  5. package/dist/core/cell-store.js +135 -0
  6. package/dist/core/cell-store.js.map +1 -0
  7. package/dist/core/command/default-registry.d.ts +10 -0
  8. package/dist/core/command/default-registry.js +18 -0
  9. package/dist/core/command/default-registry.js.map +1 -0
  10. package/dist/core/command/history.d.ts +64 -0
  11. package/dist/core/command/history.js +127 -0
  12. package/dist/core/command/history.js.map +1 -0
  13. package/dist/core/command/merge-cells.d.ts +21 -0
  14. package/dist/core/command/merge-cells.js +74 -0
  15. package/dist/core/command/merge-cells.js.map +1 -0
  16. package/dist/core/command/registry.d.ts +17 -0
  17. package/dist/core/command/registry.js +26 -0
  18. package/dist/core/command/registry.js.map +1 -0
  19. package/dist/core/command/set-cell-formula.d.ts +17 -0
  20. package/dist/core/command/set-cell-formula.js +29 -0
  21. package/dist/core/command/set-cell-formula.js.map +1 -0
  22. package/dist/core/command/set-cell-value.d.ts +22 -0
  23. package/dist/core/command/set-cell-value.js +35 -0
  24. package/dist/core/command/set-cell-value.js.map +1 -0
  25. package/dist/core/command/types.d.ts +68 -0
  26. package/dist/core/events.js +29 -0
  27. package/dist/core/events.js.map +1 -0
  28. package/dist/core/formula/ast.d.ts +58 -0
  29. package/dist/core/formula/ast.js +38 -0
  30. package/dist/core/formula/ast.js.map +1 -0
  31. package/dist/core/formula/dependency-graph.d.ts +70 -0
  32. package/dist/core/formula/dependency-graph.js +269 -0
  33. package/dist/core/formula/dependency-graph.js.map +1 -0
  34. package/dist/core/formula/errors.d.ts +25 -0
  35. package/dist/core/formula/errors.js +36 -0
  36. package/dist/core/formula/errors.js.map +1 -0
  37. package/dist/core/formula/evaluator.d.ts +41 -0
  38. package/dist/core/formula/evaluator.js +154 -0
  39. package/dist/core/formula/evaluator.js.map +1 -0
  40. package/dist/core/formula/functions.d.ts +30 -0
  41. package/dist/core/formula/functions.js +209 -0
  42. package/dist/core/formula/functions.js.map +1 -0
  43. package/dist/core/formula/parser.d.ts +7 -0
  44. package/dist/core/formula/parser.js +208 -0
  45. package/dist/core/formula/parser.js.map +1 -0
  46. package/dist/core/formula/tokenizer.d.ts +37 -0
  47. package/dist/core/formula/tokenizer.js +146 -0
  48. package/dist/core/formula/tokenizer.js.map +1 -0
  49. package/dist/core/merge-manager.d.ts +64 -0
  50. package/dist/core/merge-manager.js +111 -0
  51. package/dist/core/merge-manager.js.map +1 -0
  52. package/dist/core/selection.d.ts +31 -0
  53. package/dist/core/selection.js +62 -0
  54. package/dist/core/selection.js.map +1 -0
  55. package/dist/core/sheet.d.ts +105 -0
  56. package/dist/core/sheet.js +202 -0
  57. package/dist/core/sheet.js.map +1 -0
  58. package/dist/core/workbook.d.ts +43 -0
  59. package/dist/core/workbook.js +77 -0
  60. package/dist/core/workbook.js.map +1 -0
  61. package/dist/grid/sheet-grid.d.ts +59 -0
  62. package/dist/grid/sheet-grid.js +230 -0
  63. package/dist/grid/sheet-grid.js.map +1 -0
  64. package/dist/index.d.ts +28 -0
  65. package/dist/index.js +25 -0
  66. package/dist/tools/builtin.js +72 -0
  67. package/dist/tools/builtin.js.map +1 -0
  68. package/dist/tools/context.d.ts +57 -0
  69. package/dist/tools/context.js +43 -0
  70. package/dist/tools/context.js.map +1 -0
  71. package/dist/tools/registry.d.ts +68 -0
  72. package/dist/tools/registry.js +77 -0
  73. package/dist/tools/registry.js.map +1 -0
  74. package/dist/types/index.d.ts +2 -0
  75. package/dist/types/sheet.d.ts +43 -0
  76. package/dist/vue/index.d.ts +2 -0
  77. package/dist/vue/sheet.js +185 -0
  78. package/dist/vue/sheet.js.map +1 -0
  79. package/dist/vue/sheet.vue.d.ts +24 -0
  80. package/dist/vue/style.d.ts +1 -0
  81. package/dist/vue/style.js +1 -0
  82. package/dist/vue/style2.css +93 -0
  83. package/package.json +37 -0
  84. package/src/core/__test__/address.test.ts +113 -0
  85. package/src/core/__test__/cell-store.test.ts +97 -0
  86. package/src/core/__test__/command.test.ts +377 -0
  87. package/src/core/__test__/formula-adversarial.test.ts +265 -0
  88. package/src/core/__test__/formula-engine.test.ts +470 -0
  89. package/src/core/__test__/formula-functions.test.ts +178 -0
  90. package/src/core/__test__/formula-parser.test.ts +160 -0
  91. package/src/core/__test__/history.test.ts +225 -0
  92. package/src/core/__test__/merge-manager.test.ts +106 -0
  93. package/src/core/__test__/sheet.test.ts +142 -0
  94. package/src/core/address.ts +166 -0
  95. package/src/core/cell-store.ts +173 -0
  96. package/src/core/command/default-registry.ts +15 -0
  97. package/src/core/command/history.ts +167 -0
  98. package/src/core/command/index.ts +7 -0
  99. package/src/core/command/merge-cells.ts +74 -0
  100. package/src/core/command/registry.ts +30 -0
  101. package/src/core/command/set-cell-formula.ts +29 -0
  102. package/src/core/command/set-cell-value.ts +38 -0
  103. package/src/core/command/types.ts +73 -0
  104. package/src/core/events.ts +37 -0
  105. package/src/core/formula/ast.ts +66 -0
  106. package/src/core/formula/dependency-graph.ts +329 -0
  107. package/src/core/formula/errors.ts +41 -0
  108. package/src/core/formula/evaluator.ts +219 -0
  109. package/src/core/formula/functions.ts +266 -0
  110. package/src/core/formula/index.ts +7 -0
  111. package/src/core/formula/parser.ts +198 -0
  112. package/src/core/formula/tokenizer.ts +160 -0
  113. package/src/core/merge-manager.ts +158 -0
  114. package/src/core/selection.ts +66 -0
  115. package/src/core/sheet.ts +257 -0
  116. package/src/core/workbook.ts +99 -0
  117. package/src/env.d.ts +7 -0
  118. package/src/grid/__test__/canvas-mock.ts +49 -0
  119. package/src/grid/__test__/setup.ts +3 -0
  120. package/src/grid/__test__/sheet-grid-formula.test.ts +140 -0
  121. package/src/grid/__test__/sheet-grid.test.ts +177 -0
  122. package/src/grid/sheet-grid.ts +283 -0
  123. package/src/index.ts +16 -0
  124. package/src/tools/__test__/builtin.test.ts +128 -0
  125. package/src/tools/__test__/context.test.ts +157 -0
  126. package/src/tools/__test__/registry.test.ts +102 -0
  127. package/src/tools/builtin.ts +75 -0
  128. package/src/tools/context.ts +106 -0
  129. package/src/tools/index.ts +2 -0
  130. package/src/tools/registry.ts +129 -0
  131. package/src/types/index.ts +1 -0
  132. package/src/types/sheet.ts +41 -0
  133. package/src/vue/__test__/sheet-component.test.ts +267 -0
  134. package/src/vue/index.ts +1 -0
  135. package/src/vue/sheet.vue +195 -0
  136. package/src/vue/style.scss +94 -0
  137. package/src/vue/style.ts +1 -0
@@ -0,0 +1,43 @@
1
+ //#region src/tools/context.ts
2
+ /**
3
+ * 创建工具上下文。
4
+ * @param resolveSheet 活动 sheet 解析器(USheet 传 `() => activeSheet`,
5
+ * tab 切换后上下文自动指向当前 sheet);也可直接传 Sheet 实例(无头 / 测试场景)
6
+ */
7
+ function createSheetContext(resolveSheet) {
8
+ const sheet = typeof resolveSheet === "function" ? resolveSheet : () => resolveSheet;
9
+ return {
10
+ get sheetName() {
11
+ return sheet().name;
12
+ },
13
+ getSelection: () => sheet().getSelection(),
14
+ selectCell: (addr) => sheet().selectCell(addr),
15
+ selectRange: (range) => sheet().selectRange(range),
16
+ getCellData: (addr) => sheet().getCellData(addr),
17
+ getDisplayValue: (addr) => sheet().getDisplayValue(addr),
18
+ getCellInfo: (addr) => sheet().getCellInfo(addr),
19
+ setCellValue: (addr, value) => sheet().setCellValue(addr, value),
20
+ setCellFormula: (addr, formula) => sheet().setCellFormula(addr, formula),
21
+ setCells: (items) => sheet().setCells(items),
22
+ mergeCells: (range) => sheet().mergeCells(range),
23
+ unmergeCells: (range) => sheet().unmergeCells(range),
24
+ executeCommand: (commandId, params) => sheet().executeCommand(commandId, params),
25
+ beginTransaction: () => sheet().beginTransaction(),
26
+ commit: () => sheet().commit(),
27
+ rollback: () => sheet().rollback(),
28
+ undo: () => sheet().undo(),
29
+ redo: () => sheet().redo(),
30
+ get canUndo() {
31
+ return sheet().canUndo;
32
+ },
33
+ get canRedo() {
34
+ return sheet().canRedo;
35
+ },
36
+ onSelectionChange: (handler) => sheet().on("selection-change", handler),
37
+ onHistoryChange: (handler) => sheet().on("history-change", handler)
38
+ };
39
+ }
40
+ //#endregion
41
+ export { createSheetContext };
42
+
43
+ //# sourceMappingURL=context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.js","names":[],"sources":["../../src/tools/context.ts"],"sourcesContent":["import type { CellAddress, CellRange } from '../core/address'\nimport type { CellData, CellValue } from '../core/cell-store'\nimport type { HistoryState } from '../core/command/history'\nimport type { SetCellValueItem } from '../core/command/set-cell-value'\nimport type { CellInfo } from '../core/merge-manager'\nimport type { SelectionState } from '../core/selection'\nimport type { Sheet } from '../core/sheet'\n\n/**\n * SheetContext:工具的唯一操作门面。\n *\n * 工具(内置与第三方)对表格的全部操作都经由此门面:\n * - 读方法直达当前活动 sheet(语义与 Sheet 同名方法一致)\n * - 写方法全部走命令系统,天然进入 undo 历史——扩展无法绕过命令系统\n * - 不暴露 Sheet 实例本身,保证门面就是扩展能力的全部边界\n * - USheet 切换 sheet tab 后,同一上下文自动指向新的活动 sheet\n */\nexport interface SheetContext {\n /** 当前活动 sheet 名 */\n readonly sheetName: string\n\n // ─── 选区 ────────────────────────────────────────────────\n getSelection(): SelectionState\n /** 选中单格(被覆盖格自动定位锚点) */\n selectCell(addr: CellAddress): void\n selectRange(range: CellRange): void\n\n // ─── 读取 ────────────────────────────────────────────────\n /** 原始存储语义读取(被合并覆盖格 → undefined) */\n getCellData(addr: CellAddress): CellData | undefined\n /** 锚点解析语义读取(被覆盖格 → 锚点的值) */\n getDisplayValue(addr: CellAddress): CellValue | undefined\n /** 合并语义下的单元格信息(普通格 / 合并锚点 / 被覆盖格) */\n getCellInfo(addr: CellAddress): CellInfo\n\n // ─── 写入(全部经命令系统,可 undo) ───────────────────────\n setCellValue(addr: CellAddress, value: CellValue): void\n setCellFormula(addr: CellAddress, formula: string): void\n /** 批量写入(一次调用 = 一个 undo 单元) */\n setCells(items: SetCellValueItem[]): void\n mergeCells(range: CellRange): CellRange\n unmergeCells(range: CellRange): void\n /** 执行命令注册表中的自定义命令(高级扩展点) */\n executeCommand<R = void>(commandId: string, params: unknown): R | undefined\n\n // ─── 事务(事务内多次写入合并为一个 undo 单元) ─────────────\n beginTransaction(): void\n commit(): void\n rollback(): void\n\n // ─── 历史 ────────────────────────────────────────────────\n undo(): boolean\n redo(): boolean\n readonly canUndo: boolean\n readonly canRedo: boolean\n\n // ─── 事件订阅(订阅时绑定到当前活动 sheet;tab 切换后需重新订阅) ──\n onSelectionChange(handler: (state: SelectionState) => void): () => void\n onHistoryChange(handler: (state: HistoryState) => void): () => void\n}\n\n/**\n * 创建工具上下文。\n * @param resolveSheet 活动 sheet 解析器(USheet 传 `() => activeSheet`,\n * tab 切换后上下文自动指向当前 sheet);也可直接传 Sheet 实例(无头 / 测试场景)\n */\nexport function createSheetContext(resolveSheet: Sheet | (() => Sheet)): SheetContext {\n const sheet = typeof resolveSheet === 'function' ? resolveSheet : () => resolveSheet\n return {\n get sheetName() {\n return sheet().name\n },\n\n getSelection: () => sheet().getSelection(),\n selectCell: (addr) => sheet().selectCell(addr),\n selectRange: (range) => sheet().selectRange(range),\n\n getCellData: (addr) => sheet().getCellData(addr),\n getDisplayValue: (addr) => sheet().getDisplayValue(addr),\n getCellInfo: (addr) => sheet().getCellInfo(addr),\n\n setCellValue: (addr, value) => sheet().setCellValue(addr, value),\n setCellFormula: (addr, formula) => sheet().setCellFormula(addr, formula),\n setCells: (items) => sheet().setCells(items),\n mergeCells: (range) => sheet().mergeCells(range),\n unmergeCells: (range) => sheet().unmergeCells(range),\n executeCommand: <R = void>(commandId: string, params: unknown): R | undefined =>\n sheet().executeCommand<R>(commandId, params),\n\n beginTransaction: () => sheet().beginTransaction(),\n commit: () => sheet().commit(),\n rollback: () => sheet().rollback(),\n\n undo: () => sheet().undo(),\n redo: () => sheet().redo(),\n get canUndo() {\n return sheet().canUndo\n },\n get canRedo() {\n return sheet().canRedo\n },\n\n onSelectionChange: (handler) => sheet().on('selection-change', handler),\n onHistoryChange: (handler) => sheet().on('history-change', handler)\n }\n}\n"],"mappings":";;;;;;AAkEA,SAAgB,mBAAmB,cAAmD;CACpF,MAAM,QAAQ,OAAO,iBAAiB,aAAa,qBAAqB;CACxE,OAAO;EACL,IAAI,YAAY;GACd,OAAO,MAAM,CAAC,CAAC;EACjB;EAEA,oBAAoB,MAAM,CAAC,CAAC,aAAa;EACzC,aAAa,SAAS,MAAM,CAAC,CAAC,WAAW,IAAI;EAC7C,cAAc,UAAU,MAAM,CAAC,CAAC,YAAY,KAAK;EAEjD,cAAc,SAAS,MAAM,CAAC,CAAC,YAAY,IAAI;EAC/C,kBAAkB,SAAS,MAAM,CAAC,CAAC,gBAAgB,IAAI;EACvD,cAAc,SAAS,MAAM,CAAC,CAAC,YAAY,IAAI;EAE/C,eAAe,MAAM,UAAU,MAAM,CAAC,CAAC,aAAa,MAAM,KAAK;EAC/D,iBAAiB,MAAM,YAAY,MAAM,CAAC,CAAC,eAAe,MAAM,OAAO;EACvE,WAAW,UAAU,MAAM,CAAC,CAAC,SAAS,KAAK;EAC3C,aAAa,UAAU,MAAM,CAAC,CAAC,WAAW,KAAK;EAC/C,eAAe,UAAU,MAAM,CAAC,CAAC,aAAa,KAAK;EACnD,iBAA2B,WAAmB,WAC5C,MAAM,CAAC,CAAC,eAAkB,WAAW,MAAM;EAE7C,wBAAwB,MAAM,CAAC,CAAC,iBAAiB;EACjD,cAAc,MAAM,CAAC,CAAC,OAAO;EAC7B,gBAAgB,MAAM,CAAC,CAAC,SAAS;EAEjC,YAAY,MAAM,CAAC,CAAC,KAAK;EACzB,YAAY,MAAM,CAAC,CAAC,KAAK;EACzB,IAAI,UAAU;GACZ,OAAO,MAAM,CAAC,CAAC;EACjB;EACA,IAAI,UAAU;GACZ,OAAO,MAAM,CAAC,CAAC;EACjB;EAEA,oBAAoB,YAAY,MAAM,CAAC,CAAC,GAAG,oBAAoB,OAAO;EACtE,kBAAkB,YAAY,MAAM,CAAC,CAAC,GAAG,kBAAkB,OAAO;CACpE;AACF"}
@@ -0,0 +1,68 @@
1
+ import { SheetContext } from "./context.js";
2
+ //#region src/tools/registry.d.ts
3
+ /**
4
+ * 工具注册表:USheet 工具栏的扩展点。
5
+ *
6
+ * - 工具是框架无关的纯定义(icon 由 vue 层渲染,故此处类型为 unknown)
7
+ * - 分组渲染:同组工具连续排列,组间渲染分隔符;
8
+ * 组序 = 各组最早注册位置,组内按 (order, 注册序) 升序
9
+ * - 同 id 重复注册 = 替换定义并保留原注册位置(HMR / 覆盖内置工具友好)
10
+ * - 默认注册表全局共享:所有 USheet 实例渲染同一组工具
11
+ * (与 defaultCommandRegistry 同语义;每个实例的 SheetContext 各自绑定当前 sheet)
12
+ */
13
+ /** 工具定义 */
14
+ interface SheetTool {
15
+ /** 唯一 id;同 id 重复注册视为替换(保留原位置) */
16
+ id: string;
17
+ /** 按钮文本 */
18
+ title: string;
19
+ /** 图标(Vue 组件,由 USheet 渲染;tools 层不依赖 vue 故为 unknown) */
20
+ icon?: unknown;
21
+ /** 悬浮提示;缺省用 title */
22
+ tooltip?: string;
23
+ /** 分组名(组间渲染分隔符);缺省 'default' */
24
+ group?: string;
25
+ /** 组内排序(升序,相同 order 按注册先后);缺省 0 */
26
+ order?: number;
27
+ /** 是否可见(工具栏状态刷新时求值);缺省可见 */
28
+ visible?(ctx: SheetContext): boolean;
29
+ /** 是否禁用(工具栏状态刷新时求值);缺省可用 */
30
+ disabled?(ctx: SheetContext): boolean;
31
+ /** 点击执行;ctx 是唯一操作入口(写操作全走命令系统,天然可撤销) */
32
+ onClick(ctx: SheetContext): void;
33
+ }
34
+ /** 分组视图(供工具栏渲染) */
35
+ interface SheetToolGroup {
36
+ name: string;
37
+ tools: SheetTool[];
38
+ }
39
+ /** 缺省分组名 */
40
+ declare const DEFAULT_TOOL_GROUP = "default";
41
+ declare class ToolRegistry {
42
+ private entries;
43
+ private seq;
44
+ private emitter;
45
+ /** 注册工具;同 id 重复注册 = 替换定义并保留原注册位置 */
46
+ register(tool: SheetTool): void;
47
+ /** 注销工具;id 不存在时返回 false(不触发 change) */
48
+ unregister(id: string): boolean;
49
+ get(id: string): SheetTool | undefined;
50
+ has(id: string): boolean;
51
+ get size(): number;
52
+ /** 分组视图:组序 = 各组最早注册位置;组内按 (order, 注册序) 升序 */
53
+ getGroups(): SheetToolGroup[];
54
+ /** 订阅注册表变化(register / unregister),返回取消订阅函数 */
55
+ onChange(handler: () => void): () => void;
56
+ }
57
+ /**
58
+ * 全局默认注册表(USheet 默认渲染这里的工具;内置工具也注册于此)。
59
+ * 工具是应用级扩展:注册一次,所有 USheet 实例共享。
60
+ */
61
+ declare const defaultToolRegistry: ToolRegistry;
62
+ /** 注册工具到默认注册表 */
63
+ declare function registerTool(tool: SheetTool): void;
64
+ /** 从默认注册表注销工具;id 不存在时返回 false */
65
+ declare function unregisterTool(id: string): boolean;
66
+ //#endregion
67
+ export { DEFAULT_TOOL_GROUP, SheetTool, SheetToolGroup, ToolRegistry, defaultToolRegistry, registerTool, unregisterTool };
68
+ //# sourceMappingURL=registry.d.ts.map
@@ -0,0 +1,77 @@
1
+ import { TypedEventEmitter } from "../core/events.js";
2
+ //#region src/tools/registry.ts
3
+ /** 缺省分组名 */
4
+ const DEFAULT_TOOL_GROUP = "default";
5
+ var ToolRegistry = class {
6
+ entries = /* @__PURE__ */ new Map();
7
+ seq = 0;
8
+ emitter = new TypedEventEmitter();
9
+ /** 注册工具;同 id 重复注册 = 替换定义并保留原注册位置 */
10
+ register(tool) {
11
+ if (!tool.id) throw new Error("工具注册失败:id 不能为空");
12
+ if (!tool.title) throw new Error(`工具注册失败:${tool.id} 缺少 title`);
13
+ if (typeof tool.onClick !== "function") throw new Error(`工具注册失败:${tool.id} 缺少 onClick`);
14
+ const prev = this.entries.get(tool.id);
15
+ this.entries.set(tool.id, {
16
+ tool,
17
+ seq: prev?.seq ?? this.seq++
18
+ });
19
+ this.emitter.emit("change", null);
20
+ }
21
+ /** 注销工具;id 不存在时返回 false(不触发 change) */
22
+ unregister(id) {
23
+ const existed = this.entries.delete(id);
24
+ if (existed) this.emitter.emit("change", null);
25
+ return existed;
26
+ }
27
+ get(id) {
28
+ return this.entries.get(id)?.tool;
29
+ }
30
+ has(id) {
31
+ return this.entries.has(id);
32
+ }
33
+ get size() {
34
+ return this.entries.size;
35
+ }
36
+ /** 分组视图:组序 = 各组最早注册位置;组内按 (order, 注册序) 升序 */
37
+ getGroups() {
38
+ const groups = /* @__PURE__ */ new Map();
39
+ for (const entry of this.entries.values()) {
40
+ const name = entry.tool.group ?? "default";
41
+ let group = groups.get(name);
42
+ if (!group) {
43
+ group = {
44
+ entries: [],
45
+ firstSeq: entry.seq
46
+ };
47
+ groups.set(name, group);
48
+ }
49
+ group.entries.push(entry);
50
+ }
51
+ return [...groups.entries()].sort((a, b) => a[1].firstSeq - b[1].firstSeq).map(([name, group]) => ({
52
+ name,
53
+ tools: group.entries.slice().sort((a, b) => (a.tool.order ?? 0) - (b.tool.order ?? 0) || a.seq - b.seq).map((entry) => entry.tool)
54
+ }));
55
+ }
56
+ /** 订阅注册表变化(register / unregister),返回取消订阅函数 */
57
+ onChange(handler) {
58
+ return this.emitter.on("change", handler);
59
+ }
60
+ };
61
+ /**
62
+ * 全局默认注册表(USheet 默认渲染这里的工具;内置工具也注册于此)。
63
+ * 工具是应用级扩展:注册一次,所有 USheet 实例共享。
64
+ */
65
+ const defaultToolRegistry = new ToolRegistry();
66
+ /** 注册工具到默认注册表 */
67
+ function registerTool(tool) {
68
+ defaultToolRegistry.register(tool);
69
+ }
70
+ /** 从默认注册表注销工具;id 不存在时返回 false */
71
+ function unregisterTool(id) {
72
+ return defaultToolRegistry.unregister(id);
73
+ }
74
+ //#endregion
75
+ export { DEFAULT_TOOL_GROUP, ToolRegistry, defaultToolRegistry, registerTool, unregisterTool };
76
+
77
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","names":[],"sources":["../../src/tools/registry.ts"],"sourcesContent":["import { TypedEventEmitter } from '../core/events'\nimport type { SheetContext } from './context'\n\n/**\n * 工具注册表:USheet 工具栏的扩展点。\n *\n * - 工具是框架无关的纯定义(icon 由 vue 层渲染,故此处类型为 unknown)\n * - 分组渲染:同组工具连续排列,组间渲染分隔符;\n * 组序 = 各组最早注册位置,组内按 (order, 注册序) 升序\n * - 同 id 重复注册 = 替换定义并保留原注册位置(HMR / 覆盖内置工具友好)\n * - 默认注册表全局共享:所有 USheet 实例渲染同一组工具\n * (与 defaultCommandRegistry 同语义;每个实例的 SheetContext 各自绑定当前 sheet)\n */\n\n/** 工具定义 */\nexport interface SheetTool {\n /** 唯一 id;同 id 重复注册视为替换(保留原位置) */\n id: string\n /** 按钮文本 */\n title: string\n /** 图标(Vue 组件,由 USheet 渲染;tools 层不依赖 vue 故为 unknown) */\n icon?: unknown\n /** 悬浮提示;缺省用 title */\n tooltip?: string\n /** 分组名(组间渲染分隔符);缺省 'default' */\n group?: string\n /** 组内排序(升序,相同 order 按注册先后);缺省 0 */\n order?: number\n /** 是否可见(工具栏状态刷新时求值);缺省可见 */\n visible?(ctx: SheetContext): boolean\n /** 是否禁用(工具栏状态刷新时求值);缺省可用 */\n disabled?(ctx: SheetContext): boolean\n /** 点击执行;ctx 是唯一操作入口(写操作全走命令系统,天然可撤销) */\n onClick(ctx: SheetContext): void\n}\n\n/** 分组视图(供工具栏渲染) */\nexport interface SheetToolGroup {\n name: string\n tools: SheetTool[]\n}\n\n/** 缺省分组名 */\nexport const DEFAULT_TOOL_GROUP = 'default'\n\ntype ToolEntry = { tool: SheetTool; seq: number }\n\ntype ToolRegistryEvents = { change: null }\n\nexport class ToolRegistry {\n private entries = new Map<string, ToolEntry>()\n private seq = 0\n private emitter = new TypedEventEmitter<ToolRegistryEvents>()\n\n /** 注册工具;同 id 重复注册 = 替换定义并保留原注册位置 */\n register(tool: SheetTool): void {\n if (!tool.id) throw new Error('工具注册失败:id 不能为空')\n if (!tool.title) throw new Error(`工具注册失败:${tool.id} 缺少 title`)\n if (typeof tool.onClick !== 'function') {\n throw new Error(`工具注册失败:${tool.id} 缺少 onClick`)\n }\n const prev = this.entries.get(tool.id)\n this.entries.set(tool.id, { tool, seq: prev?.seq ?? this.seq++ })\n this.emitter.emit('change', null)\n }\n\n /** 注销工具;id 不存在时返回 false(不触发 change) */\n unregister(id: string): boolean {\n const existed = this.entries.delete(id)\n if (existed) this.emitter.emit('change', null)\n return existed\n }\n\n get(id: string): SheetTool | undefined {\n return this.entries.get(id)?.tool\n }\n\n has(id: string): boolean {\n return this.entries.has(id)\n }\n\n get size(): number {\n return this.entries.size\n }\n\n /** 分组视图:组序 = 各组最早注册位置;组内按 (order, 注册序) 升序 */\n getGroups(): SheetToolGroup[] {\n const groups = new Map<string, { entries: ToolEntry[]; firstSeq: number }>()\n for (const entry of this.entries.values()) {\n const name = entry.tool.group ?? DEFAULT_TOOL_GROUP\n let group = groups.get(name)\n if (!group) {\n group = { entries: [], firstSeq: entry.seq }\n groups.set(name, group)\n }\n group.entries.push(entry)\n }\n return [...groups.entries()]\n .sort((a, b) => a[1].firstSeq - b[1].firstSeq)\n .map(([name, group]) => ({\n name,\n tools: group.entries\n .slice()\n .sort((a, b) => (a.tool.order ?? 0) - (b.tool.order ?? 0) || a.seq - b.seq)\n .map((entry) => entry.tool)\n }))\n }\n\n /** 订阅注册表变化(register / unregister),返回取消订阅函数 */\n onChange(handler: () => void): () => void {\n return this.emitter.on('change', handler)\n }\n}\n\n/**\n * 全局默认注册表(USheet 默认渲染这里的工具;内置工具也注册于此)。\n * 工具是应用级扩展:注册一次,所有 USheet 实例共享。\n */\nexport const defaultToolRegistry = new ToolRegistry()\n\n/** 注册工具到默认注册表 */\nexport function registerTool(tool: SheetTool): void {\n defaultToolRegistry.register(tool)\n}\n\n/** 从默认注册表注销工具;id 不存在时返回 false */\nexport function unregisterTool(id: string): boolean {\n return defaultToolRegistry.unregister(id)\n}\n"],"mappings":";;;AA2CA,MAAa,qBAAqB;AAMlC,IAAa,eAAb,MAA0B;CACxB,0BAAkB,IAAI,IAAuB;CAC7C,MAAc;CACd,UAAkB,IAAI,kBAAsC;;CAG5D,SAAS,MAAuB;EAC9B,IAAI,CAAC,KAAK,IAAI,MAAM,IAAI,MAAM,gBAAgB;EAC9C,IAAI,CAAC,KAAK,OAAO,MAAM,IAAI,MAAM,UAAU,KAAK,GAAG,UAAU;EAC7D,IAAI,OAAO,KAAK,YAAY,YAC1B,MAAM,IAAI,MAAM,UAAU,KAAK,GAAG,YAAY;EAEhD,MAAM,OAAO,KAAK,QAAQ,IAAI,KAAK,EAAE;EACrC,KAAK,QAAQ,IAAI,KAAK,IAAI;GAAE;GAAM,KAAK,MAAM,OAAO,KAAK;EAAM,CAAC;EAChE,KAAK,QAAQ,KAAK,UAAU,IAAI;CAClC;;CAGA,WAAW,IAAqB;EAC9B,MAAM,UAAU,KAAK,QAAQ,OAAO,EAAE;EACtC,IAAI,SAAS,KAAK,QAAQ,KAAK,UAAU,IAAI;EAC7C,OAAO;CACT;CAEA,IAAI,IAAmC;EACrC,OAAO,KAAK,QAAQ,IAAI,EAAE,CAAC,EAAE;CAC/B;CAEA,IAAI,IAAqB;EACvB,OAAO,KAAK,QAAQ,IAAI,EAAE;CAC5B;CAEA,IAAI,OAAe;EACjB,OAAO,KAAK,QAAQ;CACtB;;CAGA,YAA8B;EAC5B,MAAM,yBAAS,IAAI,IAAwD;EAC3E,KAAK,MAAM,SAAS,KAAK,QAAQ,OAAO,GAAG;GACzC,MAAM,OAAO,MAAM,KAAK,SAAA;GACxB,IAAI,QAAQ,OAAO,IAAI,IAAI;GAC3B,IAAI,CAAC,OAAO;IACV,QAAQ;KAAE,SAAS,CAAC;KAAG,UAAU,MAAM;IAAI;IAC3C,OAAO,IAAI,MAAM,KAAK;GACxB;GACA,MAAM,QAAQ,KAAK,KAAK;EAC1B;EACA,OAAO,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC,CACzB,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,CAC7C,KAAK,CAAC,MAAM,YAAY;GACvB;GACA,OAAO,MAAM,QACV,MAAM,CAAC,CACP,MAAM,GAAG,OAAO,EAAE,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAC1E,KAAK,UAAU,MAAM,IAAI;EAC9B,EAAE;CACN;;CAGA,SAAS,SAAiC;EACxC,OAAO,KAAK,QAAQ,GAAG,UAAU,OAAO;CAC1C;AACF;;;;;AAMA,MAAa,sBAAsB,IAAI,aAAa;;AAGpD,SAAgB,aAAa,MAAuB;CAClD,oBAAoB,SAAS,IAAI;AACnC;;AAGA,SAAgB,eAAe,IAAqB;CAClD,OAAO,oBAAoB,WAAW,EAAE;AAC1C"}
@@ -0,0 +1,2 @@
1
+ import { SheetEmits, SheetExposed, SheetProps, _SheetExposed } from "./sheet.js";
2
+ export { SheetEmits, SheetExposed, SheetProps, _SheetExposed };
@@ -0,0 +1,43 @@
1
+ import { Sheet } from "../core/sheet.js";
2
+ import { Workbook } from "../core/workbook.js";
3
+ import { SheetGrid } from "../grid/sheet-grid.js";
4
+ import { SheetContext } from "../tools/context.js";
5
+ import { ComputedRef } from "vue";
6
+ import { DeconstructValue } from "@veltra/utils";
7
+ //#region src/types/sheet.d.ts
8
+ /** 电子表格组件属性 */
9
+ interface SheetProps {
10
+ /** 工作簿实例(多 sheet / 跨表公式的载体);缺省内部自建(单 sheet) */
11
+ workbook?: Workbook;
12
+ /** 渲染行数,默认 100 */
13
+ rows?: number;
14
+ /** 渲染列数,默认 26(A..Z) */
15
+ cols?: number;
16
+ /** 是否显示工具栏,默认 true */
17
+ showToolbar?: boolean;
18
+ /** 是否显示底部 sheet 标签栏,默认 true */
19
+ showTabs?: boolean;
20
+ }
21
+ interface SheetEmits {
22
+ /** 激活 sheet 切换(点击 tab 或宿主调用 workbook.activateSheet) */
23
+ (name: 'active-sheet-change', payload: {
24
+ sheet: Sheet;
25
+ index: number;
26
+ }): void;
27
+ }
28
+ /** 在组件内部引用 */
29
+ interface _SheetExposed {
30
+ /** 当前工作簿(props.workbook 缺省时为内部自建实例) */
31
+ workbook: ComputedRef<Workbook>;
32
+ /** 当前活动 sheet */
33
+ getActiveSheet: () => Sheet;
34
+ /** 工具上下文(与工具栏工具同一门面;tab 切换后自动指向当前 sheet) */
35
+ getContext: () => SheetContext;
36
+ /** 底层 SheetGrid(调试/测试用) */
37
+ getGrid: () => SheetGrid | undefined;
38
+ }
39
+ /** 电子表格组件暴露的属性和方法 */
40
+ type SheetExposed = DeconstructValue<_SheetExposed>;
41
+ //#endregion
42
+ export { SheetEmits, SheetExposed, SheetProps, _SheetExposed };
43
+ //# sourceMappingURL=sheet.d.ts.map
@@ -0,0 +1,2 @@
1
+ import _default from "./sheet.vue.js";
2
+ export { _default as USheet };
@@ -0,0 +1,185 @@
1
+ import { defaultToolRegistry } from "../tools/registry.js";
2
+ import { Workbook } from "../core/workbook.js";
3
+ import { SheetGrid } from "../grid/sheet-grid.js";
4
+ import { createSheetContext } from "../tools/context.js";
5
+ import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, normalizeClass, onBeforeUnmount, onMounted, openBlock, ref, renderList, resolveDynamicComponent, shallowRef, toDisplayString, unref, useTemplateRef, watch } from "vue";
6
+ import { bem } from "@veltra/utils";
7
+ //#region src/vue/sheet.vue
8
+ const _hoisted_1 = [
9
+ "disabled",
10
+ "title",
11
+ "onClick"
12
+ ];
13
+ const _hoisted_2 = ["onClick"];
14
+ const _sfc_main = /*@__PURE__*/ defineComponent({
15
+ name: "USheet",
16
+ __name: "sheet",
17
+ props: {
18
+ workbook: {},
19
+ rows: { default: 100 },
20
+ cols: { default: 26 },
21
+ showToolbar: {
22
+ type: Boolean,
23
+ default: true
24
+ },
25
+ showTabs: {
26
+ type: Boolean,
27
+ default: true
28
+ }
29
+ },
30
+ emits: ["active-sheet-change"],
31
+ setup(__props, { expose: __expose, emit: __emit }) {
32
+ const props = __props;
33
+ const emit = __emit;
34
+ const cls = bem("sheet");
35
+ /** 工作簿:外部传入或内部自建(单 sheet) */
36
+ const internalWorkbook = new Workbook();
37
+ const workbook = computed(() => props.workbook ?? internalWorkbook);
38
+ /** 激活 sheet 索引(镜像 workbook.activeSheetIndex,经事件同步) */
39
+ const activeIndex = ref(workbook.value.activeSheetIndex);
40
+ /** sheet 列表(tabs 渲染;由 sheets-change 同步) */
41
+ const sheetList = shallowRef(workbook.value.getSheets());
42
+ const activeSheet = computed(() => sheetList.value[activeIndex.value] ?? workbook.value.activeSheet);
43
+ /** 工具上下文:动态解析活动 sheet,tab 切换后自动指向当前 sheet */
44
+ const context = createSheetContext(() => activeSheet.value);
45
+ const gridRef = useTemplateRef("gridRef");
46
+ let grid;
47
+ const stateTick = ref(0);
48
+ const bump = () => {
49
+ stateTick.value++;
50
+ };
51
+ let disposeSheetEvents = [];
52
+ /** 订阅活动 sheet 的状态源(tab 切换 / 工作簿变更时重绑) */
53
+ function bindSheetEvents(sheet) {
54
+ for (const dispose of disposeSheetEvents) dispose();
55
+ disposeSheetEvents = [
56
+ sheet.on("selection-change", bump),
57
+ sheet.on("history-change", bump),
58
+ sheet.on("cell-change", bump),
59
+ sheet.on("merge-change", bump)
60
+ ];
61
+ }
62
+ let disposeWorkbookEvents = [];
63
+ function bindWorkbookEvents(wb) {
64
+ for (const dispose of disposeWorkbookEvents) dispose();
65
+ disposeWorkbookEvents = [wb.on("sheets-change", ({ sheets }) => {
66
+ sheetList.value = sheets;
67
+ bump();
68
+ }), wb.on("active-sheet-change", ({ sheet, index }) => {
69
+ activeIndex.value = index;
70
+ bindSheetEvents(sheet);
71
+ rebuildGrid();
72
+ bump();
73
+ emit("active-sheet-change", {
74
+ sheet,
75
+ index
76
+ });
77
+ })];
78
+ }
79
+ const offRegistryChange = defaultToolRegistry.onChange(bump);
80
+ const toolGroups = computed(() => {
81
+ stateTick.value;
82
+ return defaultToolRegistry.getGroups().map((group) => ({
83
+ name: group.name,
84
+ tools: group.tools.map((tool) => ({
85
+ tool,
86
+ visible: tool.visible?.(context) ?? true,
87
+ disabled: tool.disabled?.(context) ?? false
88
+ })).filter((item) => item.visible)
89
+ })).filter((group) => group.tools.length > 0);
90
+ });
91
+ function handleToolClick(tool) {
92
+ if (tool.disabled?.(context)) return;
93
+ tool.onClick(context);
94
+ }
95
+ function handleTabClick(index) {
96
+ if (index === activeIndex.value) return;
97
+ const sheet = sheetList.value[index];
98
+ if (sheet) workbook.value.activateSheet(sheet.name);
99
+ }
100
+ function rebuildGrid() {
101
+ const container = gridRef.value;
102
+ if (!container) return;
103
+ grid?.release();
104
+ grid = new SheetGrid({
105
+ container,
106
+ sheet: activeSheet.value,
107
+ rows: props.rows,
108
+ cols: props.cols
109
+ });
110
+ }
111
+ onMounted(() => {
112
+ bindWorkbookEvents(workbook.value);
113
+ bindSheetEvents(activeSheet.value);
114
+ rebuildGrid();
115
+ });
116
+ watch(() => [props.rows, props.cols], rebuildGrid);
117
+ watch(() => props.workbook, (wb, prev) => {
118
+ if (wb === prev) return;
119
+ activeIndex.value = workbook.value.activeSheetIndex;
120
+ sheetList.value = workbook.value.getSheets();
121
+ bindWorkbookEvents(workbook.value);
122
+ bindSheetEvents(activeSheet.value);
123
+ rebuildGrid();
124
+ bump();
125
+ });
126
+ onBeforeUnmount(() => {
127
+ offRegistryChange();
128
+ for (const dispose of disposeWorkbookEvents) dispose();
129
+ for (const dispose of disposeSheetEvents) dispose();
130
+ grid?.release();
131
+ grid = void 0;
132
+ });
133
+ __expose({
134
+ workbook,
135
+ getActiveSheet: () => activeSheet.value,
136
+ getContext: () => context,
137
+ getGrid: () => grid
138
+ });
139
+ return (_ctx, _cache) => {
140
+ return openBlock(), createElementBlock("div", { class: normalizeClass(unref(cls).b) }, [
141
+ __props.showToolbar ? (openBlock(), createElementBlock("div", {
142
+ key: 0,
143
+ class: normalizeClass(unref(cls).e("toolbar"))
144
+ }, [(openBlock(true), createElementBlock(Fragment, null, renderList(toolGroups.value, (group, groupIndex) => {
145
+ return openBlock(), createElementBlock(Fragment, { key: group.name }, [groupIndex > 0 ? (openBlock(), createElementBlock("span", {
146
+ key: 0,
147
+ class: normalizeClass(unref(cls).e("toolbar-divider"))
148
+ }, null, 2)) : createCommentVNode("v-if", true), (openBlock(true), createElementBlock(Fragment, null, renderList(group.tools, (item) => {
149
+ return openBlock(), createElementBlock("button", {
150
+ key: item.tool.id,
151
+ type: "button",
152
+ class: normalizeClass(unref(cls).e("tool")),
153
+ disabled: item.disabled,
154
+ title: item.tool.tooltip ?? item.tool.title,
155
+ onClick: ($event) => handleToolClick(item.tool)
156
+ }, [item.tool.icon ? (openBlock(), createBlock(resolveDynamicComponent(item.tool.icon), {
157
+ key: 0,
158
+ class: normalizeClass(unref(cls).e("tool-icon"))
159
+ }, null, 8, ["class"])) : createCommentVNode("v-if", true), createElementVNode("span", null, toDisplayString(item.tool.title), 1)], 10, _hoisted_1);
160
+ }), 128))], 64);
161
+ }), 128))], 2)) : createCommentVNode("v-if", true),
162
+ createElementVNode("div", {
163
+ ref_key: "gridRef",
164
+ ref: gridRef,
165
+ class: normalizeClass(unref(cls).e("grid"))
166
+ }, null, 2),
167
+ __props.showTabs ? (openBlock(), createElementBlock("div", {
168
+ key: 1,
169
+ class: normalizeClass(unref(cls).e("tabs"))
170
+ }, [(openBlock(true), createElementBlock(Fragment, null, renderList(sheetList.value, (sheet, index) => {
171
+ return openBlock(), createElementBlock("button", {
172
+ key: sheet.name,
173
+ type: "button",
174
+ class: normalizeClass([unref(cls).e("tab"), unref(bem).is("active", index === activeIndex.value)]),
175
+ onClick: ($event) => handleTabClick(index)
176
+ }, toDisplayString(sheet.name), 11, _hoisted_2);
177
+ }), 128))], 2)) : createCommentVNode("v-if", true)
178
+ ], 2);
179
+ };
180
+ }
181
+ });
182
+ //#endregion
183
+ export { _sfc_main as default };
184
+
185
+ //# sourceMappingURL=sheet.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sheet.js","names":[],"sources":["../../src/vue/sheet.vue"],"sourcesContent":["<template>\n <div :class=\"cls.b\">\n <div v-if=\"showToolbar\" :class=\"cls.e('toolbar')\">\n <template v-for=\"(group, groupIndex) in toolGroups\" :key=\"group.name\">\n <span v-if=\"groupIndex > 0\" :class=\"cls.e('toolbar-divider')\" />\n <button\n v-for=\"item in group.tools\"\n :key=\"item.tool.id\"\n type=\"button\"\n :class=\"cls.e('tool')\"\n :disabled=\"item.disabled\"\n :title=\"item.tool.tooltip ?? item.tool.title\"\n @click=\"handleToolClick(item.tool)\"\n >\n <component :is=\"item.tool.icon\" v-if=\"item.tool.icon\" :class=\"cls.e('tool-icon')\" />\n <span>{{ item.tool.title }}</span>\n </button>\n </template>\n </div>\n\n <div ref=\"gridRef\" :class=\"cls.e('grid')\" />\n\n <div v-if=\"showTabs\" :class=\"cls.e('tabs')\">\n <button\n v-for=\"(sheet, index) in sheetList\"\n :key=\"sheet.name\"\n type=\"button\"\n :class=\"[cls.e('tab'), bem.is('active', index === activeIndex)]\"\n @click=\"handleTabClick(index)\"\n >\n {{ sheet.name }}\n </button>\n </div>\n </div>\n</template>\n\n<script lang=\"ts\" setup>\nimport { bem } from '@veltra/utils'\nimport { computed, onBeforeUnmount, onMounted, ref, shallowRef, useTemplateRef, watch } from 'vue'\n\nimport type { Sheet } from '../core/sheet'\nimport { Workbook } from '../core/workbook'\nimport { SheetGrid } from '../grid/sheet-grid'\nimport { createSheetContext } from '../tools/context'\nimport { defaultToolRegistry, type SheetTool } from '../tools/registry'\nimport type { SheetEmits, SheetProps, _SheetExposed } from '../types'\n\ndefineOptions({ name: 'USheet' })\n\nconst props = withDefaults(defineProps<SheetProps>(), {\n rows: 100,\n cols: 26,\n showToolbar: true,\n showTabs: true\n})\n\nconst emit = defineEmits<SheetEmits>()\n\nconst cls = bem('sheet')\n\n/** 工作簿:外部传入或内部自建(单 sheet) */\nconst internalWorkbook = new Workbook()\nconst workbook = computed(() => props.workbook ?? internalWorkbook)\n\n/** 激活 sheet 索引(镜像 workbook.activeSheetIndex,经事件同步) */\nconst activeIndex = ref(workbook.value.activeSheetIndex)\n/** sheet 列表(tabs 渲染;由 sheets-change 同步) */\nconst sheetList = shallowRef<Sheet[]>(workbook.value.getSheets())\nconst activeSheet = computed(() => sheetList.value[activeIndex.value] ?? workbook.value.activeSheet)\n\n/** 工具上下文:动态解析活动 sheet,tab 切换后自动指向当前 sheet */\nconst context = createSheetContext(() => activeSheet.value)\n\nconst gridRef = useTemplateRef<HTMLElement>('gridRef')\nlet grid: SheetGrid | undefined\n\n// ─── 工具栏状态刷新 ─────────────────────────────────────────\n// 工具 visible/disabled 是 (ctx) => boolean 纯函数,状态源变化时 bump 触发重算\n\nconst stateTick = ref(0)\nconst bump = (): void => {\n stateTick.value++\n}\n\nlet disposeSheetEvents: (() => void)[] = []\n/** 订阅活动 sheet 的状态源(tab 切换 / 工作簿变更时重绑) */\nfunction bindSheetEvents(sheet: Sheet): void {\n for (const dispose of disposeSheetEvents) dispose()\n disposeSheetEvents = [\n sheet.on('selection-change', bump),\n sheet.on('history-change', bump),\n sheet.on('cell-change', bump),\n sheet.on('merge-change', bump)\n ]\n}\n\nlet disposeWorkbookEvents: (() => void)[] = []\nfunction bindWorkbookEvents(wb: Workbook): void {\n for (const dispose of disposeWorkbookEvents) dispose()\n disposeWorkbookEvents = [\n wb.on('sheets-change', ({ sheets }) => {\n sheetList.value = sheets\n bump()\n }),\n wb.on('active-sheet-change', ({ sheet, index }) => {\n activeIndex.value = index\n bindSheetEvents(sheet)\n rebuildGrid()\n bump()\n emit('active-sheet-change', { sheet, index })\n })\n ]\n}\n\nconst offRegistryChange = defaultToolRegistry.onChange(bump)\n\n// ─── 工具栏 ────────────────────────────────────────────────\n\nconst toolGroups = computed(() => {\n void stateTick.value // 依赖状态源:选区 / 历史 / 单元格 / 合并 / 注册表\n return defaultToolRegistry\n .getGroups()\n .map((group) => ({\n name: group.name,\n tools: group.tools\n .map((tool) => ({\n tool,\n visible: tool.visible?.(context) ?? true,\n disabled: tool.disabled?.(context) ?? false\n }))\n .filter((item) => item.visible)\n }))\n .filter((group) => group.tools.length > 0)\n})\n\nfunction handleToolClick(tool: SheetTool): void {\n if (tool.disabled?.(context)) return\n tool.onClick(context)\n}\n\n// ─── sheet tabs ─────────────────────────────────────────────\n\nfunction handleTabClick(index: number): void {\n if (index === activeIndex.value) return\n const sheet = sheetList.value[index]\n if (sheet) workbook.value.activateSheet(sheet.name)\n}\n\n// ─── grid 生命周期 ──────────────────────────────────────────\n\nfunction rebuildGrid(): void {\n const container = gridRef.value\n if (!container) return\n grid?.release()\n grid = new SheetGrid({ container, sheet: activeSheet.value, rows: props.rows, cols: props.cols })\n}\n\nonMounted(() => {\n bindWorkbookEvents(workbook.value)\n bindSheetEvents(activeSheet.value)\n rebuildGrid()\n})\n\nwatch(() => [props.rows, props.cols], rebuildGrid)\n\nwatch(\n () => props.workbook,\n (wb, prev) => {\n if (wb === prev) return\n activeIndex.value = workbook.value.activeSheetIndex\n sheetList.value = workbook.value.getSheets()\n bindWorkbookEvents(workbook.value)\n bindSheetEvents(activeSheet.value)\n rebuildGrid()\n bump()\n }\n)\n\nonBeforeUnmount(() => {\n offRegistryChange()\n for (const dispose of disposeWorkbookEvents) dispose()\n for (const dispose of disposeSheetEvents) dispose()\n grid?.release()\n grid = undefined\n})\n\nconst exposed: _SheetExposed = {\n workbook,\n getActiveSheet: () => activeSheet.value,\n getContext: () => context,\n getGrid: () => grid\n}\n\ndefineExpose(exposed)\n</script>\n"],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { Sheet } from "../core/sheet.js";
2
+ import { SheetProps, _SheetExposed } from "../types/sheet.js";
3
+ import "../types/index.js";
4
+ //#region src/vue/sheet.vue.d.ts
5
+ declare const __VLS_export: import("vue").DefineComponent<SheetProps, _SheetExposed, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
6
+ "active-sheet-change": (payload: {
7
+ sheet: Sheet;
8
+ index: number;
9
+ }) => any;
10
+ }, string, import("vue").PublicProps, Readonly<SheetProps> & Readonly<{
11
+ "onActive-sheet-change"?: ((payload: {
12
+ sheet: Sheet;
13
+ index: number;
14
+ }) => any) | undefined;
15
+ }>, {
16
+ rows: number;
17
+ cols: number;
18
+ showToolbar: boolean;
19
+ showTabs: boolean;
20
+ }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
21
+ declare const _default: typeof __VLS_export;
22
+ //#endregion
23
+ export { _default as default };
24
+ //# sourceMappingURL=sheet.vue.d.ts.map
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1 @@
1
+ import "./style2.css";
@@ -0,0 +1,93 @@
1
+ @charset "UTF-8";
2
+ /** flex布局 */
3
+ /**
4
+ * 设置css变量
5
+ * 参数1:变量前缀
6
+ * 参数2: 一个由值组成的列表或者由key, value组成的map
7
+ * css-var(height, (
8
+ * large: 40px
9
+ * default: 32px
10
+ * small: 24px
11
+ * ))
12
+ * 生成的css变量:
13
+ * --u-height-large: 40px;
14
+ * --u-height-default: 32px;
15
+ * --u-height-small: 24px;
16
+ */
17
+ /** 暗色:data-theme 与系统偏好,与 UITheme.injectBuiltInThemes 选择器策略一致 */
18
+ .u-sheet {
19
+ display: flex;
20
+ flex-direction: column;
21
+ overflow: hidden;
22
+ border: var(--u-border);
23
+ border-radius: var(--u-radius-default);
24
+ background-color: var(--u-bg-color-top);
25
+ }
26
+ .u-sheet__toolbar {
27
+ display: flex;
28
+ align-items: center;
29
+ flex-wrap: wrap;
30
+ gap: var(--u-gap-small);
31
+ padding: var(--u-gap-small);
32
+ border-bottom: 1px solid var(--u-border-muted-color);
33
+ }
34
+ .u-sheet__toolbar-divider {
35
+ width: 1px;
36
+ align-self: stretch;
37
+ margin: 2px 0;
38
+ background-color: var(--u-border-muted-color);
39
+ }
40
+ .u-sheet__tool {
41
+ display: inline-flex;
42
+ align-items: center;
43
+ gap: 4px;
44
+ height: var(--u-form-component-height-small);
45
+ padding: 0 8px;
46
+ border: none;
47
+ border-radius: var(--u-radius-small);
48
+ background: transparent;
49
+ color: var(--u-text-color-main);
50
+ font-size: var(--u-font-size-main-small);
51
+ white-space: nowrap;
52
+ cursor: pointer;
53
+ transition: background-color var(--u-transition-fast) var(--u-transition-ease), color var(--u-transition-fast) var(--u-transition-ease);
54
+ }
55
+ .u-sheet__tool:hover:not(:disabled) {
56
+ background-color: var(--u-bg-color-hover);
57
+ }
58
+ .u-sheet__tool:disabled {
59
+ color: var(--u-text-color-disabled);
60
+ cursor: not-allowed;
61
+ }
62
+ .u-sheet__tool-icon {
63
+ font-size: calc(var(--u-font-size-main-small) + 2px);
64
+ }
65
+ .u-sheet__grid {
66
+ flex: 1;
67
+ min-height: 0;
68
+ }
69
+ .u-sheet__tabs {
70
+ display: flex;
71
+ align-items: center;
72
+ gap: 2px;
73
+ padding: 2px var(--u-gap-small);
74
+ border-top: 1px solid var(--u-border-muted-color);
75
+ background-color: var(--u-bg-color-middle);
76
+ }
77
+ .u-sheet__tab {
78
+ padding: 4px 12px;
79
+ border: none;
80
+ border-radius: var(--u-radius-small);
81
+ background: transparent;
82
+ color: var(--u-text-color-second);
83
+ font-size: var(--u-font-size-main-small);
84
+ cursor: pointer;
85
+ transition: background-color var(--u-transition-fast) var(--u-transition-ease), color var(--u-transition-fast) var(--u-transition-ease);
86
+ }
87
+ .u-sheet__tab:hover {
88
+ background-color: var(--u-bg-color-hover);
89
+ }
90
+ .u-sheet__tab.is-active {
91
+ background-color: var(--u-bg-color-top);
92
+ color: var(--u-color-primary);
93
+ }
package/package.json ADDED
@@ -0,0 +1,37 @@
1
+ {
2
+ "name": "@veltra/sheet",
3
+ "version": "2.0.0",
4
+ "files": [
5
+ "dist",
6
+ "src"
7
+ ],
8
+ "type": "module",
9
+ "sideEffects": [
10
+ "src/**/style.ts",
11
+ "src/**/*.scss",
12
+ "src/tools/builtin.ts",
13
+ "dist/**/style.js",
14
+ "dist/**/*.css",
15
+ "dist/tools/builtin.js"
16
+ ],
17
+ "exports": {
18
+ ".": {
19
+ "types": "./dist/index.d.ts",
20
+ "import": "./dist/index.js"
21
+ },
22
+ "./*": {
23
+ "types": "./dist/*",
24
+ "import": "./dist/*"
25
+ }
26
+ },
27
+ "dependencies": {
28
+ "@visactor/vtable": "^1.26.5",
29
+ "@visactor/vtable-editors": "^1.26.5"
30
+ },
31
+ "peerDependencies": {
32
+ "@cat-kit/core": ">=1.1.8",
33
+ "@veltra/styles": "1.4.0",
34
+ "@veltra/utils": "1.4.0",
35
+ "vue": ">=3.5.40"
36
+ }
37
+ }