diff --git a/package.json b/package.json index 6f97f5a..2099c04 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "shrimp-server", - "version": "0.6.3", + "version": "0.6.4", "description": "Shrimp 框架后端 — 声明式字段驱动的 Node.js 管理后台框架(Express + Mongoose + JWT)", "main": "dist/main/index.js", "types": "dist/main/index.d.ts", diff --git a/src/IShrimpType.ts b/src/IShrimpType.ts index c9c0c4b..b39a766 100644 --- a/src/IShrimpType.ts +++ b/src/IShrimpType.ts @@ -278,9 +278,11 @@ export interface IFieldConfig { rules?: IFieldRule[] // 通用验证规则(前后端共用) /** tab 类型专用:每个 type 对应的子字段配置 */ tabs?: { key: any; label: ILabel; fields: IFieldConfig[] }[] - /** tab 类型专用:自定义序列化(export 列 / `${key}_label` 用),默认 JSON.stringify */ + /** tab 类型专用:展示文本(表格列 `${key}_label`),给人看、可有损好看,默认 JSON.stringify */ + format?: (value: any) => string + /** tab 类型专用:export 序列化,须与 parse 可逆(机器往返),默认 JSON.stringify */ stringify?: (value: any) => string - /** tab 类型专用:自定义反序列化(import 还原对象),默认 JSON.parse */ + /** tab 类型专用:import 反序列化,须与 stringify 可逆,默认 JSON.parse */ parse?: (text: string) => any } diff --git a/src/Shrimp/ShrimpTableModule.ts b/src/Shrimp/ShrimpTableModule.ts index 8d727fa..9c50537 100644 --- a/src/Shrimp/ShrimpTableModule.ts +++ b/src/Shrimp/ShrimpTableModule.ts @@ -60,8 +60,8 @@ export const defaultTypeHandlers: Record = { } return value }, - // 本体原样下发对象(不再 stringify);展示文本走 _label - resLabel: (value, field) => (field.stringify ?? JSON.stringify)(value), + // 本体原样下发对象(不再 stringify);展示文本走 _label,用 format(给人看,可有损) + resLabel: (value, field) => (field.format ?? JSON.stringify)(value), }, } @@ -395,13 +395,15 @@ export class ShrimpTableModule = ITableCrudProto delete shrimpQuery.limit const result = await this.dataSource.list(shrimpQuery) result.list = await this.prepareResponseItems(result.list) - // 导出是"给人看"的边界:把带 resLabel 的结构化字段(如 tab)用其字符串文本替换对象本体, - // 列保持可读,且能被 import 的 reqFilter(parse)原样还原;去掉额外的 _label 列。 + // 导出是机器往返的边界:结构化字段(如 tab)用可逆的 stringify 序列化(默认 JSON), + // import 端的 reqFilter(parse) 能原样还原;展示用的 _label 不进导出,去掉。 const labelFields = this.fields.filter(f => this.getTypeHandler(f)?.resLabel) return result.list.map(item => { const row = this.filterHidden(item) for (const f of labelFields) { - if (row[`${f.key}_label`] !== undefined) row[f.key] = row[`${f.key}_label`] + if (row[f.key] !== undefined && typeof row[f.key] === "object") { + row[f.key] = (f.stringify ?? JSON.stringify)(row[f.key]) + } delete row[`${f.key}_label`] } return row