@gct-paas/word 0.1.13 → 0.1.15

package/dist/runtime/renderer/dropdowns/components/tables/table-dropdown.vue.d.ts

@@ -42,15 +42,15 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
             readonly id?: string | undefined;
             readonly spellcheck?: boolean | undefined;
             readonly customStyle?: Record<string, string | number> | undefined;
+            readonly onInput?: ((value: string | number, event: Event) => any) | undefined;
             readonly onSearch?: ((value: string | number) => any) | undefined;
-            readonly onFocus?: ((event: FocusEvent) => any) | undefined;
-            readonly onClear?: (() => any) | undefined;
             readonly onBlur?: ((event: FocusEvent) => any) | undefined;
             readonly onChange?: ((value: string | number, event: Event) => any) | undefined;
-            readonly onInput?: ((value: string | number, event: Event) => any) | undefined;
+            readonly onFocus?: ((event: FocusEvent) => any) | undefined;
             readonly onKeydown?: ((event: KeyboardEvent) => any) | undefined;
             readonly onKeypress?: ((event: KeyboardEvent) => any) | undefined;
             readonly onKeyup?: ((event: KeyboardEvent) => any) | undefined;
+            readonly onClear?: (() => any) | undefined;
             readonly "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
             readonly onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
         } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
@@ -68,18 +68,18 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
         $root: import('vue').ComponentPublicInstance | null;
         $parent: import('vue').ComponentPublicInstance | null;
         $host: Element | null;
-        $emit: ((event: "search", value: string | number) => void) & ((event: "focus", event: FocusEvent) => void) & ((event: "clear") => void) & ((event: "blur", event: FocusEvent) => void) & ((event: "change", value: string | number, event: Event) => void) & ((event: "input", value: string | number, event: Event) => void) & ((event: "keydown", event: KeyboardEvent) => void) & ((event: "keypress", event: KeyboardEvent) => void) & ((event: "keyup", event: KeyboardEvent) => void) & ((event: "update:modelValue", value: string | number) => void) & ((event: "pressEnter", event: KeyboardEvent) => void);
+        $emit: ((event: "input", value: string | number, event: Event) => void) & ((event: "search", value: string | number) => void) & ((event: "blur", event: FocusEvent) => void) & ((event: "change", value: string | number, event: Event) => void) & ((event: "focus", event: FocusEvent) => void) & ((event: "keydown", event: KeyboardEvent) => void) & ((event: "keypress", event: KeyboardEvent) => void) & ((event: "keyup", event: KeyboardEvent) => void) & ((event: "clear") => void) & ((event: "update:modelValue", value: string | number) => void) & ((event: "pressEnter", event: KeyboardEvent) => void);
         $el: HTMLDivElement;
         $options: import('vue').ComponentOptionsBase<Readonly<import('../../../../../base/input/src/types').GctInputProps> & Readonly<{
+            onInput?: ((value: string | number, event: Event) => any) | undefined;
             onSearch?: ((value: string | number) => any) | undefined;
-            onFocus?: ((event: FocusEvent) => any) | undefined;
-            onClear?: (() => any) | undefined;
             onBlur?: ((event: FocusEvent) => any) | undefined;
             onChange?: ((value: string | number, event: Event) => any) | undefined;
-            onInput?: ((value: string | number, event: Event) => any) | undefined;
+            onFocus?: ((event: FocusEvent) => any) | undefined;
             onKeydown?: ((event: KeyboardEvent) => any) | undefined;
             onKeypress?: ((event: KeyboardEvent) => any) | undefined;
             onKeyup?: ((event: KeyboardEvent) => any) | undefined;
+            onClear?: (() => any) | undefined;
             "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
             onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
         }>, {
@@ -88,15 +88,15 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
             select: () => void;
             inputRef: import('vue').Ref<HTMLTextAreaElement | HTMLInputElement | null, HTMLTextAreaElement | HTMLInputElement | null>;
         }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+            input: (value: string | number, event: Event) => any;
             search: (value: string | number) => any;
