@veltra/sheet 2.3.3 → 2.4.0

package/src/components/report/__test__/report-viewer.test.ts

@@ -354,4 +354,47 @@ describe('UReportViewer', () => {
     exportSpy.mockRestore()
     saveBlobSpy.mockRestore()
   })
+
+  it('取数前 print() 拒绝；取数失败或未就绪时同样拒绝', async () => {
+    let gate = deferred<QueryOutcome>()
+    const outcome: QueryOutcome = {
+      error: { code: 'CONNECTION_FAILED', message: '数据库连接失败' }
+    }
+    const { connector } = createStubConnector(() => gate.promise)
+    const { exposedRef } = mountViewer({
+      connector,
+      template: createViewerTemplate(),
+      workbook: new Workbook()
+    })
+    await nextTick()
+
+    expect(() => exposedRef.value!.print()).toThrow('报表数据加载中')
+
+    gate.resolve(outcome)
+    await flushViewer()
+    expect(() => exposedRef.value!.print()).toThrow('报表数据尚未就绪')
+  })
+
+  it('取数后 print() 生成打印 HTML 并送隐藏 iframe 打印', async () => {
+    const { connector } = createStubConnector({ rows: ORDER_ROWS })
+    const workbook = new Workbook()
+    const { exposedRef } = mountViewer({ connector, template: createViewerTemplate(), workbook })
+    await flushViewer()
+
+    const printModule = await import('../../../report/print')
+    const domPrintModule = await import('../print')
+    const buildSpy = vi.spyOn(printModule, 'buildFilledReportPrintHtml')
+    const printSpy = vi.spyOn(domPrintModule, 'printHtmlDocument').mockImplementation(() => {})
+
+    exposedRef.value!.print({ orientation: 'landscape' })
+
+    expect(buildSpy).toHaveBeenCalledWith(workbook.activeSheet, { orientation: 'landscape' })
+    const html = buildSpy.mock.results[0]!.value as string
+    expect(html).toContain('甲公司')
+    expect(html).toContain('@page { size: A4 landscape;')
+    expect(printSpy).toHaveBeenCalledWith(html)
+
+    buildSpy.mockRestore()
+    printSpy.mockRestore()
+  })
 })

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

@@ -5,7 +5,12 @@ import { effectScope, ref, type EffectScope, type Ref } from 'vue'
 import { REPORT_META_NAMESPACE } from '../../../report/binding'
 import type { DataConnection, DataConnector } from '../../../report/connector'
 import { IncompatibleTemplateVersionError, type ReportTemplate } from '../../../report/template'
-import type { DatasetField, ParamValues, ReportBinding } from '../../../report/types'
+import type {
+  DatasetField,
+  ParamValues,
+  ReportBinding,
+  ReportDrillConfig
+} from '../../../report/types'
 import { roleBindingDefaults } from '../designer/role'
 import { useReportDesigner, type UseReportDesignerReturn } from '../use-report-designer'
 
@@ -559,6 +564,108 @@ describe('useReportDesigner：Action Pill 就地编辑（角色 / 聚合 / 条
   })
 })
 
