@agile-team/mach-report 2.1.0 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.md +130 -16
  2. package/dist/ReportPreview-CLENbOCL.cjs +6 -0
  3. package/dist/ReportPreview-CwTGfyTq.js +1679 -0
  4. package/dist/grid-geometry-CWmJ9c9y.js +130 -0
  5. package/dist/grid-geometry-DBH9ExuY.cjs +1 -0
  6. package/dist/index.cjs +5 -5
  7. package/dist/index.d.cts +110 -16
  8. package/dist/index.d.ts +110 -16
  9. package/dist/index.js +1099 -718
  10. package/dist/page-window-index-CIuT4BAv.js +43 -0
  11. package/dist/page-window-index-DEjnM6IB.cjs +1 -0
  12. package/dist/pdf.cjs +46 -46
  13. package/dist/pdf.d.cts +20 -0
  14. package/dist/pdf.d.ts +20 -0
  15. package/dist/pdf.js +6 -6
  16. package/dist/{plugin-Bl00j_CP.cjs → plugin-MSh_OhoW.cjs} +1 -1
  17. package/dist/{plugin-DVScnZ4C.js → plugin-uoO9VA6O.js} +2 -2
  18. package/dist/report-params-B3Fia6JO.js +10 -0
  19. package/dist/report-params-D1gZ1DME.cjs +1 -0
  20. package/dist/style.css +1 -1
  21. package/dist/textwrap-BQyrpYSR.js +117 -0
  22. package/dist/textwrap-DqiFwAV3.cjs +3 -0
  23. package/dist/vue/async.d.cts +77 -2
  24. package/dist/vue/async.d.ts +77 -2
  25. package/dist/vue/index.d.cts +91 -14
  26. package/dist/vue/index.d.ts +91 -14
  27. package/dist/vue-async.cjs +1 -1
  28. package/dist/vue-async.js +3 -3
  29. package/dist/vue.cjs +1 -1
  30. package/dist/vue.js +4 -4
  31. package/dist/xlsx.cjs +21 -21
  32. package/dist/xlsx.d.cts +28 -2
  33. package/dist/xlsx.d.ts +28 -2
  34. package/dist/xlsx.js +5637 -5515
  35. package/package.json +3 -2
  36. package/dist/ReportPreview-Dwdsyk9b.js +0 -1558
  37. package/dist/ReportPreview-VHAIfsz1.cjs +0 -6
  38. package/dist/grid-geometry-BXpOxznT.cjs +0 -1
  39. package/dist/grid-geometry-Bs8QXz1X.js +0 -65
  40. package/dist/report-params-BB85g7mg.js +0 -10
  41. package/dist/report-params-D1NeY-eR.cjs +0 -1
  42. package/dist/style-CFZ-HE2s.cjs +0 -3
  43. package/dist/style-DnmtG7Gl.js +0 -180
