@veltra/sheet 2.1.1 → 2.2.0

package/src/{vue → components/sheet}/__test__/formula-bar.test.ts

@@ -1,10 +1,12 @@
+import { parseRange } from '@veltra/sheet-core/core/address'
 import { Workbook } from '@veltra/sheet-core/core/workbook'
-import { ListTable } from '@visactor/vtable'
 import { afterEach, describe, expect, it } from 'vitest'
 import { createApp, h, nextTick, type App } from 'vue'
 
-import { USheet } from '../../index'
-import type { SheetExposed } from '../../types'
+import { USheet } from '../../../index'
+import { createSheetContext } from '../../../tools/context'
+import type { SheetExposed } from '../../../types'
+import UFormulaBar from '../formula-bar.vue'
 
 const apps: App[] = []
 const containers: HTMLElement[] = []
@@ -32,6 +34,26 @@ function mount(
   return { app, el }
 }
 
+function mountFormulaBar(sheet: Workbook['activeSheet']) {
+  const el = document.createElement('div')
+  document.body.appendChild(el)
+  containers.push(el)
+  const exposed: { value: InstanceType<typeof UFormulaBar> | undefined } = { value: undefined }
+  const app = createApp({
+    render: () =>
+      h(UFormulaBar, {
+        sheet,
+        context: createSheetContext(sheet),
+        ref: (value: unknown) => {
+          exposed.value = value as InstanceType<typeof UFormulaBar> | undefined
+        }
+      })
+  })
+  app.mount(el)
+  apps.push(app)
+  return { el, exposed }
+}
+
 function createWorkbook() {
   const workbook = new Workbook()
   workbook.addSheet('Sheet2')
@@ -397,15 +419,16 @@ describe('USheet 公式栏：函数补全与引用选择', () => {
     expect(sheet.getCellData({ row: 2, col: 0 })).toBeUndefined()
     expect(input.value).toBe('=SUM(')
 
-    // 与 grid 选区测试同路径：selectCells 设视觉选区 + fire SELECTED_CELL
-    const table = exposed.value!.getGrid()!.getTable()
-    table.selectCells([{ start: { col: 1, row: 1 }, end: { col: 2, row: 2 } }])
-    table.fireListeners(ListTable.EVENT_TYPE.SELECTED_CELL, { col: 2, row: 2 })
+    // 网格选区拦截 → handleRefSelect 路径（VTable 时序见 sheet-core selection-debug）
+    const { el: barEl, exposed: barExposed } = mountFormulaBar(sheet)
     await nextTick()
-    expect(input.value).toBe('=SUM(A1:B2')
-    expect(input.selectionStart).toBe('=SUM(A1:B2'.length)
-    // intercept 不写模型选区
-    expect(sheet.getSelection().activeCell).toEqual({ row: 2, col: 0 })
+    setFxText(barEl, '=SUM(')
+    await nextTick()
+    barExposed.value!.handleRefSelect(parseRange('A1:B2'))
+    await nextTick()
+    const barInput = fxInput(barEl)
+    expect(barInput.value).toBe('=SUM(A1:B2')
+    expect(barInput.selectionStart).toBe('=SUM(A1:B2'.length)
 
     // 非引用选择场景失焦提交
     setFxText(el, 'plain')
@@ -436,19 +459,15 @@ describe('USheet 公式栏：函数补全与引用选择', () => {
   })
 
   it('连续引用选择：=A1+ 后再插入 B1', async () => {
-    const workbook = new Workbook()
-    const sheet = workbook.activeSheet
-    const exposed: { value: SheetExposed | undefined } = { value: undefined }
-    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }), exposed)
+    const sheet = new Workbook().activeSheet
+    const { el, exposed } = mountFormulaBar(sheet)
     await nextTick()
     sheet.selectCell({ row: 2, col: 0 })
     await nextTick()
 
     setFxText(el, '=A1+')
     await nextTick()
-    const table = exposed.value!.getGrid()!.getTable()
-    table.selectCells([{ start: { col: 2, row: 1 }, end: { col: 2, row: 1 } }])
-    table.fireListeners(ListTable.EVENT_TYPE.SELECTED_CELL, { col: 2, row: 1 })
+    exposed.value!.handleRefSelect(parseRange('B1'))
     await nextTick()
     expect(fxInput(el).value).toBe('=A1+B1')
   })

package/src/{vue → components/sheet}/__test__/insert-image-popup.test.ts

