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

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 (44) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +9 -0
  3. package/README.md +48 -2
  4. package/package.json +141 -4
  5. package/src/action-designer.ts +250 -0
  6. package/src/attachment-url.ts +195 -0
  7. package/src/auth/index.ts +6 -0
  8. package/src/auth/qrcode.ts +519 -0
  9. package/src/auth/types.ts +261 -0
  10. package/src/display-style.ts +250 -0
  11. package/src/editor-frame.ts +623 -0
  12. package/src/editor-session.ts +1214 -0
  13. package/src/editor-testing.ts +838 -0
  14. package/src/editor.ts +1641 -0
  15. package/src/frame-transport.ts +491 -0
  16. package/src/frontend-routes.ts +99 -0
  17. package/src/hooks.ts +48 -0
  18. package/src/host-caps.ts +93 -0
  19. package/src/i18n.ts +238 -0
  20. package/src/im-panel.ts +132 -0
  21. package/src/image-tools.ts +91 -0
  22. package/src/index.ts +118 -0
  23. package/src/interactive-session.ts +94 -0
  24. package/src/nahida-im.ts +391 -0
  25. package/src/nahida-ws.ts +23 -0
  26. package/src/org-directory.ts +78 -0
  27. package/src/oz-realtime.ts +144 -0
  28. package/src/page.ts +404 -0
  29. package/src/print.ts +393 -0
  30. package/src/surface.ts +281 -0
  31. package/src/theme-mocks.ts +140 -0
  32. package/src/theme.ts +125 -0
  33. package/src/ui-fixtures/confirm.ts +16 -0
  34. package/src/ui-fixtures/entity-picker.ts +24 -0
  35. package/src/ui-fixtures/expression-editor.ts +52 -0
  36. package/src/ui-fixtures/image-cropper.ts +23 -0
  37. package/src/ui-fixtures/index.ts +16 -0
  38. package/src/ui-fixtures/org-tri-picker.ts +19 -0
  39. package/src/ui-fixtures/prompt.ts +19 -0
  40. package/src/ui-fixtures/record-picker.ts +17 -0
  41. package/src/ui-fixtures/template-picker.ts +13 -0
  42. package/src/ui-mocks.ts +250 -0
  43. package/src/ui.ts +479 -0
  44. package/src/workflow-designer.ts +475 -0
