@gct-paas/word 0.1.45 → 0.1.46

package/dist/runtime/_register_/composables/panel/useActivePanel.d.ts

@@ -12,5 +12,5 @@ export declare function useActivePanel(): {
     } | null | undefined>;
     widget: import('vue').ComputedRef<any>;
     schemaKey: import('vue').ComputedRef<string | null>;
-    schema: import('vue').ComputedRef<import('../../../../capabilities/panel/schema/types').PanelSchema | null | undefined>;
+    schema: import('vue').ComputedRef<import('../../../..').PanelSchema | null | undefined>;
 };

package/dist/runtime/interface/render.d.ts

@@ -8,6 +8,7 @@ import { FieldMeta } from '../../capabilities/model-field-runtime';
  */
 export declare function getDefaultQueryIdsByFieldType(payload: {
     materialNumber?: string;
+    mainRelatedLotNumber?: string;
     productId?: string;
     routingOperation?: string;
     manufacturingOrderId?: string;
@@ -15,6 +16,7 @@ export declare function getDefaultQueryIdsByFieldType(payload: {
     defaultOrgId?: string;
 }): {
     material_no: string | undefined;
+    related_lot_no: string | undefined;
     product: string | undefined;
     routing_operation: string | undefined;
     mfg_order: string | undefined;

package/dist/runtime/renderer/dropdowns/components/tables/composables/useTableDropdown.d.ts

@@ -11,4 +11,5 @@ export declare function useTableDropdown(props: any): {
     message: import('vue').ComputedRef<string>;
     enableLinkage: import('vue').ComputedRef<boolean>;
     clearValuePath: import('vue').ComputedRef<string | undefined>;
+    allowManualInput: import('vue').ComputedRef<boolean>;
 };

package/dist/runtime/renderer/dropdowns/components/tables/strategy/selectStrategy.d.ts

@@ -8,6 +8,8 @@ export interface SelectStrategy {
     linkFieldId?: string;
     /** 数据联动，切换分类进行清空原因数据 */
     clearFieldId?: string;
+    /** 搜索无匹配时允许将输入关键字作为值写入 */
+    allowManualInput?: boolean;
     buildQuery?: (keyword: string, isLinkQuery?: boolean) => {
         queryData?: Record<string, any>;
         exp?: string;

package/dist/sdk/doc-runtime/device-link/resolve-field-focus-context.d.ts

@@ -0,0 +1,15 @@
+import { Doc } from '../../../core';
+/** 字段获得/失去焦点时的上下文 */
+export interface FieldFocusContext {
+    modelId: string;
+    modelFieldKey: string;
+    runtimeValuePath: string;
+    field: string;
+    modelKey: string;
+    subModelKey?: string;
+    realRowIndex?: number;
+}
+/**
+ * 根据 focusModelId 解析字段焦点上下文；无绑定字段时返回 null。
+ */
+export declare function resolveFieldFocusContext(doc: Doc, modelId: string): FieldFocusContext | null;

package/dist/sdk/doc-runtime/device-link/useDeviceFieldFocusBridge.d.ts

@@ -0,0 +1,7 @@
+import { IFormTmplConfigController } from '../../types/form-tmpl-config.types';
+import { DocumentFactory } from '../factories/useDocumentFactory';
+/**
+ * 监听 focusModelId 变化，驱动设备互联焦点 state 与缓存回填。
+ * init 由外部通过 useFormTmplConfigInit 按 tmplId 负责，不在此处调用。
+ */
+export declare function useDeviceFieldFocusBridge(factory: DocumentFactory, formTmplConfig: IFormTmplConfigController): void;

package/dist/sdk/doc-runtime/device-link/useFormTmplAndModelInit.d.ts

@@ -0,0 +1,15 @@
+import { ShallowRef } from 'vue';
+import { DocController } from '../../types';
+/**
+ * 监听 docController 就绪，自动按 tmplId 初始化 form-tmpl、form-model  配置，避免重复 init。
+ *
+ * - 文档未就绪时不触发
+ * - 同一 tmplId 不会重复 init（换文档/requestId 变化时若 tmplId 变了则重新 init）
+ * - 返回 stop，可在组件卸载时手动停止监听（onUnmounted 时调用）
+ */
+export declare function useFormTmplAndModelInit(controller: ShallowRef<DocController | null>, options: {
+    formTmplConfigController?: any;
+    formModelConfigController?: any;
+}): {
+    stop: () => void;
+};

package/dist/sdk/doc-runtime/device-link/useFormTmplConfig.d.ts

@@ -0,0 +1,10 @@
+import { IFormTmplConfigController } from '../../types/form-tmpl-config.types';
+/**
+ * 表单模板里的设备互联模板配置（provide / inject）。
+ * 实例由 useWord 注入主工程 controller，word 包内不再内置默认实现。
+ */
+export declare function useFormTmplConfig(): {
+    provideController: (c: IFormTmplConfigController) => IFormTmplConfigController;
+    injectController: () => IFormTmplConfigController;
+    tryInjectController: () => IFormTmplConfigController | undefined;
+};

package/dist/sdk/doc-runtime/factories/document-initializer.d.ts

@@ -2,10 +2,26 @@ import { Doc } from '../../../core';
 import { DocInfo } from '../../types';
 import { DocModel } from '../../../core/model';
 import { IDocPayload, IDocProps, Execute } from './useDocumentFactory';
+import { DesignSuiteContext } from '../../../runtime/_register_/context/DesignSuiteContext';
 export interface InitializedDocument {
     doc: Doc;
     docInfo: DocInfo;
 }
+/**
+ * 全量替换 rawData 后补跑 enrich（超链接 _href_ 等）。
+ * setRawData 仅 emit('$')，不会按字段路径触发 PostChangePipeline。
+ */
+export declare function runDocumentPostLoadEnrichFlush(doc: Doc): Promise<void>;
+/**
+ * setRawData 会清空 depGraph / fieldRuntimeConfigByPath，已挂载的 overlay 不会再次 initDependency。
+ * 在 refreshData、controller.setRawData 等全量换数后调用，与首次挂载 overlay 行为对齐。
+ */
+export declare function reinitializeDocumentFieldDependencies(doc: Doc, ctx: DesignSuiteContext): Promise<void>;
+/**
+ * 全量 setRawData 后的统一收尾：依赖重算 → enrich（超链接 _href_ 等）→ 排版。
+ * 用于 refreshData、controller.setRawData（overlay 已挂载，不会再次 initDependency）。
+ */
+export declare function finalizeAfterRawDataReplace(doc: Doc, ctx: DesignSuiteContext): Promise<void>;
 /** 从 Doc 实例提取响应式页面快照（与 layout 同步，供 docInfo ref 驱动 Vue） */
 export declare function snapshotDocInfo(docInst?: Doc): DocInfo;
 export declare function initializeDocumentEngine(props: IDocProps, payload: IDocPayload, result: Execute): Promise<InitializedDocument>;

package/dist/sdk/doc-runtime/factories/useDocumentFactory.d.ts

@@ -73,6 +73,8 @@ export interface DocumentFactory {
      * 适用于保存后需要同步服务端最新实例状态与填报数据的场景。
      */
     refreshData(): Promise<void>;
+    /** 设计套件上下文（依赖注册、enrich manifest 等） */
+    ctx: DesignSuiteContext;
 }
 export interface Execute {
     /** 文档实例id或者文档模板id */

package/dist/sdk/doc-runtime/useWord.d.ts

@@ -3,14 +3,20 @@ import { WordRuntime, UseWordProps, UseWordOptions } from '../types';
  * Word 文档运行时入口
  * 返回值中的 controller 为异步就绪：首次渲染时可能为 null，待文档初始化后可用。
  * 业务侧调用 controller 方法前，需通过可选链或监听方式判断其是否已就绪。
+ * form-tmpl controller 由外部 new 后传入，word 内部只负责 provide 给数据加载面板、
+ * 以及驱动设备互联焦点桥接（focusModelId → deviceConnector → dataManager）。
  *
  * @returns WordRuntime - 运行时对象
  * @example
- * const { controller } = useWord(
- *   { requestId: 'xxx' },
- *   { factoryType: 'template', suiteKey: 'edhr', modelKey: 'fm_xxx' },
+ * const formTmpl = new FormTmplConfigController();
+ * const { controller, formTmplConfigController } = useWord(
+ *   { requestId: instanceId },
+ *   {
+ *     factoryType: 'instance',
+ *     suiteKey: 'edhr',
+ *     modelKey: 'fm_xxx',
+ *     formTmplConfigController: formTmpl,
+ *   },
  * );
- * await controller.value?.validate();
- * controller.value?.reload();
  */
 export declare function useWord(props: UseWordProps, options: UseWordOptions): WordRuntime;

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

@@ -12,3 +12,4 @@ 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 { useFormTmplAndModelInit } from '../doc-runtime/device-link/useFormTmplAndModelInit';

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

@@ -12,4 +12,5 @@ import { WordSuitePlugin } from '../types';
 export declare function registerSuite(plugin: WordSuitePlugin): void;
 export type { WordSuitePlugin } from '../types';
 export { edhrSuitePlugin } from '../../suites/edhr';
-export { useFormTmplConfig } from '../../suites/edhr/panel-schema/data-load/hooks/form-tmpl-config';
+export { registerPanelSchemas } from './register-panel-schemas';
+export type { PanelSchema, PanelSchemaKey, PanelSchemaMap } from './register-panel-schemas';

package/dist/sdk/plugins/register-panel-schemas.d.ts

@@ -0,0 +1,9 @@
+import { PanelSchemaMap } from '../../capabilities/panel/schema/types';
+/**
+ * 向指定 suite 注册属性面板 schema
+ * @param suiteKey 套件 key
+ * @param schemas 面板 schema 映射，key 需与 panel-router 解析结果一致
+ * @param override 是否覆盖已注册的同名 schema
+ */
+export declare function registerPanelSchemas(suiteKey: string, schemas: PanelSchemaMap, override?: boolean): void;
+export type { PanelSchema, PanelSchemaKey, PanelSchemaMap, } from '../../capabilities/panel/schema/types';

package/dist/sdk/types/form-tmpl-config.types.d.ts

@@ -0,0 +1,123 @@
+interface CacheFocusData {
+    /** 唯一key */
+    uniqueKey: string;
+    /** 关联字段 */
+    fieldKeys: string[];
+    /** 缓存值 */
+    value: any;
+}
+/**
+ *
+ */
+/** 设备连接器实例接口 */
+export interface IDeviceConnector {
+    state: {
+        /** mqtt取消订阅回调 */
+        unMqttTopicMap: Record<string, Function | undefined>;
+        /** 当前聚焦的字段key */
+        focusFieldKey: string | null;
+        /** 当前聚焦的子表字段的行 */
+        focusSubRowIndex?: number | null;
+        /** 缓存的需要聚焦才修改的值 */
+        cacheFieldData: Record<string, CacheFocusData>;
+    };
+    /** 初始化连接器 */
+    init(): void;
+    /**
+     * 取消订阅mqtt
+     * @param id
+     */
+    unsubscribeMqtt(id: string): void;
+    /** 清空数据 */
+    clear(): void;
+    /**
+     * 添加缓存的聚焦时填充的字段数据
+     * @param params
+     */
+    addCachedFocusValue(params: CacheFocusData): void;
+    /**
+     * 判断字段是否存在缓存聚焦值
+     * @param field
+     */
+    hasCachedFocusValue(field: string): boolean;
+    /**
+     * 获取缓存聚焦值
+     * @param field
+     */
+    getCachedFocusValue(field: string): any;
+}
+export interface IDeviceLinkTmplUtil {
+    /** 创建模板 */
+    createTmpl(type: unknown): unknown;
+    /**  计算 AI OCR 完整提示词 */
+    calcEntirePrompt(tmpl: unknown): string;
+    /** 平台设备互联对象转换 */
+    transfer2DeviceLink(data: unknown): unknown;
+    /** 通过设备 id 获取设备互联信息 */
+    getDeviceLink(deviceId: string): Promise<unknown | undefined>;
+    /** 初始化设备字段与表单字段映射 */
+    initDevice2FormFieldMap(deviceLink: unknown): unknown[];
+}
+/**
+ * 与主工程 form-tmpl-config 对齐的契约（word 包仅保留类型，实现由主工程注入）。
+ */
+export interface IFormTmplConfigController {
+    TmplUtil: IDeviceLinkTmplUtil;
+    /** 设备连接器 */
+    deviceConnector: IDeviceConnector;
+    /** 存储响应式变量 */
+    state: {
+        /** 模板列表 */
+        tmpls: unknown[];
+        /** 运行中的模板，目前是 mqtt 模板 */
+        runningTmpls: unknown[];
+        /** IOT 权限 */
+        IOTPermission: boolean;
+        /** OCR 权限 */
+        OCRPermission: boolean;
+    };
+    /** 表单模板 id */
+    tmplId: string;
+    /** 是否手动模式，手动模式不触发接口 */
+    isManual: boolean;
+    /**
+     * 初始化权限
+     */
+    initPermissions(): Promise<void>;
+    /**
+     * 初始化
+     */
+    init(opts: {
+        tmplId: string;
+        isManual?: boolean;
+    }): Promise<void>;
+    /**
+     * 设置配置字符串
+     */
+    setConfigStr(configStr?: string): void;
+    /**
+     * 获取配置字符串
+     */
+    getConfigStr(): string;
+    /**
+     * 保存数据
+     */
+    save(): Promise<void>;
+    /**
+     * 刷新数据
+     */
+    refresh(): Promise<void>;
+    /**
+     * 添加或更新模板
+     */
+    createOrUpdate(tmpl: unknown): Promise<void>;
+    /**
+     * 缓存运行中的模板
+     */
+    cacheRunningTmpl(tmpl: unknown): void;
+    /**
+     * 断开连接
+     */
+    disconnect(tmpl: unknown): void;
+}
+export {};

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

@@ -5,7 +5,7 @@ import { Page } from '../../core';
 import { DocBaselineContext, DocUnsavedChanges, DocOperations, DocGetUnsavedChangesOptions } from '../doc-runtime/composables/useDocOperations';
 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 { IFormTmplConfigController } from './form-tmpl-config.types';
 import { DesignerValidationResult } from './designer-validation';
 export type { DocUnsavedChanges, DocGetUnsavedChangesOptions, } from '../doc-runtime/composables/useDocOperations';
 export type { DesignerValidationError, DesignerValidationResult, DesignerValidationSource, } from './designer-validation';
@@ -77,8 +77,11 @@ export interface DocControllerMethods extends DocOperations {
      * 未传 formData 时使用当前 rawData。
      */
     getSubmitFormData(formData?: Record<string, any>): Record<string, any>;
-    /** 设置当前文档整个原始数据 */
-    setRawData(data: Record<string, any>, defaultDataMap?: Record<string, any>): void;
+    /**
+     * 全量替换填报数据，并重算依赖、超链接 enrich、排版。
+     * 与 refreshData 的数据收尾一致（不含重新请求接口、不重置未保存基线）。
+     */
+    setRawData(data: Record<string, any>, defaultDataMap?: Record<string, any>): Promise<void>;
     /** 根据 jsonpath 批量设置文档数据 */
     setMultiple(updates: Record<string, any>): boolean;
     /** 获取当前文档的所有子表信息 */
@@ -175,7 +178,6 @@ export interface WordRuntime {
      * - 通过该对象调用命令、读取页面与模式状态、访问只读查询 API。
      */
     controller: ShallowRef<DocController | null>;
-    formTmplConfigController: FormTmplConfigController;
     /** 文档响应式页面信息（用于驱动 canvas 渲染） */
     docInfo: Ref<DocInfo>;
 }
@@ -220,6 +222,12 @@ export interface UseWordOptions {
     onLooperAutoSave?: (payload?: {
         changed?: boolean;
     }) => void;
+    /**
+     * 主工程 form-tmpl 控制器。
+     * 外部 new 后传入，word 内部 provide 给数据加载面板使用。
+     * 多实例时每个 useWord 传入独立实例，避免 MQTT / 缓存串实例。
+     */
+    formTmplConfigController?: IFormTmplConfigController;
     /** 扩展字段 - 兼容其他未明确定义的负载参数 */
     [key: string]: any;
 }

package/dist/sdk/vue/layouts/doc-design-layout.vue.d.ts

@@ -1,9 +1,6 @@
-import { DocDesignLayoutProps } from './doc-design-layout';
-declare const _default: import('vue').DefineComponent<DocDesignLayoutProps, {
+declare const _default: import('vue').DefineComponent<{}, {
     onImportTemplate: () => void;
-}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<DocDesignLayoutProps> & Readonly<{}>, {
-    IOTPermission: boolean;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
     layoutRef: HTMLDivElement;
     scrollRef: HTMLElement;
 }, HTMLDivElement>;

package/dist/suites/edhr/field-manifest/trace/order-no-manifest.d.ts

@@ -0,0 +1,2 @@
+import { FieldManifest } from '../../../../capabilities/field-manifest';
+export declare const manifest: FieldManifest;

package/dist/suites/edhr/field-manifest/trace/related-lot-no-manifest.d.ts

@@ -0,0 +1,2 @@
+import { FieldManifest } from '../../../../capabilities/field-manifest';
+export declare const manifest: FieldManifest;

package/dist/suites/edhr/panel-schema/index.d.ts

@@ -93,11 +93,6 @@ export declare function registryPanelSchemas(): {
         title: string;
         render: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
     };
-    'data-load.basic': {
-        key: string;
-        title: string;
-        render: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
-    };
     'paper-header-footer.basic': {
         key: string;
         title: string;

package/dist/suites/edhr/paper-widget-manifest/basic/timediff-manifest.d.ts

@@ -0,0 +1,2 @@
+import { PaperWidgetManifest } from '../../../../capabilities/paper-widget-manifest';
+export declare const manifest: Omit<PaperWidgetManifest, 'renderers'>;

package/dist/utils/TriggerUtil.d.ts

@@ -1,4 +1,4 @@
-type TriggerName = 'OPEN_DATA_INIT_DATASOURCE_FORM_MODEL_MODAL' | 'OPEN_DATA_INIT_DATASOURCE_INPUT_PARAMS_MODAL' | 'OPEN_DATA_INIT_DATASOURCE_OUTPUT_PARAMS_MODAL' | 'OPEN_DATA_LOAD_DEVICE_INTERCONNECTION_ADD_PARAM_MAPPING_MODAL';
+export type TriggerName = 'OPEN_DATA_INIT_DATASOURCE_FORM_MODEL_MODAL' | 'OPEN_DATA_INIT_DATASOURCE_INPUT_PARAMS_MODAL' | 'OPEN_DATA_INIT_DATASOURCE_OUTPUT_PARAMS_MODAL' | 'OPEN_FIELD_HYPERLINK_MODAL';
 export type TriggerHandler = (name: TriggerName, options?: any) => Promise<any>;
 interface TriggerUtilHandlers {
     handle?: TriggerHandler;

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

@@ -61,6 +61,15 @@ export declare function replacePathIndexPlaceholders(params: {
  * // $.a[2].b
  */
 export declare function replacePathIndexPlaceholder(refPath: string | number | undefined, templatePath: string, placeholder?: string): string;
+/**
+ * 判断运行时路径是否匹配 valuePath 模板（支持 [n] / [n_x] / [n_y] 占位符）
+ *
+ * @example
+ * runtimePathMatchesTemplate('$.items[n].name', '$.items[2].name') // true
+ */
+export declare function runtimePathMatchesTemplate(template: string, runtimePath: string): boolean;
+/** 由 valuePath 模板生成 enricher 用的 path 匹配函数 */
+export declare function createValuePathMatcher(template: string): (runtimePath: string) => boolean;
 export interface ParsedValuePath {
     /** 原始路径 */
     raw: string;

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

@@ -6,6 +6,8 @@ export declare function transformSourceDataList(data: any[], dict?: {}): {
     _OPCT: any;
     [key: string]: any;
 }[];
+/** 深度剔除 rawData 中的超链接派生字段（*_href_） */
+export declare function stripHrefDerivedData(value: any): any;
 /** 转换formState */
 export declare function conversionFormState(payload: {
     /** 主从关联字段列表 */