@canvas-components/print-design-plugin 0.0.0-stage → 0.1.4

package/dist/model-BwhSanYM.d.ts

@@ -0,0 +1,1080 @@
+import { PrintDesignElement, PrintDesignComponentRenderer, PrintDesignElementBase, PrintDesignCropRect, PrintDesignPluginRenderer, PrintDesignComponentCellSelectionState, PrintDesignUnit } from '@canvas-components/print-design';
+import { BarcodeFormat } from '@canvas-components/barcode';
+import { QrCodeLevel, QrCodeFormat, QrCodeMode, QrCodeContentTemplate, QrCodeContentFields } from '@canvas-components/qrcode';
+
+/** 单个组件插件的原生部分。 */
+interface PrintDesignNativePlugin {
+    id: string;
+    /** 单个组件插件的语义版本；修改此插件时单独升级。 */
+    version: string;
+    type: PrintDesignElement["type"];
+    renderer: PrintDesignComponentRenderer;
+    /** 运行前必须安装的组件插件及最低版本。 */
+    dependencies?: readonly {
+        id: string;
+        minVersion: string;
+    }[];
+}
+/** 使用插件目录提供的原生绘制与交互实现建立注册项。 */
+declare function defineNativePlugin(type: PrintDesignElement["type"], version: string, renderer: PrintDesignComponentRenderer, dependencies?: readonly {
+    id: string;
+    minVersion: string;
+}[]): PrintDesignNativePlugin;
+declare function defineNativePlugin<Type extends PrintDesignElement["type"], Element extends PrintDesignElementBase & {
+    type: Type;
+}, Crop extends PrintDesignCropRect = PrintDesignCropRect>(type: Type, version: string, renderer: PrintDesignPluginRenderer<Element, Crop>, dependencies?: readonly {
+    id: string;
+    minVersion: string;
+}[]): PrintDesignNativePlugin;
+/** 装配原生组件前校验插件间的声明式依赖。 */
+declare function assertNativePluginDependencies(plugins: readonly PrintDesignNativePlugin[]): void;
+
+/** 图片裁剪范围以原图宽高的比例保存。 */
+interface ImageCrop {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    sourceWidth?: number;
+    sourceHeight?: number;
+}
+/** 图片插件持有的元素配置；核心仅负责通用元素字段。 */
+interface ImageElement extends PrintDesignElementBase {
+    type: "image";
+    src: string;
+    fit?: "contain" | "cover" | "fill";
+    crop?: ImageCrop;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        image: ImageElement;
+    }
+}
+
+/** 列表组件的独立模板配置。 */
+interface ListElement extends PrintDesignElementBase {
+    type: "list";
+    listStyle: "ordered" | "unordered" | "radio" | "checkbox";
+    items: {
+        text: string;
+        checked?: boolean;
+    }[];
+    fontSize?: number;
+    color?: string;
+    rowHeight?: number;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        list: ListElement;
+    }
+}
+
+/** 连接点可选边中点或多边形顶点。 */
+interface ConnectorEndpoint {
+    elementId?: string;
+    anchor?: "auto" | "top" | "right" | "bottom" | "left" | "top-left" | "top-right" | "bottom-right" | "bottom-left" | `edge:${number}` | `vertex:${number}`;
+}
+/** 连接线插件自己的可序列化配置。 */
+interface ConnectorElement extends PrintDesignElementBase {
+    type: "connector";
+    lineType?: "straight" | "curve" | "polyline";
+    polylinePoints?: Array<{
+        x: number;
+        y: number;
+    }>;
+    start?: ConnectorEndpoint;
+    end?: ConnectorEndpoint;
+    stroke?: string;
+    strokeWidth?: number;
+    arrowSize?: number;
+    showStartArrow?: boolean;
+    showEndArrow?: boolean;
+    text?: string;
+    fontSize?: number;
+    textColor?: string;
+    textPosition?: number;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        connector: ConnectorElement;
+    }
+}
+
+/** 表格插件自己的行列选区，核心只保存 elementId 和其余不透明数据。 */
+type TableCellSelectionState = PrintDesignComponentCellSelectionState & {
+    area: "header" | "body" | "summary";
+    selectorKind?: "row" | "column" | "all";
+    startRow: number;
+    endRow: number;
+    startColumn: number;
+    endColumn: number;
+    sourceRowOffset?: number;
+    sourceColumnOffset?: number;
+};
+/** 打印表格列配置，保留常用显示、汇总与编辑字段。 */
+interface TableBorder {
+    style?: "none" | "solid" | "dashed" | "dotted";
+    width?: number;
+    color?: string;
+    mode?: "show" | "hide" | "binding" | "preprint";
+    path?: string;
+}
+/** all 设定默认线条；inner 设定所属区域的内部网格线；四边配置设定区域外边。 */
+type TableBorders = Partial<Record<"all" | "inner" | "top" | "right" | "bottom" | "left", TableBorder>>;
+/** 打印表格列配置，保留常用显示、汇总与编辑字段。 */
+interface TableColumn {
+    key?: string;
+    title?: string | number | {
+        type: string;
+        text?: string;
+        alt?: string;
+    } | Array<{
+        type: string;
+        text?: string;
+        alt?: string;
+    }>;
+    dataIndex?: string | number | Array<string | number>;
+    children?: TableColumn[];
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    align?: "left" | "center" | "right";
+    headerAlign?: "left" | "center" | "right";
+    hidden?: boolean;
+    /** 表体文字方向；只作用于文字绘制。 */
+    textDirection?: "horizontal" | "vertical";
+    /** 按原始记录的值依次匹配；首条命中规则覆盖当前列单元格外观。 */
+    conditionalFormats?: TableConditionalFormat[];
+    borders?: TableBorders;
+    ellipsis?: boolean;
+    /** 列级文本溢出方式；优先于旧版 ellipsis 和表格默认值。 */
+    cellOverflow?: "nowrap" | "wrap" | "ellipsis" | "shrink";
+    /** 单元格四边内边距，单位为 96 DPI 逻辑像素。 */
+    cellPadding?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    cellType?: string;
+    cellStyle?: {
+        textAlign?: "left" | "center" | "right";
+        verticalAlign?: "top" | "middle" | "bottom";
+        backgroundColor?: string;
+        color?: string;
+        fontSize?: number;
+        fontFamily?: string;
+        fontWeight?: "normal" | "bold";
+    };
+    headerStyle?: {
+        backgroundColor?: string;
+        color?: string;
+        fontSize?: number;
+        fontFamily?: string;
+        fontWeight?: "normal" | "bold";
+    };
+    summaryStyle?: {
+        backgroundColor?: string;
+        color?: string;
+        fontSize?: number;
+        fontFamily?: string;
+        fontWeight?: "normal" | "bold";
+    };
+    /** 无需函数即可保存到模板的数字与日期格式。 */
+    valueFormat?: {
+        type: "number" | "percent" | "date" | "dateTime" | "time";
+        decimalPlaces?: number;
+        thousandsSeparator?: boolean;
+        /** 百分比默认把 0.25 显示为 25%，设为 false 时直接附加百分号。 */
+        percentIsFraction?: boolean;
+        /** 日期时间格式使用明确的固定模式，避免运行环境区域设置影响打印。 */
+        datePattern?: "YYYY-MM-DD" | "YYYY/MM/DD" | "YYYY-MM-DD HH:mm" | "YYYY-MM-DD HH:mm:ss" | "HH:mm" | "HH:mm:ss";
+    };
+    summary?: boolean | {
+        type?: string;
+        precision?: number;
+        /** 汇总值的小数取整方式。 */
+        roundingMode?: "round" | "floor" | "ceil" | "truncate";
+        showTypePrefix?: boolean;
+        preserveTrailingZeros?: boolean;
+        valueGetter?: (record: Record<string, unknown>) => string | number | null | undefined;
+        formatter?: (value: string | number, records: Record<string, unknown>[], column: TableColumn) => string;
+    };
+    summaryTitle?: string;
+    moneyFormat?: {
+        symbol?: string;
+        thousandsSeparator?: boolean | string;
+        decimalPlaces?: number;
+        precision?: number;
+    };
+    render?: (value: unknown, record: Record<string, unknown>, rowIndex: number, column: TableColumn) => unknown;
+}
+/** 表体单元格的可序列化条件格式规则。 */
+interface TableConditionalFormat {
+    /** 留空时比较当前列的原始值，否则读取当前记录中的字段路径。 */
+    path?: string;
+    operator: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "empty" | "notEmpty";
+    value?: string;
+    color?: string;
+    backgroundColor?: string;
+    fontWeight?: "normal" | "bold";
+}
+/** 对角线分区中文字的独立样式，字号单位为 pt。 */
+interface TableDiagonalTextStyle {
+    fontSize?: number;
+    fontFamily?: string;
+    color?: string;
+    bold?: boolean;
+    italic?: boolean;
+    textAlign?: "left" | "center" | "right";
+}
+/** 表体单元格的打印样式及合并配置，行列索引均从零开始。 */
+interface TableCell {
+    rowIndex: number;
+    columnIndex: number;
+    /** 当前单元格的打印值格式，优先于列配置。 */
+    valueFormat?: TableColumn["valueFormat"] | null;
+    /** 当前单元格的布局配置，未设置时继承列与表格。 */
+    align?: TableColumn["align"];
+    cellVerticalAlign?: "top" | "middle" | "bottom";
+    cellOverflow?: TableColumn["cellOverflow"];
+    /** 覆盖当前格的文字方向。 */
+    textDirection?: TableColumn["textDirection"];
+    cellPadding?: TableColumn["cellPadding"];
+    /** 当前区域的文字样式，未设置时继承列与表格。 */
+    textStyle?: TableColumn["cellStyle"] & {
+        fontStyle?: "normal" | "italic";
+    };
+    /** 静态表格中指定格子的取值方式；绑定值缺失时保留原静态值。 */
+    valueMode?: "static" | "binding";
+    /** 相对于打印数据根对象的字段路径或插值表达式。 */
+    valuePath?: string;
+    rowSpan?: number;
+    colSpan?: number;
+    backgroundColor?: string;
+    color?: string;
+    borders?: TableBorders;
+    /** 套打模式下内容在设计和预览中显示，实际打印时透明度为 0。 */
+    contentMode?: "show" | "preprint";
+    diagonal?: "down" | "up";
+    /** 多条对角线的共用角点；未设置时沿用旧版左侧角点。 */
+    diagonalCorner?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+    /** 对角线套打模式下，设计时显示线条，打印时线条透明。 */
+    diagonalMode?: "show" | "preprint";
+    /** 对角线数量，默认 1；多条线从同一角点扇形等分。 */
+    diagonalCount?: number;
+    diagonalStart?: string;
+    diagonalEnd?: string;
+    diagonalStartStyle?: TableDiagonalTextStyle;
+    diagonalEndStyle?: TableDiagonalTextStyle;
+    /** 按角点对侧边缘顺序配置各分区文本和样式。 */
+    diagonalSections?: {
+        text?: string;
+        style?: TableDiagonalTextStyle;
+    }[];
+}
+/** 与 ListTable 的 mergeCell 配置一致，按绑定记录自动合并连续行或相邻列。 */
+interface TableMergeCell {
+    row?: {
+        keys: NonNullable<TableColumn["dataIndex"]>[];
+        columns?: NonNullable<TableColumn["dataIndex"]>[];
+    };
+    column?: {
+        keys: NonNullable<TableColumn["dataIndex"]>[];
+    };
+}
+/** 表格组件。行高单位毫米，列宽沿用 ListTable 的逻辑像素。 */
+interface TableElement extends PrintDesignElementBase {
+    type: "table";
+    columns: TableColumn[];
+    dataSource: Record<string, unknown>[];
+    dataMode?: "static" | "binding";
+    dataPath?: string;
+    /** 仅用于分页预览副本，将局部行号映射回源表格。 */
+    sourceRowOffset?: number;
+    /** 横向续页副本的首列在源表格中的可见列索引。 */
+    sourceColumnOffset?: number;
+    /** 从原始明细生成横向分组行、每组小计及每页尾行。 */
+    packedReport?: PackedReport;
+    /** 数据源缺失时使用 dataSource 作为默认内容，空数组仍视为有效数据。 */
+    fallbackToStatic?: boolean;
+    /** 手动设置的画布占用高度；超出该高度的内容在设计画布中裁切。 */
+    manualHeight?: boolean;
+    rowHeight?: number;
+    /** 自动模式按每条记录的内容计算行高；固定模式沿用 rowHeight。 */
+    rowHeightMode?: "fixed" | "auto";
+    /** 模板中手工调整的数据行最小高度，键为静态数据的零基行号。 */
+    rowHeightOverrides?: Record<number, number>;
+    /** 分页副本中已计算的行高，单位毫米。 */
+    rowHeights?: number[];
+    /** 多层表头共用的单层行高，单位毫米。 */
+    headerRowHeight?: number;
+    showHeader?: boolean;
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: "normal" | "bold";
+    /** 列宽按比例拉伸或保持配置的逻辑像素宽度。 */
+    columnWidthMode?: "proportional" | "fixed";
+    /** 固定列宽超过页面时缩小至可用宽度或拆成横向续页。 */
+    wideTableMode?: "fit" | "paginate";
+    /** 全表默认边框；四边配置可覆盖默认值。 */
+    borders?: TableBorders;
+    /** 数据行边框，键为源表格的零基行号。 */
+    rowBorders?: Record<number, TableBorders>;
+    /** 单元格样式和合并区域；区域内仅左上角单元格绘制内容。 */
+    cells?: TableCell[];
+    /** 汇总行单元格样式，行号固定为零，与表体单元格配置分开保存。 */
+    summaryCells?: TableCell[];
+    /** 表头手动合并区域，行号按表头层级从零开始。 */
+    headerCells?: TableCell[];
+    /** 根据绑定记录动态合并连续行或同一行的相邻列。 */
+    mergeCell?: TableMergeCell;
+    /** 默认水平对齐，列级配置优先。 */
+    cellAlign?: "left" | "center" | "right";
+    /** 默认垂直对齐，列级配置优先。 */
+    cellVerticalAlign?: "top" | "middle" | "bottom";
+    /** 单元格超出方式，沿用 ListTable 的换行与省略号模式。 */
+    cellOverflow?: "nowrap" | "wrap" | "ellipsis" | "shrink";
+    /** 表格级单元格内边距默认值；列级 cellPadding 可逐边覆盖。 */
+    cellPadding?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** 是否显示列配置生成的汇总行，默认显示。 */
+    showSummary?: boolean;
+    /** 汇总显示全表结果，或在每张物理页显示当页小计。 */
+    summaryScope?: "all" | "page";
+    /** 分页副本预计算的汇总结果，防止占位行和续页改变统计范围。 */
+    summaryValues?: Record<string, string>;
+    /** 汇总行高，单位毫米，默认沿用数据行高。 */
+    summaryRowHeight?: number;
+    /** 每张物理页的数据行上限，0 或未设置表示仅按纸张容量分页。 */
+    printRowCount?: number;
+    /** 按打印行数补齐空白行，不修改原始数据，也不计入汇总。 */
+    fillEmptyRows?: boolean;
+    /** 各区域默认透明，列级样式可覆盖对应区域配置。 */
+    colors?: Partial<Record<"header" | "body" | "summary", {
+        backgroundColor?: string;
+        color?: string;
+    }>>;
+}
+/** 原始明细转为多列报表的可序列化规则，分页容量由纸张和模板位置计算。 */
+interface PackedReport {
+    /** 跟随表格底部移动的页面元素；未设置时自动选择表格下方元素。 */
+    footerElementIds?: string[];
+    groupBy: string[];
+    itemsPerRow: number;
+    groupFields: Record<string, string>;
+    groupMergeColumns: number[];
+    itemFields: {
+        prefix: string;
+        path?: string;
+        mode?: "index" | "value";
+    }[];
+    subtotal: Record<string, PackedReportValue>;
+    subtotalMerges: Pick<TableCell, "columnIndex" | "colSpan">[];
+    total: Record<string, PackedReportValue>;
+    /** 总计的统计范围；默认对全部原始记录求和。 */
+    totalScope?: "all" | "page";
+    totalMerges: Pick<TableCell, "columnIndex" | "colSpan">[];
+    /** 每页汇总行后的自定义行，空数组表示不追加。 */
+    appendRows: PackedReportAppendRow[];
+}
+/** 报表自定义行的字段内容与合并区域。 */
+interface PackedReportAppendRow {
+    fields: Record<string, PackedReportValue>;
+    merges: Pick<TableCell, "columnIndex" | "colSpan">[];
+}
+/** 报表小计、总计与自定义行的文字、数据绑定或数值求和规则。 */
+interface PackedReportValue {
+    text?: string;
+    path?: string;
+    prefix?: string;
+    sumPath?: string;
+    decimals?: number;
+    suffix?: string;
+    unitPath?: string;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        table: TableElement;
+    }
+}
+
+/** 透视字段所属区域。 */
+type PivotFieldArea = "filter" | "column" | "row" | "value";
+/** 透视值字段的统计方式。 */
+type PivotAggregator = "sum" | "avg" | "count" | "distinctCount" | "rowCount" | "mergedRowCount" | "min" | "max";
+/** 透视字段配置。 */
+interface PivotField {
+    key: string;
+    title?: string;
+    headerTitle?: string;
+    dataIndex?: string | (string | number)[];
+    defaultArea?: PivotFieldArea;
+    indicator?: {
+        title?: string;
+        aggregator?: PivotAggregator;
+        showAggregatorPrefix?: boolean;
+    };
+}
+/** 透视字段在四个区域中的顺序。 */
+interface PivotFieldLayout {
+    filters: string[];
+    columns: string[];
+    rows: string[];
+    values: string[];
+}
+/** 透视行列及筛选区域的条件。 */
+interface PivotFilterState {
+    rows: Record<string, {
+        condition?: {
+            operator: "equals";
+            value?: unknown;
+        };
+    }>;
+    columns: Record<string, {
+        condition?: {
+            operator: "equals";
+            value?: unknown;
+        };
+    }>;
+    filters?: Record<string, {
+        condition?: {
+            operator: "equals";
+            value?: unknown;
+        };
+    }>;
+}
+/** 透视表插件自己的可序列化配置。 */
+interface PivotTableElement extends PrintDesignElementBase {
+    type: "pivotTable";
+    columnWidths?: Record<string, number>;
+    dataSource: Record<string, unknown>[];
+    dataMode?: "static" | "binding";
+    dataPath?: string;
+    fallbackToStatic?: boolean;
+    fields: PivotField[];
+    layout: PivotFieldLayout;
+    filters?: PivotFilterState;
+    rowHeight?: number;
+    headerRowHeight?: number;
+    showHeader?: boolean;
+    fontSize?: number;
+    cellBorder?: {
+        color?: string;
+        width?: number;
+    };
+    colors?: TableElement["colors"];
+    showSummary?: boolean;
+    summaryScope?: "all" | "page";
+    summaryRowHeight?: number;
+    showGrandTotal?: boolean;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        pivotTable: PivotTableElement;
+    }
+}
+
+/** 金额大写插件自己的配置。 */
+interface MoneyUpperElement extends PrintDesignElementBase {
+    type: "moneyUpper";
+    value: string | number;
+    amountFormat?: "chinese" | "formal" | "number" | "chineseNumber";
+    prefix?: string;
+    suffix?: string;
+    fontSize?: number;
+    color?: string;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        moneyUpper: MoneyUpperElement;
+    }
+}
+
+/** 分割线插件自己的配置。 */
+interface DividerElement extends PrintDesignElementBase {
+    type: "divider";
+    orientation?: "horizontal" | "vertical";
+    stroke?: string;
+    strokeWidth?: number;
+    lineStyle?: "solid" | "dashed" | "dotted";
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        divider: DividerElement;
+    }
+}
+
+/** 水印插件自己的配置。 */
+interface WatermarkElement extends PrintDesignElementBase {
+    type: "watermark";
+    text: string;
+    fontSize?: number;
+    color?: string;
+    textRotation?: number;
+    rows?: number;
+    columns?: number;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        watermark: WatermarkElement;
+    }
+}
+
+/** 日期时间插件自己的配置。 */
+interface DateTimeElement extends PrintDesignElementBase {
+    type: "dateTime";
+    format?: string;
+    value?: string;
+    fontSize?: number;
+    color?: string;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        dateTime: DateTimeElement;
+    }
+}
+
+/** 页码插件自己的配置。 */
+interface PageNumberElement extends PrintDesignElementBase {
+    type: "pageNumber";
+    prefix?: string;
+    format?: "default" | "pageTotal" | "fraction" | "number" | "custom";
+    template?: string;
+    fontSize?: number;
+    color?: string;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        pageNumber: PageNumberElement;
+    }
+}
+
+/** 条形或环形打印进度。尺寸、边框与圆角以毫米表示。 */
+interface ProgressElement extends PrintDesignElementBase {
+    type: "progress";
+    variant: "bar" | "ring";
+    /** 完成百分比，范围 0–100。 */
+    value: number;
+    /** 动态完成百分比字段，缺失或无效时使用静态 value。 */
+    valuePath?: string;
+    completedColor?: string;
+    remainingColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    /** 条形圆角或环形进度端点圆角半径。 */
+    borderRadius?: number;
+    /** 环形轨道厚度。 */
+    thickness?: number;
+    /** 条形右侧或环形中心显示完成百分比。 */
+    showPercent?: boolean;
+    /** 百分比字号，单位 pt。 */
+    percentFontSize?: number;
+    percentColor?: string;
+    /** 按最高命中的阈值覆盖当前进度与百分比文字颜色。 */
+    colorRules?: Array<{
+        min: number;
+        completedColor: string;
+        percentColor: string;
+    }>;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        progress: ProgressElement;
+    }
+}
+
+/** 纵向流程节点，沿用 list-table 时间轴的标题、内容和状态语义。 */
+interface FlowItem {
+    title?: string;
+    content: string;
+    color?: string;
+    position?: "start" | "end";
+    loading?: boolean;
+    icon?: "circle" | "check" | "clock" | "cross";
+}
+/** 可独立放置在纸张上的纵向流程。 */
+interface FlowElement extends PrintDesignElementBase {
+    type: "flow";
+    items: FlowItem[];
+    dataMode?: "static" | "binding";
+    /** 动态节点数组路径，数组项可以是对象或直接可显示的值。 */
+    dataPath?: string;
+    /** 将数组项字段映射为节点属性；空路径使用同名属性。 */
+    itemFields?: Partial<Record<"title" | "content" | "color" | "position" | "loading" | "icon", string>>;
+    /** 动态路径缺失或不是数组时显示静态节点。 */
+    fallbackToStatic?: boolean;
+    mode?: "start" | "end" | "alternate";
+    reverse?: boolean;
+    variant?: "outlined" | "filled";
+    itemGap?: number;
+    dotSize?: number;
+    lineColor?: string;
+    textColor?: string;
+    titleColor?: string;
+    fontSize?: number;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        flow: FlowElement;
+    }
+}
+
+/** 模拟时钟；颜色分别控制表盘、刻度、数字和三根指针。 */
+interface ClockElement extends PrintDesignElementBase {
+    type: "clock";
+    /** ISO 日期时间或 HH:mm[:ss]；为空时使用系统时间。 */
+    value?: string;
+    /** 自动刷新间隔；none 固定显示传入时间。 */
+    refreshInterval?: "none" | "second" | "minute" | "hour";
+    /** 传入时间开始运行的时间戳，修改 value 时同步更新。 */
+    startedAt?: string;
+    showHourHand?: boolean;
+    showMinuteHand?: boolean;
+    showSecondHand?: boolean;
+    hourHandColor?: string;
+    minuteHandColor?: string;
+    secondHandColor?: string;
+    ringColor?: string;
+    /** 旧版统一刻度颜色；各级颜色未设置时作为回退值。 */
+    tickColor?: string;
+    showSmallTicks?: boolean;
+    showMediumTicks?: boolean;
+    showLargeTicks?: boolean;
+    smallTickColor?: string;
+    mediumTickColor?: string;
+    largeTickColor?: string;
+    numberColor?: string;
+    /** 刻度数字字号，单位 pt。 */
+    numberFontSize?: number;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        clock: ClockElement;
+    }
+}
+
+/** 条形码元素。 */
+interface BarcodeElement extends PrintDesignElementBase {
+    type: "barcode";
+    value: string;
+    format?: BarcodeFormat;
+    color?: string;
+    backgroundColor?: string;
+    displayValue?: boolean;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        barcode: BarcodeElement;
+    }
+}
+
+/** 二维码元素。 */
+interface QrCodeElement extends PrintDesignElementBase {
+    type: "qrcode";
+    value: string;
+    level?: QrCodeLevel;
+    format?: QrCodeFormat;
+    mode?: QrCodeMode;
+    contentTemplate?: QrCodeContentTemplate;
+    templateFields?: QrCodeContentFields;
+    color?: string;
+    backgroundColor?: string;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        qrcode: QrCodeElement;
+    }
+}
+
+/** 图表数据编辑与绑定配置，字段路径相对于数据源中的每条记录。 */
+interface ChartData {
+    mode: "static" | "binding";
+    source?: string;
+    /** 数据源缺失时使用静态分类和系列作为默认内容。 */
+    fallbackToStatic?: boolean;
+    categoryField?: string;
+    categories: string[];
+    series: Array<{
+        name: string;
+        field?: string;
+        values: number[];
+    }>;
+    /** 雷达图指标上限。 */
+    max?: number;
+}
+/** 使用 chart 包现有渲染器绘制的静态图表元素。 */
+interface ChartElement extends PrintDesignElementBase {
+    type: "chart";
+    chartType: string;
+    chartData?: ChartData;
+    option: unknown;
+    simple?: boolean;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        chart: ChartElement;
+    }
+}
+
+/** 文本元素。 */
+interface TextElement extends PrintDesignElementBase {
+    type: "text";
+    text: string;
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: string;
+    color?: string;
+    /** 文字颜色的静态或字段绑定模式。@default "static" */
+    colorMode?: "static" | "binding";
+    /** 文字颜色字段路径；字段需直接提供可用的 CSS 色值。 */
+    colorPath?: string;
+    /** 字号的静态或字段绑定模式。@default "static" */
+    fontSizeMode?: "static" | "binding";
+    /** 字号字段路径；字段可提供数字或带 mm/cm/in/pt/px 单位的值。 */
+    fontSizePath?: string;
+    /** 字号字段无单位时采用的单位；切换绑定时记录全局单位。@default "mm" */
+    fontSizeBindingUnit?: PrintDesignUnit;
+    /** 文本框边界线，单位毫米；用于打印时核对排版区域。 */
+    borderColor?: string;
+    borderWidth?: number;
+    textAlign?: CanvasTextAlign | "justify" | "distributed";
+    /** 文字排列方向。 */
+    textDirection?: "horizontal" | "vertical";
+    verticalAlign?: "top" | "middle" | "bottom";
+    lineHeight?: number;
+    /** 下划线条数；0 表示不绘制。 */
+    underlineCount?: number;
+    underlineStyle?: "solid" | "dashed" | "dotted" | "wavy";
+    underlineColor?: string;
+    /** 下划线宽度与间距，单位毫米。 */
+    underlineWidth?: number;
+    underlineGap?: number;
+    /** 文本超出固定高度时的处理方式。 */
+    heightOverflow?: "clip" | "flow" | "ellipsis";
+    /** 按字数上限选择字号；超过所有区间时使用最大上限的字号。 */
+    fontSizeRules?: Array<{
+        maxChars: number;
+        fontSize: number;
+    }>;
+    /** 可选字体文件地址，与 fontFamily 配合加载。 */
+    fontSource?: string;
+    /** 分页生成的文本已按目标宽度断行，绘制时保留这些断行。 */
+    prewrapped?: boolean;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        text: TextElement;
+    }
+}
+
+/** 形状元素。 */
+interface ShapeElement extends PrintDesignElementBase {
+    type: "shape";
+    shape: "rect" | "ellipse" | "line" | "triangle" | "circle" | "polygon" | "sector" | "star" | "bracket-left-square" | "bracket-right-square" | "bracket-left-curly" | "bracket-right-curly" | "bracket-pair-square" | "bracket-pair-curly" | "curve-quadratic" | "curve-cubic" | "curve-multi" | "curve-path";
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    /** 括号线型。 */
+    lineStyle?: "solid" | "dashed" | "dotted";
+    radius?: number;
+    /** 正多边形边数，范围 3–12。@default 5 */
+    sides?: number;
+    /** 三角形、多边形或五角星各顶点的归一化位置。 */
+    polygonPoints?: Array<{
+        x: number;
+        y: number;
+    }>;
+    /** 扇形圆心角，范围 1–359 度。@default 120 */
+    sectorAngle?: number;
+    /** 形状内部居中的文本。 */
+    text?: string;
+    fontSize?: number;
+    textColor?: string;
+    /** 曲线锚点和控制点的元素内归一化坐标。 */
+    curvePoints?: Array<{
+        x: number;
+        y: number;
+    }>;
+    /** 自定义路径的节点，使用元素内归一化坐标。 */
+    pathPoints?: Array<{
+        x: number;
+        y: number;
+    }>;
+    /** 自定义路径是否闭合。 */
+    pathClosed?: boolean;
+    /** 控制点相对锚点连线的偏移倍率，0–2。 */
+    curvature?: number;
+    /** 文本在曲线法线方向的位置。 */
+    curveTextTrack?: "above" | "middle" | "below";
+    /** 文本中心沿曲线路径的位置，0–1。 */
+    curveTextPosition?: number;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        shape: ShapeElement;
+    }
+}
+
+/** 画笔图层；每组归一化坐标对应一次独立笔画。 */
+interface BrushStrokeStyle {
+    stroke?: string;
+    strokeWidth?: number;
+    brushStyle?: "hard" | "brush" | "fountain";
+    dynamics?: number;
+    nibAngle?: number;
+    edge?: "hard" | "soft";
+    lineCap?: "round" | "square";
+}
+/** 画笔图层中每笔保留绘制时的外观。 */
+interface BrushElement extends PrintDesignElementBase {
+    type: "brush";
+    strokes: Array<Array<{
+        x: number;
+        y: number;
+        pressure?: number;
+    }>>;
+    strokeStyles?: BrushStrokeStyle[];
+    stroke?: string;
+    strokeWidth?: number;
+    /** 硬笔为等宽线，毛笔为压力笔锋，钢笔为倾斜的扁平笔尖。 */
+    brushStyle?: "hard" | "brush" | "fountain";
+    /** 压力与速度对笔画粗细的影响，0–1。 */
+    dynamics?: number;
+    /** 钢笔笔尖相对水平轴的角度。 */
+    nibAngle?: number;
+    /** 硬边保持清晰轮廓，柔边增加模糊边缘。 */
+    edge?: "hard" | "soft";
+    lineCap?: "round" | "square";
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        brush: BrushElement;
+    }
+}
+
+/** 打印甘特图的时间精度。 */
+type GanttScale = "second" | "minute" | "hour" | "day" | "week" | "month";
+/** 打印甘特图任务。 */
+interface GanttTask {
+    id: string;
+    title: string;
+    start?: string | number;
+    end?: string | number;
+    progress?: number;
+    color?: string;
+    progressColor?: string;
+    /** 当前任务的前置任务连线，to 默认为当前任务 ID。 */
+    dependencies?: Omit<GanttDependency, "to">[];
+    tasks?: GanttTask[];
+}
+/** 打印甘特图任务依赖。 */
+interface GanttDependency {
+    from: string;
+    to: string;
+    type?: "finish-to-start" | "start-to-start" | "finish-to-finish";
+    color?: string;
+}
+/** 可打印的甘特图快照。 */
+interface GanttElement extends PrintDesignElementBase {
+    type: "gantt";
+    tasks: GanttTask[];
+    showDependencies?: boolean;
+    dependencyColor?: string;
+    /** 依赖连线宽度，单位为逻辑像素。 */
+    dependencyLineWidth?: number;
+    dependencyArrow?: boolean;
+    dataMode?: "static" | "binding";
+    dataPath?: string;
+    fallbackToStatic?: boolean;
+    scale?: GanttScale;
+    startDate?: string;
+    endDate?: string;
+    taskColumnTitle?: string;
+    taskColumnRatio?: number;
+    /** 任务列正文文字的水平对齐方式。 */
+    taskAlign?: "left" | "center" | "right";
+    taskColor?: string;
+    progressColor?: string;
+    /** 任务进度条圆角半径，单位毫米。 */
+    progressRadius?: number;
+    /** 任务进度条高度，单位毫米；不超过当前行高。 */
+    progressHeight?: number;
+    /** 每条任务的行高，单位毫米；未配置时平均填充组件高度。 */
+    rowHeight?: number;
+    /** 表头可关闭；表头高度以毫米保存。 */
+    showHeader?: boolean;
+    headerHeight?: number;
+    headerBackgroundColor?: string;
+    headerTextColor?: string;
+    /** 任务列标题和时间轴刻度的水平对齐方式。 */
+    headerAlign?: "left" | "center" | "right";
+    cellBackgroundColor?: string;
+    cellTextColor?: string;
+    /** 边框宽度沿用表格的逻辑像素单位；0 表示隐藏。 */
+    frameBorder?: {
+        color?: string;
+        width?: number;
+    };
+    headerBorder?: {
+        color?: string;
+        width?: number;
+    };
+    cellBorder?: {
+        color?: string;
+        width?: number;
+    };
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        gantt: GanttElement;
+    }
+}
+
+/** 可打印刻度尺。边界模式按 0 到总刻度编号，逐格模式按 1 到总刻度编号。 */
+interface RulerElement extends PrintDesignElementBase {
+    type: "ruler";
+    orientation: "horizontal" | "vertical";
+    /** 数字与刻度位于基线的哪一侧：横向为上/下，纵向为左/右。@default "after" */
+    labelPosition?: "before" | "after";
+    /** 刻度线位于基线的哪一侧；可让左侧刻度线朝外。@default "after" */
+    tickPosition?: "before" | "after";
+    /** 反向编号，编号从总刻度向起始值递减。 */
+    reverseLabels?: boolean;
+    /** 刻度位于区间边界、每格起始线、末端线或格子中心。@default "boundary" */
+    tickPlacement?: "boundary" | "cell-start" | "cell-end" | "cell-center";
+    /** 数字对齐刻度线，或放在相邻两条刻度线之间。@default "tick" */
+    labelAlignment?: "tick" | "between";
+    /** 首尾刻度与组件边界对齐，适用于与网格线共用坐标。 */
+    fullBoundaries?: boolean;
+    /** 保留 0 标签，但不绘制 0 刻度线。 */
+    omitZeroTick?: boolean;
+    /** 不显示 0 标签，用于共享原点的坐标轴。 */
+    omitZeroLabel?: boolean;
+    totalTicks: number;
+    middleEvery?: number;
+    majorEvery?: number;
+    minorHeight?: number;
+    middleHeight?: number;
+    majorHeight?: number;
+    lineColor?: string;
+    labelColor?: string;
+    strokeWidth?: number;
+    fontSize?: number;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        ruler: RulerElement;
+    }
+}
+
+/** 网格单元格中的静态标记。 */
+type GridMark = "none" | "x" | "*";
+/** 单格静态标记及独立数据绑定；动态值无效时沿用静态值。 */
+interface GridCell {
+    content?: GridMark;
+    contentMode?: "static" | "binding";
+    contentPath?: string;
+    backgroundColor?: string;
+}
+/** 纹版图中的纵向循环区间；行号起点由网格配置决定，结束行超出网格时裁切。 */
+interface GridLoop {
+    startRow: number;
+    endRow: number;
+    count: number;
+}
+/** 纹版图中的横向列循环区间；列号起点由网格配置决定。 */
+interface GridColumnLoop {
+    startColumn: number;
+    endColumn: number;
+    count: number;
+}
+/** 循环结束位置被网格裁切时的括号端点样式。 */
+type GridLoopOverflowMarker = "cap" | "open" | "arrow" | "wave";
+/** 可按单元格显示标记与背景色的打印网格。 */
+interface GridElement extends PrintDesignElementBase {
+    type: "grid";
+    rows: number;
+    columns: number;
+    /** 在画布点击单元格时使用的标记。 */
+    paintMark?: "x" | "*";
+    /** 二维 0/1 选中数组的默认绑定路径；单元格可覆盖。 */
+    contentPath?: string;
+    /** 循环区间数组路径；数组项包含 startRow、endRow 和 count。 */
+    loopsPath?: string;
+    /** 数据路径缺失时使用的静态循环区间。 */
+    loops?: GridLoop[];
+    /** 列循环区间数组路径；数组项包含 startColumn、endColumn 和 count。 */
+    columnLoopsPath?: string;
+    /** 数据路径缺失时使用的静态列循环区间。 */
+    columnLoops?: GridColumnLoop[];
+    /** 行循环编号起点。@default 0 */
+    loopRowIndexBase?: 0 | 1;
+    /** 列循环编号起点。@default 0 */
+    loopColumnIndexBase?: 0 | 1;
+    /** 行循环编号递增方向；从底往上可与左侧反向刻度对应。@default "top-down" */
+    loopRowDirection?: "top-down" | "bottom-up";
+    /** 列循环编号递增方向。@default "left-right" */
+    loopColumnDirection?: "left-right" | "right-left";
+    /** 网格右侧为循环括号预留的宽度，单位毫米。 */
+    loopGutter?: number;
+    /** 网格上方为列循环括号预留的高度，单位毫米。 */
+    columnLoopGutter?: number;
+    /** 坐标组件的箭头需要独立占用预留区，即使没有循环括号。 */
+    reserveGutters?: boolean;
+    /** 行列循环超出网格时，裁切端的样式。@default "cap" */
+    loopOverflowMarker?: GridLoopOverflowMarker;
+    loopColor?: string;
+    /** 按行优先排列；每格可独立绑定选中状态。 */
+    cells?: GridCell[];
+    backgroundColor?: string;
+    /** 带有 X 或米字标记的单元格背景色；独立背景配置优先。 */
+    selectedBackgroundColor?: string;
+    lineColor?: string;
+    lineWidth?: number;
+    markColor?: string;
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        grid: GridElement;
+    }
+}
+
+/** 网格与左、下刻度尺共用行列和单格尺寸的坐标组件。 */
+interface CoordinateElement extends Omit<GridElement, "type"> {
+    type: "coordinate";
+    leftRulerWidth?: number;
+    bottomRulerHeight?: number;
+    rulerGap?: number;
+    rulerFontSize?: number;
+    rulerTickLength?: number;
+    rulerColor?: string;
+    /** 左侧行编号从下往上递增时为 true。 */
+    reverseRowLabels?: boolean;
+    /** 底部列编号从右往左递增时为 true。 */
+    reverseColumnLabels?: boolean;
+    /** 纵轴上端、下端和横轴左端、右端的尖头。 */
+    arrowTop?: boolean;
+    arrowBottom?: boolean;
+    arrowLeft?: boolean;
+    arrowRight?: boolean;
+    /** 箭头三角部分与网格边框的距离，单位毫米。@default 0.5 */
+    arrowGridGap?: number;
+    /** 将两根轴线连接到左下角交点，并标注 0。 */
+    showZeroCrossing?: boolean;
+    /** 在 0 点交叉处绘制纵横两根轴的刻度线。 */
+    showZeroTick?: boolean;
+    /** 0 标签显示在横轴、纵轴、两轴各一个，或共用一个原点标签。@default "shared" */
+    zeroLabelMode?: "horizontal" | "vertical" | "both" | "shared";
+}
+declare module "@canvas-components/print-design" {
+    interface PrintDesignElementTypeMap {
+        coordinate: CoordinateElement;
+    }
+}
+
+export { assertNativePluginDependencies as $, type PivotFieldLayout as A, type BarcodeElement as B, type ChartData as C, type DateTimeElement as D, type PivotFilterState as E, type FlowElement as F, type GanttDependency as G, type PivotTableElement as H, type ImageCrop as I, type ProgressElement as J, type TableBorder as K, type ListElement as L, type MoneyUpperElement as M, type TableBorders as N, type TableCell as O, type PrintDesignNativePlugin as P, type QrCodeElement as Q, type RulerElement as R, type ShapeElement as S, type TextElement as T, type TableCellSelectionState as U, type TableColumn as V, type TableConditionalFormat as W, type TableDiagonalTextStyle as X, type TableElement as Y, type TableMergeCell as Z, type WatermarkElement as _, type BrushElement as a, defineNativePlugin as a0, type BrushStrokeStyle as b, type ChartElement as c, type ClockElement as d, type ConnectorElement as e, type ConnectorEndpoint as f, type CoordinateElement as g, type DividerElement as h, type FlowItem as i, type GanttElement as j, type GanttScale as k, type GanttTask as l, type GridCell as m, type GridColumnLoop as n, type GridElement as o, type GridLoop as p, type GridLoopOverflowMarker as q, type GridMark as r, type ImageElement as s, type PackedReport as t, type PackedReportAppendRow as u, type PackedReportValue as v, type PageNumberElement as w, type PivotAggregator as x, type PivotField as y, type PivotFieldArea as z };