@veltra/sheet 2.3.3 → 2.4.0

package/src/components/report/report-viewer.vue

@@ -7,6 +7,10 @@
       @update:values="setValues"
     />
 
+    <div v-if="canDrillBack" :class="cls.e('drill-bar')">
+      <u-button size="small" plain @click="drillBack">返回上一层</u-button>
+    </div>
+
     <div :class="cls.e('body')">
       <div v-if="loading" :class="cls.e('loading')" aria-live="polite">
         <div :class="cls.e('loading-spinner')" />
@@ -18,7 +22,7 @@
 
       <u-sheet
         ref="sheetRef"
-        :class="cls.e('sheet')"
+        :class="[cls.e('sheet'), drillHover ? cls.em('sheet', 'drill-hover') : '']"
         :workbook="workbook"
         :rows="renderSize.rows"
         :cols="renderSize.cols"
@@ -27,31 +31,61 @@
         :show-tabs="false"
         :show-row-header="false"
         :show-col-header="false"
+        :resolve-cell-style="resolveViewerCellStyle"
         readonly
+        @pointerdown="handleGridPointerDown"
+        @pointermove="handleGridPointerMove"
+        @pointerleave="handleGridPointerLeave"
+        @click="handleGridClick"
       />
     </div>
+
+    <u-dialog
+      v-if="drillDialog"
+      v-model="drillDialogVisible"
+      title="详情报表"
+      :class="cls.e('drill-dialog')"
+    >
+      <u-report-viewer
+        :connector="connector"
+        :template="drillDialog.template"
+        :initial-values="drillDialog.params"
+        :resolve-template="resolveTemplate"
+      />
+    </u-dialog>
   </div>
 </template>
 
 <script lang="ts" setup>
 import { saveBlob } from '@cat-kit/fe'
-import type { SheetSnapshot } from '@veltra/sheet-core'
+import { UButton, UDialog } from '@veltra/desktop'
+import type { CellAddress, SheetSnapshot } from '@veltra/sheet-core'
 import { Workbook } from '@veltra/sheet-core'
+import type { ResolveCellStyleHook } from '@veltra/sheet-core/grid'
 import { bem } from '@veltra/utils'
-import { computed, nextTick, useTemplateRef, watch } from 'vue'
+import { computed, nextTick, ref, shallowRef, useTemplateRef, watch } from 'vue'
 
 import { exportFilledReportXlsx } from '../../report/export-xlsx'
-import type { ReportViewerProps, _ReportViewerExposed } from '../../types'
-import type { SheetExposed } from '../../types'
+import { buildFilledReportPrintHtml, type ReportPrintOptions } from '../../report/print'
+import type { ReportTemplate } from '../../report/template'
+import type { ParamValues, ReportDrillConfig } from '../../report/types'
+import type { ReportViewerProps, SheetExposed, _ReportViewerExposed } from '../../types'
 import { USheet } from '../sheet'
 import { applyGridColWidths, applySheetColWidths } from './designer/col-widths'
 import UReportFilterBar from './filter-bar.vue'
 import { previewGridSize, type PreviewGridSizeMode } from './preview-grid-size'
+import { printHtmlDocument } from './print'
 import { useReportViewer } from './use-report-viewer'
 
 defineOptions({ name: 'UReportViewer' })
 
-const props = defineProps<ReportViewerProps>()
+/** 与 `ReportViewerProps` 交叉显式列出下钻 props，避免 SFC 对跨文件 interface 漏抽 runtime 声明 */
+type ViewerRuntimeProps = ReportViewerProps & {
+  resolveTemplate?: ReportViewerProps['resolveTemplate']
+  initialValues?: ReportViewerProps['initialValues']
+}
+
+const props = defineProps<ViewerRuntimeProps>()
 
 const cls = bem('report-viewer')
 
@@ -59,26 +93,69 @@ const cls = bem('report-viewer')
 const EXPORT_NOT_READY_MESSAGE = '报表数据尚未就绪，请等待取数完成后再导出'
 const EXPORT_LOADING_MESSAGE = '报表数据加载中，请稍后再导出'
 