+describe('useReportDesigner：下钻配置读写与序列化', () => {
+  const DRILL: ReportDrillConfig = {
+    target: 'tpl-order-detail',
+    mapping: { customer: 'p_customer', amount: 'p_minAmount' },
+    openMode: 'dialog'
+  }
+
+  async function seedAndBind(
+    designer: UseReportDesignerReturn,
+    workbook: Workbook,
+    addr: { row: number; col: number }
+  ) {
+    const dataset = designer.addDataset('c1')
+    designer.updateDataset(dataset.id, { sql: 'SELECT customer, amount FROM orders' })
+    await designer.describeDataset(dataset.id)
+    designer.bindField(dataset.id, 'customer', addr)
+    workbook.activeSheet.selectCell(addr)
+    return dataset
+  }
+
+  it('drill 经 patchActiveBinding 写入，随 getTemplate() 序列化 round-trip', async () => {
+    const { designer, workbook } = createDesigner()
+    await seedAndBind(designer, workbook, { row: 0, col: 0 })
+
+    designer.patchActiveBinding({ drill: DRILL })
+    expect(designer.activeBinding.value?.drill).toEqual(DRILL)
+
+    const template = designer.getTemplate()
+    expect(template.version).toBe(1)
+    const meta = template.meta ?? []
+    expect(meta).toHaveLength(1)
+    expect((meta[0]!.payload as ReportBinding).drill).toEqual(DRILL)
+
+    // JSON 序列化往返后下钻配置完整（模板可序列化流转）
+    const restored = JSON.parse(JSON.stringify(template)) as ReportTemplate
+    expect((restored.meta![0]!.payload as ReportBinding).drill).toEqual(DRILL)
+  })
+
+  it('patchActiveBinding({ drill: undefined }) 移除下钻配置（meta 不留 drill 键）', async () => {
+    const { designer, workbook } = createDesigner()
+    await seedAndBind(designer, workbook, { row: 0, col: 0 })
+
+    designer.patchActiveBinding({ drill: DRILL })
+    designer.patchActiveBinding({ drill: undefined })
+
+    const binding = workbook.activeSheet.getCellMeta<ReportBinding>(
+      { row: 0, col: 0 },
+      REPORT_META_NAMESPACE
+    )
+    expect(binding).toBeTruthy()
+    expect('drill' in binding!).toBe(false)
+    expect(designer.getTemplate().meta![0]!.payload).not.toHaveProperty('drill')
+  })
+
+  it('载入含下钻配置的模板后还原，getTemplate 往返保留', async () => {
+    const binding: ReportBinding = {
+      dataset: 'ds-template',
+      field: 'customer',
+      preset: 'groupHeader',
+      aggregate: 'group',
+      expand: 'down',
+      drill: DRILL
+    }
+    const template: ReportTemplate = {
+      version: 1,
+      cells: [],
+      styles: [],
+      merges: [],
+      frozen: { rows: 0, cols: 0 },
+      rows: 24,
+      cols: 10,
+      meta: [{ row: 1, col: 0, namespace: REPORT_META_NAMESPACE, payload: binding }],
+      datasets: [
+        {
+          id: 'ds-template',
+          label: '模板数据集',
+          connection: { ...PG, id: 'conn-template' },
+          sql: 'SELECT customer, amount FROM orders'
+        }
+      ]
+    }
+
+    const { designer, workbook } = createDesigner([MYSQL], { template })
+
+    // 下钻配置随绑定 meta 还原
+    const loaded = workbook.activeSheet.getCellMeta<ReportBinding>(
+      { row: 1, col: 0 },
+      REPORT_META_NAMESPACE
+    )
+    expect(loaded?.drill).toEqual(DRILL)
+
+    // 选中该格：activeBinding 暴露 drill（Action Pill 下钻入口回填数据源）
+    workbook.activeSheet.selectCell({ row: 1, col: 0 })
+    expect(designer.activeBinding.value?.drill).toEqual(DRILL)
+
+    // 往返吐出保留
+    const roundTrip = designer.getTemplate()
+    expect(roundTrip.version).toBe(1)
+    expect((roundTrip.meta![0]!.payload as ReportBinding).drill).toEqual(DRILL)
+  })
+})
+
 describe('useReportDesigner：template 版本校验', () => {
   it('载入缺少 version 的模板时抛可读错误', () => {
     const { connector } = createStubConnector()

package/src/components/report/binding-badge.ts

@@ -1,4 +1,4 @@
-import type { CellAddress } from '@veltra/sheet-core'
+import type { CellAddress, CellAlign } from '@veltra/sheet-core'
 import {
   CustomLayout,
   type ResolveCellRenderer,
@@ -51,14 +51,38 @@ export function createBindingBadgeStyleResolver(
   }
 }
 
+/** 徽章容器 flex 布局属性（`flexDirection: 'row'` 下主轴 = 水平） */
+interface BadgeLayoutProps {
+  justifyContent: 'flex-start' | 'center' | 'flex-end'
+  alignItems: 'flex-start' | 'center' | 'flex-end'
+}
+
+/**
+ * 单元格对齐 → 徽章容器 flex 布局映射（纯函数，便于单测）：
+ * `horizontal` left / 缺省 → 主轴起点；`vertical` middle / 缺省 → 交叉轴居中。
+ */
+export function badgeLayoutProps(align: CellAlign | undefined): BadgeLayoutProps {
+  const justifyContent =
+    align?.horizontal === 'center'
+      ? 'center'
+      : align?.horizontal === 'right'
+        ? 'flex-end'
+        : 'flex-start'
+  const alignItems =
+    align?.vertical === 'top' ? 'flex-start' : align?.vertical === 'bottom' ? 'flex-end' : 'center'
+  return { justifyContent, alignItems }
+}
+
 /**
  * 绑定格富渲染徽章（ADR-0004 `resolveCellRenderer` 首个消费者）：
- * 绑定单元格渲染为左对齐徽章（强调色聚合标签 + 中性色字段标签），
+ * 绑定单元格渲染为徽章布局（强调色聚合标签 + 中性色字段标签），
+ * 布局跟随单元格水平 / 垂直对齐（经 `resolveAlign` 读有效样式）；
  * 未绑定格返回 `undefined` 回落默认渲染。
  */
 export function createBindingBadgeRenderer(
   getBindingAt: (addr: CellAddress) => ReportBinding | undefined,
-  resolveLabel?: (datasetId: string, fieldName: string) => string
+  resolveLabel?: (datasetId: string, fieldName: string) => string,
+  resolveAlign?: (addr: CellAddress) => CellAlign | undefined
 ): ResolveCellRenderer {
   return (addr) => {
     const binding = getBindingAt(addr)
@@ -66,12 +90,13 @@ export function createBindingBadgeRenderer(
 
     const { fg } = resolveBadgeColor(binding)
     const { tag, label } = formatBindingPlaceholderParts(binding, resolveLabel)
+    const { justifyContent, alignItems } = badgeLayoutProps(resolveAlign?.(addr))
 
     const rootContainer = new CustomLayout.Container({
       display: 'flex',
       flexDirection: 'row',
-      justifyContent: 'flex-start',
-      alignItems: 'center'
+      justifyContent,
+      alignItems
     })
     // VTable 布局层 Tag 组件（vrender-components）与其 INode 声明存在结构性类型偏差，
     // 运行时完全兼容（VTable 官方 customLayout 徽章用法即如此），此处仅收敛类型
@@ -87,6 +112,11 @@ export function createBindingBadgeRenderer(
     rootContainer.add(
       new CustomLayout.Text({ text: label, fontSize: 11, fontWeight: 500, fill: BADGE_LABEL_COLOR })
     )
+    if (binding.drill) {
+      rootContainer.add(
+        new CustomLayout.Text({ text: ' ↗', fontSize: 11, fontWeight: 700, fill: fg })
+      )
+    }
     return { rootContainer, renderDefault: false }
   }
 }

package/src/components/report/designer/drill-dialog.vue

@@ -0,0 +1,245 @@
+<template>
+  <u-dialog
+    v-model="visible"
+    title="下钻配置"
+    style="width: min(560px, 92vw); max-height: 85vh"
+    @close="onClose"
+  >
+    <div :class="cls.b">
+      <section :class="cls.e('section')">
+        <div :class="cls.e('label')">目标模板</div>
+        <u-select
+          size="small"
+          placeholder="从模板列表选择目标"
+          :model-value="target"
+          :options="templateOptions"
+          @update:model-value="onTarget"
+        />
+        <p :class="cls.e('hint')">目标模板仅从宿主提供的列表选择，不支持手填引用。</p>
+      </section>
+
+      <section :class="cls.e('section')">
+        <div :class="cls.e('label')">打开方式</div>
+        <u-radio-group
+          size="small"
+          :items="openModeItems"
+          :model-value="openMode"
+          @update:model-value="onOpenMode"
+        />
+      </section>
+
+      <section :class="cls.e('section')">
+        <div :class="cls.e('label')">字段 → 详情报参数映射</div>
+        <p v-if="!target" :class="cls.e('hint')">先选择目标模板，再配置映射。</p>
+        <p v-else-if="paramsLoading" :class="cls.e('hint')">正在解析目标模板参数…</p>
+        <p v-else-if="paramsError" :class="cls.e('error')">{{ paramsError }}</p>
+        <template v-else>
+          <p v-if="targetParams.length === 0" :class="cls.e('hint')">
+            目标模板没有查询参数，无需配置映射。
+          </p>
+          <ul v-else :class="cls.e('list')">
+            <li v-for="(row, index) in mappings" :key="index" :class="cls.e('mapping')">
+              <u-select
+                size="small"
+                :class="cls.e('field')"
+                placeholder="字段"
+                :model-value="row.field"
+                :options="fieldOptions"
+                @update:model-value="row.field = $event"
+              />
+              <span :class="cls.e('arrow')">→</span>
+              <u-select
+                size="small"
+                :class="cls.e('param')"
+                placeholder="参数"
+                :model-value="row.param"
+                :options="paramOptions"
+                @update:model-value="row.param = $event"
+              />
+              <u-button size="small" text type="danger" @click="removeMapping(index)">
+                删除
+              </u-button>
+            </li>
+          </ul>
+          <div v-if="targetParams.length > 0">
+            <u-button size="small" plain @click="addMapping">添加映射</u-button>
+          </div>
+        </template>
+      </section>
+    </div>
+
+    <template #footer>
+      <u-button
+        v-if="drill"
+        size="small"
+        text
+        type="danger"
+        style="margin-right: auto"
+        @click="remove"
+      >
+        移除下钻
+      </u-button>
+      <u-button size="small" @click="visible = false">取消</u-button>
+      <u-button size="small" type="primary" :disabled="!target" @click="confirm">确定</u-button>
+    </template>
+  </u-dialog>
+</template>
+
+<script lang="ts" setup>
+import { UButton, UDialog, URadioGroup, USelect } from '@veltra/desktop'
+import { bem } from '@veltra/utils'
+import { computed, ref, watch } from 'vue'
+
+import type { ResolveReportTemplate } from '../../../report/drill'
+import { resolveTemplateParams } from '../../../report/template'
+import type {
+  DatasetField,
+  QueryParamDef,
+  ReportDrillConfig,
+  ReportTemplateListItem
+} from '../../../report/types'
+
+defineOptions({ name: 'UReportDrillDialog' })
+
+/** 映射编辑行草稿（保存时折叠为 Record<字段, 参数>） */
+interface MappingRow {
+  field: string
+  param: string
+}
+
+const props = withDefaults(
+  defineProps<{
+    modelValue: boolean
+    /** 宿主提供的可下钻目标模板列表（目标必选，无手填输入） */
+    templates: ReportTemplateListItem[]
+    /** 当前绑定所在数据集的字段 catalog */
+    fields?: DatasetField[]
+    /** 已有下钻配置（编辑时回填；缺省为新建） */
+    drill?: ReportDrillConfig
+    /** 宿主模板解析契约：选中目标后解析其查询参数；缺失时映射区给出可读提示 */
+    resolveTemplate?: ResolveReportTemplate
+  }>(),
+  { fields: () => [], drill: undefined, resolveTemplate: undefined }
+)
+
+const emit = defineEmits<{
+  'update:modelValue': [value: boolean]
+  save: [drill: ReportDrillConfig]
+  remove: []
+}>()
+
+const cls = bem('report-drill-dialog')
+
+const visible = computed({
+  get: () => props.modelValue,
+  set: (value: boolean) => emit('update:modelValue', value)
+})
+
+const openModeItems = [
+  { value: 'switch' as const, label: '查看器内切换' },
+  { value: 'dialog' as const, label: '弹框打开（UDialog）' }
+]
+
+// ---- 草稿（打开时从 props.drill 回填） ----
+
+const target = ref('')
+const openMode = ref<ReportDrillConfig['openMode']>('switch')
+const mappings = ref<MappingRow[]>([])
+
+watch(
+  () => props.modelValue,
+  (open) => {
+    if (!open) return
+    target.value = props.drill?.target ?? ''
+    openMode.value = props.drill?.openMode ?? 'switch'
+    mappings.value = Object.entries(props.drill?.mapping ?? {}).map(([field, param]) => ({
+      field,
+      param
+    }))
+    void resolveTargetParams(target.value)
+  }
+)
+
+// ---- 目标模板参数解析（并发守卫：只应用最后一次解析） ----
+
+const targetParams = ref<QueryParamDef[]>([])
+const paramsLoading = ref(false)
+const paramsError = ref('')
+let paramsSeq = 0
+
+async function resolveTargetParams(ref: string): Promise<void> {
+  const seq = ++paramsSeq
+  targetParams.value = []
+  paramsError.value = ''
+  if (!ref) return
+  const resolve = props.resolveTemplate
+  if (!resolve) {
+    paramsError.value = '宿主未提供 resolveTemplate，无法解析目标模板参数'
+    return
+  }
+  paramsLoading.value = true
+  try {
+    const template = await resolve(ref)
+    if (seq !== paramsSeq) return
+    targetParams.value = resolveTemplateParams(template)
+  } catch (error) {
+    if (seq !== paramsSeq) return
+    paramsError.value = `解析目标模板参数失败：${error instanceof Error ? error.message : String(error)}`
+  } finally {
+    if (seq === paramsSeq) paramsLoading.value = false
+  }
+}
+
+const templateOptions = computed(() =>
+  props.templates.map((item) => ({ value: item.ref, label: item.label }))
+)
+
+const fieldOptions = computed(() =>
+  props.fields.map((field) => ({ value: field.name, label: field.label }))
+)
+
+const paramOptions = computed(() =>
+  targetParams.value.map((param) => ({
+    value: param.id,
+    label: param.label && param.label !== param.id ? `${param.label}（${param.id}）` : param.id
+  }))
+)
+
+/** 用户改选目标：旧映射的参数 id 未必存在于新模板，直接清空重配 */
+function onTarget(value: string): void {
+  target.value = value ?? ''
+  mappings.value = []
+  void resolveTargetParams(target.value)
+}
+
+function onOpenMode(value: ReportDrillConfig['openMode']): void {
+  openMode.value = value
+}
+
+function addMapping(): void {
+  mappings.value = [...mappings.value, { field: '', param: '' }]
+}
+
+function removeMapping(index: number): void {
+  mappings.value = mappings.value.filter((_, i) => i !== index)
+}
+
+function confirm(): void {
+  if (!target.value) return
+  const mapping: Record<string, string> = {}
+  for (const row of mappings.value) {
+    if (row.field && row.param) mapping[row.field] = row.param
+  }
+  emit('save', { target: target.value, mapping, openMode: openMode.value })
+  visible.value = false
+}
+
+function remove(): void {
+  emit('remove')
+  visible.value = false
+}
+
+function onClose(): void {
+  visible.value = false
+}
+</script>

package/src/components/report/designer/float-panel.vue

@@ -37,6 +37,15 @@
           @update:model-value="onExpand"
         />
         <u-button size="small" plain @click="emit('open-rules')">条件样式</u-button>
+        <u-button
+          v-if="showDrill"
+          size="small"
+          plain
+          :type="binding.drill ? 'primary' : undefined"
+          @click="emit('open-drill')"
+        >
+          下钻
+        </u-button>
         <u-button size="small" text type="danger" @click="emit('remove')">删除绑定</u-button>
         <u-button
           size="small"
@@ -190,6 +199,8 @@ const props = defineProps<{
   parentPickMode: ParentPickMode | null
   rowParentCandidates: CellAddress[]
   colParentCandidates: CellAddress[]
+  /** 宿主传入了可下钻模板列表（下钻配置入口可见性由父级按 props 计算） */
+  showDrill?: boolean
   resolveFieldLabel?: (datasetId: string, fieldName: string) => string
   getBindingAt?: (addr: CellAddress) => ReportBinding | undefined
   hostEl: HTMLElement | null
@@ -200,6 +211,7 @@ const emit = defineEmits<{
   patch: [patch: Partial<ReportBinding>]
   remove: []
   'open-rules': []
+  'open-drill': []
   'start-parent-pick': [mode: ParentPickMode]
   'cancel-parent-pick': []
   'clear-parent': [mode: ParentPickMode]

package/src/components/report/print.ts

@@ -0,0 +1,44 @@
+/**
+ * 打印 HTML 文档：隐藏 iframe 装载后调起浏览器打印，结束（或兜底超时）销毁。
+ *
+ * 路线取舍：相对 `window.open` 不被弹窗拦截；相对 `@media print` 直打宿主页，
+ * 不侵入应用布局，也不受网格 canvas 虚拟滚动（只绘制视口）限制。
+ * iframe 用 0×0 定位隐藏而非 `display:none`（部分浏览器不打印 none 的 iframe）。
+ */
+export function printHtmlDocument(html: string): void {
+  const iframe = document.createElement('iframe')
+  iframe.setAttribute('aria-hidden', 'true')
+  iframe.style.cssText = 'position:fixed;right:0;bottom:0;width:0;height:0;border:0;'
+  document.body.appendChild(iframe)
+
+  const win = iframe.contentWindow
+  const doc = iframe.contentDocument
+  if (!win || !doc || typeof win.print !== 'function') {
+    iframe.remove()
+    throw new Error('当前环境不支持打印')
+  }
+
+  let cleaned = false
+  const cleanup = (): void => {
+    if (cleaned) return
+    cleaned = true
+    iframe.remove()
+  }
+  win.addEventListener('afterprint', cleanup)
+
+  doc.open()
+  doc.write(html)
+  doc.close()
+
+  // 等内嵌图片（data URL）解码完再打印，避免打印快照取到未解码图片
+  const decoding = Array.from(doc.images).map((img) =>
+    typeof img.decode === 'function' ? img.decode().catch(() => undefined) : Promise.resolve()
+  )
+  void Promise.all(decoding).then(() => {
+    if (cleaned) return
+    win.focus()
+    win.print()
+    // 兜底回收：afterprint 在部分环境不触发，或用户长期挂着打印对话框
+    setTimeout(cleanup, 60_000)
+  })
+}

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

@@ -106,6 +106,7 @@
           :parent-pick-mode="parentPick?.mode ?? null"
           :row-parent-candidates="rowParentCandidates"
           :col-parent-candidates="colParentCandidates"
+          :show-drill="hasDrillTemplates"
           :resolve-field-label="resolveFieldLabel"
           :get-binding-at="getBindingAt"
           :host-el="gridHostEl"
@@ -113,6 +114,7 @@
           @patch="patchActiveBinding"
           @remove="removeActiveBinding"
           @open-rules="rulesDialogVisible = true"
+          @open-drill="drillDialogVisible = true"
           @start-parent-pick="startParentPick"
           @cancel-parent-pick="cancelParentPick"
           @clear-parent="clearParent"
@@ -126,6 +128,7 @@
         :connector="props.connector"
         :template="previewTemplate"
         :workbook="previewWorkbook"
+        :resolve-template="props.resolveTemplate"
       />
     </div>
 
@@ -141,6 +144,17 @@
       :field-type="activeFieldType"
       @save="saveConditionalRules"
     />
+
+    <u-report-drill-dialog
+      v-if="hasDrillTemplates"
+      v-model="drillDialogVisible"
+      :templates="props.drillTemplates ?? []"
+      :fields="activeDatasetFields"
+      :drill="activeBinding?.drill"
+      :resolve-template="props.resolveTemplate"
+      @save="saveDrill"
+      @remove="removeDrill"
+    />
   </div>
 </template>
 
@@ -153,7 +167,7 @@ import { bem } from '@veltra/utils'
 import { computed, nextTick, onScopeDispose, ref, shallowRef, useTemplateRef, watch } from 'vue'
 
 import type { ReportTemplate } from '../../report/template'
-import type { ConditionalRule } from '../../report/types'
+import type { ConditionalRule, ReportDrillConfig } from '../../report/types'
 import type {
   ReportDesignerEmits,
   ReportDesignerProps,
@@ -165,6 +179,7 @@ import { USheet } from '../sheet'
 import UReportDatasetHub from './designer-hub.vue'
 import { resolveGridDropAddress } from './designer/cell-coords'
 import { applyGridColWidths, applySheetColWidths, readGridColWidths } from './designer/col-widths'
+import UReportDrillDialog from './designer/drill-dialog.vue'
 import UReportDropHighlightOverlay from './designer/drop-highlight-overlay.vue'
 import UReportFloatPanel from './designer/float-panel.vue'
 import UReportRulesDialog from './designer/rules-dialog.vue'
@@ -176,7 +191,13 @@ import { useReportDesigner } from './use-report-designer'
 
 defineOptions({ name: 'UReportDesigner' })
 
-const props = withDefaults(defineProps<ReportDesignerProps>(), { connections: () => [] })
+/** 与 `ReportDesignerProps` 交叉显式列出下钻 props，避免 SFC 对跨文件 interface 漏抽 runtime 声明 */
+type DesignerRuntimeProps = ReportDesignerProps & {
+  drillTemplates?: ReportDesignerProps['drillTemplates']
+  resolveTemplate?: ReportDesignerProps['resolveTemplate']
+}
+
+const props = withDefaults(defineProps<DesignerRuntimeProps>(), { connections: () => [] })
 const emit = defineEmits<ReportDesignerEmits>()
 
 const cls = bem('report-designer')
@@ -237,6 +258,10 @@ const gridCols = computed(() => {
 
 const hubVisible = ref(false)
 const rulesDialogVisible = ref(false)
+const drillDialogVisible = ref(false)
+
+/** 宿主传入可下钻模板列表时才出现下钻配置入口（不传则无入口，spec 兼容性要求） */
+const hasDrillTemplates = computed(() => (props.drillTemplates?.length ?? 0) > 0)
 
 const pickCandidateCells = computed((): CellAddress[] => {
   if (!parentPick.value) return []
@@ -364,6 +389,14 @@ function saveConditionalRules(rules: ConditionalRule[]): void {
   patchActiveBinding({ conditionalRules: rules })
 }
 
+function saveDrill(drill: ReportDrillConfig): void {
+  patchActiveBinding({ drill })
+}
+
+function removeDrill(): void {
+  patchActiveBinding({ drill: undefined })
+}
+
 function clearDropState(): void {
   isFieldDragging.value = false
   dropTargetAddr.value = null