@veltra/sheet 2.4.0 → 2.5.0

package/src/types/report-designer.ts

@@ -1,55 +0,0 @@
-import type { Workbook } from '@veltra/sheet-core/core/workbook'
-import type { DeconstructValue } from '@veltra/utils'
-
-import type {
-  DataConnection,
-  DataConnector,
-  ReportTemplate,
-  ReportTemplateListItem,
-  ResolveReportTemplate
-} from '../report'
-
-/** 报表设计器组件属性（ADR-0003 决策 2） */
-export interface ReportDesignerProps {
-  /** 数据连接器（如 `createHttpConnector({ endpoint })`）：数据中枢的测试连接 / 字段解析 / 记录预览均经它 */
-  connector: DataConnector
-  /**
-   * 数据连接列表（`v-model:connections`）：纯序列化对象，仅驻留内存；
-   * 凭据的持久化与安全存储完全由宿主掌控（ADR-0003 决策 4）
-   */
-  connections?: DataConnection[]
-  /**
-   * 载入既有 Report Template 继续设计：恢复网格绑定与设计态数据集；
-   * 内嵌连接按 id 合并进 `v-model:connections`（仅缺省时追加，宿主列表是单一事实源）
-   */
-  template?: ReportTemplate
-  /** 承载设计态的工作簿（USheet 先例：缺省内部自建单 sheet 工作簿） */
-  workbook?: Workbook
-  /**
-   * 宿主提供的可下钻目标模板列表（ref + 可读名）：
-   * 传入后绑定格 Action Pill 出现下钻配置入口（目标仅从列表选择，不支持手填引用）；不传则无入口
-   */
-  drillTemplates?: ReportTemplateListItem[]
-  /**
-   * 宿主模板解析契约（按下钻 target 引用取回目标模板，失败抛错）：
-   * 下钻配置对话框据此解析目标模板的查询参数（字段→参数映射）；
-   * 预览模式原样转发给内嵌 UReportViewer，使预览内可下钻（含 switch / dialog）与逐级回退
-   */
-  resolveTemplate?: ResolveReportTemplate
-}
-
-/** 报表设计器组件定义的事件 */
-export interface ReportDesignerEmits {
-  (e: 'update:connections', value: DataConnection[]): void
-  /** 数据集增删改或数据中枢关闭：宿主可立即持久化工作区 */
-  (e: 'datasets-change'): void
-}
-
-/** 在组件内部引用 */
-export interface _ReportDesignerExposed {
-  /** 取回含 meta 绑定与内嵌数据集定义的可序列化 Report Template */
-  getTemplate: () => ReportTemplate
-}
-
-/** 报表设计器组件暴露的方法 */
-export type ReportDesignerExposed = DeconstructValue<_ReportDesignerExposed>

package/src/types/report-viewer.ts

@@ -1,54 +0,0 @@
-import type { Workbook } from '@veltra/sheet-core/core/workbook'
-import type { DeconstructValue } from '@veltra/utils'
-
-import type { DataConnector, ParamValues, ReportTemplate, ResolveReportTemplate } from '../report'
-import type { ReportColWidthEntry } from '../report/export-xlsx'
-import type { ReportPrintOptions } from '../report/print'
-
-/** 报表查看器组件属性（ADR-0003 决策 2） */
-export interface ReportViewerProps {
-  /** 数据连接器（如 `createHttpConnector({ endpoint })`） */
-  connector: DataConnector
-  /**
-   * 自包含 Report Template（SheetSnapshot + 内嵌数据集定义，见 `ReportTemplate`）：
-   * 查看器据此提取实际绑定数据集的查询参数并集生成 Filter Bar，并经连接器取数展开渲染
-   */
-  template: ReportTemplate
-  /** 承载填充报表的工作簿（USheet 先例：缺省内部自建单 sheet 工作簿） */
-  workbook?: Workbook
-  /**
-   * 列宽显式覆盖（可选）：优先于模板 `colWidths` / 展开映射结果写入模型与网格。
-   * 列宽已进 `SheetSnapshot.colWidths`，通常无需再传。
-   */
-  colWidths?: ReadonlyArray<ReportColWidthEntry>
-  /**
-   * 下钻目标模板解析契约（可选，内核共享类型）：单击配了下钻的绑定格时按 `target` 引用取目标模板。
-   * 解析失败（抛错 / reject，或宿主实现返回空值）时查看器给出可读提示并停留当前报。
-   * 缺省时下钻不生效（无点击行为与可点视觉提示）。
-   */
-  resolveTemplate?: ResolveReportTemplate
-  /**
-   * Filter Bar 初值（可选）：与当前模板参数默认值合并，显式键覆盖默认值。
-   * 仅在根模板载入时播种（下钻弹框传入映射参数）；缺省则只用参数默认值。
-   */
-  initialValues?: ParamValues
-}
-
-/** 在组件内部引用 */
-export interface _ReportViewerExposed {
-  /** 重新取数并展开渲染（外部状态变化后主动刷新报表） */
-  refresh: () => Promise<void>
-  /**
-   * 导出填充报表为 XLSX（取数完成前拒绝；内部读取填充 sheet 与运行时列宽）。
-   * 不内置导出按钮，工具栏由下游决定。
-   */
-  exportXlsx: () => Promise<void>
-  /**
-   * 打印填充报表（纯前端：模型 → 打印 HTML → 隐藏 iframe 调起浏览器打印；
-   * 取数完成前拒绝）。不内置打印按钮，工具栏由下游决定。
-   */
-  print: (options?: ReportPrintOptions) => void
-}
-
-/** 报表查看器组件暴露的方法 */
-export type ReportViewerExposed = DeconstructValue<_ReportViewerExposed>