@gct-paas/word 0.1.74-beta.4 → 0.1.74-beta.6

package/dist/assets/theme/field-state.d.ts

@@ -1,66 +1,74 @@
 /**
- * 字段交互态配色（Canvas 渲染使用）。
- * Less 侧见 field-state.less，修改时请同步两处。
+ * 字段态配色 —— 唯一数据源（Canvas / PDF / 布局）。
+ *
+ * DOM 控件（input / select）另见 field-state.less，仅保留 DOM 用到的子集；
+ * 改色时以本文件为准，并同步 less 中同语义变量。
+ *
+ * 空值占位 / 括号 []（填报，同色）：
+ *   可编辑          editable.placeholderColor / marker.default
+ *   必填            required.placeholderColor
+ *   只读            readonly.placeholderColor / marker.readonly
+ *   必填+只读       requiredReadonly.placeholderColor / color + background
+ *   禁用            disabled.color / marker.disabled
  */
 export declare const FieldStateColors: {
-    /** 可编辑：浅蓝底 */
-    readonly editableBg: "#F2F8FE";
-    readonly editableBgActive: "rgba(147, 197, 253, 0.4)";
-    readonly editableLine: "#999999";
-    /** 暗提示（空值占位文字） */
-    readonly editablePlaceholderText: "#b8b8b8";
-    readonly readonlyPlaceholderText: "#b0b0b0";
-    readonly printPlaceholderText: "#b8b8b8";
-    /** 只读：灰底 + 灰边框，与可编辑蓝底形成对比 */
-    readonly readonlyBg: "#f5f6f8";
-    readonly readonlyBgActive: "#eff1f4";
-    readonly readonlyBorder: "#d9d9d9";
-    readonly readonlyLine: "#bfbfbf";
-    readonly readonlyText: "rgba(0, 0, 0, 0.65)";
-    /** 填报只读 - 有值文本（gct-text-render） */
-    readonly readonlyValueBg: "#f0f2f5";
-    readonly readonlyValueBgActive: "#e8ebf0";
-    readonly readonlyValueText: "rgba(0, 0, 0, 0.78)";
-    readonly readonlyValueLine: "#adb5bd";
-    /** 填报只读 - 空值占位（gct-placeholder-render） */
-    readonly readonlyPlaceholderBg: "#f5f7fa";
-    readonly readonlyPlaceholderBgActive: "#eef1f5";
-    readonly readonlyPlaceholderLine: "#c4c9d0";
-    /** 详情页普通字符底色 */
-    readonly printBg: "transparent";
-    /** 详情页字段底色 */
-    readonly printFieldBg: "#E8F3FF";
-    /** 详情页字段校验失败底色 */
-    readonly printFieldErrorBg: "#FEECED";
-    /** 字段括号 [] 颜色 */
-    readonly markerDefault: "#000000";
-    readonly markerReadonly: "#8c8c8c";
-    readonly markerDisabled: "#c9c9c9";
-    /** 只读选中态（checkbox / radio） */
-    readonly readonlyCheckedBorder: "#91caff";
-    readonly readonlyCheckedBg: "#e6f4ff";
-    readonly readonlyCheckedFill: "#69b1ff";
+    /** 字段括号 []：默认可编辑黑；只读/禁用见下；必填 / 必填+只读复用对应 placeholderColor */
+    readonly marker: {
+        readonly default: "#1A1D23";
+        readonly readonly: "#8c8c8c";
+        readonly disabled: "#C6C6C6";
+    };
+    /** 可编辑 */
+    readonly editable: {
+        readonly background: "#E8F3FF";
+        readonly placeholderColor: "#8B8B8B";
+    };
+    /** 必填 */
+    readonly required: {
+        readonly placeholderColor: "#F54547";
+        readonly background: "#FEECED";
+    };
     /** 禁用 */
-    readonly disabledBg: "#f5f5f5";
-    readonly disabledBgActive: "#f0f0f0";
-    readonly disabledText: "#c9c9c9";
-    readonly disabledLine: "#c9c9c9";
-    readonly disabledFill: "rgba(0, 0, 0, 0.04)";
-    /** 字段变更（批注高亮字色） */
-    readonly fieldChangeText: "#FF9442";
+    readonly disabled: {
+        readonly background: "#F1F2F5";
+        readonly color: "#C6C6C6";
+    };
+    /** 必填 + 只读（他岗字段，弱提示：字色 + 底色） */
+    readonly requiredReadonly: {
+        readonly placeholderColor: "#FAA9AA";
+        readonly color: "#FAA9AA";
+        readonly background: "#FFF4F4";
+    };
+    /** 只读 */
+    readonly readonly: {
+        readonly background: "#f5f6f8";
+        readonly border: "#d9d9d9";
+        /** DOM overlay / 下拉等 */
+        readonly color: "rgba(0, 0, 0, 0.65)";
+        readonly placeholderColor: "#b0b0b0";
+        readonly valueColor: "rgba(0, 0, 0, 0.78)";
+    };
+    /** 详情页 / 打印 */
+    readonly print: {
+        /** run 级底（字段组底由 fieldBackground 绘制） */
+        readonly background: "transparent";
+        readonly fieldBackground: "#E8F3FF";
+        readonly fieldErrorBackground: "#FEECED";
+        readonly placeholderColor: "#b8b8b8";
+    };
     /** 校验失败 */
-    readonly validationErrorText: "#ff4d4f";
-    readonly validationErrorLine: "#ff4d4f";
-    readonly validationErrorBg: "#fff2f2";
-    /** 禁用态校验失败 */
-    readonly validationErrorDisabledText: "#ff7072";
-    readonly validationErrorDisabledLine: "#ff8a8c";
-    readonly validationErrorDisabledBg: "#f5f5f5";
-    readonly validationErrorDisabledBgActive: "#f0f0f0";
+    readonly validation: {
+        readonly color: "#ff4d4f";
+        readonly background: "#fff2f2";
+        readonly disabledColor: "#ff7072";
+        readonly disabledBackground: "#f5f5f5";
+    };
+    /** 字段变更批注字色 */
+    readonly fieldChange: "#FF9442";
 };
 /** 详情页字段内容四周内边距 */
 export declare const PRINT_FIELD_PAD = 2;
 /** 详情页相邻字段背景间距 */
 export declare const PRINT_FIELD_GAP = 2;
