@agile-team/mach-report 2.19.0 → 2.20.0

package/dist/designer.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("vue");const E=require("./designer-CyKXBhQg.cjs");exports.COLUMN_VISUAL_MESSAGES=E.COLUMN_VISUAL_MESSAGES;exports.ChartBindingInspector=E.ChartBindingInspector;exports.ColumnVisualEditor=E.ColumnVisualEditor;exports.DESIGNER_GUIDE_MESSAGES=E.DESIGNER_GUIDE_MESSAGES;exports.EXCEL_BINDING_MESSAGES=E.EXCEL_BINDING_MESSAGES;exports.ExcelBindingWizard=E.ExcelBindingWizard;exports.LABEL_STUDIO_MESSAGES=E.LABEL_STUDIO_MESSAGES;exports.PARAM_EDITOR_MESSAGES=E.PARAM_EDITOR_MESSAGES;exports.ParamEditor=E.ParamEditor;exports.REPORT_BATCH_MESSAGES=E.REPORT_BATCH_MESSAGES;exports.RULE_EDITOR_MESSAGES=E.DEFAULT_RULE_EDITOR_MESSAGES;exports.ReportBatchPanel=E.ReportBatchPanel;exports.ReportLabelStudio=E.ReportLabelStudio;exports.ReportTemplateEditor=E.ReportTemplateEditor;exports.ReportTemplateLibrary=E.ReportTemplateLibrary;exports.RuleEditor=E.RuleEditor;exports.TEMPLATE_EDITOR_MESSAGES=E.TEMPLATE_EDITOR_MESSAGES;exports.TEMPLATE_LIBRARY_MESSAGES=E.TEMPLATE_LIBRARY_MESSAGES;exports.TEMPLATE_PRODUCT_MESSAGES=E.TEMPLATE_PRODUCT_MESSAGES;exports.TEMPLATE_RECOVERY_MESSAGES=E.TEMPLATE_RECOVERY_MESSAGES;exports.TEMPLATE_REVIEW_MESSAGES=E.TEMPLATE_REVIEW_MESSAGES;exports.TemplateOutlinePanel=E.TemplateOutlinePanel;exports.TemplateReusePanel=E.TemplateReusePanel;exports.TemplateReviewPanel=E.TemplateReviewPanel;exports.createTemplateDraftStorage=E.createTemplateDraftStorage;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("vue");const E=require("./designer-Dtsw_rh7.cjs");exports.COLUMN_VISUAL_MESSAGES=E.COLUMN_VISUAL_MESSAGES;exports.ChartBindingInspector=E.ChartBindingInspector;exports.ColumnVisualEditor=E.ColumnVisualEditor;exports.DESIGNER_GUIDE_MESSAGES=E.DESIGNER_GUIDE_MESSAGES;exports.EXCEL_BINDING_MESSAGES=E.EXCEL_BINDING_MESSAGES;exports.ExcelBindingWizard=E.ExcelBindingWizard;exports.LABEL_STUDIO_MESSAGES=E.LABEL_STUDIO_MESSAGES;exports.PARAM_EDITOR_MESSAGES=E.PARAM_EDITOR_MESSAGES;exports.ParamEditor=E.ParamEditor;exports.REPORT_BATCH_MESSAGES=E.REPORT_BATCH_MESSAGES;exports.RULE_EDITOR_MESSAGES=E.DEFAULT_RULE_EDITOR_MESSAGES;exports.ReportBatchPanel=E.ReportBatchPanel;exports.ReportLabelStudio=E.ReportLabelStudio;exports.ReportTemplateEditor=E.ReportTemplateEditor;exports.ReportTemplateLibrary=E.ReportTemplateLibrary;exports.RuleEditor=E.RuleEditor;exports.TEMPLATE_EDITOR_MESSAGES=E.TEMPLATE_EDITOR_MESSAGES;exports.TEMPLATE_LIBRARY_MESSAGES=E.TEMPLATE_LIBRARY_MESSAGES;exports.TEMPLATE_PRODUCT_MESSAGES=E.TEMPLATE_PRODUCT_MESSAGES;exports.TEMPLATE_RECOVERY_MESSAGES=E.TEMPLATE_RECOVERY_MESSAGES;exports.TEMPLATE_REVIEW_MESSAGES=E.TEMPLATE_REVIEW_MESSAGES;exports.TemplateOutlinePanel=E.TemplateOutlinePanel;exports.TemplateReusePanel=E.TemplateReusePanel;exports.TemplateReviewPanel=E.TemplateReviewPanel;exports.createTemplateDraftStorage=E.createTemplateDraftStorage;