+/** 取数未完成时拒绝打印的可读错误 */
+const PRINT_NOT_READY_MESSAGE = '报表数据尚未就绪，请等待取数完成后再打印'
+const PRINT_LOADING_MESSAGE = '报表数据加载中，请稍后再打印'
+
+/**
+ * 单击 / 拖拽框选判定位移阈值（px）：pointerdown 与 click 位移超过它视为拖选，不触发下钻。
+ * （VTable 拖选后 DOM click 仍会冒泡，按位移自行抑制。）
+ */
+const DRAG_CLICK_THRESHOLD_PX = 4
+
 /** 查看器工作簿：宿主可注入（同 USheet `workbook?` 先例），缺省内部自建；模板 / 填充结果都 restore 进活动 sheet 只读展示 */
 const internalWorkbook = new Workbook()
 const workbook = computed(() => props.workbook ?? internalWorkbook)
 
 const sheetRef = useTemplateRef<SheetExposed>('sheetRef')
 
-const { params, values, loading, error, filledSnapshot, filledColWidths, refresh, setValues } =
-  useReportViewer(props)
+const {
+  params,
+  values,
+  loading,
+  error,
+  filledSnapshot,
+  filledColWidths,
+  currentTemplate,
+  canDrillBack,
+  resolveDrillHit,
+  resolveDrillTarget,
+  drillInto,
+  drillBack,
+  refresh,
+  setValues
+} = useReportViewer(props)
+
+/** 配了下钻的单元格在查看态展示可点击链接样式（蓝字 + 下划线），便于用户直观感知 */
+const resolveViewerCellStyle: ResolveCellStyleHook = (addr, base) => {
+  if (!props.resolveTemplate) return base
+  const hit = resolveDrillHit(addr)
+  if (!hit) return base
+  return {
+    ...base,
+    font: {
+      ...base?.font,
+      color: base?.font?.color ?? '#2f54eb',
+      underline: base?.font?.underline ?? true
+    }
+  }
+}
+
+/** 弹框下钻：先挂 UDialog 再打开，避免 modelValue 初始为 true 时 overlay 不进入 */
+const drillDialogVisible = ref(false)
+const drillDialog = shallowRef<{ template: ReportTemplate; params: ParamValues } | null>(null)
 
 const renderSize = computed(() => {
   const filled = filledSnapshot.value
   if (filled) return previewGridSize(filled, 'filled')
-  return previewGridSize(props.template, 'template')
+  return previewGridSize(currentTemplate.value, 'template')
 })
 
-/** 宿主显式传入优先；否则取数完成后用展开映射列宽；再回落模板设计态列宽 */
+/** 宿主显式传入优先；否则取数完成后用展开映射列宽；再回落当前层模板设计态列宽 */
 const effectiveColWidths = computed(() => {
   if (props.colWidths?.length) return props.colWidths
   if (filledColWidths.value?.length) return filledColWidths.value
-  return props.template.colWidths
+  return currentTemplate.value.colWidths
 })
 
 /** 将运行时列宽写入模型与 VTable（模型为单一事实源；grid 构造/content-reset 也会回放） */
@@ -103,17 +180,79 @@ function applySnapshot(snapshot: SheetSnapshot, mode: PreviewGridSizeMode): void
   void nextTick(applyRuntimeColWidths)
 }
 
-// 先铺模板静态结构（取数期间 / 取数失败时可见），取数成功后替换为 Filled Report
-watch(
-  () => props.template,
-  (template) => applySnapshot(template, 'template'),
-  { immediate: true }
-)
+// 先铺当前层模板静态结构（取数期间 / 取数失败时可见），取数成功后替换为 Filled Report
+watch(currentTemplate, (template) => applySnapshot(template, 'template'), { immediate: true })
 watch(filledSnapshot, (filled) => {
   if (filled) applySnapshot(filled, 'filled')
 })
 watch(effectiveColWidths, applyRuntimeColWidths)
 