package/dist/xlsx.d.cts CHANGED
@@ -786,6 +786,10 @@ declare interface GradientStop {
786
786
  declare interface GridCell {
787
787
  text?: string;
788
788
  rawText?: string;
789
+ /** 原始值,仅供 Excel raw 模式消费;不参与预览、分页与 PDF 绘制。 */
790
+ value?: string | number | boolean | null;
791
+ /** Excel 数字格式(例如 #,##0.00 / 0.00%),不改变 text。 */
792
+ numberFormat?: string;
789
793
  children?: PlanComponent[];
790
794
  colSpan?: number;
791
795
  rowSpan?: number;
@@ -1089,6 +1093,7 @@ declare interface PlanComponent {
1089
1093
  richParagraphs?: RichParagraph[];
1090
1094
  imageData?: string;
1091
1095
  grid?: PlanGrid;
1096
+ table?: PlanTableFragment;
1092
1097
  style?: ComponentStyle;
1093
1098
  meta?: Record<string, unknown>;
1094
1099
  /** MachReport 扩展字段:未知 kind 的兜底渲染标记 */
@@ -1104,6 +1109,8 @@ declare interface PlanGrid {
1104
1109
  }
1105
1110
 
1106
1111
  declare interface PlanPage {
1112
+ /** wide 表示完整自然列宽;页面仅为预览的垂直窗口分段。 */
1113
+ layout?: "page" | "wide";
1107
1114
  pageWidthMm: number;
1108
1115
  pageHeightMm: number;
1109
1116
  marginTopMm?: number;
@@ -1113,6 +1120,19 @@ declare interface PlanPage {
1113
1120
  components: PlanComponent[];
1114
1121
  }
1115
1122
 
1123
+ /** 列表的逻辑行来源;用于连续 Excel 重组,避免按文本猜测重复表头。 */
1124
+ declare interface PlanTableFragment {
1125
+ /** 在整个计划中唯一的逻辑表身份;同一表的分页片段共享身份。 */
1126
+ id: string;
1127
+ /** 表头固定 -1;其余行(包括组头/小计/总计)从 0 连续递增。 */
1128
+ rowIndex: number;
1129
+ role: "header" | "body" | "group-header" | "subtotal" | "grand-total";
1130
+ /** 按物理列顺序保存字段身份;不以表头显示文本判断列结构。 */
1131
+ columnKeys: string[];
1132
+ layout?: "page" | "wide";
1133
+ title?: string;
1134
+ }
1135
+
1116
1136
  declare interface Protection {
1117
1137
  locked: boolean;
1118
1138
  hidden: boolean;
@@ -2272,8 +2292,14 @@ declare interface XlsxReadOptions {
2272
2292
  * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
2273
2293
  */
2274
2294
  export declare interface XlsxRenderOptions {
2275
- /** 工作表命名(默认 "Sheet1" 起序) */
2276
- sheetName?: (pageIndex: number) => string;
2295
+ /** 工作表命名(连续表默认使用标题,其余默认 "Sheet1" 起序)。 */
2296
+ sheetName?: (sheetIndex: number) => string;
2297
+ /** auto 默认将 wide 逻辑表合并为连续 Sheet;pages 保留逐页;continuous 要求明确的表来源。 */
2298
+ sheetMode?: "auto" | "pages" | "continuous";
2299
+ /** 宽表或连续表默认 raw,其余默认 text;显式配置可覆盖默认值。 */
2300
+ valueMode?: "text" | "raw";
2301
+ /** 连续表默认不限制打印纸型;显式 A3/A4/A5 仅设置打印适配,不改变 Excel 列宽。 */
2302
+ paperSize?: "auto" | "a3" | "a4" | "a5";
2277
2303
  }
2278
2304
 
2279
2305
  export declare interface XlsxRenderResult {
package/dist/xlsx.d.ts CHANGED
@@ -786,6 +786,10 @@ declare interface GradientStop {
786
786
  declare interface GridCell {
787
787
  text?: string;
788
788
  rawText?: string;
789
+ /** 原始值,仅供 Excel raw 模式消费;不参与预览、分页与 PDF 绘制。 */
790
+ value?: string | number | boolean | null;
791
+ /** Excel 数字格式(例如 #,##0.00 / 0.00%),不改变 text。 */
792
+ numberFormat?: string;
789
793
  children?: PlanComponent[];
790
794
  colSpan?: number;
791
795
  rowSpan?: number;
@@ -1089,6 +1093,7 @@ declare interface PlanComponent {
1089
1093
  richParagraphs?: RichParagraph[];
1090
1094
  imageData?: string;
1091
1095
  grid?: PlanGrid;
1096
+ table?: PlanTableFragment;
1092
1097
  style?: ComponentStyle;
1093
1098
  meta?: Record<string, unknown>;
1094
1099
  /** MachReport 扩展字段:未知 kind 的兜底渲染标记 */
@@ -1104,6 +1109,8 @@ declare interface PlanGrid {
1104
1109
  }
1105
1110
 
1106
1111
  declare interface PlanPage {
1112
+ /** wide 表示完整自然列宽;页面仅为预览的垂直窗口分段。 */
1113
+ layout?: "page" | "wide";
1107
1114
  pageWidthMm: number;
1108
1115
  pageHeightMm: number;
1109
1116
  marginTopMm?: number;
@@ -1113,6 +1120,19 @@ declare interface PlanPage {
1113
1120
  components: PlanComponent[];
1114
1121
  }
1115
1122
 
1123
+ /** 列表的逻辑行来源;用于连续 Excel 重组,避免按文本猜测重复表头。 */
1124
+ declare interface PlanTableFragment {
1125
+ /** 在整个计划中唯一的逻辑表身份;同一表的分页片段共享身份。 */
1126
+ id: string;
1127
+ /** 表头固定 -1;其余行(包括组头/小计/总计)从 0 连续递增。 */
1128
+ rowIndex: number;
1129
+ role: "header" | "body" | "group-header" | "subtotal" | "grand-total";
1130
+ /** 按物理列顺序保存字段身份;不以表头显示文本判断列结构。 */
1131
+ columnKeys: string[];
1132
+ layout?: "page" | "wide";
1133
+ title?: string;
1134
+ }
1135
+
1116
1136
  declare interface Protection {
1117
1137
  locked: boolean;
1118
1138
  hidden: boolean;
@@ -2272,8 +2292,14 @@ declare interface XlsxReadOptions {
2272
2292
  * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
2273
2293
  */
2274
2294
  export declare interface XlsxRenderOptions {
2275
- /** 工作表命名(默认 "Sheet1" 起序) */
2276
- sheetName?: (pageIndex: number) => string;
2295
+ /** 工作表命名(连续表默认使用标题,其余默认 "Sheet1" 起序)。 */
2296
+ sheetName?: (sheetIndex: number) => string;
2297
+ /** auto 默认将 wide 逻辑表合并为连续 Sheet;pages 保留逐页;continuous 要求明确的表来源。 */
2298
+ sheetMode?: "auto" | "pages" | "continuous";
2299
+ /** 宽表或连续表默认 raw,其余默认 text;显式配置可覆盖默认值。 */
2300
+ valueMode?: "text" | "raw";
2301
+ /** 连续表默认不限制打印纸型;显式 A3/A4/A5 仅设置打印适配,不改变 Excel 列宽。 */
2302
+ paperSize?: "auto" | "a3" | "a4" | "a5";
2277
2303
  }
2278
2304
 
2279
2305
  export declare interface XlsxRenderResult {