package/dist/designer.d.cts

@@ -483,9 +483,45 @@ export declare const DESIGNER_GUIDE_MESSAGES: {
     readonly reviewHint: "校验字段依赖、样例结果与输出限制";
     readonly result: "预览确认效果后保存模板；高级 JSON 保留给需要时使用。";
 };
+declare const DESIGNER_INSERT_MESSAGES: {
+    readonly add: "添加内容";
+    readonly title: "添加到当前版面";
+    readonly text: "说明文字";
+    readonly textHint: "添加标题、备注或说明";
+    readonly field: "业务字段";
+    readonly columnField: "添加表格字段";
+    readonly fieldHint: "选择字段后立即显示真实内容";
+    readonly image: "图片或 Logo";
+    readonly imageHint: "使用 PNG 或 JPEG 图片";
+    readonly qrcode: "二维码";
+    readonly barcode: "条形码";
+    readonly codeHint: "绑定记录编号或填写编码内容";
+    readonly list: "明细表";
+    readonly listHint: "从当前字段契约建立表格";
+    readonly chart: "图表";
+    readonly recordCount: "记录数";
+    readonly chartHint: "选择分类与数值字段";
+    readonly rect: "装饰色块";
+    readonly rectHint: "辅助分区与突出信息";
+    readonly search: "搜索业务字段";
+    readonly noFields: "没有匹配的字段";
+    readonly close: "关闭添加内容";
+    readonly back: "返回内容类型";
+    readonly duplicate: "复制组件";
+    readonly newPage: "当前版面空间不足或含动态明细，内容已放到新增版面，可撤销恢复。";
+    readonly addColumn: "添加字段列";
+    readonly removeColumn: "删除当前列";
+    readonly removeLast: "至少保留一列";
+    readonly dependentColumn: "此字段仍被合计、规则或表头引用，请先调整相关配置。";
+    readonly assetPending: "请完成图片或编码内容配置，再预览或保存。";
+    readonly fieldsUnavailable: "当前模板尚无可绑定的数据字段。";
+};
 export declare type DesignerGuideMessages = {
     [K in keyof typeof DESIGNER_GUIDE_MESSAGES]: string;
 };
