@gct-paas/word 0.2.7-beta.0 → 0.2.7-beta.2

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

@@ -27,6 +27,8 @@ type __VLS_Props = {
     /** 选项列表最大高度 */
     listMaxHeight?: number | string;
     dropdownExtraProps?: Record<string, any>;
+    /** 下拉入口点击前校验；返回 false 时不展开菜单 */
+    beforeOpen?: () => boolean;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;

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

@@ -43,7 +43,7 @@ export declare function computeContainDisplaySize(natural: ImageSize, box: Image
 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, 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/command/commands/DeleteCol.d.ts

@@ -4,7 +4,7 @@ import { CommandBase, PostCommandContext } from '../base/CommandBase';
 /**
  * 表格列删除命令
  *
- * 删除指定索引处的列
+ * 删除指定列，或当前选区中同一表格的连续多列
  */
 export declare class DeleteCol extends CommandBase<'deleteCol'> {
     constructor(doc: Doc, payload?: CommandPayloadMap['deleteCol']);

package/dist/core/command/commands/InsertTable.d.ts

@@ -5,7 +5,6 @@ import { Wtbl } from '../../model/document';
 export declare class InsertTable extends CommandBase<'insertTable'> {
     constructor(doc: Doc, payload?: CommandPayloadMap['insertTable']);
     protected createTable(width: number, rowCount?: number, colCount?: number): Wtbl;
-    private resolveBlockedTableLabel;
     protected execute(): Promise<PostCommandContext>;
     private insertAtCursor;
     private insertIntoBody;

package/dist/core/command/types.d.ts

@@ -1,4 +1,5 @@
 import { VOrientationType } from '../../domain/constants/enum';
+import { FIELD_TYPE } from '../../domain/field/field-type';
 import { Doc } from '../view/Doc';
 import { WidgetMeta } from '../widget/widget-meta';
 import { WordHighlight } from '../model/types';
@@ -91,6 +92,7 @@ export type CommandPayloadMap = {
     };
     commitValidateNumber: CommandPayload & {
         valuePath?: string;
+        fieldType?: FIELD_TYPE;
         type?: 'fw:number' | 'fw:double';
         digits?: number;
         roundingMode?: 1 | 4 | 6;

package/dist/core/data/formula/business-functions.d.ts

@@ -1,4 +1,10 @@
+export { setFormulaParamsConfig } from './formula-params-cache';
 export type FormulaRegister = (name: string, executor: (...args: any[]) => any) => void;
-/** 更新当前表单的参数配置；未传入配置时清空上次的数据。 */
-export declare function setFormulaParamsConfig(paramsConfig?: Record<string, any> | null): void;
+interface DeviceParamConfig {
+    customFieldKey: string;
+    lowerLimit?: number | string | null;
+    upperLimit?: number | string | null;
+}
+type FetchDeviceParamLimits = (id: any) => Promise<DeviceParamConfig[] | null>;
+export declare function configureDeviceParamCheck(fetcher: FetchDeviceParamLimits): void;
 export declare function registerFormulaFuncs(register?: FormulaRegister): void;

package/dist/core/data/formula/formula-params-cache.d.ts

@@ -0,0 +1,15 @@
+interface FormulaParam {
+    customFieldKey: string;
+    lowerLimit?: number | string | null;
+    upperLimit?: number | string | null;
+}
+export declare const currentParamsConfig: {
+    readonly routingParamList: FormulaParam[];
+    readonly inspectionParamList: FormulaParam[];
+    readonly deviceParamList: FormulaParam[];
+};
+/** Excel、Word 共用参数；空配置也要覆盖旧值。 */
+export declare function setFormulaParamsConfig(paramsConfig?: Record<string, any> | null): void;
+/** 随应用绑定一次失效通知，不包装或替换宿主计算函数。 */
+export declare function bindFormulaCacheInvalidation(value: unknown): void;
+export {};

package/dist/core/model/logic/subtable/shared/dataGroupSlotCount.d.ts

@@ -1,3 +1,4 @@
+import { Wtbl } from '../../../document/Wtbl';
 /** 表格矩形范围（含起止行列，均为闭区间） */
 export type TableRange = {
     start: {
@@ -9,10 +10,45 @@ export type TableRange = {
         col: number;
     };
 };
+type AxisRange = {
+    start: number;
+    end: number;
+};
+export type MergeAwareDataGroupSlot = {
+    range: TableRange;
+    /** 目标可见行带与模板行带的对应关系。 */
+    rowBands: Array<{
+        source: AxisRange;
+        target: AxisRange;
+    }>;
+    /** 目标可见列带与模板列带的对应关系。 */
+    colBands: Array<{
+        source: AxisRange;
+        target: AxisRange;
+    }>;
+};
+export type MergeAwareDataGroupCellMapping = {
+    row: number;
+    col: number;
+    sourceRow: number;
+    sourceCol: number;
+    dataIndex: number;
+};
+/**
+ * 按可见合并单元格枚举铺砖槽位。
+ *
+ * Word 底层的 gridCol/gridRow 数量不一定等于用户看到的单元格数量。这里先把父区域
+ * 转换为逻辑行列带，再按原有的先横后纵/先纵后横顺序铺砖。返回 undefined 表示合并
+ * 结构不规则，应回退到传统的底层网格矩形算法。
+ */
+export declare function getMergeAwareDataGroupSlots(table: Wtbl, range: TableRange, itemRange: TableRange, fillDirection?: 'x' | 'y'): MergeAwareDataGroupSlot[] | undefined;
+/** 将可见槽位展开为每个底层网格单元格的数据索引和模板坐标。 */
+export declare function getMergeAwareDataGroupCellMappings(slots: MergeAwareDataGroupSlot[]): MergeAwareDataGroupCellMapping[];
 /**
  * 计算数据分组 / 动态关联在版面中可铺砖的数据槽位数（含模板块 dataIndex 0）。
  * 逻辑与 TableExpander.computeDataIndexMap 中铺砖循环一致。
  */
-export declare function countDataGroupSlots(range: TableRange, itemRange: TableRange, fillDirection?: 'x' | 'y'): number;
+export declare function countDataGroupSlots(range: TableRange, itemRange: TableRange, fillDirection?: 'x' | 'y', table?: Wtbl): number;
 /** 检验表 / 二维表动态关联：itemRegion 行范围可能超出子表主体 */
 export declare function expandDataGroupRowRange(parent: TableRange, itemRange: TableRange): TableRange;
+export {};

package/dist/domain/field/form-value.d.ts

@@ -80,6 +80,12 @@ type NormalizeNumberTextResult = {
  * - fw:number 根据 digits 执行整数化或小数截断
  */
 export declare function normalizeNumberTextOnCommit(rawText: string, options: NormalizeNumberTextOptions): NormalizeNumberTextResult;
+/** 配置检查：返回错误说明，不抛异常。 */
+export declare function getNumberInputConfigError(fieldType: FIELD_TYPE | undefined, digits: unknown): string | null;
+/** 填报失焦时处理数字长度和整数上限。 */
+export declare function normalizeNumberInputOnBlur(rawText: string, options: NormalizeNumberTextOptions, fieldType?: FIELD_TYPE): NormalizeNumberTextResult & {
+    configError?: string;
+};
 export declare function buildNumberFormats(props: any, type: NumberFieldType): {
     type: NumberFieldType;
     digits: number | undefined;

package/dist/domain/table/business/device/maintenance/profile/field-keys.d.ts

@@ -1,8 +1,8 @@
 /** 设备保养表内置字段 key */
 export declare const F: {
-    /** 点检日期 */
+    /** 保养日期 */
     readonly inspectionDate: "inspection_date_";
-    /** 点检人 */
+    /** 保养人 */
     readonly inspector: "inspector_";
     /** 复核人 */
     readonly reviewer: "reviewer_";

package/dist/domain/table/business/material/material-substitution/profile/field-keys.d.ts

@@ -37,3 +37,5 @@ export declare const DISABLED_INPUT_FIELDS: readonly ["source_material_no_", "so
 export declare const CLEAR_ON_SOURCE_PRODUCT_EMPTY: readonly ["source_material_no_", "source_product_id_name_", "source_product_id_code_", "source_product_id_spec_", "source_qty_consumed_"];
 /** 替换物料批号清空 / 手输时需清空的物料字段 */
 export declare const CLEAR_ON_TARGET_MATERIAL_NO_EMPTY: readonly ["target_product_id_name_", "target_product_id_code_", "target_product_id_spec_"];
+/** 替换料清空时同步清除批次、数量和物料信息。 */
+export declare const CLEAR_ON_TARGET_PRODUCT_EMPTY: readonly ["target_material_no_", "target_product_id_name_", "target_product_id_code_", "target_product_id_spec_", "target_qty_consumed_"];

package/dist/domain/table/business/material/material-substitution/runtime/row-change-handlers.d.ts

@@ -1,3 +1,4 @@
 import { Doc } from '../../../../../../core';
 export declare function handleTargetMaterialNoChange(doc: Doc, subFieldKey: string, rowIndex: number): void;
 export declare function handleSourceProductChange(doc: Doc, subFieldKey: string, rowIndex: number): void;
+export declare function handleTargetProductChange(doc: Doc, subFieldKey: string, rowIndex: number): void;

package/dist/domain/table/design/validate-nested-table-insert.d.ts

@@ -0,0 +1,3 @@
+import { Wtc } from '../../../core/model/document';
+/** 返回普通表格插入被当前单元格阻止时的原有提示。 */
+export declare function getNestedTableInsertWarning(hostCell: Wtc): string | undefined;

package/dist/domain/table/index.d.ts

@@ -16,4 +16,5 @@ export * from './design/hooks/on-repeating-default-props';
 export * from './design/hooks/on-bounded-default-props';
 export * from './design/validate-table-selection';
 export * from './design/validate-nested-table-region';
+export * from './design/validate-nested-table-insert';
 export * from './business/device/signature-lock';

package/dist/domain/table/runtime/option-fill-updates.d.ts

@@ -0,0 +1,6 @@
+interface OptionFillWriter {
+    setMultiple(updates: Record<string, unknown>, source: 'user' | 'enrichment'): unknown;
+}
+/** 选中值保留用户事件；同行回填使用 enrichment，避免触发被填字段的手工变更副作用。 */
+export declare function applyOptionFillUpdates(writer: OptionFillWriter, nextValues: Record<string, unknown>, optionFill: Record<string, unknown>, inputValues: Record<string, unknown>, optionFillSource?: 'user' | 'enrichment'): void;
+export {};

package/dist/domain/table/runtime/table-runtime.d.ts

@@ -61,6 +61,8 @@ export declare class TableRuntime {
      * 解析业务表字段的下拉数据源 / 列覆盖（selectSource）。
      */
     resolveSelectSource(options: ResolveSelectSourceOptions): SelectSourceDef | null;
+    /** 默认保留原来的 user 写入，仅显式配置的业务字段改变回填事件来源。 */
+    resolveOptionFillSource(options: ResolveSelectSourceOptions): 'user' | 'enrichment';
     /**
      * 下拉选中后从选项反向回填同行字段，供 onChange 使用。
      */

package/dist/domain/table/types.d.ts

@@ -371,6 +371,8 @@ export interface BusinessFieldProfile {
     select?: SelectBehaviorDef;
     /** 选中下拉项后，从 option 数据同步填充同行多个字段 */
     fillFromOption?: FieldOptionFillDef[];
+    /** 同行回填的事件来源；默认沿用 user，仅显式配置的字段使用 enrichment。 */
+    optionFillSource?: 'user' | 'enrichment';
     /**
      * 按表实例 props 动态解析回填规则；返回值优先于 fillFromOption。
      * 返回 null/undefined 时回退 fillFromOption。