feat(embed,ui04): E01 v2 contract skeleton — displayMode/scrollSpeed/reactionsEnabled, v2 loader entry and fixed 195x280 shell

- contracts: EmbedSlotSettings optional v2 fields (carousel default) + SlotSettingsPayload; gen + redocly green
- api: DTO validation + normalization full-set (cn manage + ov public projection share normalizeStoredSettings)
- embed-loader: params v2 parse/merge/url family, loader-v2.js fixed shell (border/radius/#10161E/safe-area, resize ignored, stack gap 12), dual-artifact build+sync; v1 source frozen
- viewer: EmbedPage v=2 branch, EmbedStream (viewport/track/real anchors/collapse/empty), stream.ts pure fns, i18n zh/en
- admin: types + utils (create default vertical-stream, clampScrollSpeed, v1/v2 snippet selection)
- tests: loader 36 (+9 v2), viewer 222, admin 82, api unit 51, v1 embed e2e 20, v2 E01 gate 2 (195x280 desktop+mobile cross-origin, no footer)

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-22 12:50:28 +08:00
parent f8dbc3ab9b
commit 66d1eb3e9f
25 changed files with 1383 additions and 52 deletions
+21
View File
@@ -2123,6 +2123,27 @@ export interface components {
* @default 1000
*/
zIndex: number;
/**
* @description 展示模式(UI-04):carousel=旧版轮播(v1 loader,footer/舞台结构);
* vertical-stream=新版垂直照片流(v2 loader,固定 195×280 连续上滚照片窗,
* 忽略 size/intervalMs/imageFit 的布局作用)。可缺省(默认 carousel——
* UI-04 前旧记录读取归一为旧模式;新建走 v2 由管理端显式提交)。
* @default carousel
* @enum {string}
*/
displayMode: "carousel" | "vertical-stream";
/**
* @description vertical-stream 自动上滚速度(CSS px/秒,UI-04)。可缺省(默认 16);
* 仅 v2 生效,carousel 模式忽略。
* @default 16
*/
scrollSpeed: number;
/**
* @description vertical-stream 点赞心形气泡开关(UI-04)。可缺省(默认 true);
* false 仅隐藏气泡(不产生 WS 订阅),照片滚动不受影响。仅 v2 生效。
* @default true
*/
reactionsEnabled: boolean;
};
/**
* @description 展示位条目(管理视角)。albumId/albumTitle 为当前绑定相册(null=未