@kimposoft/plugin-sdk 0.0.0-stage → 1.1.0-tp.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +9 -0
  3. package/README.md +48 -2
  4. package/package.json +145 -4
  5. package/src/action-designer.ts +267 -0
  6. package/src/attachment-open.ts +574 -0
  7. package/src/attachment-url.ts +235 -0
  8. package/src/auth/index.ts +6 -0
  9. package/src/auth/qrcode.ts +519 -0
  10. package/src/auth/types.ts +261 -0
  11. package/src/display-style.ts +532 -0
  12. package/src/editor-frame.ts +625 -0
  13. package/src/editor-session.ts +1214 -0
  14. package/src/editor-testing.ts +838 -0
  15. package/src/editor.ts +1720 -0
  16. package/src/frame-transport.ts +516 -0
  17. package/src/frontend-routes.ts +99 -0
  18. package/src/hooks.ts +48 -0
  19. package/src/host-caps.ts +93 -0
  20. package/src/i18n.ts +238 -0
  21. package/src/im-panel.ts +132 -0
  22. package/src/image-tools.ts +91 -0
  23. package/src/index.ts +125 -0
  24. package/src/interactive-session.ts +94 -0
  25. package/src/nahida-im.ts +391 -0
  26. package/src/nahida-ws.ts +23 -0
  27. package/src/org-directory.ts +78 -0
  28. package/src/oz-realtime.ts +144 -0
  29. package/src/page.ts +591 -0
  30. package/src/print.ts +393 -0
  31. package/src/surface.ts +310 -0
  32. package/src/theme-mocks.ts +140 -0
  33. package/src/theme.ts +125 -0
  34. package/src/ui-fixtures/attachment.ts +24 -0
  35. package/src/ui-fixtures/confirm.ts +16 -0
  36. package/src/ui-fixtures/entity-picker.ts +24 -0
  37. package/src/ui-fixtures/expression-editor.ts +52 -0
  38. package/src/ui-fixtures/image-cropper.ts +23 -0
  39. package/src/ui-fixtures/index.ts +17 -0
  40. package/src/ui-fixtures/org-tri-picker.ts +19 -0
  41. package/src/ui-fixtures/prompt.ts +19 -0
  42. package/src/ui-fixtures/record-picker.ts +17 -0
  43. package/src/ui-fixtures/template-picker.ts +13 -0
  44. package/src/ui-mocks.ts +264 -0
  45. package/src/ui.ts +491 -0
  46. package/src/workflow-designer.ts +475 -0
