fix(web): stale-closure + focus trap + 去边界强转 + a11y/性能打磨 + 类型化客户端

P1-6 useStyleLearn/useKimiOauth 修 stale-closure 依赖。
P1-7 CommandPalette/Drawer 加 focus trap(新 lib/a11y/focusTrap)。
P1-8 SSE 解析与 server.ts 去 as 强转改类型守卫/运行时校验。
P2 删冗余强转、开 noUncheckedIndexedAccess、Toast 清理+稳定 key、列表 key 稳定化、
  rel=noopener、useMemo 大文本、ConflictCard role=group、useInjection 加锁、
  client.test 真断言。
codegen 重生成 schema.d.ts + 消费 DimensionEntry/ReviewConflictView 强类型。
This commit is contained in:
Yaojia Wang
2026-06-21 19:32:49 +02:00
parent 016509c5c6
commit c6651b74b9
36 changed files with 792 additions and 140 deletions

View File

@@ -139,7 +139,125 @@ export function parseReviewBlock(block: string): ReviewSseEvent | null {
} catch {
return null;
}
return { event, data } as ReviewSseEvent;
return narrowReviewEvent(event, data);
}
function isRecord(v: unknown): v is Record<string, unknown> {
return typeof v === "object" && v !== null && !Array.isArray(v);
}
function asStringArray(v: unknown): string[] {
return Array.isArray(v) ? v.filter((x): x is string => typeof x === "string") : [];
}
function asNumberArray(v: unknown): number[] {
return Array.isArray(v)
? v.filter((x): x is number => typeof x === "number" && Number.isFinite(x))
: [];
}
function nullableString(v: unknown): string | null {
return typeof v === "string" ? v : null;
}
function asPaceIssues(v: unknown): PaceIssue[] {
if (!Array.isArray(v)) return [];
return v.flatMap((x) =>
isRecord(x) && typeof x.where === "string" && typeof x.reason === "string"
? [{ where: x.where, reason: x.reason }]
: [],
);
}
function asStyleSegments(v: unknown): StyleEvent["data"]["segments"] {
if (!Array.isArray(v)) return [];
return v.flatMap((x) =>
isRecord(x) && typeof x.idx === "number" && typeof x.score === "number"
? [{ idx: x.idx, score: x.score, label: nullableString(x.label) }]
: [],
);
}
// 逐事件类型守卫:按 event 名收窄 data 形状;形状不符返回 null安全跳过
function narrowReviewEvent(event: string, data: unknown): ReviewSseEvent | null {
if (!isRecord(data)) return null;
switch (event) {
case "section":
return typeof data.name === "string" && isSectionStatus(data.status)
? { event: "section", data: { name: data.name, status: data.status } }
: null;
case "conflict":
return typeof data.type === "string" &&
typeof data.where === "string" &&
typeof data.suggestion === "string"
? {
event: "conflict",
data: {
type: data.type,
where: data.where,
refs: asStringArray(data.refs),
suggestion: data.suggestion,
},
}
: null;
case "foreshadow":
return isForeshadowKind(data.kind) && typeof data.title === "string"
? {
event: "foreshadow",
data: {
kind: data.kind,
code: nullableString(data.code),
title: data.title,
where: nullableString(data.where),
note: nullableString(data.note),
},
}
: null;
case "pace":
return {
event: "pace",
data: {
water: asPaceIssues(data.water),
hook: data.hook === true,
beat_map: asNumberArray(data.beat_map),
},
};
case "style":
return typeof data.score === "number"
? {
event: "style",
data: {
score: data.score,
segments: asStyleSegments(data.segments),
},
}
: null;
case "done":
return typeof data.length === "number"
? { event: "done", data: { length: data.length } }
: null;
case "error":
return typeof data.code === "string" && typeof data.message === "string"
? {
event: "error",
data: {
code: data.code,
message: data.message,
request_id: nullableString(data.request_id),
},
}
: null;
default:
return null;
}
}
function isSectionStatus(v: unknown): v is SectionStatus {
return v === "started" || v === "done" || v === "incomplete";
}
function isForeshadowKind(v: unknown): v is ForeshadowKind {
return v === "planted" || v === "resolved";
}
// 增量缓冲:吃进一段文本,吐出已完成的事件块(空行分隔),保留未完成尾部。