@@ -2,7 +2,7 @@ import { Sheet } from '@veltra/sheet-core/core/sheet'
 import { afterEach, describe, expect, it, vi } from 'vitest'
 import { createApp, h, type App } from 'vue'
 
-import { createSheetContext } from '../../tools/context'
+import { createSheetContext } from '../../../tools/context'
 import USheetInsertImagePopup from '../popups/insert-image-popup.vue'
 
 const mocks = vi.hoisted(() => {

package/src/{vue → components/sheet}/__test__/insert-image.test.ts

@@ -1,7 +1,7 @@
 import { Sheet } from '@veltra/sheet-core/core/sheet'
 import { afterEach, describe, expect, it, vi } from 'vitest'
 
-import { createSheetContext } from '../../tools/context'
+import { createSheetContext } from '../../../tools/context'
 import {
   INSERT_IMAGE_ACCEPT,
   insertImageFromFile,

package/src/{vue → components/sheet}/__test__/sheet-component.test.ts

@@ -2,9 +2,9 @@ import { Workbook } from '@veltra/sheet-core/core/workbook'
 import { afterEach, describe, expect, it, vi } from 'vitest'
 import { createApp, h, nextTick, ref, type App } from 'vue'
 
-import { USheet } from '../../index'
-import { registerTool, unregisterTool } from '../../tools/registry'
-import type { SheetExposed } from '../../types'
+import { USheet } from '../../../index'
+import { registerTool, unregisterTool } from '../../../tools/registry'
+import type { SheetExposed } from '../../../types'
 
 const apps: App[] = []
 const containers: HTMLElement[] = []
@@ -258,6 +258,43 @@ describe('USheet 组件', () => {
     expect(gridAfter).not.toBe(gridBefore)
   })
 
+  it('resolveCellStyle prop 传入 SheetGrid 视口渲染', async () => {
+    const workbook = createWorkbook()
+    const sheet = workbook.activeSheet
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    mount(
+      () => ({
+        workbook,
+        rows: 10,
+        cols: 6,
+        resolveCellStyle: (
+          addr: { row: number; col: number },
+          baseStyle?: { fill?: { color: string } }
+        ) => {
+          if (addr.row === 1 && addr.col === 1) {
+            return { ...baseStyle, fill: { color: '#FFE0E0' } }
+          }
+          return baseStyle
+        }
+      }),
+      exposed
+    )
+    await nextTick()
+
+    const addr = { row: 1, col: 1 }
+    sheet.setCellStyle({ start: addr, end: addr }, { fill: { color: '#CCCCCC' } })
+    await nextTick()
+
+    const table = exposed.value?.getGrid()?.getTable()
+    expect(table).toBeDefined()
+    const column = table!.getBodyColumnDefine(2, 2) as {
+      style?: (arg: { row: number; col: number; table: unknown }) => Record<string, unknown>
+    }
+    const rendered = column.style!({ row: 2, col: 2, table })
+    expect(rendered.bgColor).toBe('#FFE0E0')
+    expect(sheet.getCellStyle(addr)?.fill?.color).toBe('#CCCCCC')
+  })
+
   it('workbook prop 变更：tabs 与 grid 切到新工作簿', async () => {
     const workbook1 = createWorkbook()
     const workbook2 = new Workbook()

package/src/{vue → components/sheet}/__test__/sheet-context-menu.test.ts

@@ -2,7 +2,7 @@ import { createRange } from '@veltra/sheet-core/core/address'
 import { Sheet } from '@veltra/sheet-core/core/sheet'
 import { describe, expect, it } from 'vitest'
 
-import { createSheetContext } from '../../tools/context'
+import { createSheetContext } from '../../../tools/context'
 import {
   buildBodyMenus,
   buildColHeaderMenus,

package/src/{vue → components/sheet}/formula-bar.vue

@@ -86,7 +86,7 @@ import {
   watch
 } from 'vue'
 
-import type { SheetContext } from '../tools/context'
+import type { SheetContext } from '../../tools/context'
 import UFormulaSuggestList from './formula-suggest-list.vue'
 import { insertRefText, isRefSelectContext } from './use-formula-ref-select'
 import {

package/src/{vue → components/sheet}/insert-image.ts

@@ -1,7 +1,7 @@
 import { message } from '@veltra/desktop'
 import type { SheetImageType } from '@veltra/sheet-core/core/image'
 
-import type { SheetContext } from '../tools/context'
+import type { SheetContext } from '../../tools/context'
 
 /** 文件选择 accept（工具栏弹层与右键菜单共用；不用裸 image/*） */
 export const INSERT_IMAGE_ACCEPT = '.png,.jpg,.jpeg,.gif,.svg,.webp'

package/src/{vue → components/sheet}/popup-helpers.ts

@@ -2,7 +2,7 @@ import type { CellRange } from '@veltra/sheet-core/core/address'
 import type { BorderPreset } from '@veltra/sheet-core/core/style/border-presets'
 import { BORDER_STYLE_WIDTH, type BorderLineStyle } from '@veltra/sheet-core/core/style/types'
 
-import type { SheetContext } from '../tools/context'
+import type { SheetContext } from '../../tools/context'
 
 /** 当前选区（ranges[0] 优先；无区域选区时用活动格单格） */
 export function currentRange(context: SheetContext): CellRange | null {

package/src/{vue → components/sheet}/popups/border-popup.vue

@@ -45,7 +45,7 @@ import {
 import { bem } from '@veltra/utils'
 import { ref } from 'vue'
 
-import type { SheetContext } from '../../tools/context'
+import type { SheetContext } from '../../../tools/context'
 import {
   BORDER_LINE_STYLES,
   BORDER_LINE_TITLES,

package/src/{vue → components/sheet}/popups/export-popup.vue

@@ -13,8 +13,8 @@
 import { message } from '@veltra/desktop'
 import { bem } from '@veltra/utils'
 
-import type { SheetContext } from '../../tools/context'
-import { exportSheetCsvFile, exportWorkbookFile } from '../../tools/download'
+import type { SheetContext } from '../../../tools/context'
+import { exportSheetCsvFile, exportWorkbookFile } from '../../../tools/download'
 
 defineOptions({ name: 'USheetExportPopup' })
 

package/src/{vue → components/sheet}/popups/fill-color-popup.vue

@@ -6,7 +6,7 @@
 import { UPalette } from '@veltra/desktop'
 import { onMounted, ref } from 'vue'
 
-import type { SheetContext } from '../../tools/context'
+import type { SheetContext } from '../../../tools/context'
 import { currentRange } from '../popup-helpers'
 
 defineOptions({ name: 'USheetFillColorPopup' })

package/src/{vue → components/sheet}/popups/find-popup.vue

@@ -72,7 +72,7 @@ import { UInput } from '@veltra/desktop'
 import type { Sheet } from '@veltra/sheet-core/core/sheet'
 import { bem } from '@veltra/utils'
 
-import type { SheetContext } from '../../tools/context'
+import type { SheetContext } from '../../../tools/context'
 import { useFindReplace } from '../use-find-replace'
 
 defineOptions({ name: 'USheetFindPopup' })

package/src/{vue → components/sheet}/popups/font-color-popup.vue

@@ -6,7 +6,7 @@
 import { UPalette } from '@veltra/desktop'
 import { onMounted, ref } from 'vue'
 
-import type { SheetContext } from '../../tools/context'
+import type { SheetContext } from '../../../tools/context'
 import { currentRange } from '../popup-helpers'
 
 defineOptions({ name: 'USheetFontColorPopup' })

package/src/{vue → components/sheet}/popups/font-size-popup.vue

@@ -20,7 +20,7 @@ import { UScroll } from '@veltra/desktop'
 import { bem } from '@veltra/utils'
 import { onMounted, ref } from 'vue'
 
-import type { SheetContext } from '../../tools/context'
+import type { SheetContext } from '../../../tools/context'
 import { currentRange } from '../popup-helpers'
 
 defineOptions({ name: 'USheetFontSizePopup' })

package/src/{vue → components/sheet}/popups/insert-image-popup.vue

@@ -15,7 +15,7 @@
 import { UFilePicker } from '@veltra/desktop'
 import { bem } from '@veltra/utils'
 
-import type { SheetContext } from '../../tools/context'
+import type { SheetContext } from '../../../tools/context'
 import { INSERT_IMAGE_ACCEPT, insertImageFromFile } from '../insert-image'
 
 defineOptions({ name: 'USheetInsertImagePopup' })

package/src/{vue → components/sheet}/sheet-context-menu.ts

@@ -2,8 +2,8 @@ import type { ContextmenuItem } from '@veltra/desktop'
 import { createRange, type CellAddress, type CellRange } from '@veltra/sheet-core/core/address'
 import { defineComponent, h } from 'vue'
 
-import type { SheetContext } from '../tools/context'
-import { defaultToolRegistry } from '../tools/registry'
+import type { SheetContext } from '../../tools/context'
+import { defaultToolRegistry } from '../../tools/registry'
 import InsertCountMenuItem from './insert-count-menu-item.vue'
 import { pickAndInsertImage } from './insert-image'
 

package/src/{vue → components/sheet}/sheet-toolbar.vue

@@ -61,8 +61,8 @@ import { ArrowLeft, ArrowRight } from '@veltra/icons/normal'
 import { bem } from '@veltra/utils'
 import { toRef, useTemplateRef } from 'vue'
 
-import type { SheetTool } from '../tools/registry'
-import type { ToolGroupView } from '../use-tool-groups'
+import type { SheetTool } from '../../tools/registry'
+import type { ToolGroupView } from './use-tool-groups'
 import { useToolbarScroll } from './use-toolbar-scroll'
 
 defineOptions({ name: 'USheetToolbar' })

package/src/{vue → components/sheet}/sheet.vue

@@ -77,8 +77,8 @@ import { UDropdown } from '@veltra/desktop'
 import { bem } from '@veltra/utils'
 import { computed, ref, useTemplateRef, watch } from 'vue'
 
-import type { SheetTool } from '../tools/registry'
-import type { SheetEmits, SheetProps, _SheetExposed } from '../types'
+import type { SheetTool } from '../../tools/registry'
+import type { SheetEmits, SheetProps, _SheetExposed } from '../../types'
 import UFormulaBar from './formula-bar.vue'
 import { pickAndImportFile } from './import-file'
 import USheetBorderPopup from './popups/border-popup.vue'
@@ -102,7 +102,8 @@ const props = withDefaults(defineProps<SheetProps>(), {
   cols: 26,
   showToolbar: true,
   showFormulaBar: true,
-  showTabs: true
+  showTabs: true,
+  readonly: false
 })
 
 const emit = defineEmits<SheetEmits>()

package/src/{vue → components/sheet}/use-find-replace.ts

@@ -14,7 +14,7 @@ import {
 import type { Sheet } from '@veltra/sheet-core/core/sheet'
 import { computed, ref, shallowRef, watch } from 'vue'
 
-import type { SheetContext } from '../tools/context'
+import type { SheetContext } from '../../tools/context'
 
 interface UseFindReplaceOptions {
   /** 目标 sheet（弹层存活期间固定；tab 切换会关闭并销毁弹层） */

package/src/{vue → components/sheet}/use-sheet-grid.ts

@@ -4,8 +4,8 @@ import type { Sheet } from '@veltra/sheet-core/core/sheet'
 import { SheetGrid, type SheetGridContextMenuInfo } from '@veltra/sheet-core/grid/sheet-grid'
 import { onBeforeUnmount, onMounted, watch } from 'vue'
 
-import type { SheetContext } from '../tools/context'
-import type { SheetProps } from '../types'
+import type { SheetContext } from '../../tools/context'
+import type { SheetProps } from '../../types'
 import {
   buildBodyMenus,
   buildColHeaderMenus,
@@ -114,6 +114,10 @@ export function useSheetGrid(options: UseSheetGridOptions) {
       sheet,
       rows: props.rows,
       cols: props.cols,
+      readonly: props.readonly,
+      resolveDisplayValue: props.resolveDisplayValue,
+      resolveCellStyle: props.resolveCellStyle,
+      resolveCellRenderer: props.resolveCellRenderer,
       onContextMenu: handleContextMenu,
       onEditStart: (addr) => formulaBarRef.value?.mirrorGridEdit(addr),
       onEditEnd: (addr) => formulaBarRef.value?.exitMirror(addr),
@@ -233,7 +237,7 @@ export function useSheetGrid(options: UseSheetGridOptions) {
 
   onMounted(activateGrid)
 
-  watch(() => [props.rows, props.cols], rebuildGrid)
+  watch(() => [props.rows, props.cols, props.readonly], rebuildGrid)
 
   onBeforeUnmount(() => {
     invalidateAll()

package/src/{vue → components/sheet}/use-sheet-state.ts

@@ -2,9 +2,9 @@ import type { Sheet } from '@veltra/sheet-core/core/sheet'
 import { Workbook } from '@veltra/sheet-core/core/workbook'
 import { computed, onBeforeUnmount, onMounted, ref, shallowRef, watch } from 'vue'
 
-import { createSheetContext } from '../tools/context'
-import { defaultToolRegistry } from '../tools/registry'
-import type { SheetProps } from '../types'
+import { createSheetContext } from '../../tools/context'
+import { defaultToolRegistry } from '../../tools/registry'
+import type { SheetProps } from '../../types'
 
 /**
  * useSheetState 与宿主组件的协作钩子。

package/src/{vue → components/sheet}/use-tool-groups.ts

@@ -1,7 +1,7 @@
 import { computed, type ComputedRef, type Ref } from 'vue'
 
-import type { SheetContext } from '../tools/context'
-import { defaultToolRegistry, type SheetTool } from '../tools/registry'
+import type { SheetContext } from '../../tools/context'
+import { defaultToolRegistry, type SheetTool } from '../../tools/registry'
 
 /** 工具栏按钮视图模型 */
 export interface ToolGroupItem {

package/src/{vue → components/sheet}/use-tool-popup.ts

@@ -1,7 +1,7 @@
 import { onBeforeUnmount, onMounted, shallowRef } from 'vue'
 
-import type { SheetContext } from '../tools/context'
-import { defaultToolRegistry, type SheetTool } from '../tools/registry'
+import type { SheetContext } from '../../tools/context'
+import { defaultToolRegistry, type SheetTool } from '../../tools/registry'
 
 /** 模板 ref 只读形态 */
 type ElRef = { readonly value: HTMLElement | null | undefined }

package/src/index.ts

@@ -3,192 +3,10 @@
 // 无头场景不涉及
 import './tools/builtin'
 
-// 数据模型 / 渲染内核（原 src/core、src/grid）已迁至 @veltra/sheet-core，
-// 下方 core/grid 来源的导出全部为其主入口白名单的 re-export（公开 API 不变）。
-// 聚合导出为**公开 API 白名单**：仅测试引用的内部符号（如 rangeContainsRange、
-// mergeCellStyle、shiftFormulaRefs、io 转换函数、grid 样式映射、normalizeStyle、
-// ToolRegistry 类等，见 #31）不在此导出，测试一律深导入 @veltra/sheet-core 子路径。
-// 类成员方法（Sheet.setCell / setCellStyles、CellStore.setCellValue 等）随类整体
-// 导出，属内部实现细节，见 packages/sheet/AGENTS.md「核心语义」注。
-
-export {
-  cellKey,
-  colIndexToName,
-  colNameToIndex,
-  parseAddress,
-  formatAddress,
-  createRange,
-  parseRange,
-  formatRange,
-  rangesEqual,
-  rangesIntersect,
-  rangeContainsAddress,
-  boundingBox,
-  iterateRange,
-  type CellAddress,
-  type CellRange
-} from '@veltra/sheet-core'
-
-export {
-  NUMERIC_TEXT_RE,
-  normalizeInputValue,
-  inferCellType,
-  isEmptyCellData,
-  cellDataEqual,
-  CellStore,
-  type CellType,
-  type CellValue,
-  type CellData,
-  type CellSnapshotItem
-} from '@veltra/sheet-core'
-
-export {
-  computeFillTargetRange,
-  generateFill,
-  type FillDirection,
-  type GenerateFillOptions
-} from '@veltra/sheet-core'
-
-export {
-  findAll,
-  findNext,
-  findNextFrom,
-  findPrev,
-  findPrevFrom,
-  type FindOptions,
-  type FindMatch
-} from '@veltra/sheet-core'
-
-export {
-  MergeManager,
-  type MergedCellKind,
-  type CellInfo,
-  type MergeResult
-} from '@veltra/sheet-core'
-
-export { SelectionModel, type SelectionState } from '@veltra/sheet-core'
-
-export { Sheet, type FrozenState, type SheetSnapshot, type SheetEvents } from '@veltra/sheet-core'
-
-export {
-  createImageId,
-  cloneImageAnchor,
-  cloneSheetImage,
-  type SheetImageType,
-  type SheetImageAnchor,
-  type SheetImage,
-  type ImageInput
-} from '@veltra/sheet-core'
-
-export {
-  BORDER_SIDES,
-  BORDER_STYLE_WIDTH,
-  BORDER_EDGE_DEFAULTS,
-  FONT_STYLE_KEYS,
-  ALIGN_STYLE_KEYS,
-  type BorderLineStyle,
-  type BorderSide,
-  type BorderEdge,
-  type HorizontalAlign,
-  type VerticalAlign,
-  type CellFont,
-  type CellAlign,
-  type CellStyle,
-  type StyleId,
-  type CellStylePatch
-} from '@veltra/sheet-core'
-
-export { StylePool } from '@veltra/sheet-core'
-
-export {
-  buildBorderPresetItems,
-  type BorderPreset,
-  type BorderPresetItem
-} from '@veltra/sheet-core'
-
-export { Workbook, type WorkbookEvents } from '@veltra/sheet-core'
-
-export {
-  HistoryManager,
-  type HistoryState,
-  type PatchDirection,
-  type CellPatch,
-  type MergePatch,
-  type StructureChange,
-  type StructurePatch,
-  type SnapshotPatch,
-  type ImagePatch,
-  type Patch,
-  type Mutation,
-  type CommandResult,
-  type CommandContext,
-  type Command,
-  type SetCellValueItem,
-  type SetCellValueParams,
-  SetCellValueCommand,
-  type SetCellFormulaParams,
-  SetCellFormulaCommand,
-  type SetCellStyleItem,
-  type SetCellStyleParams,
-  SetCellStyleCommand,
-  type InsertCellsParams,
-  InsertCellsCommand,
-  type MergeCellsParams,
-  MergeCellsCommand,
-  type UnmergeCellsParams,
-  UnmergeCellsCommand,
-  type InsertImageParams,
-  InsertImageCommand,
-  type RemoveImageParams,
-  RemoveImageCommand,
-  type ImageUpdateFields,
-  type UpdateImageParams,
-  UpdateImageCommand,
-  defaultCommandRegistry
-} from '@veltra/sheet-core'
-
-export {
-  FORMULA_ERROR_CODES,
-  formulaError,
-  isFormulaError,
-  isFormulaErrorCode,
-  type FormulaErrorCode,
-  type FormulaError,
-  type BinaryOperator,
-  type AstNode,
-  type AstReference,
-  collectReferences,
-  FormulaParseError,
-  tokenizeFormula,
-  type FormulaOperator,
-  type FormulaToken,
-  parseFormula,
-  type ScalarValue,
-  type EvalValue,
-  type FormulaEvalContext,
-  coerceToNumber,
-  coerceToText,
-  coerceToBoolean,
-  evaluateAst,
-  registerFormulaFunction,
-  listFormulaFunctions,
-  invokeFormulaFunction,
-  type FormulaFunctionMeta,
-  type FormulaFunction,
-  type FormulaDependency,
-  type FormulaNode,
-  DependencyGraph
-} from '@veltra/sheet-core'
-
-export { exportWorkbookXlsx, exportSheetCsv } from '@veltra/sheet-core'
-export { importXlsx, importCsv, replaceWorkbook } from '@veltra/sheet-core'
-
-export {
-  SheetGrid,
-  type SheetGridOptions,
-  type SheetGridContextMenuKind,
-  type SheetGridContextMenuInfo
-} from '@veltra/sheet-core'
+// 数据模型 / 渲染内核在 @veltra/sheet-core（独立发包）。本包**不做** re-export：
+// core API（Workbook / Sheet / SheetGrid / 公式 / IO 等）一律
+// `from '@veltra/sheet-core'` 直导，白名单外符号深导入其子路径。
+// 本入口只导出 sheet 自有能力：组件、tools、组件类型。
 
 export { createSheetContext, type SheetContext } from './tools/context'
 
@@ -201,6 +19,24 @@ export {
   type SheetToolGroup
 } from './tools/registry'
 
-export { type SheetProps, type SheetEmits, type _SheetExposed, type SheetExposed } from './types'
+export {
+  type SheetProps,
+  type SheetEmits,
+  type _SheetExposed,
+  type SheetExposed,
+  type ReportViewerProps,
+  type _ReportViewerExposed,
+  type ReportViewerExposed,
+  type ReportDesignerProps,
+  type ReportDesignerEmits,
+  type _ReportDesignerExposed,
+  type ReportDesignerExposed
+} from './types'
+
+export { USheet } from './components/sheet'
+
+export { UReportViewer, UReportDesigner } from './components/report'
 
-export { default as USheet } from './vue/sheet.vue'
+// 报表纯 TS 内核：renderReport / binding / rules / params / DataConnector / Report Template /
+// Filter Bar 值规范化（结构见 packages/sheet/AGENTS.md）
+export * from './report'