@@ -0,0 +1,52 @@
1
+ // 全局表达式编辑器服务(expressionEditor)的请求/结果夹具。
2
+ //
3
+ // 🔴 硬约束:夹具必须纯 JSON 可序列化(不含函数)——这是插件门面 hostBridge.ui.<服务名>.open()
4
+ // 的真实闸门(宿主侧会断言请求可 JSON 序列化),夹具本身
5
+ // 就要示范"合法请求长什么样",因此本文件不使用 OpenExpressionEditorRequest 里插件门面用不到的
6
+ // `getStagingSchema`(回调函数,仅宿主门面场景传入,见 ui.ts 请求类型注释)。
7
+ import type { OpenExpressionEditorRequest, OpenExpressionEditorResult } from '../ui';
8
+
9
+ /** 典型请求:output 模式(产出写入目标字段的值),带最小合法的 context。 */
10
+ export const uiExpressionEditorRequestFixture: OpenExpressionEditorRequest = {
11
+ mode: 'output',
12
+ title: '取数公式',
13
+ guide: '请配置取数表达式',
14
+ context: {
15
+ appId: 'fixture-app',
16
+ templateId: 'fixture-template'
17
+ }
18
+ };
19
+
20
+ /**
21
+ * 带 extraSystemVariables/sourcePolicy 两个可选字段的请求夹具(见 ui.ts OpenExpressionEditorRequest
22
+ * 注释)——示范"合法请求长什么样"之余,顺带证明两个新字段
23
+ * 确实纯 JSON 可序列化(本文件同目录 ui-fixtures.test.ts 对全部夹具做 JSON 往返 + 无函数字段断言,
24
+ * 新增本夹具即自动纳入那两条断言的覆盖范围,不必新开测试文件)。典型消费方=流程设计器:judge 模式
25
+ * 唤起分支条件编辑器,注入「流程变量 + 上游审批结果」并锁定来源为当前记录。
26
+ */
27
+ export const uiExpressionEditorRequestWithExtrasFixture: OpenExpressionEditorRequest = {
28
+ mode: 'judge',
29
+ title: '分支条件',
30
+ guide: '请配置分支条件',
31
+ context: {
32
+ appId: 'fixture-app',
33
+ templateId: 'fixture-template',
34
+ extraSystemVariables: [
35
+ { var_id: 'flow.instance_id', label: '流程实例ID', type: 'string' },
36
+ { var_id: 'node["approve1"].result.approved', label: '审批节点(approve1)结果', type: 'boolean' }
37
+ ]
38
+ },
39
+ sourcePolicy: 'current_record_only'
40
+ };
41
+
42
+ /**
43
+ * 与上面请求对应的一份"用户已确认"结果夹具。
44
+ * model 内部结构对 SDK 不透明(ui.ts 顶部注释:"本 SDK 刻意不描述它的内部结构"),
45
+ * 这里只给一个非空、可 JSON 序列化的占位对象。
46
+ */
47
+ export const uiExpressionEditorResultFixture: OpenExpressionEditorResult = {
48
+ confirmed: true,
49
+ model: {
50
+ fixtureNote: '仅供插件测试占位使用,不代表真实表达式模型的内部结构'
51
+ }
52
+ };
@@ -0,0 +1,23 @@
1
+ // 图片裁切/调整弹窗服务(imageCropper)的请求/结果夹具。
2
+ //
3
+ // 🔴 请求夹具刻意用 `src`(字符串 URL)而非 `file`(File 对象)——夹具必须纯 JSON 可序列化,
4
+ // File 无法被 JSON.stringify 还原为等价对象(ui.ts 对 file 字段的专门注释:它是浏览器原生
5
+ // 可结构化克隆对象,不受插件门面的可序列化闸门限制,但依然不是"纯 JSON",故夹具不用它)。
6
+ import type { OpenImageCropperRequest, OpenImageCropperResult } from '../ui';
7
+
8
+ /** 典型请求:来源为 URL,固定 1:1 裁切比例。 */
9
+ export const uiImageCropperRequestFixture: OpenImageCropperRequest = {
10
+ src: 'https://example.com/fixture-avatar.png',
11
+ aspectRatio: 1,
12
+ defaultMode: 'visually_lossless'
13
+ };
14
+
15
+ /** 与上面请求对应的一份"用户已确认裁切"结果夹具。 */
16
+ export const uiImageCropperResultFixture: OpenImageCropperResult = {
17
+ confirmed: true,
18
+ result: {
19
+ crop: { x: 0, y: 0, width: 256, height: 256 },
20
+ rotateDegree: 0,
21
+ mode: 'visually_lossless'
22
+ }
23
+ };
@@ -0,0 +1,17 @@
1
+ // ui-fixtures —— 宿主 UI 服务总线各服务的请求/结果夹具汇总出口。
2
+ // 每个服务一个文件,这里统一出口。本目录夹具是**纯 JSON**(不含 mock 函数/句柄)——插件门面
3
+ // 本身就要求请求纯 JSON,夹具作为"合法用法示范"必须以身作则,见各文件头注释。
4
+ export {
5
+ uiExpressionEditorRequestFixture,
6
+ uiExpressionEditorResultFixture,
7
+ // 带 extraSystemVariables/sourcePolicy 的请求夹具。
8
+ uiExpressionEditorRequestWithExtrasFixture
9
+ } from './expression-editor';
10
+ export { uiEntityPickerRequestFixture, uiEntityPickerResultFixture } from './entity-picker';
11
+ export { uiRecordPickerRequestFixture, uiRecordPickerResultFixture } from './record-picker';
12
+ export { uiImageCropperRequestFixture, uiImageCropperResultFixture } from './image-cropper';
13
+ export { uiTemplatePickerRequestFixture, uiTemplatePickerResultFixture } from './template-picker';
14
+ export { uiOrgTriPickerRequestFixture, uiOrgTriPickerResultFixture } from './org-tri-picker';
15
+ export { uiConfirmRequestFixture, uiConfirmResultFixture } from './confirm';
16
+ export { uiPromptRequestFixture, uiPromptResultFixture } from './prompt';
17
+ export { uiAttachmentRequestFixture, uiAttachmentResultFixture } from './attachment';
@@ -0,0 +1,19 @@
1
+ // 用户/角色/部门三维选择器服务(orgTriPicker)的请求/结果夹具。
2
+ import type { OrgTriPickerRequest, OrgTriPickerResult } from '../ui';
3
+
4
+ /** 典型请求:带 appId(角色页签会显示本应用角色分组)+ 预选一名用户(回显)。 */
5
+ export const uiOrgTriPickerRequestFixture: OrgTriPickerRequest = {
6
+ appId: 'fixture-app-1',
7
+ title: '选择审批人',
8
+ initial: {
9
+ users: [{ user_id: 'fixture-user-1', login_name: 'fixture.user1', display_name: '夹具用户一', status_code: 'active' }]
10
+ }
11
+ };
12
+
13
+ /** 与上面请求对应的一份"用户已确认,三类各选一条"结果夹具。 */
14
+ export const uiOrgTriPickerResultFixture: OrgTriPickerResult = {
15
+ confirmed: true,
16
+ users: [{ user_id: 'fixture-user-1', login_name: 'fixture.user1', display_name: '夹具用户一', status_code: 'active' }],
17
+ roles: [{ id: 'fixture-role-1', name: '夹具审批员', scope: 'instance' }],
18
+ depts: [{ id: 'fixture-dept-1', org_name: '夹具部门', path_name: '夹具公司/夹具部门' }]
19
+ };
@@ -0,0 +1,19 @@
1
+ // 输入框服务(prompt)的请求/结果夹具。
2
+ import type { OpenPromptRequest, OpenPromptResult } from '../ui';
3
+
4
+ /** 典型请求:带说明、预填值与必填校验的单行输入。 */
5
+ export const uiPromptRequestFixture: OpenPromptRequest = {
6
+ title: '重命名',
7
+ content: '请输入新的名称',
8
+ label: '名称',
9
+ defaultValue: '夹具默认名称',
10
+ placeholder: '请输入名称',
11
+ required: true,
12
+ maxLength: 50
13
+ };
14
+
15
+ /** 与上面请求对应的一份"用户确认并保留预填值"结果夹具(value 为输入原文)。 */
16
+ export const uiPromptResultFixture: OpenPromptResult = {
17
+ confirmed: true,
18
+ value: '夹具默认名称'
19
+ };
@@ -0,0 +1,17 @@
1
+ // 记录选择器服务(recordPicker)的请求/结果夹具(X20:界面动作「打开表单」多命中场景)。
2
+ import type { OpenRecordPickerRequest, OpenRecordPickerResult } from '../ui';
3
+
4
+ /** 典型请求:两条候选记录,预览两列。 */
5
+ export const uiRecordPickerRequestFixture: OpenRecordPickerRequest = {
6
+ records: [
7
+ { record_id: 'fixture-record-1', preview: { name: '夹具记录一', amount: 100 } },
8
+ { record_id: 'fixture-record-2', preview: { name: '夹具记录二', amount: 200 } }
9
+ ],
10
+ previewFieldIds: ['name', 'amount']
11
+ };
12
+
13
+ /** 与上面请求对应的一份"用户点选了第一条"结果夹具。 */
14
+ export const uiRecordPickerResultFixture: OpenRecordPickerResult = {
15
+ confirmed: true,
16
+ recordId: 'fixture-record-1'
17
+ };
@@ -0,0 +1,13 @@
1
+ // 通用模板选择弹窗服务(templatePicker)的请求/结果夹具。
2
+ import type { TemplatePickerRequest, TemplatePickerResult } from '../ui';
3
+
4
+ /** 典型请求:只带 appId(其余走宿主默认标题/无预选)。 */
5
+ export const uiTemplatePickerRequestFixture: TemplatePickerRequest = {
6
+ appId: 'fixture-app-1'
7
+ };
8
+
9
+ /** 与上面请求对应的一份"用户已确认,选中一个模板"结果夹具。 */
10
+ export const uiTemplatePickerResultFixture: TemplatePickerResult = {
11
+ confirmed: true,
12
+ template: { template_id: 'fixture-template-1', template_name: '夹具采购申请单', published: true }
13
+ };
@@ -0,0 +1,264 @@
1
+ // ui-mocks.ts —— 宿主 UI 服务总线 mock 工厂,供插件在自己的 playground / 单测里
2
+ // **不启动宿主**也能把「唤起弹窗 → 用户操作 → 拿回结果」这条交互跑通。
3
+ //
4
+ // 【为什么落在 src 根目录而不是 ui/mocks.ts】ui.ts 本身是 src 根下的一份扁平文件(没有为自己
5
+ // 起 ui/ 子目录),与 image-tools.ts / org-directory.ts 等同级契约文件同属一种风格;只有
6
+ // workflow/ 这种多文件领域才会开子目录、并在其中放 mocks.ts。本文件与 ui.ts 同级、以 "ui-"
7
+ // 前缀命名,是"文件名前缀 = 领域名"这一扁平文件既有惯例的延伸,不是另起一套约定。
8
+ //
9
+ // 组织与命名风格照抄 ./workflow/mocks.ts:每个服务一份可控假数据 + 顶层
10
+ // createMockHostUi(overrides) 汇总;本文件同样不含任何真实网络调用/DOM 渲染(硬约束)。
11
+ //
12
+ // 【必须能表达的两条路径】插件作者最容易只测"用户点了确认"这一条 happy path,漏测取消与
13
+ // 未接线两种同样真实的路径。因此每个服务位支持三档结果(而不是只给一份写死的 confirm 数据):
14
+ // - 'confirm' (缺省):resolve 一份"用户确认并选了一条合理假数据"的结果;
15
+ // - 'cancel' :resolve 一份 confirmed:false 的结果(数据字段按 ui.ts 既定约定
16
+ // 置空数组/null,与真实宿主取消时的行为一致);
17
+ // - 'not-wired' :reject 一个与 ui.ts createNotWiredHostUi 措辞一致的错误——直接
18
+ // 复用该函数产出的实现,不重抄一遍错误文案,避免两处措辞漂移。
19
+ // 模拟"宿主根本没有提供这条 UI 服务"这一装配态缺陷,而不是伪装成
20
+ // 用户取消(把装配错误伪装成正常交互是最难排查的一类缺陷)。
21
+ // 用法:createMockHostUi({ expressionEditor: 'cancel', entityPicker: 'not-wired' });
22
+ // 未在 overrides 里出现的服务位按 'confirm' 处理。三档假数据不够用时,也可以直接传一个
23
+ // 与 HostUi 同名方法签名一致的自定义实现函数,整体覆盖该服务位(与 workflow/mocks.ts 的
24
+ // overrides 用法一致)。
25
+ //
26
+ // 【busy 档为什么没有】HOSTUI-002(HostUiBusyError)是宿主注册表的重入锁产物——同一服务在途
27
+ // 时二次调用才会触发,属于"调用时序"而非"结果形态",与 confirm/cancel/not-wired 这三档
28
+ // "服务返回什么"不是同一个维度,本工厂不模拟它。要测重入场景,请直接让 mock 的 Promise
29
+ // 保持 pending(如 overrides 传一个不 resolve 的自定义函数)再发起第二次调用并自行断言。
30
+ import {
31
+ createNotWiredHostUi,
32
+ type ExpressionModel,
33
+ type HostUi,
34
+ type HostUiBridge,
35
+ type HostUiServiceName,
36
+ type OrgTriPickedUser,
37
+ type PickedDeptRef,
38
+ type PickedRoleRef,
39
+ type PickedUser,
40
+ type TemplatePickerResultTemplate
41
+ } from './ui';
42
+ import type { ImageCropperResult } from './image-tools';
43
+
44
+ /** 三档结果快捷方式;'confirm'/'cancel' 都代表服务"已接线",区别只是用户的选择。 */
45
+ export type HostUiMockOutcome = 'confirm' | 'cancel' | 'not-wired';
46
+
47
+ /** 每个服务位可传三档字符串走内置假数据,或直接传一个自定义实现整体覆盖。 */
48
+ export interface HostUiMockOverrides {
49
+ expressionEditor?: HostUiMockOutcome | HostUi['openExpressionEditor'];
50
+ entityPicker?: HostUiMockOutcome | HostUi['openEntityPicker'];
51
+ recordPicker?: HostUiMockOutcome | HostUi['openRecordPicker'];
52
+ imageCropper?: HostUiMockOutcome | HostUi['openImageCropper'];
53
+ templatePicker?: HostUiMockOutcome | HostUi['openTemplatePicker'];
54
+ orgTriPicker?: HostUiMockOutcome | HostUi['openOrgTriPicker'];
55
+ confirm?: HostUiMockOutcome | HostUi['openConfirm'];
56
+ prompt?: HostUiMockOutcome | HostUi['openPrompt'];
57
+ attachment?: HostUiMockOutcome | HostUi['openAttachment'];
58
+ }
59
+
60
+ // ---------------------------------------------------------------------------
61
+ // 稳定占位数据(同 workflow/mocks.ts MOCK_TIMESTAMP 的用法:写死而非每次现造,
62
+ // 避免快照/断言抖动,也省得每个插件各自手写一份)。
63
+ // ---------------------------------------------------------------------------
64
+
65
+ const MOCK_EXPRESSION_MODEL: ExpressionModel = {
66
+ // ExpressionModel 内部结构对 SDK 不透明(ui.ts 顶部注释:"本 SDK 刻意不描述它的内部结构"),
67
+ // mock 只需给一个非空、可 JSON 序列化的占位对象,代表"用户已经编好了一条表达式"。
68
+ __mock: true,
69
+ note: '仅供 playground/单测占位使用,不代表真实表达式模型的内部结构'
70
+ };
71
+
72
+ const MOCK_PICKED_USER: PickedUser = {
73
+ user_id: 'mock-user-1',
74
+ login_name: 'mock.user',
75
+ display_name: '模拟用户',
76
+ status_code: 'active'
77
+ };
78
+
79
+ const MOCK_RECORD_ID = 'mock-record-1';
80
+
81
+ const MOCK_IMAGE_CROPPER_RESULT: ImageCropperResult = {
82
+ crop: { x: 0, y: 0, width: 100, height: 100 },
83
+ rotateDegree: 0,
84
+ mode: 'visually_lossless'
85
+ };
86
+
87
+ const MOCK_TEMPLATE: TemplatePickerResultTemplate = {
88
+ template_id: 'mock-template-1',
89
+ template_name: '模拟模板',
90
+ published: true
91
+ };
92
+
93
+ const MOCK_ORG_TRI_USER: OrgTriPickedUser = {
94
+ user_id: 'mock-user-1',
95
+ login_name: 'mock.user',
96
+ display_name: '模拟用户',
97
+ status_code: 'active'
98
+ };
99
+
100
+ const MOCK_ORG_TRI_ROLE: PickedRoleRef = { id: 'mock-role-1', name: '模拟角色', scope: 'instance' };
101
+
102
+ const MOCK_ORG_TRI_DEPT: PickedDeptRef = { id: 'mock-dept-1', org_name: '模拟部门', path_name: '模拟公司/模拟部门' };
103
+
104
+ // 输入框 confirm 档返回的占位输入值(与 ui-fixtures/prompt.ts 的结果夹具一致)。
105
+ const MOCK_PROMPT_VALUE = '夹具默认名称';
106
+
107
+ // ---------------------------------------------------------------------------
108
+ // 每服务三档解析:not-wired 直接借用 createNotWiredHostUi 的实现(措辞不重复维护一份)。
109
+ // ---------------------------------------------------------------------------
110
+
111
+ function resolveExpressionEditorImpl(
112
+ outcome: HostUiMockOutcome | HostUi['openExpressionEditor'] | undefined
113
+ ): HostUi['openExpressionEditor'] {
114
+ if (typeof outcome === 'function') return outcome;
115
+ if (outcome === 'not-wired') return createNotWiredHostUi().openExpressionEditor;
116
+ if (outcome === 'cancel') return async () => ({ confirmed: false, model: null });
117
+ return async () => ({ confirmed: true, model: MOCK_EXPRESSION_MODEL });
118
+ }
119
+
120
+ function resolveEntityPickerImpl(
121
+ outcome: HostUiMockOutcome | HostUi['openEntityPicker'] | undefined
122
+ ): HostUi['openEntityPicker'] {
123
+ if (typeof outcome === 'function') return outcome;
124
+ if (outcome === 'not-wired') return createNotWiredHostUi().openEntityPicker;
125
+ // depts 恒为空数组:本 mock 只模拟 'user' 档的 happy path(当前唯一消费方 kimpo-workflow
126
+ // 只选人不选部门),'dept' 档需要不同假数据时请用自定义覆盖函数(见本文件头注释"逃生舱")。
127
+ if (outcome === 'cancel') return async () => ({ confirmed: false, users: [], depts: [] });
128
+ return async () => ({ confirmed: true, users: [MOCK_PICKED_USER], depts: [] });
129
+ }
130
+
131
+ function resolveRecordPickerImpl(
132
+ outcome: HostUiMockOutcome | HostUi['openRecordPicker'] | undefined
133
+ ): HostUi['openRecordPicker'] {
134
+ if (typeof outcome === 'function') return outcome;
135
+ if (outcome === 'not-wired') return createNotWiredHostUi().openRecordPicker;
136
+ if (outcome === 'cancel') return async () => ({ confirmed: false, recordId: null });
137
+ return async () => ({ confirmed: true, recordId: MOCK_RECORD_ID });
138
+ }
139
+
140
+ function resolveImageCropperImpl(
141
+ outcome: HostUiMockOutcome | HostUi['openImageCropper'] | undefined
142
+ ): HostUi['openImageCropper'] {
143
+ if (typeof outcome === 'function') return outcome;
144
+ if (outcome === 'not-wired') return createNotWiredHostUi().openImageCropper;
145
+ if (outcome === 'cancel') return async () => ({ confirmed: false, result: null });
146
+ return async () => ({ confirmed: true, result: MOCK_IMAGE_CROPPER_RESULT });
147
+ }
148
+
149
+ function resolveTemplatePickerImpl(
150
+ outcome: HostUiMockOutcome | HostUi['openTemplatePicker'] | undefined
151
+ ): HostUi['openTemplatePicker'] {
152
+ if (typeof outcome === 'function') return outcome;
153
+ if (outcome === 'not-wired') return createNotWiredHostUi().openTemplatePicker;
154
+ if (outcome === 'cancel') return async () => ({ confirmed: false, template: null });
155
+ return async () => ({ confirmed: true, template: MOCK_TEMPLATE });
156
+ }
157
+
158
+ function resolveOrgTriPickerImpl(
159
+ outcome: HostUiMockOutcome | HostUi['openOrgTriPicker'] | undefined
160
+ ): HostUi['openOrgTriPicker'] {
161
+ if (typeof outcome === 'function') return outcome;
162
+ if (outcome === 'not-wired') return createNotWiredHostUi().openOrgTriPicker;
163
+ if (outcome === 'cancel') return async () => ({ confirmed: false, users: [], roles: [], depts: [] });
164
+ return async () => ({ confirmed: true, users: [MOCK_ORG_TRI_USER], roles: [MOCK_ORG_TRI_ROLE], depts: [MOCK_ORG_TRI_DEPT] });
165
+ }
166
+
167
+ function resolveConfirmImpl(outcome: HostUiMockOutcome | HostUi['openConfirm'] | undefined): HostUi['openConfirm'] {
168
+ if (typeof outcome === 'function') return outcome;
169
+ if (outcome === 'not-wired') return createNotWiredHostUi().openConfirm;
170
+ if (outcome === 'cancel') return async () => ({ confirmed: false });
171
+ return async () => ({ confirmed: true });
172
+ }
173
+
174
+ function resolvePromptImpl(outcome: HostUiMockOutcome | HostUi['openPrompt'] | undefined): HostUi['openPrompt'] {
175
+ if (typeof outcome === 'function') return outcome;
176
+ if (outcome === 'not-wired') return createNotWiredHostUi().openPrompt;
177
+ // 取消时 value 恒为 null(不是空串),与 ui.ts OpenPromptResult 约定一致。
178
+ if (outcome === 'cancel') return async () => ({ confirmed: false, value: null });
179
+ return async () => ({ confirmed: true, value: MOCK_PROMPT_VALUE });
180
+ }
181
+
182
+ function resolveAttachmentImpl(outcome: HostUiMockOutcome | HostUi['openAttachment'] | undefined): HostUi['openAttachment'] {
183
+ if (typeof outcome === 'function') return outcome;
184
+ if (outcome === 'not-wired') return createNotWiredHostUi().openAttachment;
185
+ // 附件外壳没有「确认 / 取消」之分,只有关闭;confirm 档模拟「看过并保存了一次编辑」,cancel 档模拟「只看没改就关了」。
186
+ if (outcome === 'cancel') return async () => ({ edited: false });
187
+ return async () => ({ edited: true });
188
+ }
189
+
190
+ /**
191
+ * 构造满足 HostUi 接口的 mock(插件侧窄化调用面,即 createHostUi() 的产出形状)。
192
+ * 适合在插件自己的 playground/单测里直接替代 `createHostUi(hostBridge)` 的返回值。
193
+ */
194
+ export function createMockHostUi(overrides?: HostUiMockOverrides): HostUi {
195
+ // has():'not-wired' 档视为该服务未接线(与真实 createHostUi 的 has() 语义一致);
196
+ // 'confirm'/'cancel' 都代表服务"存在",用户点了确认还是取消是另一回事,不影响 has()。
197
+ const wired: Record<HostUiServiceName, boolean> = {
198
+ expressionEditor: overrides?.expressionEditor !== 'not-wired',
199
+ entityPicker: overrides?.entityPicker !== 'not-wired',
200
+ recordPicker: overrides?.recordPicker !== 'not-wired',
201
+ imageCropper: overrides?.imageCropper !== 'not-wired',
202
+ templatePicker: overrides?.templatePicker !== 'not-wired',
203
+ orgTriPicker: overrides?.orgTriPicker !== 'not-wired',
204
+ confirm: overrides?.confirm !== 'not-wired',
205
+ prompt: overrides?.prompt !== 'not-wired',
206
+ attachment: overrides?.attachment !== 'not-wired'
207
+ };
208
+
209
+ return {
210
+ has: service => wired[service],
211
+ openExpressionEditor: resolveExpressionEditorImpl(overrides?.expressionEditor),
212
+ openEntityPicker: resolveEntityPickerImpl(overrides?.entityPicker),
213
+ openRecordPicker: resolveRecordPickerImpl(overrides?.recordPicker),
214
+ openImageCropper: resolveImageCropperImpl(overrides?.imageCropper),
215
+ openTemplatePicker: resolveTemplatePickerImpl(overrides?.templatePicker),
216
+ openOrgTriPicker: resolveOrgTriPickerImpl(overrides?.orgTriPicker),
217
+ openConfirm: resolveConfirmImpl(overrides?.confirm),
218
+ openPrompt: resolvePromptImpl(overrides?.prompt),
219
+ openAttachment: resolveAttachmentImpl(overrides?.attachment)
220
+ };
221
+ }
222
+
223
+ /**
224
+ * 构造满足 HostUiBridge 形状的 mock(键 = 服务名,值 = { open }),供需要模拟
225
+ * `hostBridge.ui` 整体(而非已经过 createHostUi 窄化的 HostUi)的场景使用——例如验证
226
+ * 插件自己包在 createHostUi 之上的一层封装代码本身有没有写对。
227
+ *
228
+ * 'not-wired' 档在这一层的表达方式与 createMockHostUi **不同**:真实总线里"未接线"等价于
229
+ * `hostBridge.ui` 上压根没有这个键(见 ui.ts createHostUi 的 resolve():取不到域就退化为
230
+ * NotWired),所以这里直接不写入该键,而不是写入一个恒 reject 的 open——这样插件侧惯用的
231
+ * `typeof bridge.ui?.entityPicker?.open === 'function'` 探测能拿到与真机一致的结果,
232
+ * 用 createHostUi() 包一层后也会自然得到与生产环境相同的 NotWired 报错(见本文件配套测试)。
233
+ */
234
+ export function createMockHostUiBridge(overrides?: HostUiMockOverrides): HostUiBridge {
235
+ const bridge: HostUiBridge = {};
236
+ if (overrides?.expressionEditor !== 'not-wired') {
237
+ bridge.expressionEditor = { open: resolveExpressionEditorImpl(overrides?.expressionEditor) };
238
+ }
239
+ if (overrides?.entityPicker !== 'not-wired') {
240
+ bridge.entityPicker = { open: resolveEntityPickerImpl(overrides?.entityPicker) };
241
+ }
242
+ if (overrides?.recordPicker !== 'not-wired') {
243
+ bridge.recordPicker = { open: resolveRecordPickerImpl(overrides?.recordPicker) };
244
+ }
245
+ if (overrides?.imageCropper !== 'not-wired') {
246
+ bridge.imageCropper = { open: resolveImageCropperImpl(overrides?.imageCropper) };
247
+ }
248
+ if (overrides?.templatePicker !== 'not-wired') {
249
+ bridge.templatePicker = { open: resolveTemplatePickerImpl(overrides?.templatePicker) };
250
+ }
251
+ if (overrides?.orgTriPicker !== 'not-wired') {
252
+ bridge.orgTriPicker = { open: resolveOrgTriPickerImpl(overrides?.orgTriPicker) };
253
+ }
254
+ if (overrides?.confirm !== 'not-wired') {
255
+ bridge.confirm = { open: resolveConfirmImpl(overrides?.confirm) };
256
+ }
257
+ if (overrides?.prompt !== 'not-wired') {
258
+ bridge.prompt = { open: resolvePromptImpl(overrides?.prompt) };
259
+ }
260
+ if (overrides?.attachment !== 'not-wired') {
261
+ bridge.attachment = { open: resolveAttachmentImpl(overrides?.attachment) };
262
+ }
263
+ return bridge;
264
+ }