@canvas-components/list-table 0.3.38 → 0.3.39

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 (6) hide show
  1. package/README.md +1 -1
  2. package/dist/index.cjs +826 -131
  3. package/dist/index.d.cts +21 -4
  4. package/dist/index.d.ts +21 -4
  5. package/dist/index.js +827 -132
  6. package/package.json +5 -5
package/dist/index.d.cts CHANGED
@@ -190,7 +190,7 @@ interface Rect {
190
190
  * 命中结果。
191
191
  */
192
192
  interface DebugHitTestResult {
193
- area: "header" | "grouping-bar" | "grouping-tag" | "grouping-remove" | "body" | "body-content" | "body-control" | "expand-trigger" | "collapse-trigger" | "column-collapse-trigger" | "expanded-row" | "header-selection" | "sort-trigger" | "filter-trigger" | "fixed-trigger" | "resize-handle" | "horizontal-scrollbar" | "vertical-scrollbar" | "summary" | "summary" | "empty";
193
+ area: "header" | "grouping-bar" | "grouping-tag" | "grouping-remove" | "group-toggle" | "body" | "body-content" | "body-control" | "expand-trigger" | "collapse-trigger" | "column-collapse-trigger" | "expanded-row" | "header-selection" | "sort-trigger" | "filter-trigger" | "fixed-trigger" | "resize-handle" | "horizontal-scrollbar" | "vertical-scrollbar" | "summary" | "summary" | "empty";
194
194
  scrollbarRole?: "thumb" | "track" | "decrease-button" | "increase-button";
195
195
  columnKey?: string;
196
196
  rowIndex?: number;
@@ -206,6 +206,8 @@ interface DebugHitTestResult {
206
206
  resizeEdge?: "left" | "right";
207
207
  cursor?: string;
208
208
  rect?: Rect;
209
+ /** 错误提示所属单元格的矩形，独立于内容命中区域。 */
210
+ tooltipRect?: Rect;
209
211
  tooltipText?: string;
210
212
  tooltipVariant?: "default" | "error";
211
213
  textSelectionText?: string;
@@ -230,7 +232,7 @@ type HeaderActionType = "sort" | "filter" | "fixed";
230
232
  * 渲染矩形描述。
231
233
  */
232
234
  interface RenderCellDescriptor {
233
- kind: "header" | "grouping-bar" | "grouping-tag" | "grouping-remove" | "body" | "body-content" | "body-control" | "expand-trigger" | "collapse-trigger" | "column-collapse-trigger" | "expanded-row" | "header-selection" | "header-action" | "resize-handle" | "horizontal-scrollbar" | "vertical-scrollbar" | "summary";
235
+ kind: "header" | "grouping-bar" | "grouping-tag" | "grouping-remove" | "group-toggle" | "body" | "body-content" | "body-control" | "expand-trigger" | "collapse-trigger" | "column-collapse-trigger" | "expanded-row" | "header-selection" | "header-action" | "resize-handle" | "horizontal-scrollbar" | "vertical-scrollbar" | "summary";
234
236
  rect: Rect;
235
237
  columnKey?: string;
236
238
  rowIndex?: number;
@@ -1358,6 +1360,13 @@ interface ListTableTooltipRequest {
1358
1360
  y: number;
1359
1361
  content: string;
1360
1362
  variant?: "default" | "error" | "resize";
1363
+ /** 视口坐标中的目标矩形；提供后 tooltip 围绕该区域自动选位。 */
1364
+ anchorRect?: {
1365
+ x: number;
1366
+ y: number;
1367
+ width: number;
1368
+ height: number;
1369
+ };
1361
1370
  /**
1362
1371
  * 表格内容缩放（1 = 100%），用于 tooltip 与画布视觉同步。
1363
1372
  */
@@ -1433,7 +1442,13 @@ interface HeaderContextMenuConfig {
1433
1442
  /** 自定义右键菜单项，支持多级菜单。 */
1434
1443
  customItems?: ListTableContextMenuItem[];
1435
1444
  /** 按当前表格显示顺序读取打印数据。 */
1436
- onGetPrintData?: () => Promise<{
1445
+ onGetPrintData?: (options?: {
1446
+ signal?: AbortSignal;
1447
+ onProgress?: (completed: number, total: number) => void;
1448
+ /** 设计器仅获取首屏样本；未传时读取全部行。 */
1449
+ rowLimit?: number;
1450
+ includeSummary?: boolean;
1451
+ }) => Promise<{
1437
1452
  columns: Array<{
1438
1453
  key: string;
1439
1454
  title: string;
@@ -1657,6 +1672,8 @@ interface ListTableEditorTheme {
1657
1672
  fontFamily: string;
1658
1673
  textColor: string;
1659
1674
  cellColor?: string;
1675
+ /** 编辑单元格的水平对齐方式。 */
1676
+ textAlign?: CanvasTextAlign;
1660
1677
  /**
1661
1678
  * 单元格水平内边距（已含缩放），用于编辑表单与画布内容对齐。
1662
1679
  */
@@ -1685,7 +1702,7 @@ interface ListTableEditorCommitOptions {
1685
1702
  }
1686
1703
  interface ListTableTooltipAdapter {
1687
1704
  mount(parent?: HTMLElement): void;
1688
- show(x: number, y: number, content: string, variant?: ListTableTooltipRequest["variant"]): void;
1705
+ show(x: number, y: number, content: string, variant?: ListTableTooltipRequest["variant"], anchorRect?: ListTableTooltipRequest["anchorRect"]): void;
1689
1706
  hide(): void;
1690
1707
  destroy(): void;
1691
1708
  }
package/dist/index.d.ts CHANGED
@@ -190,7 +190,7 @@ interface Rect {
190
190
  * 命中结果。
191
191
  */
192
192
  interface DebugHitTestResult {
193
- area: "header" | "grouping-bar" | "grouping-tag" | "grouping-remove" | "body" | "body-content" | "body-control" | "expand-trigger" | "collapse-trigger" | "column-collapse-trigger" | "expanded-row" | "header-selection" | "sort-trigger" | "filter-trigger" | "fixed-trigger" | "resize-handle" | "horizontal-scrollbar" | "vertical-scrollbar" | "summary" | "summary" | "empty";
193
+ area: "header" | "grouping-bar" | "grouping-tag" | "grouping-remove" | "group-toggle" | "body" | "body-content" | "body-control" | "expand-trigger" | "collapse-trigger" | "column-collapse-trigger" | "expanded-row" | "header-selection" | "sort-trigger" | "filter-trigger" | "fixed-trigger" | "resize-handle" | "horizontal-scrollbar" | "vertical-scrollbar" | "summary" | "summary" | "empty";
194
194
  scrollbarRole?: "thumb" | "track" | "decrease-button" | "increase-button";
195
195
  columnKey?: string;
196
196
  rowIndex?: number;
@@ -206,6 +206,8 @@ interface DebugHitTestResult {
206
206
  resizeEdge?: "left" | "right";
207
207
  cursor?: string;
208
208
  rect?: Rect;
209
+ /** 错误提示所属单元格的矩形，独立于内容命中区域。 */
210
+ tooltipRect?: Rect;
209
211
  tooltipText?: string;
210
212
  tooltipVariant?: "default" | "error";
211
213
  textSelectionText?: string;
@@ -230,7 +232,7 @@ type HeaderActionType = "sort" | "filter" | "fixed";
230
232
  * 渲染矩形描述。
231
233
  */
232
234
  interface RenderCellDescriptor {
233
- kind: "header" | "grouping-bar" | "grouping-tag" | "grouping-remove" | "body" | "body-content" | "body-control" | "expand-trigger" | "collapse-trigger" | "column-collapse-trigger" | "expanded-row" | "header-selection" | "header-action" | "resize-handle" | "horizontal-scrollbar" | "vertical-scrollbar" | "summary";
235
+ kind: "header" | "grouping-bar" | "grouping-tag" | "grouping-remove" | "group-toggle" | "body" | "body-content" | "body-control" | "expand-trigger" | "collapse-trigger" | "column-collapse-trigger" | "expanded-row" | "header-selection" | "header-action" | "resize-handle" | "horizontal-scrollbar" | "vertical-scrollbar" | "summary";
234
236
  rect: Rect;
235
237
  columnKey?: string;
236
238
  rowIndex?: number;
@@ -1358,6 +1360,13 @@ interface ListTableTooltipRequest {
1358
1360
  y: number;
1359
1361
  content: string;
1360
1362
  variant?: "default" | "error" | "resize";
1363
+ /** 视口坐标中的目标矩形；提供后 tooltip 围绕该区域自动选位。 */
1364
+ anchorRect?: {
1365
+ x: number;
1366
+ y: number;
1367
+ width: number;
1368
+ height: number;
1369
+ };
1361
1370
  /**
1362
1371
  * 表格内容缩放（1 = 100%），用于 tooltip 与画布视觉同步。
1363
1372
  */
@@ -1433,7 +1442,13 @@ interface HeaderContextMenuConfig {
1433
1442
  /** 自定义右键菜单项，支持多级菜单。 */
1434
1443
  customItems?: ListTableContextMenuItem[];
1435
1444
  /** 按当前表格显示顺序读取打印数据。 */
1436
- onGetPrintData?: () => Promise<{
1445
+ onGetPrintData?: (options?: {
1446
+ signal?: AbortSignal;
1447
+ onProgress?: (completed: number, total: number) => void;
1448
+ /** 设计器仅获取首屏样本；未传时读取全部行。 */
1449
+ rowLimit?: number;
1450
+ includeSummary?: boolean;
1451
+ }) => Promise<{
1437
1452
  columns: Array<{
1438
1453
  key: string;
1439
1454
  title: string;
@@ -1657,6 +1672,8 @@ interface ListTableEditorTheme {
1657
1672
  fontFamily: string;
1658
1673
  textColor: string;
1659
1674
  cellColor?: string;
1675
+ /** 编辑单元格的水平对齐方式。 */
1676
+ textAlign?: CanvasTextAlign;
1660
1677
  /**
1661
1678
  * 单元格水平内边距（已含缩放），用于编辑表单与画布内容对齐。
1662
1679
  */
@@ -1685,7 +1702,7 @@ interface ListTableEditorCommitOptions {
1685
1702
  }
1686
1703
  interface ListTableTooltipAdapter {
1687
1704
  mount(parent?: HTMLElement): void;
1688
- show(x: number, y: number, content: string, variant?: ListTableTooltipRequest["variant"]): void;
1705
+ show(x: number, y: number, content: string, variant?: ListTableTooltipRequest["variant"], anchorRect?: ListTableTooltipRequest["anchorRect"]): void;
1689
1706
  hide(): void;
1690
1707
  destroy(): void;
1691
1708
  }