-            focus: (event: FocusEvent) => any;
-            clear: () => any;
             blur: (event: FocusEvent) => any;
             change: (value: string | number, event: Event) => any;
-            input: (value: string | number, event: Event) => any;
+            focus: (event: FocusEvent) => any;
             keydown: (event: KeyboardEvent) => any;
             keypress: (event: KeyboardEvent) => any;
             keyup: (event: KeyboardEvent) => any;
+            clear: () => any;
             "update:modelValue": (value: string | number) => any;
             pressEnter: (event: KeyboardEvent) => any;
         }, string, {
@@ -110,8 +110,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
             placeholder: string;
             autocomplete: string;
             spellcheck: boolean;
-            modelValue: string | number;
             prefix: string;
+            modelValue: string | number;
             suffix: string;
             addonBefore: string;
             addonAfter: string;
@@ -154,8 +154,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
         placeholder: string;
         autocomplete: string;
         spellcheck: boolean;
-        modelValue: string | number;
         prefix: string;
+        modelValue: string | number;
         suffix: string;
         addonBefore: string;
         addonAfter: string;
@@ -168,18 +168,18 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
         showSearchButton: boolean;
         customStyle: Record<string, string | number>;
     }> & Omit<Readonly<import('../../../../../base/input/src/types').GctInputProps> & Readonly<{
+        onInput?: ((value: string | number, event: Event) => any) | undefined;
         onSearch?: ((value: string | number) => any) | undefined;
-        onFocus?: ((event: FocusEvent) => any) | undefined;
-        onClear?: (() => any) | undefined;
         onBlur?: ((event: FocusEvent) => any) | undefined;
         onChange?: ((value: string | number, event: Event) => any) | undefined;
-        onInput?: ((value: string | number, event: Event) => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
         onKeydown?: ((event: KeyboardEvent) => any) | undefined;
         onKeypress?: ((event: KeyboardEvent) => any) | undefined;
         onKeyup?: ((event: KeyboardEvent) => any) | undefined;
+        onClear?: (() => any) | undefined;
         "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
         onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
-    }>, "select" | "focus" | "blur" | "inputRef" | ("name" | "type" | "id" | "rows" | "readonly" | "disabled" | "size" | "placeholder" | "autocomplete" | "spellcheck" | "modelValue" | "prefix" | "suffix" | "addonBefore" | "addonAfter" | "allowClear" | "showCount" | "showPasswordToggle" | "maxLength" | "autofocus" | "bordered" | "showSearchButton" | "customStyle")> & import('vue').ShallowUnwrapRef<{
+    }>, "select" | "blur" | "focus" | "inputRef" | ("name" | "type" | "id" | "rows" | "readonly" | "disabled" | "size" | "placeholder" | "autocomplete" | "spellcheck" | "prefix" | "modelValue" | "suffix" | "addonBefore" | "addonAfter" | "allowClear" | "showCount" | "showPasswordToggle" | "maxLength" | "autofocus" | "bordered" | "showSearchButton" | "customStyle")> & import('vue').ShallowUnwrapRef<{
         focus: () => void;
         blur: () => void;
         select: () => void;

package/dist/runtime/renderer/main/preview-canvas.vue.d.ts

@@ -3,7 +3,8 @@ type __VLS_Props = {
     pages: Array<Page>;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {
-    exportCustomPdf: () => Promise<void>;
+    onPrintView: () => void;
+    getPdfBuffer: () => ArrayBuffer | undefined;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     scrollRef: HTMLDivElement;
     pageStageRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
@@ -12,13 +13,16 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     }> & Readonly<{}>, {
         stageRef: import('vue').Ref<any, any>;
         contentLayerRef: import('vue').Ref<any, any>;
-        pageGroupRefs: import('vue').Ref<Record<string, import('konva/lib/Group').Group>, Record<string, import('konva/lib/Group').Group>>;
+        getPagesDataURL: () => Record<string, import('../../../core').PaperItem>;
     }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
         stageRef: unknown;
         contentLayerRef: unknown;
+        overlayLayerRef: unknown;
         contextMenuRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {
             show: (params: import('../../canvas/__common__/context-menu/index.type').ContextMenuParams) => void;
-        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+            menuRef: HTMLDivElement;
+        }, any, import('vue').ComponentProvideOptions, {
             P: {};
             B: {};
             D: {};
@@ -41,7 +45,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     }> & Readonly<{}>, {
         stageRef: import('vue').Ref<any, any>;
         contentLayerRef: import('vue').Ref<any, any>;
-        pageGroupRefs: import('vue').Ref<Record<string, import('konva/lib/Group').Group>, Record<string, import('konva/lib/Group').Group>>;
+        getPagesDataURL: () => Record<string, import('../../../core').PaperItem>;
     }, {}, {}, {}, {}> | null;
 }, HTMLDivElement>;
 export default _default;

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

@@ -0,0 +1,17 @@
+import { ShallowRef } from 'vue';
+import { DocController } from '../../types';
+import { DocumentFactory } from '../factories/useDocumentFactory';
+import { DocOperations } from './useDocOperations';
+/**
+ * 将加载层（factory）与操作层（ops）组合为受控文档句柄 DocController
+ *
+ * 内部通过 watch doc 变化来重建 controller，当文档未加载时返回 null。
+ * 可与任何持有 DocumentFactory + DocOperations 的场景搭配使用。
+ *
+ * @example
+ * 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

@@ -0,0 +1,41 @@
+import { ShallowRef } from 'vue';
+import { Doc } from '../../../core';
+import { FieldChangeItem, WidgetFieldMetaMap } from '../../../runtime/interface/change-diff';
+/** 数据变更基线上下文 */
+export interface DocBaselineContext {
+    baselineSnapshot: Record<string, any> | undefined;
+    widgetMetaMap: WidgetFieldMetaMap;
+}
+export interface DocOperations {
+    /** 校验所有字段，返回错误映射或 null（通过） */
+    validate(): Promise<Record<string, string[]> | null>;
+    /** 获取文档模型的 XmlJson（用于保存） */
+    exportModel(): any;
+    /**
+     * 获取文档中所有附件文件路径列表
+     * @param types 需要筛选的组件类型，默认 ['fw:file']
+     */
+    getDocumentAttachmentPaths(types?: string[]): string[];
+    /** 进入填报模式并记录基线快照（用于变更追踪） */
+    enterBaseline(uniqueId: string): DocBaselineContext | null;
+    /** 基于基线快照计算字段变更列表 */
+    computeBaselineChanges(ctx: DocBaselineContext): Promise<FieldChangeItem[]>;
+    /** 设置变更批注 */
+    setAnnotation(ids: string[], list: any[]): void;
+}
+/**
+ * 文档操作组合式函数
+ *
+ * 接收任意来源的 Doc 响应式引用，返回可独立使用的操作集合。
+ * 不依赖 useDocumentFactory，可与任何持有 Doc 的场景搭配使用。
+ *
+ * @example
+ * // 独立使用
+ * const ops = useDocOperations(someDocRef);
+ * await ops.validate();
+ *
+ * // 与 factory 搭配
+ * const factory = useDocumentFactory(props, payload);
+ * const ops = useDocOperations(factory.doc);
+ */
+export declare function useDocOperations(docRef: ShallowRef<Doc | null>): DocOperations;

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

@@ -0,0 +1,19 @@
+import { ShallowRef } from 'vue';
+import { DocController } from '../../types';
+import { DocumentFactory } from '../factories/useDocumentFactory';
+/**
+ * 将文档工厂的响应式上下文注入 Vue provide 链
+ *
+ * 供内部 Layout 组件通过 inject 消费 controller、docInfo 等 context key。
+ * 必须在 Vue setup() 中调用，且必须在 useDocumentFactory 与 useDocController 之后调用。
+ *
+ * - DOC_PUBLIC_API_KEY → DocController（对外公共 API）
+ * - DOC_INSTANCE_KEY   → Doc 原始实例（仅供内部渲染组件使用）
+ *
+ * @example
+ * const factory = useDocumentFactory(docProps, docPayload);
+ * const ops = useDocOperations(factory.doc);
+ * const controller = useDocController(factory, ops);
+ * useDocRuntimeProvider(factory, controller);
+ */
+export declare function useDocRuntimeProvider(factory: DocumentFactory, controller: ShallowRef<DocController | null>): void;

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

@@ -0,0 +1,20 @@
+import { DesignSuiteContext } from '../../../runtime/_register_/context/DesignSuiteContext';
+export interface UseDocSuiteOptions {
+    /** 套件 key，默认 'edhr' */
+    suiteKey?: string;
+    /** 主模型 key */
+    modelKey?: string;
+}
+/**
+ * 注册文档运行时套件
+ *
+ * 封装 useRegisterSuite，以 SDK 友好的参数格式暴露套件注册能力。
+ * 必须在 Vue setup() 中调用（内部使用 onMounted / onUnmounted）。
+ *
+ * @returns DesignSuiteContext — 套件上下文，供 useDocumentFactory 使用
+ *
+ * @example
+ * const ctx = useDocSuite({ suiteKey: 'edhr', modelKey: 'fm_xxx' });
+ * const factory = useDocumentFactory(docProps, { ...options, ctx });
+ */
+export declare function useDocSuite(options?: UseDocSuiteOptions): DesignSuiteContext;

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

@@ -0,0 +1,10 @@
+import { Doc } from '../../../core';
+import { DocInfo } from '../../types';
+import { IDocPayload, IDocProps, Execute } from './useDocumentFactory';
+export interface InitializedDocument {
+    doc: Doc;
+    docInfo: DocInfo;
+}
+/** 从 Doc 实例提取响应式页面快照 */
+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/document-request-strategy.d.ts

@@ -0,0 +1,3 @@
+import { IDocPayload, IDocProps, Execute } from './useDocumentFactory';
+/** 统一处理文档数据流程 */
+export declare function processDocumentRequest(props: IDocProps, payload: IDocPayload, id: string): Promise<Execute | null>;

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

@@ -1,6 +1,8 @@
 import { ComputedRef, MaybeRef, Ref, ShallowRef } from 'vue';
-import { DocInfo, DocModeType, EnginePublic } from '../../core';
-import { DesignSuiteContext } from '../_register_/context/DesignSuiteContext';
+import { DocModeType, Doc } from '../../../core';
+import { DocInfo } from '../../types';
+import { DesignSuiteContext } from '../../../runtime/_register_/context/DesignSuiteContext';
+import { OnlineFormInstanceResponse, OnlineFormTmplResponse } from '@gct-paas/api/apaas';
 export interface IDocProps {
     /** 文档实例id或者文档模板id */
     requestId: MaybeRef<string | undefined>;
@@ -40,15 +42,40 @@ export interface IDocPayload extends IDocTemplatePayload, IDocInstancePayload {
     isPreview: boolean;
     ctx: DesignSuiteContext;
 }
+/** 文档加载工厂 — 只负责响应式加载与生命周期，不包含业务操作 */
 export interface DocumentFactory {
-    docEngine: ShallowRef<EnginePublic | null, EnginePublic | null>;
+    /** 文档引擎实例 */
+    docIns: ShallowRef<Doc | null>;
+    /** 文档页面信息（响应式，驱动 canvas 渲染） */
     docInfo: Ref<DocInfo>;
-    selfInfo: Ref<any>;
+    /** 交互状态 */
     docInteraction: any;
+    /** 是否已成功加载文档 */
     hasData: ComputedRef<boolean>;
+    /** 是否正在加载 */
     loading: ComputedRef<boolean>;
-    updateDocumentCounter: () => void;
-    getWordDocumentModelXmlJson: any;
+    /** 手动触发文档重新加载 */
+    reload(): void;
 }
+export interface Execute {
+    /** 文档实例id或者文档模板id */
+    id: string;
+    /** 模板 id */
+    tid: string;
+    /** 接口返回的数据 */
+    requestInfo: OnlineFormTmplResponse & OnlineFormInstanceResponse;
+    /** 填报渲染模式 */
+    fillModeType: DocModeType;
+    /** 按钮渲染模式 */
+    btnModelType: DocModeType;
+    /** 外部传进来的参数（实例的话会和接口进行合并处理） */
+    paramsConfig?: Record<string, any>;
+    /** 真实填报数据的查询条件 */
+    query: Record<string, any>;
+}
+/**
+ * 文档加载工厂
+ * 职责：响应 requestId 变化 → 拉取数据 → 初始化引擎 → 暴露响应式状态
+ */
 export declare function useDocumentFactory(props: IDocProps, payload: IDocPayload): DocumentFactory;
 export {};

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

@@ -0,0 +1,12 @@
+import { WordRuntime, UseWordProps, UseWordOptions } from '../types';
+/**
+ * Word 文档运行时入口
+ * @returns WordRuntime - 运行时对象
+ * @example
+ * const { controller } = useWord(
+ *   { requestId: 'xxx' },
+ *   { factoryType: 'template', suiteKey: 'edhr', modelKey: 'fm_xxx' },
+ * );
+ * await controller.value?.validate();
+ */
+export declare function useWord(props: UseWordProps, options: UseWordOptions): WordRuntime;

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

@@ -0,0 +1,14 @@
+/**
+ * @gct-paas/word/engine
+ * 引擎公共 API 与类型
+ */
+export { DocModeTypeConst, PageSizeEnumConst, BuiltinComponentTypeConst } from '../../core/constants';
+export type { DocModeType, CompleteComponentType, BuiltinComponentType } from '../../core/constants';
+export type { DocController, DocQueryAPI, WordRuntime, DocInfo, DocRuntimeMeta, DocRuntimeMetaHandleInfo, UseWordProps, UseWordOptions, } from '../types';
+export { useWord } from '../doc-runtime/useWord';
+export { useDocSuite } from '../doc-runtime/composables/useDocSuite';
+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 '../../runtime/interface/utils';

package/dist/sdk/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @gct-paas/word
+ * SDK 默认聚合入口
+ *
+ * 推荐使用子路径按需导入以获得更细粒度的类型隔离：
+ * - @gct-paas/word/engine  — 引擎 API 与公共类型
+ * - @gct-paas/word/vue     — Vue 组件
+ * - @gct-paas/word/plugins — Suite 插件协议
+ */
+export { setupPlatformAdapters, setupVueRuntime } from './setup';
+export type { SetupPlatformAdaptersOptions, SetupVueRuntimeOptions } from './setup';
+export * from './engine';
+export * from './vue';
+export * from './plugins';

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

@@ -0,0 +1,15 @@
+import { WordSuitePlugin } from '../types';
+/**
+ * 注册 Suite 插件
+ * 将插件能力注入全局 registry，需在应用启动时调用（整个应用生命周期调用一次）
+ *
+ * @example
+ * import { registerSuite } from '@gct-paas/word/plugins';
+ * import { edhrSuitePlugin } from '@gct-paas/word/plugins';
+ *
+ * registerSuite(edhrSuitePlugin);
+ */
+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';

package/dist/sdk/setup.d.ts

@@ -0,0 +1,55 @@
+import { createApp } from 'vue';
+import { TriggerHandler } from '../utils/TriggerUtil';
+import { WordSuitePlugin } from './types';
+export interface SetupPlatformAdaptersOptions {
+    /** HTTP 请求拦截器配置，用于统一处理请求/响应的拦截逻辑 */
+    interceptors: any;
+    /** 获取应用信息/默认内置参数 */
+    getAppInfo: any;
+    /** 文件解析方法 */
+    parseFile: any;
+    /** 文件上传方法 */
+    uploadFile: any;
+    /** 公式变量识别（可选） */
+    formulaIdentify?: any;
+    /** 公式计算（可选） */
+    formulaCalculate?: any;
+    /** 触发主工程交互（可选） */
+    triggerHandler?: TriggerHandler;
+    /** 需要安装的 Suite 插件列表 */
+    plugins?: WordSuitePlugin[];
+}
+/**
+ * 平台适配器注册 **全局唯一，整个应用生命周期内只需调用一次**
+ * @description 注册 HTTP 拦截器、平台服务、Suite 插件等宿主能力
+ *
+ * @example
+ * import { setupPlatformAdapters, setupVueRuntime } from '@gct-paas/word';
+ * import { edhrSuitePlugin } from '@gct-paas/word/plugins';
+ *
+ * setupPlatformAdapters({
+ *   interceptors,
+ *   getAppInfo,
+ *   parseFile,
+ *   uploadFile,
+ *   formulaIdentify,
+ *   formulaCalculate,
+ *   triggerHandler,
+ *   plugins: [edhrSuitePlugin],
+ * });
+ */
+export declare function setupPlatformAdapters(options: SetupPlatformAdaptersOptions): void;
+export interface SetupVueRuntimeOptions {
+    /** Vue 应用实例（createApp 的返回值） */
+    app: ReturnType<typeof createApp>;
+}
+/**
+ * Vue 运行时注册（在 createApp 之后调用）
+ * 注册 Vue 插件（FloatingVue、VueKonva）和全局指令
+ *
+ * @example
+ * const app = createApp(App);
+ * setupVueRuntime({ app });
+ * app.mount('#app');
+ */
+export declare function setupVueRuntime(options: SetupVueRuntimeOptions): void;

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

@@ -0,0 +1,119 @@
+import { ComputedRef, Ref, ShallowRef } from 'vue';
+import { DocModeType } from '../../core/constants';
+import { DocModel } from '../../core/model';
+import { Page } from '../../core';
+import { DocOperations } from '../doc-runtime/composables/useDocOperations';
+import { OnlineFormInstanceResponse, OnlineFormTmplResponse } from '@gct-paas/api/apaas';
+/** 套件插件协议 */
+export interface WordSuitePlugin {
+    /** 套件唯一标识 */
+    key: string;
+    /** 注册套件能力（调用全局 registry），应用启动时调用一次 */
+    install(): void;
+}
+/** 文档页面信息（响应式渲染所需） */
+export interface DocInfo {
+    /** 页面数组 */
+    pages: Page[];
+    /** 布局刷新次数 */
+    updateTick: number;
+}
+/** 只读文档查询 API（对外稳定） */
+export interface DocQueryAPI {
+    getWidgetByModelId(modelId: string): any | undefined;
+    getPaperBySecRefId(id: string): any | null;
+}
+/**
+ * DocController 方法能力（代理 docInstance）
+ */
+export interface DocControllerMethods extends DocOperations {
+    execute(command: string, payload?: any): void;
+    undo(): void;
+    redo(): void;
+    /** 设置渲染模式 */
+    setMode(mode: DocModeType): void;
+    /** 设置文档 */
+    setModel(model: DocModel): void;
+    /** 获取填报数据 */
+    rawData(): Recordable<any>;
+    /** 手动触发文档重新加载 */
+    reload(): void;
+}
+/**
+ * DocController 状态变量（只读/响应式）
+ */
+export interface DocControllerState {
+    /** 渲染模式 */
+    mode: ComputedRef<DocModeType | null>;
+    /** 渲染模式中文文案 */
+    modeLabel: ComputedRef<string>;
+    /** 布局刷新次数 */
+    updateTick: ComputedRef<number>;
+    /** 页面数组 */
+    pages: ComputedRef<Page[]>;
+}
+/**
+ * 对外受控文档句柄
+ * 不暴露原始 docInstance，暴露代理方法与响应式状态
+ */
+export interface DocController extends DocControllerState, DocControllerMethods {
+    /** 文档id */
+    readonly id: string;
+    /** 对外暴露的 api */
+    readonly query: DocQueryAPI;
+    /** 文档运行时元信息（接口数据 + 业务数据） */
+    readonly docRuntimeMeta: DocRuntimeMeta;
+}
+/** docRuntimeMeta 中业务拼接的运行时处理信息 */
+export interface DocRuntimeMetaHandleInfo {
+    /** 按钮区渲染模式 */
+    btnRenderModeType: DocModeType;
+    /** bpmn 流程类型 */
+    bpmnType?: string;
+    /** bpmn 字段权限映射 */
+    bpmnFieldAuthMap?: Record<string, any>;
+}
+/** 文档运行时元信息（接口返回字段 + 业务拼接字段） */
+export interface DocRuntimeMeta extends OnlineFormInstanceResponse, OnlineFormTmplResponse {
+    /** 业务拼接的运行时处理信息 */
+    handleInfo: DocRuntimeMetaHandleInfo;
+}
+/**
+ * useWord 返回的运行时对象（SDK 公共面）
+ */
+export interface WordRuntime {
+    /** 受控文档控制器（加载完成前为 null） */
+    controller: ShallowRef<DocController | null>;
+    /** 文档响应式页面信息（用于驱动 canvas 渲染） */
+    docInfo: Ref<DocInfo>;
+}
+/** useWord 入参属性 */
+export interface UseWordProps {
+    /** 文档实例 id 或模板 id */
+    requestId: string | undefined | (() => string | undefined);
+    /** 批次号（可选） */
+    materialNo?: string;
+    /** 查询条件（可选） */
+    requestQuery?: Recordable<any>;
+    /** 扩展字段 - 兼容其他未明确定义的参数 */
+    [key: string]: any;
+}
+/** useWord 配置选项 */
+export interface UseWordOptions {
+    /** 工厂类型：template（模板） | instance（实例） */
+    factoryType: 'template' | 'instance';
+    /** 主模型 key */
+    modelKey: string;
+    /** 套件 key（默认 'edhr'） */
+    suiteKey?: string;
+    /** 是否预览模式 */
+    isPreview?: boolean;
+    /** 是否模拟填报 */
+    isMockReport?: boolean;
+    /** 是否详情页（强制只读） */
+    isDetailPage?: boolean | (() => boolean);
+    /** 指定渲染模式 */
+    renderModeType?: DocModeType;
+    /** 扩展字段 - 兼容其他未明确定义的负载参数 */
+    [key: string]: any;
+}

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

@@ -0,0 +1,7 @@
+/**
+ * @gct-paas/word/vue
+ * Vue 适配组件（设计器 / 渲染器 / 布局容器）
+ */
+export { default as DocDesignLayout } from './layouts/doc-design-layout.vue';
+export { default as DocRenderLayout } from './layouts/doc-render-layout.vue';
+export { GctLayout } from '../../base';

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

@@ -0,0 +1,7 @@
+export interface DocDesignLayoutProps {
+    IOTPermission?: boolean;
+}
+export declare const useDocDesignLayoutProps: () => {
+    provideProps: (props: DocDesignLayoutProps) => void;
+    injectProps: () => DocDesignLayoutProps;
+};

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

@@ -0,0 +1,10 @@
+import { DocDesignLayoutProps } from './doc-design-layout';
+declare const _default: import('vue').DefineComponent<DocDesignLayoutProps, {
+    onImportTemplate: (payload: any) => void;
+    onImportData: (mainData: any) => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<DocDesignLayoutProps> & Readonly<{}>, {
+    IOTPermission: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    scrollRef: HTMLElement;
+}, HTMLDivElement>;
+export default _default;