Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

2.7 KB
Raw Blame
/**
 * 内容等值工具集:供「引用调和 / memo 比较器」使用的纯函数。
 * ---------------------------------------------------------------------------
 * 背景(2026-07-18 首页列表重渲染风暴):store 高频 emit 下,派生索引(Map)与列表
 * 行 props 每轮都换新引用,memo/useMemo 全部失效,整列表反复重渲染把 JS 线程打满。
 * 修法是在各消费点做「内容未变 → 保留旧引用」的调和,这里收敛判定逻辑本体。
 * 语义取舍:JSON.stringify 兜底比较对函数值不敏感(函数被序列化丢弃)、对键序敏感
 * (同构造路径的对象键序稳定)。误判方向是安全侧:比不出相等 → 走原重建/重渲染路径。
 */

export function isPlainObjectOrArray(value: unknown): value is object {
  return !!value && typeof value === 'object';
}

/** 深内容等值:Object.is 快路径,对象/数组退 JSON.stringify(任一侧不可序列化即判不等)。 */
export function deepValueEqual(a: unknown, b: unknown): boolean {
  if (Object.is(a, b)) return true;
  if (isPlainObjectOrArray(a) && isPlainObjectOrArray(b)) {
    const sa = safeStableStringify(a);
    // 双侧都序列化失败(循环引用等)不得判等——那会静默吞掉真实变化(review P2)。
    return sa !== null && sa === safeStableStringify(b);
  }
  return false;
}

/** Map 内容等值:键集合一致且逐值 valueEqual(默认 deepValueEqual)。 */
export function mapContentEqual<K, V>(
  a: ReadonlyMap<K, V>,
  b: ReadonlyMap<K, V>,
  valueEqual: (x: V, y: V) => boolean = deepValueEqual,
): boolean {
  if (a === b) return true;
  if (a.size !== b.size) return false;
  for (const [key, value] of a) {
    if (!b.has(key)) return false;
    if (!valueEqual(value, b.get(key) as V)) return false;
  }
  return true;
}

/**
 * React.memo 数据 props 比较器:全键逐一深比较,**函数 prop 跳过**。
 * 适用前提(使用处必须逐一审计并注释):所有函数 prop 的闭包语义稳定(只闭合
 * router / store / setState 等稳定引用),新旧闭包可互换。数据变化(含嵌套对象)
 * 一律如实触发重渲染,不会造成数据级 stale。
 */
export function dataPropsEqual(
  prev: Readonly<Record<string, unknown>>,
  next: Readonly<Record<string, unknown>>,
): boolean {
  const keys = new Set([...Object.keys(prev), ...Object.keys(next)]);
  for (const key of keys) {
    const a = prev[key];
    const b = next[key];
    if (typeof a === 'function' && typeof b === 'function') continue;
    if (!deepValueEqual(a, b)) return false;
  }
  return true;
}

function safeStableStringify(value: unknown): string | null {
  try {
    return JSON.stringify(value) ?? null;
  } catch {
    return null;
  }
}