+// ─── 下钻点击与可点视觉提示 ─────────────────────────────────
+
+/** 悬停命中下钻格时给网格加 cursor 提示 */
+const drillHover = ref(false)
+let pointerStart: { x: number; y: number } | null = null
+
+watch(drillDialogVisible, (visible) => {
+  if (!visible) drillDialog.value = null
+})
+
+async function openDrillDialog(
+  config: ReportDrillConfig,
+  record: Record<string, unknown>
+): Promise<void> {
+  const next = await resolveDrillTarget(config, record)
+  if (!next) return
+  drillDialog.value = next
+  await nextTick()
+  drillDialogVisible.value = true
+}
+
+/** 事件坐标 → 模型地址（经当前 SheetGrid 命中测试；网格随内容尺寸重建，实例按事件时刻取） */
+function resolveEventAddr(event: MouseEvent): CellAddress | null {
+  const host = event.currentTarget as HTMLElement
+  const gridEl = host.querySelector('.u-sheet__grid-instance') as HTMLElement | null
+  const grid = sheetRef.value?.getGrid()
+  if (!gridEl || !grid) return null
+  const rect = gridEl.getBoundingClientRect()
+  return grid.hitTestSheetAddr(event.clientX - rect.left, event.clientY - rect.top)
+}
+
+function handleGridPointerDown(event: PointerEvent): void {
+  pointerStart = { x: event.clientX, y: event.clientY }
+}
+
+function handleGridClick(event: MouseEvent): void {
+  if (!props.resolveTemplate) return
+  const start = pointerStart
+  pointerStart = null
+  if (start) {
+    const dx = event.clientX - start.x
+    const dy = event.clientY - start.y
+    if (dx * dx + dy * dy > DRAG_CLICK_THRESHOLD_PX * DRAG_CLICK_THRESHOLD_PX) return
+  }
+  const addr = resolveEventAddr(event)
+  if (!addr) return
+  const hit = resolveDrillHit(addr)
+  if (!hit) return
+  if (hit.config.openMode === 'dialog') {
+    void openDrillDialog(hit.config, hit.record)
+    return
+  }
+  void drillInto(hit.config, hit.record)
+}
+
+function handleGridPointerMove(event: PointerEvent): void {
+  const addr = props.resolveTemplate ? resolveEventAddr(event) : null
+  const hit = addr ? resolveDrillHit(addr) : null
+  const next = !!hit
+  if (next !== drillHover.value) drillHover.value = next
+}
+
+function handleGridPointerLeave(): void {
+  drillHover.value = false
+}
+
 async function exportXlsx(): Promise<void> {
   if (loading.value) {
     throw new Error(EXPORT_LOADING_MESSAGE)
@@ -132,5 +271,19 @@ async function exportXlsx(): Promise<void> {
   )
 }
 
-defineExpose<_ReportViewerExposed>({ refresh, exportXlsx })
+/**
+ * 打印填充报表（纯前端）：填充 sheet 模型 → 打印专用 HTML（buildFilledReportPrintHtml）
+ * → 隐藏 iframe 调起浏览器打印。守卫语义与 exportXlsx 一致（取数完成前拒绝）。
+ */
+function print(options?: ReportPrintOptions): void {
+  if (loading.value) {
+    throw new Error(PRINT_LOADING_MESSAGE)
+  }
+  if (!filledSnapshot.value) {
+    throw new Error(PRINT_NOT_READY_MESSAGE)
+  }
+  printHtmlDocument(buildFilledReportPrintHtml(workbook.value.activeSheet, options))
+}
+
+defineExpose<_ReportViewerExposed>({ refresh, exportXlsx, print })
 </script>

package/src/components/report/style-designer.scss

@@ -291,6 +291,72 @@
   }
 }
 