-/** 详情页字段空值占位尺寸 */
-export declare const PRINT_EMPTY_FIELD_SIZE = 20;
+/** 详情页字段空值占位尺寸（默认字号 + MEASURE_LINE_HEIGHT 1.1 下字高） */
+export declare const PRINT_EMPTY_FIELD_SIZE = 21;

package/dist/base/collapse/src/collapse.vue.d.ts

@@ -5,6 +5,9 @@ type __VLS_Props = {
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
+        expandIcon?(_: {
+            open: boolean;
+        }): any;
         default?(_: {}): any;
     };
     refs: {

package/dist/base/empty/src/empty.vue.d.ts

@@ -1,7 +1,7 @@
 import { IEmptyProps } from './empty';
 declare const _default: import('vue').DefineComponent<IEmptyProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<IEmptyProps> & Readonly<{}>, {
-    width: number | string;
     height: number | string;
+    width: number | string;
     tip: string;
     iconSrc: string;
     iconHeight: number | string;

package/dist/base/image-upload/src/image-upload.vue.d.ts

@@ -6,8 +6,8 @@ declare const _default: import('vue').DefineComponent<IUploadProps, {}, {}, {},
     onChange?: ((...args: any[]) => any) | undefined;
     "onUpdate:value"?: ((...args: any[]) => any) | undefined;
 }>, {
-    width: string;
     height: string;
+    width: string;
     tip: string;
     accept: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {

package/dist/base/select/src/basic-select.vue.d.ts

@@ -66,12 +66,12 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     getRef: import('vue').Ref<any, any>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     edit: (option: DropdownOption) => any;
-    click: () => any;
+    click: (evt: any) => any;
     change: (val: string | number | (string | number)[], item?: DropdownOption | undefined) => any;
     "update:modelValue": (val: string | number | (string | number)[]) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onEdit?: ((option: DropdownOption) => any) | undefined;
-    onClick?: (() => any) | undefined;
+    onClick?: ((evt: any) => any) | undefined;
     onChange?: ((val: string | number | (string | number)[], item?: DropdownOption | undefined) => any) | undefined;
     "onUpdate:modelValue"?: ((val: string | number | (string | number)[]) => any) | undefined;
 }>, {

package/dist/base/select/src/searchable-select.vue.d.ts

@@ -7,8 +7,28 @@ type __VLS_Props = {
     readonly?: boolean;
     allowClear?: boolean;
     popperWidth?: number;
+    /** 是否需要分组展示 */
+    grouped?: boolean;
 };
-declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        option?(_: {
+            option: DropdownOption;
+        }): any;
+        'gct-ss-option-icon'?(_: {
+            option: DropdownOption;
+        }): any;
+    };
+    refs: {
+        rootRef: HTMLDivElement;
+        inputRef: HTMLInputElement;
+        dropdownRef: HTMLDivElement;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     change: (val?: string | number | undefined, item?: DropdownOption | undefined) => any;
     "update:modelValue": (val?: string | number | undefined) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
@@ -19,10 +39,17 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     disabled: boolean;
     options: DropdownOption[];
     placeholder: string;
+    grouped: boolean;
     allowClear: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     rootRef: HTMLDivElement;
     inputRef: HTMLInputElement;
     dropdownRef: HTMLDivElement;
 }, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -30,7 +30,13 @@ export interface ContainLayout extends ImageSize {
 }
 /** object-fit: contain —— 等比缩放到目标框内并居中，保证完整显示 */
 export declare function computeContainLayout(natural: ImageSize, box: ImageSize): ContainLayout;
-/** 将签名姓名绘制为图片 DataURL */
-export declare function createSignatureImageDataUrl(name: string, width: number, height: number): string;
-/** 创建签名图片 */
-export declare function createSignatureImage(name: string, width: number, height: number): Promise<unknown>;
+/**
+ * 在目标框内等比缩放（contain），不压缩、不拉伸
+ */
+export declare function computeContainDisplaySize(natural: ImageSize, box: ImageSize): ImageSize;
+/**
+ * 创建无图签名兜底图（用户名 + 电子签名 + 验证日期）
+ * 按字段宽高绘制，显示框设多大，字就按多大排
+ */
+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>;

package/dist/core/constants/paper.d.ts

@@ -27,7 +27,9 @@ export declare const DEFAULT_PAGE_PADDING: [number, number, number, number];
 export declare const DEFAULT_CELL_PADDING: [number, number, number, number];
 export declare const DEFAULT_FONT_SIZE = 16;
 /** 默认黑体 */
-export declare const DEFAULT_LINE_HEIGHT = 1.6;
+export declare const DEFAULT_LINE_HEIGHT = 1.5715;
+/** Konva 度量 lineHeight（仅量字盒，不含段落 DEFAULT_LINE_HEIGHT） */
+export declare const MEASURE_LINE_HEIGHT = 1.1;
 /** 图片 / 签名行高，略高于内容，避免贴行又不过松 */
 export declare const IMAGE_LINE_HEIGHT = 1.1;
 export declare const DEFAULT_FONT_FAMILY = "\"Noto Sans SC\", \"NotoSansSC\", \"\u9ED1\u4F53\", \"SimHei\", sans-serif";

package/dist/core/view/Page.d.ts

@@ -58,8 +58,8 @@ export declare class Page extends LayoutGroup<PageChild> implements IContainerMe
      */
     get contentMaxHeight(): number;
     /**
-     * 获取当前页面所有子元素的总高度
-     * 累加段落、表格等子组件的高度
+     * 获取当前页面正文实际占用高度
+     * 按段落、表格等子组件的底边计算，包含显式块间距
      */
     getContentHeight(): number;
     /** 获取当前是第几页 */

package/dist/core/view/base/LayoutGroup.d.ts

@@ -1,4 +1,12 @@
 import { LayoutNode, LayoutNodeOptions } from './LayoutNode';
+type PositionedLayoutNode = Pick<LayoutNode, 'y' | 'height'>;
+/**
+ * 按子节点的实际底边计算内容占位高度。
+ *
+ * 子节点可能带有块级间距形成的 y 偏移；仅累加 height 会漏掉这些间距，
+ * 导致后续文档流插入到已有内容之间。
+ */
+export declare function measureLayoutContentHeight(children: readonly PositionedLayoutNode[]): number;
 /**
  * 布局容器配置
  */
@@ -68,6 +76,8 @@ export declare abstract class LayoutGroup<T extends LayoutNode = LayoutNode> ext
      * 获取子节点数量
      */
     getChildCount(): number;
+    /** 获取所有子节点在当前容器中实际占用的纵向高度。 */
+    protected getChildrenContentHeight(): number;
     /**
      * 获取第一个子节点
      */
@@ -109,3 +119,4 @@ export declare abstract class LayoutGroup<T extends LayoutNode = LayoutNode> ext
      */
     filterChildren(predicate: (child: T) => boolean): T[];
 }
+export {};

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

@@ -10,6 +10,8 @@ export interface IImageWidget extends IImageRun {
     /** 组件元数据 */
     widgetMeta?: WidgetMeta;
     signature?: string;
+    /** 无图签名时的验证时间 */
+    signTime?: number;
     pageWidgetMeta?: Record<string, any>;
     dataSlotIndex?: DataSlotIndex;
 }
@@ -19,6 +21,7 @@ export interface ImageWidgetOptions extends ImageRunOptions {
     /** 组件元数据 */
     widgetMeta?: WidgetMeta;
     signature?: string;
+    signTime?: number;
     pageWidgetMeta?: IImageWidget['pageWidgetMeta'];
     dataSlotIndex?: DataSlotIndex;
 }
@@ -30,6 +33,7 @@ export declare class ImageWidget extends ImageRun implements IImageWidget {
     valuePath?: string;
     widgetMeta?: WidgetMeta;
     signature?: string;
+    signTime?: number;
     pageWidgetMeta?: IImageWidget['pageWidgetMeta'];
     dataSlotIndex?: DataSlotIndex;
     constructor(options: ImageWidgetOptions);

package/dist/core/view/utils/TextUtil.d.ts

@@ -66,17 +66,9 @@ export declare class TextUtil {
      * @returns
      */
     private static getMeasureCacheKey;
-    /** 历史默认西文栈：仅黑体垂直定位参照，保持与旧版观感一致 */
-    private static readonly VERTICAL_METRICS_REF_FONT;
-    /**
-     * 是否为文档黑体（Noto Sans SC）；宋体/楷体不走 Roboto 垂直参照
-     */
-    private static isHeitiDocumentFontFamily;
     /**
      * 计算字体度量 ascent / descent
-     *
-     * 黑体：用 Roboto 栈的 'Hg' + actualBoundingBox 做垂直定位（接近旧默认观感）。
-     * 宋体/楷体/其它：用自身字体度量。
+     * 与屏显/PDF 绘制字体一致，直接用文档 fontFamily 度量（黑体为 Noto Sans SC）。
      */
     static getFontMetrics(payload: Konva.TextConfig): {
         ascent: number;