c6651b74b9
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 强类型。
86 lines
2.8 KiB
TypeScript
86 lines
2.8 KiB
TypeScript
// 审稿历史归一：把后端 ReviewHistoryItem 的松散 conflicts（dict[]）收紧成 ReviewConflict[]。
|
||
// 纯逻辑（可单测）；schema 把 conflicts 标成 {[k]:unknown}[]，这里安全收窄。
|
||
|
||
import type { ReviewHistoryItem } from "@/lib/api/types";
|
||
import type {
|
||
ForeshadowKind,
|
||
ForeshadowSuggestion,
|
||
PaceIssue,
|
||
PaceReport,
|
||
ReviewConflict,
|
||
} from "./sse";
|
||
|
||
function asString(v: unknown, fallback = ""): string {
|
||
return typeof v === "string" ? v : fallback;
|
||
}
|
||
|
||
function asOptionalString(v: unknown): string | null {
|
||
return typeof v === "string" ? v : null;
|
||
}
|
||
|
||
function asIntArray(v: unknown): number[] {
|
||
if (!Array.isArray(v)) return [];
|
||
return v.filter((x): x is number => typeof x === "number" && Number.isFinite(x));
|
||
}
|
||
|
||
// 把一条留痕的 conflicts（ReviewConflictView[]，已强类型）映射成 ReviewConflict。
|
||
// 保持顺序=下标身份（对齐冲突 gate）；type 空串回退「未分类」，refs 容忍缺省。
|
||
export function normalizeConflicts(
|
||
item: ReviewHistoryItem | undefined,
|
||
): ReviewConflict[] {
|
||
const raw = item?.conflicts ?? [];
|
||
return raw.map((c) => ({
|
||
type: c.type || "未分类",
|
||
where: c.where,
|
||
refs: c.refs ?? [],
|
||
suggestion: c.suggestion,
|
||
}));
|
||
}
|
||
|
||
// 把一条留痕的 foreshadow_sug（扁平 list，每条带 kind）收紧成建议（缺字段给安全默认）。
|
||
// 对齐 collect 列映射（C4 扩 T3.3）：planted/resolved 扁平成单 list、每条加 kind。
|
||
export function normalizeForeshadowSug(
|
||
item: ReviewHistoryItem | undefined,
|
||
): ForeshadowSuggestion[] {
|
||
const raw = item?.foreshadow_sug ?? [];
|
||
return raw.map((s) => ({
|
||
kind: asKind(s["kind"]),
|
||
code: asOptionalString(s["code"]),
|
||
title: asString(s["title"], "（未命名线索）"),
|
||
where: asOptionalString(s["where"]),
|
||
note: asOptionalString(s["note"]),
|
||
}));
|
||
}
|
||
|
||
function asKind(v: unknown): ForeshadowKind {
|
||
return v === "resolved" ? "resolved" : "planted";
|
||
}
|
||
|
||
// 把一条留痕的 pace（dict）收紧成节奏报告；缺失/非 dict → null（不渲染节拍图）。
|
||
export function normalizePace(
|
||
item: ReviewHistoryItem | undefined,
|
||
): PaceReport | null {
|
||
const raw = item?.pace;
|
||
if (typeof raw !== "object" || raw === null) return null;
|
||
const dict = raw as Record<string, unknown>;
|
||
const waterRaw = Array.isArray(dict["water"]) ? dict["water"] : [];
|
||
const water: PaceIssue[] = waterRaw
|
||
.filter((w): w is Record<string, unknown> => typeof w === "object" && w !== null)
|
||
.map((w) => ({
|
||
where: asString(w["where"]),
|
||
reason: asString(w["reason"]),
|
||
}));
|
||
return {
|
||
water,
|
||
hook: dict["hook"] === true,
|
||
beat_map: asIntArray(dict["beat_map"]),
|
||
};
|
||
}
|
||
|
||
// 最近一条留痕（GET .../reviews 已按新→旧排序）。
|
||
export function latestReview(
|
||
items: readonly ReviewHistoryItem[] | undefined,
|
||
): ReviewHistoryItem | undefined {
|
||
return items?.[0];
|
||
}
|