+/* 下钻配置对话框内容 */
+@include m.b(report-drill-dialog) {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+
+  @include m.e(section) {
+    display: flex;
+    flex-direction: column;
+    gap: 6px;
+  }
+
+  @include m.e(label) {
+    font-size: 12px;
+    font-weight: 600;
+    color: fn.use-var(text-color, second);
+  }
+
+  @include m.e(hint) {
+    margin: 0;
+    font-size: 12px;
+    line-height: 1.5;
+    color: fn.use-var(text-color, second);
+  }
+
+  @include m.e(error) {
+    margin: 0;
+    font-size: 12px;
+    line-height: 1.5;
+    color: fn.use-var(color, danger);
+  }
+
+  @include m.e(list) {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    max-height: 320px;
+    overflow: auto;
+  }
+
+  @include m.e(mapping) {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+  }
+
+  @include m.e(field) {
+    width: 160px;
+    flex: none;
+  }
+
+  @include m.e(param) {
+    width: 200px;
+    flex: none;
+  }
+
+  @include m.e(arrow) {
+    flex: none;
+    font-size: 12px;
+    color: fn.use-var(text-color, second);
+  }
+}
+
 @include m.b(report-rule-row) {
   display: flex;
   align-items: flex-start;

package/src/components/report/style-viewer.scss

@@ -22,6 +22,46 @@
     flex: 1;
     min-height: 0;
     min-width: 0;
+
+    /* 下钻格可点提示：VTable pointermove 会把容器内联 cursor 重置为 default，需 !important 覆盖 */
+    @include m.m(drill-hover) {
+      &,
+      .u-sheet__grid-instance,
+      .u-sheet__grid-instance canvas,
+      .u-sheet__grid-instance * {
+        cursor: pointer !important;
+      }
+    }
+  }
+
+  @include m.e(drill-bar) {
+    display: flex;
+    align-items: center;
+    gap: fn.use-var(gap, small);
+  }
+
+  /* 下钻弹框挂在 UDialog 根（Teleport 到 body），给内嵌查看器明确高度 */
+  @include m.e(drill-dialog) {
+    width: min(960px, 92vw);
+    height: min(80vh, 720px);
+
+    .u-dialog__body {
+      flex: 1;
+      min-height: 0;
+      display: flex;
+      flex-direction: column;
+    }
+
+    .u-scroll__container,
+    .u-scroll__content {
+      height: 100%;
+      min-height: 0;
+    }
+
+    .u-report-viewer {
+      height: 100%;
+      min-height: 0;
+    }
   }
 
   @include m.e(loading) {

package/src/components/report/use-report-designer.ts

@@ -316,6 +316,7 @@ export function useReportDesigner(options: UseReportDesignerOptions): UseReportD
     const next: ReportBinding = { ...binding, ...patch }
     if ('rowParent' in patch && patch.rowParent === undefined) delete next.rowParent
     if ('colParent' in patch && patch.colParent === undefined) delete next.colParent
+    if ('drill' in patch && patch.drill === undefined) delete next.drill
     if (
       ('aggregate' in patch || 'expand' in patch) &&
       !('preset' in patch) &&
@@ -483,7 +484,13 @@ export function useReportDesigner(options: UseReportDesignerOptions): UseReportD
   // ---- 渲染与模板 ----
 
   const resolveCellStyle = createBindingBadgeStyleResolver(getBindingAt)
-  const resolveCellRenderer = createBindingBadgeRenderer(getBindingAt, resolveFieldLabel)
+  // 对齐访问器：hook 为长生命周期闭包而 activeSheet 可变（template 载入 / 宿主换 workbook），
+  // 每次调用动态取当前 sheet 的有效样式（getEffectiveStyle 为 O(1) 列→行→格叠加）
+  const resolveCellRenderer = createBindingBadgeRenderer(
+    getBindingAt,
+    resolveFieldLabel,
+    (addr) => workbook.value.activeSheet.getEffectiveStyle(addr)?.align
+  )
 
   function getTemplate(): ReportTemplate {
     const resolved: ReportDatasetDef[] = datasets.value.flatMap((dataset) => {

package/src/components/report/use-report-viewer.ts

@@ -1,30 +1,65 @@
-import type { SheetSnapshot } from '@veltra/sheet-core'
+import type { CellAddress, SheetSnapshot } from '@veltra/sheet-core'
+import { cellKey } from '@veltra/sheet-core'
 import { computed, ref, shallowRef, watch, type ComputedRef, type Ref, type ShallowRef } from 'vue'
 
 import type { ConnectorError } from '../../report/connector'
+import {
+  buildDrillHitMap,
+  createDrillStack,
+  currentDrillLayer,
+  popDrillLayer,
+  pushDrillLayer,
+  resolveDrillParams,
+  type DrillHit,
+  type DrillStack
+} from '../../report/drill'
 import type { ReportColWidthEntry } from '../../report/export-xlsx'
 import { renderReport, resolveFilledColWidths } from '../../report/render'
 import {
   fetchTemplateRecords,
   resolveParamDefaults,
-  resolveTemplateParams
+  resolveTemplateParams,
+  type ReportTemplate
 } from '../../report/template'
-import type { ParamValues, QueryParamDef } from '../../report/types'
+import type { ParamValues, QueryParamDef, ReportDrillConfig } from '../../report/types'
 import type { ReportViewerProps } from '../../types'
 
 export interface UseReportViewerReturn {
-  /** Filter Bar 参数（模板实际绑定的数据集的查询参数并集） */
+  /** Filter Bar 参数（当前层模板实际绑定的数据集的查询参数并集） */
   params: ComputedRef<QueryParamDef[]>
-  /** 当前运行时参数值（初始为参数默认值） */
+  /** 当前运行时参数值（初始为参数默认值；下钻时写入映射值） */
   values: Ref<ParamValues>
   /** 取数中 */
   loading: Ref<boolean>
-  /** 最近一次取数的业务错误（可读提示；成功或重新取数时清空） */
+  /** 最近一次取数的业务错误或下钻解析错误（可读提示；成功或重新取数时清空） */
   error: ShallowRef<ConnectorError | null>
   /** 最近一次成功展开渲染的 Filled Report 快照（组件壳据此替换网格内容） */
   filledSnapshot: ShallowRef<SheetSnapshot | null>
   /** 展开后物理列宽（由模板 colWidths 映射；无模板列宽时为 undefined） */
   filledColWidths: ShallowRef<ReadonlyArray<ReportColWidthEntry> | undefined>
+  /** 当前展示模板：下钻栈顶；未下钻时为 props.template */
+  currentTemplate: ComputedRef<ReportTemplate>
+  /** 下钻栈深（0 = 根层，未下钻） */
+  drillDepth: ComputedRef<number>
+  /** 可回退（栈深 > 0） */
+  canDrillBack: ComputedRef<boolean>
+  /** 物理格下钻命中查询（无命中返回 null）；供组件壳点击 / 悬停判定 */
+  resolveDrillHit: (addr: CellAddress) => DrillHit | null
+  /**
+   * 解析下钻目标：宿主契约取模板 + 默认值叠加映射参数。
+   * 失败设可读错误、返回 null（栈不变）。成功时清除先前的下钻解析错误。
+   */
+  resolveDrillTarget: (
+    config: ReportDrillConfig,
+    record: Record<string, unknown>
+  ) => Promise<{ template: ReportTemplate; params: ParamValues } | null>
+  /**
+   * 下钻进入（openMode 'switch'）：解析目标模板 → 映射参数带入 Filter Bar → 压栈切换并取数。
+   * 解析失败设可读错误提示、停留当前报、栈不变。
+   */
+  drillInto: (config: ReportDrillConfig, record: Record<string, unknown>) => Promise<void>
+  /** 回退上一层：恢复该层模板与当时 Filter Bar 参数并重新取数渲染 */
+  drillBack: () => Promise<void>
   /** 重新取数并展开渲染 */
   refresh: () => Promise<void>
   /** Filter Bar 改值：写入新参数值并重新取数 */
@@ -34,6 +69,8 @@ export interface UseReportViewerReturn {
 /**
  * UReportViewer 的 headless 编排：参数提取 → 取数 → renderReport 展开。
  * 不持有 DOM / 网格引用；填充快照经 `filledSnapshot` 交给组件壳应用。
+ * 下钻：openMode 'switch' 栈式切换当前层；'dialog' 由组件壳解析目标后嵌套独立查看器。
+ * 导出 / 打印始终作用于当前可见层。
  */
 export function useReportViewer(props: ReportViewerProps): UseReportViewerReturn {
   const loading = ref(false)
@@ -41,7 +78,18 @@ export function useReportViewer(props: ReportViewerProps): UseReportViewerReturn
   const filledSnapshot = shallowRef<SheetSnapshot | null>(null)
   const filledColWidths = shallowRef<ReadonlyArray<ReportColWidthEntry> | undefined>(undefined)
 
-  const params = computed(() => resolveTemplateParams(props.template))
+  // 下钻栈：null = 未下钻（当前层即 props.template）；命中索引随每次成功取数重建
+  const drillStack = shallowRef<DrillStack | null>(null)
+  const drillHits = shallowRef<Map<number, DrillHit>>(new Map())
+
+  const currentTemplate = computed(() => {
+    const stack = drillStack.value
+    return stack ? currentDrillLayer(stack).template : props.template
+  })
+  const drillDepth = computed(() => (drillStack.value?.length ?? 1) - 1)
+  const canDrillBack = computed(() => drillDepth.value > 0)
+
+  const params = computed(() => resolveTemplateParams(currentTemplate.value))
   // 初始值由下方 immediate watch 播种（参数默认值）
   const values = shallowRef<ParamValues>({})
 
@@ -50,7 +98,7 @@ export function useReportViewer(props: ReportViewerProps): UseReportViewerReturn
 
   async function refresh(): Promise<void> {
     const current = ++fetchSeq
-    const template = props.template
+    const template = currentTemplate.value
     loading.value = true
     error.value = null
     const result = await fetchTemplateRecords(props.connector, template, values.value)
@@ -65,6 +113,79 @@ export function useReportViewer(props: ReportViewerProps): UseReportViewerReturn
     filledColWidths.value = template.colWidths?.length
       ? resolveFilledColWidths(template, result.data, template.colWidths)
       : undefined
+    drillHits.value = props.resolveTemplate ? buildDrillHitMap(template, result.data) : new Map()
+  }
+
+  /** 切层共有收尾：清填充结果与命中索引，写入新层参数并重新取数 */
+  function transitionTo(layerParams: ParamValues): Promise<void> {
+    filledSnapshot.value = null
+    filledColWidths.value = undefined
+    drillHits.value = new Map()
+    values.value = layerParams
+    return refresh()
+  }
+
+  async function resolveDrillTarget(
+    config: ReportDrillConfig,
+    record: Record<string, unknown>
+  ): Promise<{ template: ReportTemplate; params: ParamValues } | null> {
+    const resolve = props.resolveTemplate
+    if (!resolve) return null
+
+    let target: ReportTemplate | null | undefined
+    try {
+      target = await resolve(config.target)
+    } catch (err) {
+      error.value = {
+        code: 'DRILL_RESOLVE_FAILED',
+        message: err instanceof Error ? err.message : String(err)
+      }
+      return null
+    }
+    if (!target) {
+      error.value = {
+        code: 'DRILL_RESOLVE_FAILED',
+        message: `下钻目标模板解析失败：${config.target}`
+      }
+      return null
+    }
+
+    error.value = null
+    return {
+      template: target,
+      params: {
+        ...resolveParamDefaults(resolveTemplateParams(target)),
+        ...resolveDrillParams(config, record)
+      }
+    }
+  }
+
+  async function drillInto(
+    config: ReportDrillConfig,
+    record: Record<string, unknown>
+  ): Promise<void> {
+    const next = await resolveDrillTarget(config, record)
+    if (!next) return
+    const base =
+      drillStack.value ?? createDrillStack({ template: props.template, params: values.value })
+    drillStack.value = pushDrillLayer(
+      base,
+      { template: next.template, params: next.params },
+      values.value
+    )
+    await transitionTo(next.params)
+  }
+
+  async function drillBack(): Promise<void> {
+    const stack = drillStack.value
+    if (!stack || stack.length <= 1) return
+    const next = popDrillLayer(stack)
+    drillStack.value = next
+    await transitionTo({ ...currentDrillLayer(next).params })
+  }
+
+  function resolveDrillHit(addr: CellAddress): DrillHit | null {
+    return drillHits.value.get(cellKey(addr)) ?? null
   }
 
   function setValues(next: ParamValues): void {
@@ -72,17 +193,35 @@ export function useReportViewer(props: ReportViewerProps): UseReportViewerReturn
     void refresh()
   }
 
-  // 模板更换：清空上一模板的填充结果，参数值重置为新模板默认值并重新取数
+  // 宿主更换根模板：下钻栈作废；Filter Bar 播种为默认值叠加 initialValues
   watch(
     () => props.template,
     () => {
+      drillStack.value = null
+      drillHits.value = new Map()
       filledSnapshot.value = null
       filledColWidths.value = undefined
-      values.value = resolveParamDefaults(params.value)
+      values.value = { ...resolveParamDefaults(params.value), ...props.initialValues }
       void refresh()
     },
     { immediate: true }
   )
 
-  return { params, values, loading, error, filledSnapshot, filledColWidths, refresh, setValues }
+  return {
+    params,
+    values,
+    loading,
+    error,
+    filledSnapshot,
+    filledColWidths,
+    currentTemplate,
+    drillDepth,
+    canDrillBack,
+    resolveDrillHit,
+    resolveDrillTarget,
+    drillInto,
+    drillBack,
+    refresh,
+    setValues
+  }
 }

package/src/components/sheet/insert-image.ts

@@ -24,7 +24,7 @@ const EXT_TO_TYPE: Record<string, SheetImageType> = {
   webp: 'webp'
 }
 
-/** MIME → hucre 图片类型；MIME 为空时回落扩展名 */
+/** MIME → sheet-core 图片类型（core/image 的 SheetImageType）；MIME 为空时回落扩展名 */
 export function resolveImageType(file: File): SheetImageType | undefined {
   const mime = file.type.trim().toLowerCase()
   if (mime && MIME_TO_TYPE[mime]) return MIME_TO_TYPE[mime]

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

@@ -30,7 +30,7 @@ const cls = bem('sheet')
 function exportXlsx(): void {
   emit('close')
   // 大工作簿序列化在 worker 中进行（数秒）：给常驻反馈，失败（如 sheet 名含
-  // Excel 非法字符，hucre 1.0 写入校验抛 InvalidArgumentError）明确报错，
+  // Excel 非法字符，sheet-core 写入校验抛 InvalidArgumentError）明确报错，
   // 绝不静默失败
   const loading = message({ message: '正在导出…', duration: 0 })
   exportWorkbookFile(props.context)