@@ -0,0 +1,140 @@
1
+ // theme-mocks.ts —— 宿主 theme 能力的 mock 工厂,供插件在自己的 playground / 单测里
2
+ // 不启动宿主也能验证「读主题 → 订阅变化 → 重绘」这条链路。
3
+ //
4
+ // 组织风格与 ui-mocks.ts 一致:扁平文件、"theme-" 前缀 = 领域名、不含任何真实网络 / DOM。
5
+ // 【重要】本文件里的数值全部是明显的测试值,**仅测试用,非宿主真实数值**——
6
+ // 它们不得被业务代码当作回退值引用(设计数值唯一出处是宿主主题)。
7
+ import type { HostTheme, HostThemeTokens, RGB } from './theme';
8
+
9
+ /** 可手动触发变化的 mock 主题:在 HostTheme 之上附带测试辅助方法。 */
10
+ export interface MockHostTheme extends HostTheme {
11
+ /** 切换明暗:换出对应测试色板,version +1 并通知订阅者。 */
12
+ setScheme(scheme: 'light' | 'dark'): void;
13
+ /** 局部覆盖 tokens(浅合并到各分组):version +1 并通知订阅者。 */
14
+ update(patch: MockHostThemeTokensPatch): void;
15
+ }
16
+
17
+ /** update / overrides 可传的 tokens 局部补丁(每个分组可只写部分键)。 */
18
+ export type MockHostThemeTokensPatch = {
19
+ [K in keyof HostThemeTokens]?: HostThemeTokens[K] extends object ? Partial<HostThemeTokens[K]> : HostThemeTokens[K];
20
+ };
21
+
22
+ /** createMockHostTheme 的入参。 */
23
+ export interface MockHostThemeOptions {
24
+ /** 初始明暗,缺省 light。 */
25
+ scheme?: 'light' | 'dark';
26
+ /** 初始 tokens 局部覆盖。 */
27
+ tokens?: MockHostThemeTokensPatch;
28
+ }
29
+
30
+ // 以下为测试占位值(仅测试用,非宿主真实数值):用易辨认的整数,便于断言。
31
+ const TEST_GRAY = (n: number): RGB => [n, n, n];
32
+ const TEST_PALETTE_KEYS = ['50', '100', '200', '300', '400', '500', '600', '700', '800', '900', '950'] as const;
33
+
34
+ /** 生成某一明暗下的测试 tokens(仅测试用,非宿主真实数值)。 */
35
+ function buildTestTokens(scheme: 'light' | 'dark'): HostThemeTokens {
36
+ const dark = scheme === 'dark';
37
+ const palette = {} as HostThemeTokens['color']['primaryPalette'];
38
+ TEST_PALETTE_KEYS.forEach((key, i) => {
39
+ palette[key] = [10 + i, 20 + i, 30 + i];
40
+ });
41
+ return {
42
+ color: {
43
+ primary: [1, 2, 3],
44
+ info: [4, 5, 6],
45
+ success: [7, 8, 9],
46
+ warning: [10, 11, 12],
47
+ error: [13, 14, 15],
48
+ onPrimary: [250, 250, 250],
49
+ primaryPalette: palette,
50
+ container: TEST_GRAY(dark ? 20 : 240),
51
+ layout: TEST_GRAY(dark ? 10 : 230),
52
+ inverted: TEST_GRAY(dark ? 230 : 10),
53
+ text: TEST_GRAY(dark ? 220 : 30),
54
+ textSecondary: TEST_GRAY(dark ? 180 : 70),
55
+ textHint: TEST_GRAY(dark ? 140 : 110),
56
+ fill: TEST_GRAY(dark ? 60 : 200),
57
+ fillLightest: TEST_GRAY(dark ? 40 : 220),
58
+ fillLight: TEST_GRAY(dark ? 50 : 210),
59
+ fillLighter: TEST_GRAY(dark ? 45 : 215),
60
+ border: TEST_GRAY(dark ? 70 : 190),
61
+ borderLight: TEST_GRAY(dark ? 65 : 195),
62
+ borderLighter: TEST_GRAY(dark ? 55 : 205),
63
+ borderDark: TEST_GRAY(dark ? 90 : 170),
64
+ borderDeep: TEST_GRAY(dark ? 100 : 160),
65
+ borderLightest: TEST_GRAY(dark ? 35 : 225)
66
+ },
67
+ radius: { control: 1, card: 2, block: 3, pill: 99 },
68
+ control: {
69
+ height: { small: 21, medium: 22, large: 23 },
70
+ fontSize: { small: 11, medium: 12, large: 13 }
71
+ },
72
+ fontSize: { mini: 1, caption: 2, body: 3, subtitle: 4, title: 5, display: 6 },
73
+ space: { 1: 1, 2: 2, 3: 3, 4: 4, 5: 5, 6: 6 },
74
+ shadow: { popup: 'test-popup', dialog: `test-dialog-${scheme}`, drawer: `test-drawer-${scheme}` },
75
+ z: { shell: 1, dropdown: 2, dialog: 3, guide: 4, message: 5 },
76
+ fontFamily: 'test-font',
77
+ uiScale: 1
78
+ };
79
+ }
80
+
81
+ /** 把补丁浅合并到 tokens 的各分组上,返回新对象(不改入参)。 */
82
+ function applyPatch(base: HostThemeTokens, patch: MockHostThemeTokensPatch | undefined): HostThemeTokens {
83
+ if (!patch) return base;
84
+ const next: Record<string, unknown> = { ...base };
85
+ for (const key of Object.keys(patch) as (keyof HostThemeTokens)[]) {
86
+ const value = patch[key];
87
+ if (value === undefined) continue;
88
+ const current = base[key];
89
+ next[key] = typeof current === 'object' && current !== null ? { ...current, ...(value as object) } : value;
90
+ }
91
+ return next as unknown as HostThemeTokens;
92
+ }
93
+
94
+ /**
95
+ * createMockHostTheme —— 造一个可手动触发变化的 HostTheme。
96
+ *
97
+ * 返回对象的 scheme / version / tokens 是 getter,始终反映最新状态;setScheme / update 会让
98
+ * version +1 并同步通知全部订阅者;subscribe 返回的取消函数可重复调用。
99
+ * 用法:`createMockHostTheme({ scheme: 'dark' })`,再放进 `{ theme }` 作为 hostBridge 传给被测插件。
100
+ */
101
+ export function createMockHostTheme(options: MockHostThemeOptions = {}): MockHostTheme {
102
+ let scheme: 'light' | 'dark' = options.scheme ?? 'light';
103
+ let version = 1;
104
+ let tokens = applyPatch(buildTestTokens(scheme), options.tokens);
105
+ const listeners = new Set<(theme: HostTheme) => void>();
106
+
107
+ const notify = (): void => {
108
+ version += 1;
109
+ // 复制一份再遍历,避免回调里取消订阅影响本轮遍历
110
+ for (const cb of [...listeners]) cb(theme);
111
+ };
112
+
113
+ const theme: MockHostTheme = {
114
+ get scheme() {
115
+ return scheme;
116
+ },
117
+ get version() {
118
+ return version;
119
+ },
120
+ get tokens() {
121
+ return tokens;
122
+ },
123
+ subscribe(cb) {
124
+ listeners.add(cb);
125
+ return () => {
126
+ listeners.delete(cb);
127
+ };
128
+ },
129
+ setScheme(next) {
130
+ scheme = next;
131
+ tokens = buildTestTokens(next);
132
+ notify();
133
+ },
134
+ update(patch) {
135
+ tokens = applyPatch(tokens, patch);
136
+ notify();
137
+ }
138
+ };
139
+ return theme;
140
+ }
package/src/theme.ts ADDED
@@ -0,0 +1,125 @@
1
+ // theme.ts —— 宿主设计数值(theme 能力)的 SDK 契约面:只有类型与读取函数,没有任何数值常量。
2
+ //
3
+ // 约定:
4
+ // - 数值唯一出处是宿主主题(宿主设计系统预设 + 用户主题色 + 明暗 + 界面缩放),由宿主经
5
+ // hostBridge.theme 以只读方式提供;写样式的地方优先用宿主 CSS 变量,读不到 CSS 的地方
6
+ // (画布、X6 等非 CSS 渲染面)才读本能力并订阅变化重绘。
7
+ // - SDK 不得放置设计数值常量——本包经 `file:` 拷贝打进各插件包后,常量会随宿主改版
8
+ // 而过期;缺少 theme 能力的老宿主由插件自行使用自己的回退值(readHostTheme 返回 null)。
9
+ // - tokens 为纯数据;subscribe 的回调是插件自己的函数,不跨边界传给宿主序列化。
10
+ //
11
+ // 下列类型与宿主前端的设计数值类型保持一致(逐字段同形),两边改动须同步。
12
+
13
+ /** 颜色三元组 [r, g, b],每个分量 0-255;使用方经 toCss 转成 CSS 颜色字符串。 */
14
+ export type RGB = readonly [number, number, number];
15
+
16
+ /** 主色色阶的 11 个档位键。 */
17
+ export type HostThemePaletteKey = '50' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900' | '950';
18
+
19
+ /** 宿主设计数值快照(随明暗、主题色、界面缩放变化;每次变化宿主会换出新的快照并递增 version)。 */
20
+ export interface HostThemeTokens {
21
+ color: {
22
+ primary: RGB;
23
+ info: RGB;
24
+ success: RGB;
25
+ warning: RGB;
26
+ error: RGB;
27
+ /** 主色之上的文字色。 */
28
+ onPrimary: RGB;
29
+ /** 主色色阶 50~950。 */
30
+ primaryPalette: Record<HostThemePaletteKey, RGB>;
31
+ container: RGB;
32
+ layout: RGB;
33
+ inverted: RGB;
34
+ text: RGB;
35
+ textSecondary: RGB;
36
+ textHint: RGB;
37
+ fill: RGB;
38
+ fillLightest: RGB;
39
+ fillLight: RGB;
40
+ fillLighter: RGB;
41
+ border: RGB;
42
+ borderLight: RGB;
43
+ borderLighter: RGB;
44
+ borderDark: RGB;
45
+ borderDeep: RGB;
46
+ borderLightest: RGB;
47
+ };
48
+ /** 圆角,单位 px。 */
49
+ radius: { control: number; card: number; block: number; pill: number };
50
+ /** 控件高度与字号(按 small / medium / large 三档),单位 px。 */
51
+ control: {
52
+ height: { small: number; medium: number; large: number };
53
+ fontSize: { small: number; medium: number; large: number };
54
+ };
55
+ /** 文字字号,单位 px,已乘界面缩放。 */
56
+ fontSize: { mini: number; caption: number; body: number; subtitle: number; title: number; display: number };
57
+ /** 间距档,单位 px。 */
58
+ space: { 1: number; 2: number; 3: number; 4: number; 5: number; 6: number };
59
+ /** 阴影(CSS box-shadow 字符串,随明暗变化)。 */
60
+ shadow: { popup: string; dialog: string; drawer: string };
61
+ /** 静态层级(动态弹层由宿主层级栈分配)。 */
62
+ z: { shell: number; dropdown: number; dialog: number; guide: number; message: number };
63
+ /** 宿主字体栈。 */
64
+ fontFamily: string;
65
+ /** 界面缩放系数。 */
66
+ uiScale: number;
67
+ }
68
+
69
+ /**
70
+ * HostTheme —— 宿主在 hostBridge.theme 上提供的只读主题能力。
71
+ * 常驻可见:不需要在 manifest 声明,也不受 hostCaps 裁剪。
72
+ */
73
+ export interface HostTheme {
74
+ /** 当前明暗。 */
75
+ readonly scheme: 'light' | 'dark';
76
+ /** 每次变化(明暗 / 主题色 / 缩放)递增,便于画布类渲染面做缓存失效判断。 */
77
+ readonly version: number;
78
+ /** 当前设计数值快照。 */
79
+ readonly tokens: HostThemeTokens;
80
+ /** 订阅变化;回调收到变化后的主题,返回取消订阅函数(插件卸载时必须调用,防泄漏)。 */
81
+ subscribe(cb: (theme: HostTheme) => void): () => void;
82
+ }
83
+
84
+ /** 判断是否为 [r,g,b] 三个有限数。 */
85
+ function isRgb(value: unknown): value is RGB {
86
+ return Array.isArray(value) && value.length === 3 && value.every((n) => typeof n === 'number' && Number.isFinite(n));
87
+ }
88
+
89
+ /**
90
+ * readHostTheme —— 从 hostBridge 读取 theme 能力。
91
+ *
92
+ * 缺少 theme 能力(老宿主)、bridge 不是对象、或 theme 形状不合法时返回 null,绝不抛错;
93
+ * 插件在拿到 null 时用自己的回退值。只做必要的形状校验(scheme / version / tokens 主干 /
94
+ * subscribe),不逐字段深校验——深层缺失属宿主实现缺陷,不在此兜底。
95
+ */
96
+ export function readHostTheme(bridge: unknown): HostTheme | null {
97
+ try {
98
+ if (bridge === null || typeof bridge !== 'object') return null;
99
+ const candidate = (bridge as { theme?: unknown }).theme;
100
+ if (candidate === null || typeof candidate !== 'object') return null;
101
+ const theme = candidate as Partial<HostTheme>;
102
+ if (theme.scheme !== 'light' && theme.scheme !== 'dark') return null;
103
+ if (typeof theme.version !== 'number' || !Number.isFinite(theme.version)) return null;
104
+ if (typeof theme.subscribe !== 'function') return null;
105
+ const tokens = theme.tokens as HostThemeTokens | undefined;
106
+ if (tokens === null || typeof tokens !== 'object') return null;
107
+ if (tokens.color === null || typeof tokens.color !== 'object' || !isRgb(tokens.color.primary)) return null;
108
+ for (const key of ['radius', 'control', 'fontSize', 'space', 'shadow', 'z'] as const) {
109
+ if (tokens[key] === null || typeof tokens[key] !== 'object') return null;
110
+ }
111
+ return theme as HostTheme;
112
+ } catch {
113
+ // 被裁剪 Proxy 或异常 getter 抛错时同样视为「没有该能力」
114
+ return null;
115
+ }
116
+ }
117
+
118
+ /**
119
+ * toCss —— 把 RGB 三元组转成 CSS 颜色字符串(空格语法,与宿主 `rgb(var(--x) / α)` 写法一致)。
120
+ * 不传 alpha 得 `rgb(r g b)`,传入得 `rgb(r g b / a)`。
121
+ */
122
+ export function toCss(rgb: RGB, alpha?: number): string {
123
+ const [r, g, b] = rgb;
124
+ return alpha === undefined ? `rgb(${r} ${g} ${b})` : `rgb(${r} ${g} ${b} / ${alpha})`;
125
+ }
@@ -0,0 +1,16 @@
1
+ // 确认框服务(confirm)的请求/结果夹具。
2
+ import type { OpenConfirmRequest, OpenConfirmResult } from '../ui';
3
+
4
+ /** 典型请求:删除类不可恢复操作,用 error 档并带换行正文。 */
5
+ export const uiConfirmRequestFixture: OpenConfirmRequest = {
6
+ title: '删除确认',
7
+ content: '确定删除该条记录吗?\n删除后不可恢复。',
8
+ type: 'error',
9
+ positiveText: '删除',
10
+ negativeText: '再想想'
11
+ };
12
+
13
+ /** 与上面请求对应的一份"用户点了确认"结果夹具。 */
14
+ export const uiConfirmResultFixture: OpenConfirmResult = {
15
+ confirmed: true
16
+ };
@@ -0,0 +1,24 @@
1
+ // 通讯录选人器服务(entityPicker)的请求/结果夹具。
2
+ //
3
+ // EntityPickerKind 支持 'user' 与 'dept',OpenEntityPickerResult 为 {confirmed, users, depts} 两数组
4
+ // 形态。本夹具只示范 'user' 档(典型消费方流程引擎只选人不选部门),depts
5
+ // 恒为空数组——与"未选的那档恒为空"的类型注释口径一致。
6
+ import type { OpenEntityPickerRequest, OpenEntityPickerResult } from '../ui';
7
+
8
+ /** 典型请求:多选、限 10 人。 */
9
+ export const uiEntityPickerRequestFixture: OpenEntityPickerRequest = {
10
+ kinds: ['user'],
11
+ multiple: true,
12
+ max: 10,
13
+ title: '选择通知对象'
14
+ };
15
+
16
+ /** 与上面请求对应的一份"用户已确认,选中两人"结果夹具。 */
17
+ export const uiEntityPickerResultFixture: OpenEntityPickerResult = {
18
+ confirmed: true,
19
+ users: [
20
+ { user_id: 'fixture-user-1', login_name: 'fixture.user1', display_name: '夹具用户一', status_code: 'active' },
21
+ { user_id: 'fixture-user-2', login_name: 'fixture.user2', display_name: '夹具用户二', status_code: 'active' }
22
+ ],
23
+ depts: []
24
+ };
@@ -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,16 @@
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';
@@ -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
+ };