+export declare type DesignerInsertMessages = {
+    [K in keyof typeof DESIGNER_INSERT_MESSAGES]: string;
+};
 /** Optional wizard labels remain independent of the general designer configuration. */
 export declare const EXCEL_BINDING_MESSAGES: {
     recoveredMapping: string;
@@ -934,9 +970,10 @@ export declare const LABEL_STUDIO_MESSAGES: {
     readonly faces: "个版面";
     readonly labels: "张标签";
     readonly session: "当前会话模板";
-    readonly flow: "选择记录 → 设计标签 → 预览并打印";
+    readonly flow: "成品预览 · 按记录生成";
+    readonly designHint: "设计使用前 3 条样本 · 完整记录用于预览和打印";
     readonly guide: "使用指引";
-    readonly help: "在画布点选文字或码图，再设置绑定字段；在“模板”中调整纸张与份数。";
+    readonly help: "先选成品样式与显示字段即可使用。需要追加内容或自由排版时，进入设计标签。";
     readonly size: "纸张与份数";
     readonly bindings: "字段与码图";
     readonly count: "条记录";
@@ -946,18 +983,55 @@ export declare const LABEL_STUDIO_MESSAGES: {
     readonly printHint: "先试打一张，使用同规格纸张与 100% 比例核对尺寸和扫码。";
     readonly empty: "暂无可打印记录";
     readonly save: "保存标签模板";
+    readonly layout: "成品样式";
+    readonly materialPreset: "物料卡";
+    readonly pairedPreset: "双版标识";
+    readonly warehousePreset: "仓储标签";
+    readonly fields: "显示字段";
+    readonly findField: "查找业务字段";
+    readonly noFields: "没有匹配的字段";
+    readonly fieldLimit: "最多显示 5 个字段，取消已选项后可继续选择。";
+    readonly removeField: "取消字段";
+    readonly fieldSearchHint: "每次显示前 30 项，可搜索完整字段目录。";
+    readonly brand: "标题与品牌";
+    readonly brandName: "主标题";
+    readonly brandTagline: "副标题（可选）";
+    readonly applyLayout: "更新标签";
+    readonly restoreConfiguration: "还原轻配置";
+    readonly choosePreset: "请选择成品样式后更新标签，或还原轻配置继续使用当前模板。";
+    readonly discardTitle: "保留标签修改";
+    readonly discardDescription: "标签设计或轻配置存在未保存的修改，继续将丢弃这些修改。";
+    readonly keepEditing: "继续编辑";
+    readonly discard: "丢弃并继续";
+    readonly reflowHint: "按所选样式重新排版，可在设计中撤销恢复。";
+    readonly customTemplate: "自定义模板";
+    readonly readyTemplate: "成品模板 · 可直接打印";
 };
 /** Named business row interfaces and readonly arrays need no index signature or conversion. */
 declare type LabelReportRows = readonly object[];
+export declare interface LabelStudioBrand {
+    name?: string;
+    tagline?: string;
+    /** Portable image data shared by preview, PDF and image output. */
+    logoData?: string;
+}
 export declare interface LabelStudioController {
     readonly busy?: boolean;
+    readonly pendingLocalChanges?: boolean;
     guardChanges(): Promise<boolean>;
     prepare(): Promise<ReportTemplateDocument | undefined>;
 }
+export declare interface LabelStudioLayout {
+    preset?: LabelStudioPreset;
+    brand?: LabelStudioBrand;
+    fields?: readonly string[];
+}
 export declare type LabelStudioMessages = {
     [K in keyof typeof LABEL_STUDIO_MESSAGES]: string;
 };
-export declare interface LabelStudioOptions {
+export declare interface LabelStudioOptions extends LabelStudioLayout {
+    /** A host-owned completion action may replace the inner draft-save button. */
+    showSave?: boolean;
     rows: LabelReportRows;
     schema: DatasetContract;
     title?: string;
@@ -968,6 +1042,7 @@ export declare interface LabelStudioOptions {
     beforeDiscard?: TemplateEditorOptions["beforeDiscard"];
     messages?: Partial<LabelStudioMessages>;
 }
+export declare type LabelStudioPreset = "material" | "paired" | "warehouse";
 /** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
 declare type ListAlignment = NonNullable<ComponentStyle["align"]> | "auto";
 /** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
@@ -2534,6 +2609,14 @@ declare interface ReportCalculationMessages {
     calculationErrorDivision: string;
     calculationErrorOverflow: string;
     calculationErrorPrecision: string;
+    calculationSummary?: string;
+    calculationAdvanced?: string;
+    calculationClose?: string;
+    calculationPending?: string;
+    calculationSummarySum?: string;
+    calculationSummaryAverage?: string;
+    calculationSummaryCount?: string;
+    calculationMixedColumns?: string;
 }
 declare interface ReportCalculationMessages_2 {
     calculationTitle: string;
@@ -2563,6 +2646,14 @@ declare interface ReportCalculationMessages_2 {
     calculationErrorDivision: string;
     calculationErrorOverflow: string;
     calculationErrorPrecision: string;
+    calculationSummary?: string;
+    calculationAdvanced?: string;
+    calculationClose?: string;
+    calculationPending?: string;
+    calculationSummarySum?: string;
+    calculationSummaryAverage?: string;
+    calculationSummaryCount?: string;
+    calculationMixedColumns?: string;
 }
 declare interface ReportCandidateValidationOptions extends Pick<ReportDatasetValidationOptions, "rules" | "maxChecks" | "maxIssues"> {
     /** Warnings are visible and allowed by default; block explicitly when required by business policy. */
@@ -3193,11 +3284,14 @@ export declare const ReportLabelStudio: DefineComponent<LabelStudioOptions, {
     guardChanges: () => Promise<boolean>;
     prepare: () => Promise<ReportTemplateDocument_3 | undefined>;
     busy: boolean;
+    pendingLocalChanges: boolean;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     "update:modelValue": (document: ReportTemplateDocument_3) => any;
 }, string, MachReportVuePublicProps, Readonly<LabelStudioOptions> & Readonly<{
     "onUpdate:modelValue"?: ((document: ReportTemplateDocument_3) => any) | undefined;
-}>, {}>;
+}>, {
+    showSave: boolean;
+}>;
 declare interface ReportOutputOptions {
     /** warn preserves supported output and shows diagnostics; strict rejects known fidelity loss. */
     fidelity?: "warn" | "strict";
@@ -3562,6 +3656,11 @@ declare interface ReportTemplateDocument_3 {
 }
 export declare const ReportTemplateEditor: DefineComponent<TemplateEditorOptions, {
     openPanel: typeof openPanel;
+    applyTemplate: (template: ReportTemplate) => boolean;
+    undo: () => void;
+    redo: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
     canApply: boolean;
     saveReason: string;
     pendingLocalChanges: boolean;
@@ -3569,18 +3668,21 @@ export declare const ReportTemplateEditor: DefineComponent<TemplateEditorOptions
     blocked: boolean;
     guardChanges: (reason?: TemplateEditorBeforeDiscardContext["reason"], replacement?: ReportTemplateDocument) => Promise<boolean>;
     reset: () => Promise<void>;
-    save: () => Promise<void>;
+    save: typeof saveDocument;
     insertComponent: (component: TemplateComponent) => boolean;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     "update:modelValue": (document: ReportTemplateDocument) => any;
     saved: (document: ReportTemplateDocument) => any;
     "excel-bound": (result: ExcelBindingWizardApply) => any;
+    "update:mode": (mode: "preview" | "design") => any;
 }, string, MachReportVuePublicProps, Readonly<TemplateEditorOptions> & Readonly<{
     "onUpdate:modelValue"?: ((document: ReportTemplateDocument) => any) | undefined;
     onSaved?: ((document: ReportTemplateDocument) => any) | undefined;
     "onExcel-bound"?: ((result: ExcelBindingWizardApply) => any) | undefined;
+    "onUpdate:mode"?: ((mode: "preview" | "design") => any) | undefined;
 }>, {
     showSave: boolean;
+    showModeSwitch: boolean;
 }>;
 declare interface ReportTemplateFixture {
     name: string;
@@ -3909,6 +4011,7 @@ export declare interface RuleEditorOptions {
     readonly?: boolean;
     messages?: Partial<RuleEditorMessages>;
 }
+declare function saveDocument(): Promise<void>;
 /** 条件格式规则求值（声明式，见 ListColumn.rules） */
 declare interface StyleRule {
     when: ReportPredicate;
@@ -4445,6 +4548,11 @@ export declare interface TemplateEditorController {
     openPanel?(target: TemplateEditorPanel): void;
     /** Insert a native/registered component through validation, geometry constraints and undo history. */
     insertComponent(component: TemplateComponent): boolean;
+    applyTemplate?(template: ReportTemplate): boolean;
+    undo?(): void;
+    redo?(): void;
+    readonly canUndo?: boolean;
+    readonly canRedo?: boolean;
     readonly canApply?: boolean;
     readonly saveReason?: string;
     readonly pendingLocalChanges: boolean;
@@ -4459,6 +4567,11 @@ export declare type TemplateEditorMessages = typeof BASE_TEMPLATE_EDITOR_MESSAGE
 export declare interface TemplateEditorOptions extends TemplateEditorConflictOptions {
     /** Hide the duplicate save action when the host already provides an apply/save footer. */
     showSave?: boolean;
+    /** Host-controlled view for an editor embedded inside a studio. */
+    mode?: "design" | "preview";
+    showModeSwitch?: boolean;
+    capabilities?: Partial<Record<"params" | "excel" | "rules" | "review" | "advanced" | "outline" | "reuse", boolean>>;
+    insertionMessages?: Partial<DesignerInsertMessages>;
     guideMessages?: Partial<DesignerGuideMessages>;
     /** Opt-in declaration-only recovery. Scope should include project and account identity. */
     draftStorage?: TemplateDraftStorage;
@@ -4604,6 +4717,30 @@ export declare interface TemplateToolDraft {
     baseline: string;
     value: string;
 }
+export declare type TemplateTotalsMessages = typeof TOTALS_MESSAGES;
+declare const TOTALS_MESSAGES: {
+    title: string;
+    field: string;
+    operation: string;
+    position: string;
+    tableEnd: string;
+    groupEnd: string;
+    add: string;
+    remove: string;
+    sum: string;
+    avg: string;
+    count: string;
+    noFields: string;
+    scope: string;
+    groupScope: string;
+    saved: string;
+    empty: string;
+    advanced: string;
+    complex: string;
+    unconfigured: string;
+    configured: string;
+    update: string;
+};
 /** A serialized tree contract. Sibling and root order follow input order. */
 declare interface TreeTableOptions {
     input: "flat" | "nested";

package/dist/designer.d.ts

@@ -483,9 +483,45 @@ export declare const DESIGNER_GUIDE_MESSAGES: {
     readonly reviewHint: "校验字段依赖、样例结果与输出限制";
     readonly result: "预览确认效果后保存模板；高级 JSON 保留给需要时使用。";
 };
+declare const DESIGNER_INSERT_MESSAGES: {
+    readonly add: "添加内容";
+    readonly title: "添加到当前版面";
+    readonly text: "说明文字";
+    readonly textHint: "添加标题、备注或说明";
+    readonly field: "业务字段";
+    readonly columnField: "添加表格字段";
+    readonly fieldHint: "选择字段后立即显示真实内容";
+    readonly image: "图片或 Logo";
+    readonly imageHint: "使用 PNG 或 JPEG 图片";
+    readonly qrcode: "二维码";
+    readonly barcode: "条形码";
+    readonly codeHint: "绑定记录编号或填写编码内容";
+    readonly list: "明细表";
+    readonly listHint: "从当前字段契约建立表格";
+    readonly chart: "图表";
+    readonly recordCount: "记录数";
+    readonly chartHint: "选择分类与数值字段";
+    readonly rect: "装饰色块";
+    readonly rectHint: "辅助分区与突出信息";
+    readonly search: "搜索业务字段";
+    readonly noFields: "没有匹配的字段";
+    readonly close: "关闭添加内容";
+    readonly back: "返回内容类型";
+    readonly duplicate: "复制组件";
+    readonly newPage: "当前版面空间不足或含动态明细，内容已放到新增版面，可撤销恢复。";
+    readonly addColumn: "添加字段列";
+    readonly removeColumn: "删除当前列";
+    readonly removeLast: "至少保留一列";
+    readonly dependentColumn: "此字段仍被合计、规则或表头引用，请先调整相关配置。";
+    readonly assetPending: "请完成图片或编码内容配置，再预览或保存。";
+    readonly fieldsUnavailable: "当前模板尚无可绑定的数据字段。";
+};
 export declare type DesignerGuideMessages = {
     [K in keyof typeof DESIGNER_GUIDE_MESSAGES]: string;
 };
+export declare type DesignerInsertMessages = {
+    [K in keyof typeof DESIGNER_INSERT_MESSAGES]: string;
+};
 /** Optional wizard labels remain independent of the general designer configuration. */
 export declare const EXCEL_BINDING_MESSAGES: {
     recoveredMapping: string;
@@ -934,9 +970,10 @@ export declare const LABEL_STUDIO_MESSAGES: {
     readonly faces: "个版面";
     readonly labels: "张标签";
     readonly session: "当前会话模板";
-    readonly flow: "选择记录 → 设计标签 → 预览并打印";
+    readonly flow: "成品预览 · 按记录生成";
+    readonly designHint: "设计使用前 3 条样本 · 完整记录用于预览和打印";
     readonly guide: "使用指引";
-    readonly help: "在画布点选文字或码图，再设置绑定字段；在“模板”中调整纸张与份数。";
+    readonly help: "先选成品样式与显示字段即可使用。需要追加内容或自由排版时，进入设计标签。";
     readonly size: "纸张与份数";
     readonly bindings: "字段与码图";
     readonly count: "条记录";
@@ -946,18 +983,55 @@ export declare const LABEL_STUDIO_MESSAGES: {
     readonly printHint: "先试打一张，使用同规格纸张与 100% 比例核对尺寸和扫码。";
     readonly empty: "暂无可打印记录";
     readonly save: "保存标签模板";
+    readonly layout: "成品样式";
+    readonly materialPreset: "物料卡";
+    readonly pairedPreset: "双版标识";
+    readonly warehousePreset: "仓储标签";
+    readonly fields: "显示字段";
+    readonly findField: "查找业务字段";
+    readonly noFields: "没有匹配的字段";
+    readonly fieldLimit: "最多显示 5 个字段，取消已选项后可继续选择。";
+    readonly removeField: "取消字段";
+    readonly fieldSearchHint: "每次显示前 30 项，可搜索完整字段目录。";
+    readonly brand: "标题与品牌";
+    readonly brandName: "主标题";
+    readonly brandTagline: "副标题（可选）";
+    readonly applyLayout: "更新标签";
+    readonly restoreConfiguration: "还原轻配置";
+    readonly choosePreset: "请选择成品样式后更新标签，或还原轻配置继续使用当前模板。";
+    readonly discardTitle: "保留标签修改";
+    readonly discardDescription: "标签设计或轻配置存在未保存的修改，继续将丢弃这些修改。";
+    readonly keepEditing: "继续编辑";
+    readonly discard: "丢弃并继续";
+    readonly reflowHint: "按所选样式重新排版，可在设计中撤销恢复。";
+    readonly customTemplate: "自定义模板";
+    readonly readyTemplate: "成品模板 · 可直接打印";
 };
 /** Named business row interfaces and readonly arrays need no index signature or conversion. */
 declare type LabelReportRows = readonly object[];
+export declare interface LabelStudioBrand {
+    name?: string;
+    tagline?: string;
+    /** Portable image data shared by preview, PDF and image output. */
+    logoData?: string;
+}
 export declare interface LabelStudioController {
     readonly busy?: boolean;
+    readonly pendingLocalChanges?: boolean;
     guardChanges(): Promise<boolean>;
     prepare(): Promise<ReportTemplateDocument | undefined>;
 }
+export declare interface LabelStudioLayout {
+    preset?: LabelStudioPreset;
+    brand?: LabelStudioBrand;
+    fields?: readonly string[];
+}
 export declare type LabelStudioMessages = {
     [K in keyof typeof LABEL_STUDIO_MESSAGES]: string;
 };
-export declare interface LabelStudioOptions {
+export declare interface LabelStudioOptions extends LabelStudioLayout {
+    /** A host-owned completion action may replace the inner draft-save button. */
+    showSave?: boolean;
     rows: LabelReportRows;
     schema: DatasetContract;
     title?: string;
@@ -968,6 +1042,7 @@ export declare interface LabelStudioOptions {
     beforeDiscard?: TemplateEditorOptions["beforeDiscard"];
     messages?: Partial<LabelStudioMessages>;
 }
+export declare type LabelStudioPreset = "material" | "paired" | "warehouse";
 /** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
 declare type ListAlignment = NonNullable<ComponentStyle["align"]> | "auto";
 /** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
@@ -2534,6 +2609,14 @@ declare interface ReportCalculationMessages {
     calculationErrorDivision: string;
     calculationErrorOverflow: string;
     calculationErrorPrecision: string;
+    calculationSummary?: string;
+    calculationAdvanced?: string;
+    calculationClose?: string;
+    calculationPending?: string;
+    calculationSummarySum?: string;
+    calculationSummaryAverage?: string;
+    calculationSummaryCount?: string;
+    calculationMixedColumns?: string;
 }
 declare interface ReportCalculationMessages_2 {
     calculationTitle: string;
@@ -2563,6 +2646,14 @@ declare interface ReportCalculationMessages_2 {
     calculationErrorDivision: string;
     calculationErrorOverflow: string;
     calculationErrorPrecision: string;
+    calculationSummary?: string;
+    calculationAdvanced?: string;
+    calculationClose?: string;
+    calculationPending?: string;
+    calculationSummarySum?: string;
+    calculationSummaryAverage?: string;
+    calculationSummaryCount?: string;
+    calculationMixedColumns?: string;
 }
 declare interface ReportCandidateValidationOptions extends Pick<ReportDatasetValidationOptions, "rules" | "maxChecks" | "maxIssues"> {
     /** Warnings are visible and allowed by default; block explicitly when required by business policy. */
@@ -3193,11 +3284,14 @@ export declare const ReportLabelStudio: DefineComponent<LabelStudioOptions, {
     guardChanges: () => Promise<boolean>;
     prepare: () => Promise<ReportTemplateDocument_3 | undefined>;
     busy: boolean;
+    pendingLocalChanges: boolean;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     "update:modelValue": (document: ReportTemplateDocument_3) => any;
 }, string, MachReportVuePublicProps, Readonly<LabelStudioOptions> & Readonly<{
     "onUpdate:modelValue"?: ((document: ReportTemplateDocument_3) => any) | undefined;
-}>, {}>;
+}>, {
+    showSave: boolean;
+}>;
 declare interface ReportOutputOptions {
     /** warn preserves supported output and shows diagnostics; strict rejects known fidelity loss. */
     fidelity?: "warn" | "strict";
@@ -3562,6 +3656,11 @@ declare interface ReportTemplateDocument_3 {
 }
 export declare const ReportTemplateEditor: DefineComponent<TemplateEditorOptions, {
     openPanel: typeof openPanel;
+    applyTemplate: (template: ReportTemplate) => boolean;
+    undo: () => void;
+    redo: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
     canApply: boolean;
     saveReason: string;
     pendingLocalChanges: boolean;
@@ -3569,18 +3668,21 @@ export declare const ReportTemplateEditor: DefineComponent<TemplateEditorOptions
     blocked: boolean;
     guardChanges: (reason?: TemplateEditorBeforeDiscardContext["reason"], replacement?: ReportTemplateDocument) => Promise<boolean>;
     reset: () => Promise<void>;
-    save: () => Promise<void>;
+    save: typeof saveDocument;
     insertComponent: (component: TemplateComponent) => boolean;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     "update:modelValue": (document: ReportTemplateDocument) => any;
     saved: (document: ReportTemplateDocument) => any;
     "excel-bound": (result: ExcelBindingWizardApply) => any;
+    "update:mode": (mode: "preview" | "design") => any;
 }, string, MachReportVuePublicProps, Readonly<TemplateEditorOptions> & Readonly<{
     "onUpdate:modelValue"?: ((document: ReportTemplateDocument) => any) | undefined;
     onSaved?: ((document: ReportTemplateDocument) => any) | undefined;
     "onExcel-bound"?: ((result: ExcelBindingWizardApply) => any) | undefined;
+    "onUpdate:mode"?: ((mode: "preview" | "design") => any) | undefined;
 }>, {
     showSave: boolean;
+    showModeSwitch: boolean;
 }>;
 declare interface ReportTemplateFixture {
     name: string;
@@ -3909,6 +4011,7 @@ export declare interface RuleEditorOptions {
     readonly?: boolean;
     messages?: Partial<RuleEditorMessages>;
 }
+declare function saveDocument(): Promise<void>;
 /** 条件格式规则求值（声明式，见 ListColumn.rules） */
 declare interface StyleRule {
     when: ReportPredicate;
@@ -4445,6 +4548,11 @@ export declare interface TemplateEditorController {
     openPanel?(target: TemplateEditorPanel): void;
     /** Insert a native/registered component through validation, geometry constraints and undo history. */
     insertComponent(component: TemplateComponent): boolean;
+    applyTemplate?(template: ReportTemplate): boolean;
+    undo?(): void;
+    redo?(): void;
+    readonly canUndo?: boolean;
+    readonly canRedo?: boolean;
     readonly canApply?: boolean;
     readonly saveReason?: string;
     readonly pendingLocalChanges: boolean;
@@ -4459,6 +4567,11 @@ export declare type TemplateEditorMessages = typeof BASE_TEMPLATE_EDITOR_MESSAGE
 export declare interface TemplateEditorOptions extends TemplateEditorConflictOptions {
     /** Hide the duplicate save action when the host already provides an apply/save footer. */
     showSave?: boolean;
+    /** Host-controlled view for an editor embedded inside a studio. */
+    mode?: "design" | "preview";
+    showModeSwitch?: boolean;
+    capabilities?: Partial<Record<"params" | "excel" | "rules" | "review" | "advanced" | "outline" | "reuse", boolean>>;
+    insertionMessages?: Partial<DesignerInsertMessages>;
     guideMessages?: Partial<DesignerGuideMessages>;
     /** Opt-in declaration-only recovery. Scope should include project and account identity. */
     draftStorage?: TemplateDraftStorage;
@@ -4604,6 +4717,30 @@ export declare interface TemplateToolDraft {
     baseline: string;
     value: string;
 }
+export declare type TemplateTotalsMessages = typeof TOTALS_MESSAGES;
+declare const TOTALS_MESSAGES: {
+    title: string;
+    field: string;
+    operation: string;
+    position: string;
+    tableEnd: string;
+    groupEnd: string;
+    add: string;
+    remove: string;
+    sum: string;
+    avg: string;
+    count: string;
+    noFields: string;
+    scope: string;
+    groupScope: string;
+    saved: string;
+    empty: string;
+    advanced: string;
+    complex: string;
+    unconfigured: string;
+    configured: string;
+    update: string;
+};
 /** A serialized tree contract. Sibling and root order follow input order. */
 declare interface TreeTableOptions {
     input: "flat" | "nested";

package/dist/designer.js

@@ -1,5 +1,5 @@
 import "vue";
-import { C as e, d as s, e as t, f as T, E as _, g as A, L as R, P as r, h as M, R as l, D as i, i as o, j as G, c as L, k as p, l as P, m as n, a as I, b as m, n as D, T as d, o as O, p as C, q as B, r as u } from "./designer-fVvpYg8H.js";
+import { C as e, e as s, f as t, g as T, E as _, h as A, L as R, P as r, i as M, R as l, D as i, j as o, k as G, d as L, l as p, m as P, n, a as I, b as m, o as D, T as d, p as O, q as C, r as B, s as u } from "./designer-B52ddmHO.js";
 export {
   e as COLUMN_VISUAL_MESSAGES,
   s as ChartBindingInspector,

package/dist/{plugin-4VuL38Nc.cjs → plugin-BMsIIJDh.cjs}

@@ -1 +1 @@
-"use strict";var R=Object.create;var f=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var d=Object.getPrototypeOf,p=Object.prototype.hasOwnProperty;var m=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of P(e))!p.call(r,o)&&o!==t&&f(r,o,{get:()=>e[o],enumerable:!(n=u(e,o))||n.enumerable});return r};var E=(r,e,t)=>(t=r!=null?R(d(r)):{},m(e||!r||!r.__esModule?f(t,"default",{value:r,enumerable:!0}):t,r));const l=require("vue"),i=require("./injection-keys-Db_DyLkm.cjs"),h=require("./report-params-VTg8MoCp.cjs"),s=l.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-D7PvKzs3.cjs")).then(r=>r.ReportPreview$1)),v={install(r,e={}){let t=e.fetcher;if(!t&&e.reports){const n=e.reports;let o;t=async c=>(o??=import("@agile-team/mach-report").then(({createReportSource:a})=>a(n)),(await o)(c)),t.getParamDefs=c=>h.getReportParamDefs(n,c)}t&&r.provide(i.MACH_REPORT_FETCHER_KEY,t),e.pdfExporter&&r.provide(i.MACH_REPORT_PDF_EXPORTER_KEY,e.pdfExporter),r.provide(i.MACH_REPORT_CONFIG_KEY,l.computed(()=>{if(e.pdfFontUrl===void 0)return e.config??null;const n=e.config??{defaults:{},presets:{}};return{...n,defaults:{...n.defaults,pdfFontUrl:e.pdfFontUrl}}})),e.globalComponent!==!1&&!r.component("MachReportPreview")&&r.component("MachReportPreview",s)}};exports.MachReportPreview=s;exports.machReportPlugin=v;
+"use strict";var R=Object.create;var f=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var d=Object.getPrototypeOf,p=Object.prototype.hasOwnProperty;var m=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of P(e))!p.call(r,o)&&o!==t&&f(r,o,{get:()=>e[o],enumerable:!(n=u(e,o))||n.enumerable});return r};var E=(r,e,t)=>(t=r!=null?R(d(r)):{},m(e||!r||!r.__esModule?f(t,"default",{value:r,enumerable:!0}):t,r));const l=require("vue"),i=require("./injection-keys-Db_DyLkm.cjs"),h=require("./report-params-VTg8MoCp.cjs"),s=l.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-hlwvZ1wf.cjs")).then(r=>r.ReportPreview$1)),v={install(r,e={}){let t=e.fetcher;if(!t&&e.reports){const n=e.reports;let o;t=async c=>(o??=import("@agile-team/mach-report").then(({createReportSource:a})=>a(n)),(await o)(c)),t.getParamDefs=c=>h.getReportParamDefs(n,c)}t&&r.provide(i.MACH_REPORT_FETCHER_KEY,t),e.pdfExporter&&r.provide(i.MACH_REPORT_PDF_EXPORTER_KEY,e.pdfExporter),r.provide(i.MACH_REPORT_CONFIG_KEY,l.computed(()=>{if(e.pdfFontUrl===void 0)return e.config??null;const n=e.config??{defaults:{},presets:{}};return{...n,defaults:{...n.defaults,pdfFontUrl:e.pdfFontUrl}}})),e.globalComponent!==!1&&!r.component("MachReportPreview")&&r.component("MachReportPreview",s)}};exports.MachReportPreview=s;exports.machReportPlugin=v;

package/dist/{plugin-YWHcI3t4.js → plugin-Co1oKD7T.js}

@@ -1,7 +1,7 @@
 import { defineAsyncComponent as c, computed as m } from "vue";
 import { b as i, c as l, a as d } from "./injection-keys-e85udZCp.js";
 import { g as s } from "./report-params-D9tBuM9B.js";
-const p = c(() => import("./ReportPreview-BUr8GQUW.js").then((r) => r.v)), _ = {
+const p = c(() => import("./ReportPreview-CGcxwkAn.js").then((r) => r.v)), _ = {
   install(r, e = {}) {
     let t = e.fetcher;
     if (!t && e.reports) {

package/dist/sbom.cdx.json

@@ -6,7 +6,7 @@
     "component": {
       "type": "library",
       "name": "@agile-team/mach-report",
-      "version": "2.19.0"
+      "version": "2.20.0"
     },
     "properties": [
       {