@agile-team/mach-report 0.7.0 → 0.9.0

package/dist/layout/paginate.d.ts

@@ -1,11 +1,36 @@
 import { ComponentStyle, PlanComponent, RenderPlan } from '../schema/render-plan';
-import { measureTextMm, wrapText, TextMeasurer } from './textwrap';
+import { TextMeasurer } from './textwrap';
+import { ColumnFormat, StyleRule } from '../format';
 export interface ListColumn {
     header: string;
     field: string;
     widthMm: number;
     style?: ComponentStyle;
+    /** 值格式化（声明式）：千分位/小数位、百分比、日期 pattern */
+    format?: ColumnFormat;
+    /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
+    rules?: StyleRule[];
 }
+/** 分组小计配置（声明式，见 ListComponent.groupBy） */
+export interface ListGroupBy {
+    /** 分组字段（值变化即切组） */
+    field: string;
+    /** 组头文案模板，{value} 占位（默认 "{value}"） */
+    headerTemplate?: string;
+    headerStyle?: ComponentStyle;
+    /** 需要小计的列字段（组尾输出合计行；数值列求和，其余输出首值/留空） */
+    subtotal?: string[];
+    subtotalStyle?: ComponentStyle;
+    subtotalLabel?: string;
+    /** 组头防孤行（默认 true：页尾放不下"组头+首行"时整体换页） */
+    keepWithNext?: boolean;
+}
+export type ListGrandTotal = boolean | {
+    label?: string;
+    style?: ComponentStyle;
+    /** 合计列（缺省沿用 groupBy.subtotal） */
+    fields?: string[];
+};
 export interface ListComponent {
     kind: "list";
     id?: string;
@@ -21,6 +46,10 @@ export interface ListComponent {
     headerEveryPage?: boolean;
     headerBackgroundColor?: string;
     border?: boolean;
+    /** 分组小计（组头/组尾小计/组头防孤行） */
+    groupBy?: ListGroupBy;
+    /** 末尾总合计行（依赖 groupBy.subtotal 或显式 fields） */
+    grandTotal?: ListGrandTotal;
 }
 export type TemplateComponent = PlanComponent | ListComponent;
 export interface TemplatePage {
@@ -48,4 +77,3 @@ export interface PaginateResult {
     warnings: string[];
 }
 export declare function paginateTemplate(template: ReportTemplate, datasets: DatasetRows, optionsOrMmPerRow?: number | PaginateOptions): PaginateResult;
-export { measureTextMm, wrapText };