@gct-paas/word 0.1.38 → 0.1.41

package/dist/runtime/_register_/runtime/SuiteRuntime.d.ts

@@ -28,6 +28,10 @@ export declare class SuiteRuntime implements FieldModelQuery {
     getFieldByKeyAsync(modelKey: ModelKey, key: string): FieldMeta | undefined;
     getFieldByIdAsync(modelKey: ModelKey, id: string): FieldMeta | undefined;
     getModel(modelKey: ModelKey): ModelMeta | undefined;
+    /**
+     * 确保主模型字段已拉取并写入缓存（避免 preload 与文档 immediate 加载竞态）。
+     */
+    ensureModelFieldsReady(modelKey: ModelKey): Promise<void>;
     getMasterSlaveFieldList(modelKey: ModelKey): FieldMeta[];
     reloadFields(modelKey: ModelKey): Promise<import('../../../capabilities/model-field-runtime').FieldListResult>;
     reloadModel(modelKey: ModelKey): Promise<[ModelMeta | undefined, import('../../../capabilities/model-field-runtime').FieldListResult]>;

package/dist/runtime/interface/change-diff.d.ts

@@ -1,3 +1,4 @@
+import { SubTableInfo } from '../../sdk/types';
 interface WidgetFieldMeta {
     id: string;
     metaKey: string;
@@ -22,5 +23,6 @@ export declare function buildFieldChangeList(params: {
     baselineData: Record<string, any> | undefined;
     currentData: Record<string, any> | undefined;
     widgetMetaMap?: WidgetFieldMetaMap;
+    subTableInfoList?: SubTableInfo[];
 }): FieldChangeItem[];
 export {};

package/dist/sdk/doc-runtime/check-table/map-check-table-item-infos.d.ts

@@ -1,5 +1,5 @@
 import { CheckTableItemInfosPayload } from './types';
-/** 从检验项详情推导每张检验表需要扩的主体行数 */
+/** 从检验项详情推导每张检验表需要扩的主体行数（仅检验项条数，不含关联轴铺砖槽位） */
 export declare function resolveItemCountByRegionId(runtimeJson: unknown, infos: CheckTableItemInfosPayload): Record<string, number>;
 /**
  * 将接口返回的检验项配置写入 defaults（展开为 $.f_jianyan1[0].type_ 等字段路径）。

package/dist/sdk/doc-runtime/composables/useDocOperations.d.ts

@@ -2,10 +2,12 @@ import { ShallowRef } from 'vue';
 import { Doc } from '../../../core';
 import { FieldChangeItem, WidgetFieldMetaMap } from '../../../runtime/interface/change-diff';
 import { DesignerValidationResult } from '../../types/designer-validation';
+import { SubTableInfo } from '../../types';
 /** 数据变更基线上下文 */
 export interface DocBaselineContext {
     baselineSnapshot: Record<string, any> | undefined;
     widgetMetaMap: WidgetFieldMetaMap;
+    subTableInfoList: SubTableInfo[];
 }
 export interface DocUnsavedChanges {
     /** 是否存在未保存改动 */

package/dist/sdk/doc-runtime/utils/wait-for-data-settle.d.ts

@@ -0,0 +1,8 @@
+import { Doc } from '../../../core';
+/**
+ * 等待 Vue 响应式与 DataManager 后置流水线（依赖 / enrich / emit 队列）完成一轮 settle。
+ * 与 refreshData 收尾一致，避免过早读取 rawData 或误判 dirty。
+ */
+export declare function waitForDataManagerSettle(): Promise<void>;
+/** 将当前 rawData 写入 initRawDataSnapshot，供 getUnsavedChanges({ includeRawData: true }) 比对 */
+export declare function syncInitRawDataSnapshot(doc: Doc): void;

package/dist/sdk/engine/index.d.ts

@@ -12,4 +12,3 @@ export { useDocumentFactory } from '../doc-runtime/factories/useDocumentFactory'
 export { useDocRuntimeProvider } from '../doc-runtime/composables/useDocRuntimeProvider';
 export { useDocOperations } from '../doc-runtime/composables/useDocOperations';
 export { useDocController } from '../doc-runtime/composables/useDocController';
-export { getSubmitFormData } from '../../utils/func/render';

package/dist/sdk/types/field-model-query.d.ts

@@ -14,6 +14,8 @@ export interface FieldModelQuery {
     getFieldByIdAsync(modelKey: ModelKey, id: string): FieldMeta | undefined;
     getModel(modelKey: ModelKey): ModelMeta | undefined;
     getMasterSlaveFieldList(modelKey: ModelKey): FieldMeta[];
+    /** 拉取并缓存模型字段（幂等，有缓存则跳过请求） */
+    ensureModelFieldsReady(modelKey: ModelKey): Promise<void>;
     reloadFields(modelKey: ModelKey): Promise<FieldListResult>;
     reloadModel(modelKey: ModelKey): Promise<[ModelMeta | undefined, FieldListResult]>;
 }

package/dist/sdk/types/index.d.ts

@@ -10,6 +10,16 @@ import { DesignerValidationResult } from './designer-validation';
 export type { DocUnsavedChanges, DocGetUnsavedChangesOptions, } from '../doc-runtime/composables/useDocOperations';
 export type { DesignerValidationError, DesignerValidationResult, DesignerValidationSource, } from './designer-validation';
 export type { FieldModelQuery } from './field-model-query';
+/** 文档模型层子表元信息 */
+export interface SubTableInfo {
+    field: string;
+    subType: string;
+    name: string;
+    key: string;
+    /** 二维/检验表交叉区 rawData key，形如 f_sub:f_link */
+    crossKey?: string;
+    [key: string]: any;
+}
 /** 字段权限信息 */
 export interface FieldPermissionInfo {
     modelKey: string;
@@ -62,18 +72,17 @@ export interface DocControllerMethods extends DocOperations {
     setModel(model: DocModel): void;
     /** 获取当前文档原始填报数据快照 */
     rawData(): Recordable<any>;
+    /**
+     * 将填报数据转为提交结构（二维交叉区合并回子表、清理前端占位字段等）。
+     * 未传 formData 时使用当前 rawData。
+     */
+    getSubmitFormData(formData?: Record<string, any>): Record<string, any>;
     /** 设置当前文档整个原始数据 */
     setRawData(data: Record<string, any>, defaultDataMap?: Record<string, any>): void;
     /** 根据 jsonpath 批量设置文档数据 */
     setMultiple(updates: Record<string, any>): boolean;
     /** 获取当前文档的所有子表信息 */
-    getSubTableInfoList(): Array<{
-        field: string;
-        subType: string;
-        name: string;
-        key: string;
-        [key: string]: any;
-    }>;
+    getSubTableInfoList(): SubTableInfo[];
     /** 手动触发文档重新加载 */
     reload(): void;
     /**
@@ -198,12 +207,14 @@ export interface UseWordOptions {
     /** 指定渲染模式 */
     renderModeType?: DocModeType;
     /**
-     * 文档接口请求成功且引擎挂载完成后的回调（每轮成功加载触发一次）。
+     * 文档接口请求成功且引擎挂载完成、dataManager 首轮 settle 后的回调（每轮成功加载触发一次）。
+     * 此时 controller.rawData() 已与内部 initRawDataSnapshot 对齐，适合做外部自动保存基线。
      * 不会在 requestId 为空、请求被丢弃、或初始化抛错时调用。
      */
     onDocumentLoadSuccess?: () => void;
     /**
-     * 文档数据发生变化（防抖 300ms 后）的回调，可在此处触发外部自动保存通知。
+     * 文档数据发生变化（防抖 300ms 后）且存在未保存改动时的回调，可触发外部自动保存轮询。
+     * 保存成功后请调用 controller.markAsSaved()，避免重复通知。
      * 例：() => emitter.emit(EmitterEnum.__on_looper_auto_save)
      */
     onLooperAutoSave?: (payload?: {

package/dist/utils/func/render.d.ts

@@ -1,5 +1,5 @@
 import { FieldMeta } from '../../capabilities/model-field-runtime';
-import { Wr } from '../../core/model/document';
+import { SubTableInfo } from '../../sdk/types';
 export declare function transformSourceData(sourceData: any, i18nData: any): any;
 export declare function transformSourceDataList(data: any[], dict?: {}): {
     _DICT: object;
@@ -13,7 +13,15 @@ export declare function conversionFormState(payload: {
     /** 渲染数据列表 */
     interfaceData: any;
     /** 主要是 WrField */
-    instances: Wr[];
+    subTableInfoList: {
+        field: string;
+        key: string;
+        name: string;
+        subType: string;
+        crossKey?: string;
+    }[];
 }): Record<string, any>;
+/** 从模型子表元信息解析二维/检验表交叉区 key；无元信息时回退为 formData 中含 `:` 的 key */
+export declare function resolveSubmitCrossKeys(formData: Record<string, any>, subTableInfoList?: SubTableInfo[]): string[];
 /** 数据转成真实提交数据 */
-export declare function getSubmitFormData(formData: any): any;
+export declare function getSubmitFormData(formData: any, subTableInfoList?: SubTableInfo[]): any;

package/dist/word.css

@@ -8170,17 +8170,17 @@ textarea[data-v-57fe54a3]::placeholder {
 .table-action .row-headers .row-header:last-child .row-add-btn[data-v-c40eef9f] .gct-icon.bottom {
   transform: translateY(-100%);
 }
-.sub-table-action[data-v-a58c6b2e] {
+.sub-table-action[data-v-da25771b] {
   position: absolute;
   z-index: 999;
 }
-.sub-table-action-content[data-v-a58c6b2e] {
+.sub-table-action-content[data-v-da25771b] {
   display: flex;
   align-items: center;
   gap: 4px;
   padding: 4px;
 }
-.action-group[data-v-a58c6b2e] {
+.action-group[data-v-da25771b] {
   display: flex;
   align-items: center;
   gap: 4px;
@@ -8188,15 +8188,15 @@ textarea[data-v-57fe54a3]::placeholder {
   border-radius: 4px;
   overflow: hidden;
 }
-.action-group .sub-table-btn[data-v-a58c6b2e] {
+.action-group .sub-table-btn[data-v-da25771b] {
   border-radius: 0;
 }
-.sub-table-action-bar[data-v-a58c6b2e],
-.sub-table-action-content[data-v-a58c6b2e] {
+.sub-table-action-bar[data-v-da25771b],
+.sub-table-action-content[data-v-da25771b] {
   pointer-events: auto;
   user-select: none;
 }
-.sub-table-btn[data-v-a58c6b2e] {
+.sub-table-btn[data-v-da25771b] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -8206,25 +8206,25 @@ textarea[data-v-57fe54a3]::placeholder {
   border-radius: 4px;
   cursor: pointer;
 }
-.sub-table-btn.delete-icon[data-v-a58c6b2e] {
+.sub-table-btn.delete-icon[data-v-da25771b] {
   border: none;
   background-color: #ff7875;
 }
-.insert-row-container[data-v-a58c6b2e] {
+.insert-row-container[data-v-da25771b] {
   padding: 6px;
 }
-.insert-row-container .insert-row-item[data-v-a58c6b2e] {
+.insert-row-container .insert-row-item[data-v-da25771b] {
   display: flex;
   align-items: center;
   gap: 8px;
   padding: 5px 8px;
   cursor: pointer;
 }
-.insert-row-container .insert-row-item[data-v-a58c6b2e]:hover {
+.insert-row-container .insert-row-item[data-v-da25771b]:hover {
   background: rgba(13, 13, 13, 0.06);
   border-radius: 4px;
 }
-.insert-row-container .insert-row-item .title[data-v-a58c6b2e] {
+.insert-row-container .insert-row-item .title[data-v-da25771b] {
   font-size: 14px;
   line-height: 28px;
   color: #0d0d0d;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gct-paas/word",
-  "version": "0.1.38",
+  "version": "0.1.41",
   "description": "GCT 在线 word",
   "keywords": [
     "vue",
@@ -34,11 +34,11 @@
   "scripts": {
     "build": "vite build",
     "lint": "eslint . --ext .vue,.js,.jsx,.cjs,.mjs,.ts,.tsx --fix",
-    "version:beta": "npm version prerelease --preid=beta --no-git-tag-version",
-    "version:release": "npm version patch --no-git-tag-version",
     "publish:beta": "pnpm run version:beta && pnpm run build && npm publish --registry=https://registry.npmjs.org/ --access public --tag beta",
     "publish:prod": "pnpm run version:release && pnpm run build && npm publish --registry=https://registry.npmjs.org/ --access public",
-    "test": "vitest run"
+    "test": "vitest run",
+    "version:beta": "npm version prerelease --preid=beta --no-git-tag-version",
+    "version:release": "npm version patch --no-git-tag-version"
   },
   "dependencies": {
     "@gct-paas/api": "0.1.0-word.7",
@@ -47,6 +47,7 @@
     "bignumber.js": "^9.3.1",
     "dayjs": "^1.11.19",
     "hotkeys-js": "4.0.0-beta.7",
+    "jsonpath-plus": "^10.4.0",
     "less": "^4.4.2",
     "lodash-es": "^4.17.21",
     "node-sql-parser": "^5.4.0",