feat(note): 列表多选纯逻辑——Ctrl/Shift 区间/批量模式（REQ-287 地基）

Author: Aparencia

app/src/utils/noteSelection.test.ts

@@ -0,0 +1,46 @@
+// @vitest-environment jsdom
+/**
+ * noteSelection.test.ts — 笔记列表多选纯逻辑（REQ-287，v0.19.7）。
+ *
+ * @ai-context: 覆盖交互矩阵关键路径——Ctrl 单点加/减、Shift 区间并集
+ *              （乱序也按列表位置）、单选替换、全选/清空；纯函数零依赖。
+ */
+import { describe, expect, it } from "vitest";
+import {
+  emptySelection, rangeSelection, selectAll, singleSelection, toggleSelection,
+} from "./noteSelection";
+
+const ordered = [3, 1, 5, 2, 4]; // 注意：非自然序——验证"按列表位置"语义
+
+describe("noteSelection 多选逻辑（REQ-287）", () => {
+  it("Ctrl 单击：加/减单个成员", () => {
+    const s0 = emptySelection();
+    const s1 = toggleSelection(s0, 1);
+    expect([...s1]).toEqual([1]);
+    const s2 = toggleSelection(s1, 5);
+    expect([...s2].sort()).toEqual([1, 5]);
+    expect(toggleSelection(s2, 1).has(1)).toBe(false);
+  });
+
+  it("Shift 单击：按列表位置区间并入（非 id 大小）", () => {
+    const sel = rangeSelection(emptySelection(), ordered, 1, 5);
+    // ordered 中 1 在位置 1、5 在位置 2 → 区间 {1,5}
+    expect([...sel].sort()).toEqual([1, 5]);
+    const wider = rangeSelection(sel, ordered, 5, 4);
+    // 5 在位置 2、4 在位置 4 → 并集后 {1,2,4,5}
+    expect([...wider].sort()).toEqual([1, 2, 4, 5]);
+  });
+
+  it("anchor 缺失时 Shift 只选目标；反向区间同样成立", () => {
+    expect([...rangeSelection(emptySelection(), ordered, null, 2)]).toEqual([2]);
+    const back = rangeSelection(emptySelection(), ordered, 4, 3); // 位置 4→0 全段
+    expect([...back].sort()).toEqual([1, 2, 3, 4, 5]);
+  });
+
+  it("批量模式行单击=单选替换；全选/清空", () => {
+    const a = toggleSelection(emptySelection(), 1);
+    expect([...singleSelection(a, 7)]).toEqual([7]);
+    expect([...selectAll(ordered)].sort()).toEqual([1, 2, 3, 4, 5]);
+    expect(emptySelection().size).toBe(0);
+  });
+});

app/src/utils/noteSelection.ts

@@ -0,0 +1,53 @@
+/**
+ * noteSelection — 笔记列表多选纯逻辑（REQ-287，v0.19.7）。
+ *
+ * @ai-context: 交互矩阵——去行内 checkbox：Ctrl/Shift+单击多选（Ctrl=加/减单
+ *              id；Shift=首尾区间并集）、「批量选择」模式下行单击=勾选；行
+ *              列顺序（树视图含组序）由调用方以 orderedIds 传入，区间语义
+ *              锚定**列表位置**而非 id 大小。全部纯函数可单测。
+ */
+
+/** Ctrl+单击：切换单个 id 成员资格 */
+export function toggleSelection(prev: ReadonlySet<number>, id: number): Set<number> {
+  const next = new Set(prev);
+  if (next.has(id)) next.delete(id);
+  else next.add(id);
+  return next;
+}
+
+/** Shift+单击：anchor→target 连续区间并入（含两端；目标不在序内=仅目标） */
+export function rangeSelection(
+  prev: ReadonlySet<number>,
+  orderedIds: readonly number[],
+  anchor: number | null,
+  target: number,
+): Set<number> {
+  const next = new Set(prev);
+  const pos = new Map<number, number>();
+  orderedIds.forEach((id, i) => pos.set(id, i));
+  const b = pos.get(target);
+  if (b == null) {
+    next.add(target);
+    return next;
+  }
+  const a = anchor != null ? pos.get(anchor) : null;
+  const [lo, hi] = a == null || a === b
+    ? [b, b]
+    : a < b ? [a, b] : [b, a];
+  for (let i = lo; i <= hi; i += 1) next.add(orderedIds[i]);
+  return next;
+}
+
+/** 批量选择模式 / 修饰键外的行单击：单选（不并集） */
+export function singleSelection(_prev: ReadonlySet<number>, id: number): Set<number> {
+  return new Set([id]);
+}
+
+/** 全选当前可见 / 清空 */
+export function selectAll(ids: readonly number[]): Set<number> {
+  return new Set(ids);
+}
+
+export function emptySelection(): Set<number> {
+  return new Set();
+}