@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.
- package/LICENSE +202 -0
- package/NOTICE +9 -0
- package/README.md +48 -2
- package/package.json +141 -4
- package/src/action-designer.ts +250 -0
- package/src/attachment-url.ts +195 -0
- package/src/auth/index.ts +6 -0
- package/src/auth/qrcode.ts +519 -0
- package/src/auth/types.ts +261 -0
- package/src/display-style.ts +250 -0
- package/src/editor-frame.ts +623 -0
- package/src/editor-session.ts +1214 -0
- package/src/editor-testing.ts +838 -0
- package/src/editor.ts +1641 -0
- package/src/frame-transport.ts +491 -0
- package/src/frontend-routes.ts +99 -0
- package/src/hooks.ts +48 -0
- package/src/host-caps.ts +93 -0
- package/src/i18n.ts +238 -0
- package/src/im-panel.ts +132 -0
- package/src/image-tools.ts +91 -0
- package/src/index.ts +118 -0
- package/src/interactive-session.ts +94 -0
- package/src/nahida-im.ts +391 -0
- package/src/nahida-ws.ts +23 -0
- package/src/org-directory.ts +78 -0
- package/src/oz-realtime.ts +144 -0
- package/src/page.ts +404 -0
- package/src/print.ts +393 -0
- package/src/surface.ts +281 -0
- package/src/theme-mocks.ts +140 -0
- package/src/theme.ts +125 -0
- package/src/ui-fixtures/confirm.ts +16 -0
- package/src/ui-fixtures/entity-picker.ts +24 -0
- package/src/ui-fixtures/expression-editor.ts +52 -0
- package/src/ui-fixtures/image-cropper.ts +23 -0
- package/src/ui-fixtures/index.ts +16 -0
- package/src/ui-fixtures/org-tri-picker.ts +19 -0
- package/src/ui-fixtures/prompt.ts +19 -0
- package/src/ui-fixtures/record-picker.ts +17 -0
- package/src/ui-fixtures/template-picker.ts +13 -0
- package/src/ui-mocks.ts +250 -0
- package/src/ui.ts +479 -0
- package/src/workflow-designer.ts +475 -0
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
// 附件值 → 地址纯函数:图片 / 附件列的展示、作输出列与候选显示共用。
|
|
2
|
+
//
|
|
3
|
+
// 定位:纯函数、零依赖、无副作用、不读宿主状态。把附件 / 图片字段的值(条目列表)解析成统一条目,
|
|
4
|
+
// 再给出缩略图 / 原图 / 下载地址。表格编辑器(list 候选下拉与弹窗)、历史记录页(插件记录列表)、宿主内置回退
|
|
5
|
+
// 记录列表与视图设计器预览共用这一份——各处**不得自行拼接**宿主图片 / 附件端点路径。
|
|
6
|
+
//
|
|
7
|
+
// 值形态(宿主各出口历史上不完全统一,这里统一兼容):
|
|
8
|
+
// - JSON 文本:`[{"assetId":"img_…","name":"a.png"}]`;
|
|
9
|
+
// - 已解码数组 / 单对象;
|
|
10
|
+
// - 旧形态 `{ data: [...] }`;
|
|
11
|
+
// - 条目标识驼峰 `assetId` 与下划线 `asset_id` 都认(表格编辑器附件写回走下划线,图片走驼峰);
|
|
12
|
+
// - 嵌套数组拍平;同一 assetId 只保留第一次出现(与表达式引擎 SUM / `+` 的去重口径一致)。
|
|
13
|
+
//
|
|
14
|
+
// 地址口径:
|
|
15
|
+
// - 图片资产(`img_` 前缀):原图 `/api/v1/sheet/images/assets/{id}/bytes`,缩略图追加 `variant=thumb`;
|
|
16
|
+
// - 附件资产(`ast_` 前缀):只有下载端点 `/api/v1/sheet/assets/{id}/download`,**不给 bytes 地址**
|
|
17
|
+
// (bytes 端点只认图片资产);即便是图片类型的附件资产,原图 / 缩略图也都落下载端点;
|
|
18
|
+
// - 宿主随查询结果下发 `asset_tickets: { assetId: 票据 }`(查询上下文读票据):
|
|
19
|
+
// 有票据的条目在地址上追加 `qt=<票据>`,无票据时地址不带参数、由图片端点按派生裁决判权。
|
|
20
|
+
|
|
21
|
+
/** 一条附件 / 图片条目(解析后的统一形态)。 */
|
|
22
|
+
export interface AttachmentItem {
|
|
23
|
+
/** 资产标识:`img_…`(图片资产)或 `ast_…`(附件资产);解析时无标识的条目已丢弃。 */
|
|
24
|
+
assetId: string;
|
|
25
|
+
/** 文件名;值里没有时为空串(展示方按需回退)。 */
|
|
26
|
+
name: string;
|
|
27
|
+
/** MIME 类型(值里带了才有)。 */
|
|
28
|
+
contentType?: string;
|
|
29
|
+
/** 字节数(值里带了才有)。 */
|
|
30
|
+
byteSize?: number;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** 单条条目的地址集合。 */
|
|
34
|
+
export interface AttachmentItemUrls {
|
|
35
|
+
/** 是否按图片展示(见 isImageItem)。 */
|
|
36
|
+
isImage: boolean;
|
|
37
|
+
/** 缩略图地址;只有图片条目才有。 */
|
|
38
|
+
thumbUrl?: string;
|
|
39
|
+
/** 原图 / 打开地址;非图片条目等于 downloadUrl。 */
|
|
40
|
+
url: string;
|
|
41
|
+
/** 下载地址。 */
|
|
42
|
+
downloadUrl: string;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** attachmentItemUrls 的选项。 */
|
|
46
|
+
export interface AttachmentUrlOptions {
|
|
47
|
+
/** 宿主随结果下发的查询上下文读票据表(assetId → 票据),对应 wire 字段 `asset_tickets`。 */
|
|
48
|
+
tickets?: Record<string, string> | null;
|
|
49
|
+
/** 地址前缀(默认空串 = 同源相对路径);末尾斜杠会被去掉。 */
|
|
50
|
+
base?: string;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/** 单元格图片(501)与浮动图片(502)两档展示样式码。 */
|
|
54
|
+
const IMAGE_DISPLAY_STYLES = new Set<string>(['501', '502']);
|
|
55
|
+
|
|
56
|
+
/** 展示样式码是否属于图片档(501 单元格图片 / 502 浮动图片)。 */
|
|
57
|
+
export function isImageDisplayStyle(code: string | null | undefined): boolean {
|
|
58
|
+
return !!code && IMAGE_DISPLAY_STYLES.has(String(code).trim());
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** 字段元数据的最小形状(各处字段类型都满足:PageFieldInfo / 宿主 TemplateField / 表达式编辑器字段)。 */
|
|
62
|
+
export interface AttachmentFieldLike {
|
|
63
|
+
data_type?: string | null;
|
|
64
|
+
display_style?: string | null;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** 是否附件类字段(data_type = attachment,含图片字段)。 */
|
|
68
|
+
export function isAttachmentField(field: AttachmentFieldLike | null | undefined): boolean {
|
|
69
|
+
return !!field && String(field.data_type ?? '').trim().toLowerCase() === 'attachment';
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** 是否图片字段(附件类字段且展示样式为 501 / 502)。展示样式为 6 的是普通附件字段。 */
|
|
73
|
+
export function isImageField(field: AttachmentFieldLike | null | undefined): boolean {
|
|
74
|
+
return isAttachmentField(field) && isImageDisplayStyle(field?.display_style);
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** 取对象上第一个非空字符串属性。 */
|
|
78
|
+
function pickString(obj: Record<string, unknown>, keys: readonly string[]): string {
|
|
79
|
+
for (const key of keys) {
|
|
80
|
+
const raw = obj[key];
|
|
81
|
+
if (typeof raw === 'string' && raw.trim()) return raw.trim();
|
|
82
|
+
if (typeof raw === 'number' && Number.isFinite(raw)) return String(raw);
|
|
83
|
+
}
|
|
84
|
+
return '';
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/** 取对象上第一个可解析的非负数属性。 */
|
|
88
|
+
function pickNumber(obj: Record<string, unknown>, keys: readonly string[]): number | undefined {
|
|
89
|
+
for (const key of keys) {
|
|
90
|
+
const raw = obj[key];
|
|
91
|
+
if (raw === null || raw === undefined || raw === '') continue;
|
|
92
|
+
const n = Number(raw);
|
|
93
|
+
if (Number.isFinite(n) && n >= 0) return n;
|
|
94
|
+
}
|
|
95
|
+
return undefined;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/** 把一个值递归展开成候选条目对象(拍平嵌套数组、拆旧 `{data:[…]}`、JSON 文本先解码)。 */
|
|
99
|
+
function collectRawItems(value: unknown, out: Array<Record<string, unknown>>, depth: number): void {
|
|
100
|
+
// 防御异常深嵌套(正常值最多两三层)。
|
|
101
|
+
if (depth > 8 || value === null || value === undefined) return;
|
|
102
|
+
if (typeof value === 'string') {
|
|
103
|
+
const trimmed = value.trim();
|
|
104
|
+
if (!trimmed || (trimmed[0] !== '[' && trimmed[0] !== '{')) return;
|
|
105
|
+
let parsed: unknown;
|
|
106
|
+
try {
|
|
107
|
+
parsed = JSON.parse(trimmed);
|
|
108
|
+
} catch {
|
|
109
|
+
return;
|
|
110
|
+
}
|
|
111
|
+
collectRawItems(parsed, out, depth + 1);
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
if (Array.isArray(value)) {
|
|
115
|
+
for (const item of value) collectRawItems(item, out, depth + 1);
|
|
116
|
+
return;
|
|
117
|
+
}
|
|
118
|
+
if (typeof value === 'object') {
|
|
119
|
+
const obj = value as Record<string, unknown>;
|
|
120
|
+
// 旧形态 `{ data: [...] }`:自身没有资产标识、带 data 数组 / 文本时按容器展开。
|
|
121
|
+
if (!pickString(obj, ['assetId', 'asset_id']) && obj.data !== undefined) {
|
|
122
|
+
collectRawItems(obj.data, out, depth + 1);
|
|
123
|
+
return;
|
|
124
|
+
}
|
|
125
|
+
out.push(obj);
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/**
|
|
130
|
+
* 把附件 / 图片字段的值解析成条目列表。解析不出返回空数组(不抛错)。
|
|
131
|
+
* 无资产标识的条目丢弃;按 assetId 去重(保留首次出现的顺序与元数据)。
|
|
132
|
+
*/
|
|
133
|
+
export function parseAttachmentItems(value: unknown): AttachmentItem[] {
|
|
134
|
+
const raws: Array<Record<string, unknown>> = [];
|
|
135
|
+
collectRawItems(value, raws, 0);
|
|
136
|
+
const seen = new Set<string>();
|
|
137
|
+
const items: AttachmentItem[] = [];
|
|
138
|
+
for (const raw of raws) {
|
|
139
|
+
const assetId = pickString(raw, ['assetId', 'asset_id']);
|
|
140
|
+
if (!assetId || seen.has(assetId)) continue;
|
|
141
|
+
seen.add(assetId);
|
|
142
|
+
const item: AttachmentItem = {
|
|
143
|
+
assetId,
|
|
144
|
+
name: pickString(raw, ['name', 'fileName', 'file_name', 'filename']),
|
|
145
|
+
};
|
|
146
|
+
const contentType = pickString(raw, ['contentType', 'content_type']);
|
|
147
|
+
if (contentType) item.contentType = contentType;
|
|
148
|
+
const byteSize = pickNumber(raw, ['byteSize', 'byte_size']);
|
|
149
|
+
if (byteSize !== undefined) item.byteSize = byteSize;
|
|
150
|
+
items.push(item);
|
|
151
|
+
}
|
|
152
|
+
return items;
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
/** 条目是否按图片展示:图片资产(`img_` 前缀),或 MIME 为 `image/*`。 */
|
|
156
|
+
export function isImageItem(item: Pick<AttachmentItem, 'assetId' | 'contentType'>): boolean {
|
|
157
|
+
if (item.assetId.startsWith('img_')) return true;
|
|
158
|
+
return (item.contentType ?? '').trim().toLowerCase().startsWith('image/');
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
/** 给地址追加查询参数(已有 `?` 用 `&`)。 */
|
|
162
|
+
function appendQuery(url: string, key: string, value: string): string {
|
|
163
|
+
return `${url}${url.includes('?') ? '&' : '?'}${key}=${encodeURIComponent(value)}`;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
/** 条目的地址集合(图片条目给缩略图 + 原图,非图片条目只给下载地址;有票据追加 `qt=`)。 */
|
|
167
|
+
export function attachmentItemUrls(
|
|
168
|
+
item: Pick<AttachmentItem, 'assetId' | 'contentType'>,
|
|
169
|
+
opts?: AttachmentUrlOptions
|
|
170
|
+
): AttachmentItemUrls {
|
|
171
|
+
const base = (opts?.base ?? '').replace(/\/+$/, '');
|
|
172
|
+
const id = encodeURIComponent(item.assetId);
|
|
173
|
+
const ticket = opts?.tickets?.[item.assetId];
|
|
174
|
+
const withTicket = (url: string): string => (ticket ? appendQuery(url, 'qt', ticket) : url);
|
|
175
|
+
const isImage = isImageItem(item);
|
|
176
|
+
// 附件资产(ast_)只有下载端点;其余(img_ 及历史未知前缀)走图片端点取原图。
|
|
177
|
+
const isAttachmentAsset = item.assetId.startsWith('ast_');
|
|
178
|
+
const downloadUrl = withTicket(
|
|
179
|
+
isAttachmentAsset ? `${base}/api/v1/sheet/assets/${id}/download` : `${base}/api/v1/sheet/images/assets/${id}/bytes`
|
|
180
|
+
);
|
|
181
|
+
if (!isImage) return { isImage: false, url: downloadUrl, downloadUrl };
|
|
182
|
+
if (isAttachmentAsset) return { isImage: true, thumbUrl: downloadUrl, url: downloadUrl, downloadUrl };
|
|
183
|
+
const bytes = `${base}/api/v1/sheet/images/assets/${id}/bytes`;
|
|
184
|
+
return {
|
|
185
|
+
isImage: true,
|
|
186
|
+
thumbUrl: withTicket(`${bytes}?variant=thumb`),
|
|
187
|
+
url: withTicket(bytes),
|
|
188
|
+
downloadUrl,
|
|
189
|
+
};
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
/** 条目文件名摘要:文件名用「、」连接,无文件名的条目回退为资产标识(供列宽估算与附件列显示)。 */
|
|
193
|
+
export function attachmentItemsSummary(items: ReadonlyArray<Pick<AttachmentItem, 'assetId' | 'name'>>): string {
|
|
194
|
+
return items.map(item => item.name || item.assetId).join('、');
|
|
195
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
// 登录页插件(auth.login slot)前端契约出口。
|
|
2
|
+
// types.ts:AuthKind/LoginMethod/LoginPageProps/LoginOutcome/AuthErrorCode/AuthLoginHostBridge/
|
|
3
|
+
// definePluginLoginSurface(说明见 SDK 第三方指南 docs/third-party/auth-and-hooks.md)。
|
|
4
|
+
// qrcode.ts:QrCodeRenderer 零依赖 QR Code 生成工具(qr kind 自渲染用)。
|
|
5
|
+
export * from './types';
|
|
6
|
+
export { QrCodeRenderer } from './qrcode';
|