@gct-paas/word 0.2.5 → 0.2.6

package/dist/base/utils/image-size-util.d.ts

@@ -18,6 +18,11 @@ export interface ImageCropRect {
     width: number;
     height: number;
 }
+/** 固定 360×204 兜底图同一比例，按 2 倍像素绘制 */
+export declare const FALLBACK_SIGN_DISPLAY_SIZE: {
+    readonly width: 180;
+    readonly height: 102;
+};
 /**
  * 根据图片原始尺寸 + 配置，计算最终显示尺寸
  */
@@ -34,11 +39,11 @@ export declare function computeContainLayout(natural: ImageSize, box: ImageSize)
  * 在目标框内等比缩放（contain），不压缩、不拉伸
  */
 export declare function computeContainDisplaySize(natural: ImageSize, box: ImageSize): ImageSize;
-/** 同步取无图签名缓存（布局重建时可避免先闪占位再异步补图） */
-export declare function getCachedSignatureImage(name: string, width?: number, height?: number, time?: number | string): HTMLImageElement | null;
+/** 同步取无图签名缓存（布局重建时可避免先闪占位再异步补图）。宽高参数仅为兼容现有调用。 */
+export declare function getCachedSignatureImage(name: string, _width?: number, _height?: number, time?: number | string, fallbackSignType?: string, signatureImageDirection?: string): HTMLImageElement | null;
 /**
- * 创建无图签名兜底图（用户名 + 电子签名 + 验证日期）
- * 按字段宽高绘制，显示框设多大，字就按多大排
+ * 创建无图签名兜底图
+ * 默认用户名 + 电子签名 + 验证日期；仅用户名时只绘制姓名
  */
-export declare function createSignatureImageDataUrl(name: string, width?: number, height?: number, time?: number | string): string;
-export declare function createSignatureImage(name: string, width?: number, height?: number, time?: number | string): Promise<HTMLImageElement>;
+export declare function createSignatureImageDataUrl(name: string, _width?: number, _height?: number, time?: number | string, fallbackSignType?: string, signatureImageDirection?: string): string;
+export declare function createSignatureImage(name: string, width?: number, height?: number, time?: number | string, fallbackSignType?: string, signatureImageDirection?: string): Promise<HTMLImageElement>;

package/dist/core/layout/handlers/fields/signature-decoration-layout.d.ts

@@ -0,0 +1,14 @@
+/** 签名与日期的组合区域。未设置样式的旧模板按上下排列。 */
+export declare function getSignatureDecorationPlacement(width: number, height: number, textWidth: number, textHeight: number, gap: number, signDisplayStyle?: string): {
+    position: "right";
+    rectWidth: number;
+    rectHeight: number;
+    x: number;
+    y: number;
+} | {
+    position: "bottom";
+    rectWidth: number;
+    rectHeight: number;
+    x: number;
+    y: number;
+};

package/dist/core/model/logic/subtable/shared/merged-table-range.d.ts

@@ -0,0 +1,4 @@
+import { Wtbl } from '../../../document';
+import { TableRange } from './dataGroupSlotCount';
+/** 补齐业务模板覆盖的合并格底层范围，兼容旧表单只记录主格坐标的范围。 */
+export declare function expandMergedTableRange(table: Wtbl, range: TableRange): TableRange;

package/dist/core/view/runs/ImageRun.d.ts

@@ -10,14 +10,20 @@ export interface IImageRun {
     readonly width: number;
     /** 组件高度 */
     readonly height: number;
+    /** 图片本身的宽高（不包含日期装饰） */
+    readonly imageWidth: number;
+    readonly imageHeight: number;
     /** 组件坐标位置 */
     readonly x: number;
     /** 组件坐标位置 */
     readonly y: number;
     /** 图片源地址 */
     src: string;
+    decorations?: ImageRunOptions['decorations'];
     /** 是否保持等比 */
     keepAspect: boolean;
+    /** 下方文字比图片宽时，图片在组合区域中的水平偏移 */
+    readonly imageOffsetX: number;
 }
 export interface ImageRunOptions extends LayoutNodeOptions {
     src: string;
@@ -45,6 +51,9 @@ export declare class ImageRun extends LayoutNode implements IImageRun {
     decorations?: ImageRunOptions['decorations'];
     get width(): number;
     set width(value: number);
+    get imageWidth(): number;
+    get imageHeight(): number;
+    get imageOffsetX(): number;
     get height(): number;
     set height(value: number);
     constructor(options: ImageRunOptions);

package/dist/domain/constants/enum/signature.d.ts

@@ -28,3 +28,17 @@ export declare const SignDisplayTypeConst: {
     /** 水平显示 */
     HORIZONTAL: string;
 };
+/** 兜底签名配置：个人无上传/手写签名素材时，密码校验通过后展示的样式 */
+export declare const FallbackSignTypeConst: {
+    /** 仅用户名 */
+    NAME_ONLY: string;
+    /** 用户名 + 签署日期 */
+    NAME_AND_DATE: string;
+};
+/** 签名图片方向 */
+export declare const SignatureImageDirectionConst: {
+    /** 横向签名 */
+    HORIZONTAL: string;
+    /** 竖向签名 */
+    VERTICAL: string;
+};