@gct-paas/word 0.1.35 → 0.1.36

package/README.md

@@ -289,6 +289,12 @@ const customPlugin: WordSuitePlugin = {
 - 检查是否在 `setupPlatformAdapters` 初始化阶段完成注册
 - 检查 `suiteKey` 与已注册插件 `key` 是否一致
 
+## 本仓库开发与发布
+
+维护 `@gct-paas/word` 的分支策略、版本号与 npm 发布约定见仓库根目录文档：
+
+[开发与发布流程](../../docs/development-and-release.md)
+
 ## License
 
 MIT

package/dist/index.es.js

@@ -56257,7 +56257,7 @@ function getDataIndexLayersMap({
   convertExtraProps
 }) {
   const getDataIndex = (cell) => {
-    return isLinkSubTableType(type4) && isDesign ? cell.subRenderer?.xDataIndex : cell.subRenderer?.yDataIndex;
+    return isLinkSubTableType(type4) && isDesign ? cell.subRenderer?.xDataIndex : cell.subRenderer?.yDataIndex ?? cell.subRenderer?.dataIndex;
   };
   const getAllDataIndex = (cell) => {
     const { dataIndex, xDataIndex, yDataIndex } = cell?.subRenderer || {};
@@ -58200,6 +58200,34 @@ function buildFieldChangeList(params) {
   }
   return changeList;
 }
+function createDesignerValidationResult(errors) {
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+function validateDocDesigner(doc) {
+  if (!doc?.model) {
+    return createDesignerValidationResult([]);
+  }
+  const errors = [];
+  const children = doc.model.document.body.children || [];
+  const fixedTableRegions = children.filter((w2) => w2.name === "w:tbl" && w2.hasBounded).flatMap((w2) => w2.bounded);
+  if (fixedTableRegions.some((r) => !r.itemRegion)) {
+    errors.push({
+      code: "item-region-required",
+      message: "请给固定表设置数据分组",
+      source: "doc"
+    });
+  }
+  return createDesignerValidationResult(errors);
+}
+function validateDesigner(doc) {
+  const errors = [];
+  const docResult = validateDocDesigner(doc);
+  errors.push(...docResult.errors);
+  return createDesignerValidationResult(errors);
+}
 function useDocOperations(docRef) {
   function getDoc() {
     return docRef.value ?? null;
@@ -58217,6 +58245,9 @@ function useDocOperations(docRef) {
     if (!doc) return null;
     return validateAllFields(doc);
   }
+  function validateDesigner$1() {
+    return validateDesigner(getDoc());
+  }
   function exportModel() {
     return getDoc()?.model?.toXmlJson() ?? null;
   }
@@ -58296,6 +58327,7 @@ function useDocOperations(docRef) {
   }
   return {
     validate,
+    validateDesigner: validateDesigner$1,
     exportModel,
     getDocumentAttachmentPaths,
     enterBaseline,
@@ -58363,6 +58395,9 @@ function useDocController(factory2, ops) {
         validate() {
           return ops.validate();
         },
+        validateDesigner() {
+          return ops.validateDesigner();
+        },
         exportModel() {
           return ops.exportModel();
         },

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

@@ -12,6 +12,5 @@ import { DocOperations } from './useDocOperations';
  * const factory = useDocumentFactory(docProps, docPayload);
  * const ops = useDocOperations(factory.doc);
  * const controller = useDocController(factory, ops);
- * // controller.value?.validate()
  */
 export declare function useDocController(factory: DocumentFactory, ops: DocOperations): ShallowRef<DocController | null>;

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

@@ -1,6 +1,7 @@
 import { ShallowRef } from 'vue';
 import { Doc } from '../../../core';
 import { FieldChangeItem, WidgetFieldMetaMap } from '../../../runtime/interface/change-diff';
+import { DesignerValidationResult } from '../../types/designer-validation';
 /** 数据变更基线上下文 */
 export interface DocBaselineContext {
     baselineSnapshot: Record<string, any> | undefined;
@@ -18,6 +19,8 @@ export interface DocGetUnsavedChangesOptions {
 export interface DocOperations {
     /** 校验所有字段，返回错误映射或 null（通过） */
     validate(): Promise<Record<string, string[]> | null>;
+    /** 设计态保存前校验（文档配置 + 数据加载模板配置等） */
+    validateDesigner(): DesignerValidationResult;
     /** 获取文档模型的 XmlJson（用于保存） */
     exportModel(): any;
     /**

package/dist/sdk/doc-runtime/validators/validate-designer.d.ts

@@ -0,0 +1,4 @@
+import { Doc } from '../../../core';
+import { DesignerValidationResult } from '../../types/designer-validation';
+/** 聚合设计态校验：文档模型 */
+export declare function validateDesigner(doc: Doc | null): DesignerValidationResult;

package/dist/sdk/doc-runtime/validators/validate-doc-designer.d.ts

@@ -0,0 +1,4 @@
+import { Doc } from '../../../core';
+import { DesignerValidationResult } from '../../types/designer-validation';
+/** 校验文档模型中的设计态配置 */
+export declare function validateDocDesigner(doc: Doc | null): DesignerValidationResult;

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

@@ -4,7 +4,7 @@
  */
 export { DocModeTypeConst, PageSizeEnumConst, BuiltinComponentTypeConst } from '../../core';
 export type { DocModeType, CompleteComponentType, BuiltinComponentType } from '../../core';
-export type { DocController, DocQueryAPI, WordRuntime, DocInfo, DocRuntimeMeta, DocRuntimeMetaHandleInfo, DocUnsavedChanges, DocGetUnsavedChangesOptions, UseWordProps, UseWordOptions, FieldModelQuery, } from '../types';
+export type { DocController, DocQueryAPI, WordRuntime, DocInfo, DocRuntimeMeta, DocRuntimeMetaHandleInfo, DocUnsavedChanges, DocGetUnsavedChangesOptions, DesignerValidationError, DesignerValidationResult, DesignerValidationSource, UseWordProps, UseWordOptions, FieldModelQuery, } from '../types';
 export type { Execute } from '../doc-runtime/factories/useDocumentFactory';
 export { useWord } from '../doc-runtime/useWord';
 export { useDocSuite } from '../doc-runtime/composables/useDocSuite';

package/dist/sdk/types/designer-validation.d.ts

@@ -0,0 +1,16 @@
+/** 设计态校验错误来源 */
+export type DesignerValidationSource = 'doc';
+/** 单条设计态校验错误 */
+export interface DesignerValidationError {
+    code: string;
+    message: string;
+    source: DesignerValidationSource;
+    /** 便于定位 */
+    path?: string;
+}
+/** 设计态校验结果 */
+export interface DesignerValidationResult {
+    valid: boolean;
+    errors: DesignerValidationError[];
+}
+export declare function createDesignerValidationResult(errors: DesignerValidationError[]): DesignerValidationResult;

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

@@ -6,7 +6,9 @@ import { DocBaselineContext, DocUnsavedChanges, DocOperations, DocGetUnsavedChan
 import { OnlineFormInstanceResponse, OnlineFormTmplResponse } from '@gct-paas/api/apaas';
 import { FieldChangeItem } from '../../runtime/interface/change-diff';
 import { FormTmplConfigController } from '../../suites/edhr/panel-schema/data-load/hooks/form-tmpl-config';
+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 FieldPermissionInfo {
@@ -81,6 +83,8 @@ export interface DocControllerMethods extends DocOperations {
     refreshData(): Promise<void>;
     /** 校验全量字段，返回错误映射；通过时返回 null */
     validate(): Promise<Record<string, string[]> | null>;
+    /** 设计态保存前校验；通过时 valid 为 true */
+    validateDesigner(): DesignerValidationResult;
     /** 导出当前文档模型 XmlJson（常用于保存） */
     exportModel(): any;
     /** 获取文档内附件路径列表（默认提取 fw:file 组件） */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gct-paas/word",
-  "version": "0.1.35",
+  "version": "0.1.36",
   "description": "GCT 在线 word",
   "keywords": [
     "vue",
@@ -34,8 +34,10 @@
   "scripts": {
     "build": "vite build",
     "lint": "eslint . --ext .vue,.js,.jsx,.cjs,.mjs,.ts,.tsx --fix",
-    "publish:beta": "pnpm build && npm publish --registry=https://registry.npmjs.org/ --access public --tag beta",
-    "publish:prod": "pnpm build && npm publish --registry=https://registry.npmjs.org/ --access public",
+    "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"
   },
   "dependencies": {