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
+3
View File
@@ -157,6 +157,9 @@ export interface SlotSettingsPayload {
offsetX?: number; // 0..120(默认 16)
offsetBottom?: number; // 0..240(默认 24)
zIndex?: number; // 1..2147483000(默认 1000)
displayMode?: string; // carousel|vertical-stream(默认 carousel,UI-04)
scrollSpeed?: number; // 8..32 CSS px/s(默认 16,UI-04;仅 v2 生效)
reactionsEnabled?: boolean; // 默认 true(UI-04;false 仅隐藏气泡)
}
// 运行时校验用:全部合法事件类型字符串。satisfies 保证 数组 ⊆ 接口 union;
+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=未