@allbluecn/web-app 0.18.2 → 0.19.0

package/src/components/story/detail/story-detail-toolbar/scroll-hint.tsx

@@ -0,0 +1,57 @@
+import * as React from "react";
+
+type ScrollHintProps = {
+  children: React.ReactNode;
+  suffix?: React.ReactNode;
+  className?: string;
+  dataTestId?: string;
+};
+
+/**
+ * 响应式提示条：
+ * - 宽屏（视口 ≥ 640px）：静态单行，文字 + 关闭按钮并排，完整显示
+ * - 窄屏（视口 < 640px）：提示框变窄(max-w-14rem)，文字自然折行，关闭按钮浮在框内右侧
+ *
+ * 响应式用视口宽度判断（不测自身/父元素——会死锁）。
+ */
+export function ScrollHint({ children, suffix, className = "", dataTestId }: ScrollHintProps) {
+  const narrowRef = React.useRef(false);
+  const [narrow, setNarrow] = React.useState(false);
+
+  React.useEffect(() => {
+    const check = () => {
+      const w = window.innerWidth;
+      if (!narrowRef.current && w < 640) {
+        narrowRef.current = true;
+        setNarrow(true);
+      } else if (narrowRef.current && w >= 640) {
+        narrowRef.current = false;
+        setNarrow(false);
+      }
+    };
+    check();
+    window.addEventListener("resize", check);
+    return () => window.removeEventListener("resize", check);
+  }, []);
+
+  return (
+    <span
+      data-testid={dataTestId}
+      className={`inline-flex min-w-0 max-w-full items-center gap-1.5 ${className}`}
+    >
+      {narrow ? (
+        <div className="relative w-full max-w-[14rem] overflow-hidden rounded-md border border-amber-500/30 bg-amber-500/10 px-2 py-1 pr-7 text-xs leading-5 text-amber-700 dark:text-amber-400">
+          <div className="break-words">{children}</div>
+          {suffix && (
+            <span className="absolute right-1 top-1 shrink-0">{suffix}</span>
+          )}
+        </div>
+      ) : (
+        <div className="flex min-w-0 items-center gap-1.5 rounded-md border border-amber-500/30 bg-amber-500/10 px-2 py-1 text-amber-700 dark:text-amber-400">
+          <span className="shrink-0 whitespace-nowrap">{children}</span>
+          {suffix && <span className="shrink-0">{suffix}</span>}
+        </div>
+      )}
+    </span>
+  );
+}

package/src/components/story/detail/story-detail-toolbar/use-panel-frozen-groups.ts

@@ -0,0 +1,97 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { useCallback, useEffect, useRef, useState } from "react";
+
+/**
+ * 详情面板列表的冻结组头派生（依赖/测试用例/关联 BUG 面板共用）。
+ * 与子需求列表 children.tsx 同构，配套的容器结构：
+ *
+ *   <div className="relative flex max-h-[60vh] flex-col overflow-clip rounded-lg border">
+ *     <div ref={scrollRef} className="relative min-h-0 flex-1 overflow-auto" onScroll={onScroll}>
+ *       <div className="min-w-[44rem]">…组头行（registerHeader）+ 数据行…</div>
+ *     </div>
+ *     {frozenGroupKey != null && <div className="absolute z-10 overflow-hidden"
+ *        style={{ top: 0, left: 0, right: scrollbarW, height: 36 }}>活跃主组头</div>}
+ *     {frozenSubGroupKey != null && <div … style={{ top: 36, … }}>活跃子组头</div>}
+ *     <BatchToolbar />（常驻容器底，勿放滚动层内）
+ *   </div>
+ *
+ * 已踩坑（勿回退）：
+ * - 冻结层必须 absolute 覆盖渲染（sticky top-N 相对页面滚动口，纵滚脱钩错位）
+ * - 派生阈值 scrollTop + 1（带组头高余量会未滚先冻，与原位组头堆成两份）
+ * - 滚动条宽用 ResizeObserver 测（滚动条随数据加载才出现，window resize 感知不到）
+ * - 冻结层右缘 right=scrollbarW 对齐滚动可视右缘（原位 sticky right-1 钉滚动条内侧）
+ * - sticky 钉定吃 margin：钉定元素的视觉边距用 right 偏移（right-1），不用 mr-*
+ */
+export function usePanelFrozenGroups() {
+  const scrollRef = useRef<HTMLDivElement>(null);
+  // 注册顺序 = 渲染顺序（主组头→其子组头→下一主组头），派生时遇主组头重置子组
+  const headerEls = useRef(new Map<string, { el: HTMLElement; depth: 0 | 1 }>());
+  const scrollRafId = useRef<number | null>(null);
+  const [frozenGroupKey, setFrozenGroupKey] = useState<string | null>(null);
+  const [frozenSubGroupKey, setFrozenSubGroupKey] = useState<string | null>(null);
+  const [scrollbarW, setScrollbarW] = useState(0);
+
+  useEffect(() => {
+    const el = scrollRef.current;
+    if (!el) return;
+    const measure = () => setScrollbarW(el.offsetWidth - el.clientWidth);
+    measure();
+    const ro = new ResizeObserver(measure);
+    ro.observe(el);
+    return () => ro.disconnect();
+  }, []);
+
+  useEffect(() => () => {
+    if (scrollRafId.current != null) cancelAnimationFrame(scrollRafId.current);
+  }, []);
+
+  const onScroll = useCallback(() => {
+    if (scrollRafId.current != null) return;
+    scrollRafId.current = requestAnimationFrame(() => {
+      scrollRafId.current = null;
+      const sc = scrollRef.current;
+      if (!sc) return;
+      const threshold = sc.scrollTop + 1;
+      let groupKey: string | null = null;
+      let subKey: string | null = null;
+      headerEls.current.forEach((info, key) => {
+        if (info.el.offsetTop > threshold) return;
+        if (info.depth === 0) {
+          groupKey = key;
+          subKey = null;
+        } else {
+          subKey = key;
+        }
+      });
+      setFrozenGroupKey((prev) => (prev === groupKey ? prev : groupKey));
+      setFrozenSubGroupKey((prev) => (prev === subKey ? prev : subKey));
+    });
+  }, []);
+
+  const registerHeader = useCallback(
+    (key: string, depth: 0 | 1) =>
+      (el: HTMLDivElement | null) => {
+        if (el) headerEls.current.set(key, { el, depth });
+        else headerEls.current.delete(key);
+      },
+    [],
+  );
+
+  return { scrollRef, scrollbarW, frozenGroupKey, frozenSubGroupKey, registerHeader, onScroll };
+}

package/src/components/story/detail/story-properties.tsx

@@ -35,11 +35,11 @@ interface PropertyItemProps {
 function PropertyItem({ icon, label, children }: PropertyItemProps) {
   return (
     <div className="flex items-center">
-      <span className="flex w-70 shrink-0 items-center gap-1 text-xs">
+      <span className="flex w-28 shrink-0 items-center gap-2 text-xs">
         {icon}
         {label}
       </span>
-      <div className="flex-1">{children}</div>
+      <div className="min-w-0 flex-1">{children}</div>
     </div>
   );
 }
@@ -60,6 +60,8 @@ interface StoryPropertiesProps {
   iterations?: IterationSummary[];
   onParentChange: (parentId: string | null) => void;
   onLabelsChange: (labelIds: string[]) => void;
+  /** 新标签创建后回调（父级并入标签清单，保证 chip 渲染有名字与颜色） */
+  onLabelCreated?: (label: { id: string; name: string; color: string }) => void;
   onIterationChange?: (iteration: { id: string; name: string } | null) => void;
   onActivities?: (activities: ActivityItem[]) => void;
 }
@@ -71,13 +73,14 @@ export function StoryProperties({
   iterations,
   onParentChange,
   onLabelsChange,
+  onLabelCreated,
   onIterationChange,
   onActivities,
 }: StoryPropertiesProps) {
   return (
     <Collapsible defaultOpen>
-      <div className="px-6 py-4 text-sm font-semibold">{m.story_properties_title()}</div>
-      <CollapsibleContent className="px-6 pb-2 space-y-2">
+      <div className="px-3 py-4 text-sm font-semibold">{m.story_properties_title()}</div>
+      <CollapsibleContent className="px-3 pb-2 space-y-2">
         <Collapsible defaultOpen>
           <CollapsibleTrigger className="flex select-none items-center gap-2 pb-4 text-xs font-semibold hover:text-foreground transition-colors">
             {m.story_properties_basic()}
@@ -105,8 +108,9 @@ export function StoryProperties({
                   labelIds={story.labels.map((l) => l.id)}
                   labels={labels}
                   onChange={onLabelsChange}
-                  variant="button"
+                  variant="chip"
                   aiContext={{ name: () => story.name, description: () => story.description ?? undefined }}
+                  onLabelCreated={onLabelCreated}
                 />
               </PropertyItem>
             )}

package/src/components/story/display/__tests__/display-dropdown-helpers.test.ts

@@ -34,6 +34,7 @@ describe("getSubGroupOptions", () => {
   it("布局不支持子分组时返回空数组", () => {
     expect(getSubGroupOptions("table", "state")).toEqual([]);
     expect(getSubGroupOptions("calendar", "state")).toEqual([]);
+    expect(getSubGroupOptions("timeline", "state")).toEqual([]);
   });
 });
 
@@ -43,10 +44,25 @@ describe("getGroupOptions", () => {
     expect(getGroupOptions("board")).toContain("none");
   });
 
+  it("timeline 分组白名单 = 甘特 clamp 白名单（六键，含甘特专属 iteration）", () => {
+    expect(getGroupOptions("timeline")).toEqual([
+      "none",
+      "state",
+      "priority",
+      "assignee",
+      "labels",
+      "iteration",
+    ]);
+  });
+
+  it("list/board 全集不含 iteration（GROUP_KEYS 数组不动，甘特专属维度不外溢）", () => {
+    expect(getGroupOptions("list")).not.toContain("iteration");
+    expect(getGroupOptions("board")).not.toContain("iteration");
+  });
+
   it("布局不支持分组时返回空数组", () => {
     expect(getGroupOptions("table")).toEqual([]);
     expect(getGroupOptions("calendar")).toEqual([]);
-    expect(getGroupOptions("timeline")).toEqual([]);
   });
 
   it("选定特定项目时隐藏「项目」分组", () => {

package/src/components/story/display/__tests__/display-dropdown.test.tsx

@@ -199,6 +199,15 @@ describe("DisplayDropdown", () => {
     expect(patch.orderDir).toBe("desc");
   });
 
+  it("manual 排序时隐藏排序方向按钮", () => {
+    renderWithTooltip(
+      <DisplayDropdown filters={makeFilters({ orderBy: "manual" })} onChange={vi.fn()} layout="list" {...viewProps} />,
+    );
+    fireEvent.click(screen.getByRole("button", { name: /显示/ }));
+    expect(screen.queryByTestId("order-dir-asc")).toBeNull();
+    expect(screen.queryByTestId("order-dir-desc")).toBeNull();
+  });
+
   it("切换附加选项开关触发 onChange", () => {
     const onChange = vi.fn();
     renderWithTooltip(<DisplayDropdown filters={makeFilters()} onChange={onChange} layout="list" {...viewProps} />);

package/src/components/story/display/__tests__/flatten-story-groups.test.ts

@@ -0,0 +1,42 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// 回归：peek prev/next 须按当前视图展示顺序（分组 → 子组）导航，而非平坦 stories.items。
+import { describe, expect, it } from "vitest";
+import { flattenStoryGroups } from "../flatten-story-groups";
+import type { StoryListItem } from "../../types";
+
+const s = (id: string) => ({ id } as StoryListItem);
+
+describe("flattenStoryGroups", () => {
+  it("子组模式：按父组 → 子组顺序摊平", () => {
+    const nodes = [
+      { items: [], subGroups: [{ items: [s("a"), s("b")] }, { items: [s("c")] }] },
+      { items: [], subGroups: [{ items: [s("d")] }] },
+    ];
+    expect(flattenStoryGroups(nodes).map((x) => x.id)).toEqual(["a", "b", "c", "d"]);
+  });
+
+  it("无子组：按顶层组 items 顺序摊平", () => {
+    const nodes = [{ items: [s("a"), s("b")] }, { items: [s("c")] }];
+    expect(flattenStoryGroups(nodes).map((x) => x.id)).toEqual(["a", "b", "c"]);
+  });
+
+  it("空分组返回空数组", () => {
+    expect(flattenStoryGroups([])).toEqual([]);
+  });
+});

package/src/components/story/display/__tests__/group-fields.test.ts

@@ -16,7 +16,8 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 import { describe, it, expect } from "vitest";
-import { GROUP_FIELD, toGroupFieldPatch } from "../group-fields";
+import { GROUP_FIELD, toGroupFieldPatch, applyStoryPatchToItem } from "../group-fields";
+import type { StoryListItem, UserBrief } from "../../types";
 
 describe("GROUP_FIELD", () => {
   it("state 映射到 state", () => {
@@ -105,3 +106,82 @@ describe("toGroupFieldPatch", () => {
     });
   });
 });
+
+const USER: UserBrief = {
+  id: "u9",
+  username: "u9",
+  email: "u9@example.com",
+  avatarConfig: null,
+  bgShape: null,
+  bgColor: null,
+};
+
+function baseStory(overrides: Partial<StoryListItem> = {}): StoryListItem {
+  return {
+    id: "s1",
+    identifier: "PERF-1",
+    name: "原始标题",
+    description: null,
+    state: "todo",
+    priority: "medium",
+    archived: false,
+    startDate: null,
+    targetDate: null,
+    boardOrder: 0,
+    projectId: null,
+    parentId: null,
+    parent: null,
+    assignee: null,
+    createdBy: USER,
+    labels: [],
+    createdAt: "2026-10-01T00:00:00.000Z",
+    updatedAt: "2026-10-01T00:00:00.000Z",
+    ...overrides,
+  };
+}
+
+const CTX = { users: [USER], labels: [{ id: "l1", name: "Bug", color: "#f00" }] };
+
+describe("applyStoryPatchToItem", () => {
+  it("合并 name / state / priority / 日期并刷新 updatedAt", () => {
+    const next = applyStoryPatchToItem(
+      baseStory(),
+      { name: "新标题", state: "in_progress", priority: "high", startDate: "2026-10-02", targetDate: "2026-10-09" },
+      CTX,
+    );
+    expect(next.name).toBe("新标题");
+    expect(next.state).toBe("in_progress");
+    expect(next.priority).toBe("high");
+    expect(next.startDate).toBe("2026-10-02");
+    expect(next.targetDate).toBe("2026-10-09");
+    expect(next.updatedAt).not.toBe("2026-10-01T00:00:00.000Z");
+  });
+
+  it("assigneeId 命中 users → 展开成 assignee 对象", () => {
+    const next = applyStoryPatchToItem(baseStory(), { assigneeId: "u9" }, CTX);
+    expect(next.assignee).toEqual(USER);
+  });
+
+  it("assigneeId 为 null → assignee 置空", () => {
+    const next = applyStoryPatchToItem(baseStory({ assignee: USER }), { assigneeId: null }, CTX);
+    expect(next.assignee).toBeNull();
+  });
+
+  it("assigneeId 未命中 users → 保留原 assignee", () => {
+    const next = applyStoryPatchToItem(baseStory({ assignee: USER }), { assigneeId: "ghost" }, CTX);
+    expect(next.assignee).toEqual(USER);
+  });
+
+  it("labelIds → 展开成 labels 对象，未知 id 丢弃", () => {
+    const next = applyStoryPatchToItem(baseStory(), { labelIds: ["l1", "unknown"] }, CTX);
+    expect(next.labels).toEqual([{ id: "l1", name: "Bug", color: "#f00" }]);
+  });
+
+  it("未提供的字段保持原值", () => {
+    const original = baseStory({ state: "done", priority: "urgent" });
+    const next = applyStoryPatchToItem(original, { name: "改标题" }, CTX);
+    expect(next.state).toBe("done");
+    expect(next.priority).toBe("urgent");
+    expect(next.createdAt).toBe(original.createdAt);
+  });
+});

package/src/components/story/display/__tests__/group-resolver.test.ts

@@ -16,7 +16,16 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 import { describe, it, expect } from "vitest";
-import { groupBy } from "../group-resolver";
+import {
+  buildGroupMeta,
+  groupBy,
+  groupUniverse,
+  resolveColumnTint,
+  PRIORITY_COLUMN_TINT,
+  STATE_COLUMN_TINT,
+} from "../group-resolver";
+import { STATE_COLOR } from "../../constants";
+import { PRIORITY_COLOR } from "../../priority-icon";
 import type { StoryListItem } from "../../types";
 
 const makeStory = (over: Partial<StoryListItem> & { id: string }): StoryListItem => ({
@@ -94,4 +103,147 @@ describe("groupBy", () => {
     const r = groupBy(items, "state", { users: [], labels: [], projects: [] });
     expect(r.map(g => g.key)).toEqual(["todo"]);
   });
+});
+
+describe("groupUniverse", () => {
+  const u = { id: "u1", username: "张三", email: "z", avatarConfig: null, bgShape: null, bgColor: null };
+  const ctx = {
+    users: [u],
+    labels: [{ id: "l1", name: "紧急", color: "text-red-500" }],
+    projects: [{ id: "p1", name: "项目一", displayId: "P1", icon: "rocket" }],
+  };
+
+  it("state/priority 给出常量全集（含未渲染的空列，items 全空）", () => {
+    expect(groupUniverse("state", ctx).map(n => n.key)).toEqual([
+      "backlog", "todo", "in_progress", "done", "cancelled",
+    ]);
+    expect(groupUniverse("priority", ctx).map(n => n.key)).toEqual([
+      "urgent", "high", "medium", "low", "none",
+    ]);
+    expect(groupUniverse("state", ctx).every(n => n.items.length === 0)).toBe(true);
+  });
+
+  it("assignee/project 依 ctx 动态枚举（含未指派/无项目兜底 key）", () => {
+    expect(groupUniverse("assignee", ctx).map(n => n.key)).toEqual(["u1", "unassigned"]);
+    expect(groupUniverse("assignee", ctx)[0].label).toBe("张三");
+    expect(groupUniverse("project", ctx).map(n => n.key)).toEqual(["p1", "no-project"]);
+  });
+
+  it("labels/createdBy/none 不可跨组写字段 → 无虚显列", () => {
+    expect(groupUniverse("labels", ctx)).toEqual([]);
+    expect(groupUniverse("createdBy", ctx)).toEqual([]);
+    expect(groupUniverse("none", ctx)).toEqual([]);
+  });
+});
+
+describe("buildGroupMeta", () => {
+  const ctx = { users: [], labels: [], projects: [] };
+  const universe = groupUniverse("state", ctx);
+  const serverMiss = { key: "todo", label: "服务端待办", items: [makeStory({ id: "a" })] };
+  const serverExtra = { key: "done", label: "已完成", items: [makeStory({ id: "b" })] };
+
+  it("服务端分组优先于维度全集（同 key 取服务端节点）", () => {
+    const meta = buildGroupMeta([serverMiss], universe);
+    expect(meta.todo.label).toBe("服务端待办");
+    expect(meta.todo.items).toHaveLength(1);
+  });
+
+  it("仅存在于维度全集的 key 也有元数据（标题取 i18n 文案，不回落原始 key）", () => {
+    const meta = buildGroupMeta([serverMiss], universe);
+    expect(meta.backlog.label).toBe(universe.find(n => n.key === "backlog")!.label);
+    expect(meta.backlog.label).not.toBe("backlog");
+    expect(meta.cancelled).toBeDefined();
+  });
+
+  it("不在维度全集、仅服务端返回的 key 同样保留", () => {
+    const meta = buildGroupMeta([serverExtra], universe);
+    expect(meta.done.label).toBe("已完成");
+  });
+});
+
+describe("resolveColumnTint", () => {
+  const ctx = { users: [], labels: [], projects: [] };
+  /** 浓度必须走主题变量：浅色 5% / 深色 10%（globals.css 的 --kanban-column-tint）
+   *  基色必须是表面实色（--kanban-column-tint-base），列底得能完全遮挡下层内容 */
+  const tinted = (color: string) => ({
+    backgroundColor: `color-mix(in srgb, ${color} var(--kanban-column-tint), var(--kanban-column-tint-base))`,
+  });
+
+  it("state 维度取同色系调色板并走主题浓度变量", () => {
+    expect(resolveColumnTint("todo", "state", ctx)).toEqual(tinted("var(--color-blue-500)"));
+    expect(resolveColumnTint("in_progress", "state", ctx)).toEqual(tinted("var(--color-amber-500)"));
+    expect(resolveColumnTint("done", "state", ctx)).toEqual(tinted("var(--color-green-500)"));
+  });
+
+  it("state 的中性态取 bg-muted", () => {
+    expect(resolveColumnTint("backlog", "state", ctx)).toEqual({ className: "bg-muted" });
+    expect(resolveColumnTint("cancelled", "state", ctx)).toEqual({ className: "bg-muted" });
+  });
+
+  it("state 列浅底的色相与 STATE_COLOR 同族（防色系漂移）", () => {
+    const expected = (state: keyof typeof STATE_COLOR) => {
+      const token = STATE_COLOR[state].split(" ").find((c) => c.startsWith("bg-"));
+      return token === "bg-muted" ? "bg-muted" : `--color-${token!.slice(3).split("/")[0]}`;
+    };
+    for (const state of Object.keys(STATE_COLOR) as (keyof typeof STATE_COLOR)[]) {
+      const tint = STATE_COLUMN_TINT[state];
+      expect(tint.backgroundColor ?? tint.className).toContain(expected(state));
+    }
+  });
+
+  it("priority 维度用优先级浅底表，low 与 none 不着色系", () => {
+    expect(resolveColumnTint("urgent", "priority", ctx)).toEqual(tinted("var(--color-red-600)"));
+    expect(resolveColumnTint("high", "priority", ctx)).toEqual(tinted("var(--color-orange-600)"));
+    expect(resolveColumnTint("medium", "priority", ctx)).toEqual(tinted("var(--color-blue-600)"));
+    expect(resolveColumnTint("low", "priority", ctx)).toEqual({ className: "bg-muted" });
+    expect(resolveColumnTint("none", "priority", ctx)).toEqual({});
+  });
+
+  it("priority 列浅底与 PRIORITY_COLOR 的文字色同色号（防色系漂移）", () => {
+    for (const [priority, color] of Object.entries(PRIORITY_COLOR)) {
+      const tint = PRIORITY_COLUMN_TINT[priority];
+      if (color.startsWith("text-muted")) {
+        expect(tint.className ?? "bg-muted").toBe("bg-muted");
+        continue;
+      }
+      const token = color.split(" ").find((c) => c.startsWith("text-"))!;
+      expect(tint.backgroundColor).toContain(`--color-${token.slice(5)}`);
+    }
+  });
+
+  it("assignee 维度取该用户头像背景色并走主题浓度变量", () => {
+    const withUser = {
+      users: [{ id: "u1", username: "甲", email: "a", avatarConfig: null, bgShape: null, bgColor: "#ff0000" }],
+      labels: [],
+      projects: [],
+    };
+    expect(resolveColumnTint("u1", "assignee", withUser)).toEqual(tinted("#ff0000"));
+  });
+
+  it("assignee 的 unassigned 与缺头像色的用户不着色", () => {
+    const withUser = {
+      users: [{ id: "u1", username: "甲", email: "a", avatarConfig: null, bgShape: null, bgColor: null }],
+      labels: [],
+      projects: [],
+    };
+    expect(resolveColumnTint("unassigned", "assignee", withUser)).toEqual({});
+    expect(resolveColumnTint("u1", "assignee", withUser)).toEqual({});
+  });
+
+  it("labels 维度取标签颜色并走主题浓度变量", () => {
+    const withLabel = { users: [], labels: [{ id: "l1", name: "标签七", color: "#8b5cf6" }], projects: [] };
+    expect(resolveColumnTint("l1", "labels", withLabel)).toEqual(tinted("#8b5cf6"));
+  });
+
+  it("labels 的 no-labels 与未知标签不着色", () => {
+    const withLabel = { users: [], labels: [{ id: "l1", name: "标签七", color: "#8b5cf6" }], projects: [] };
+    expect(resolveColumnTint("no-labels", "labels", withLabel)).toEqual({});
+    expect(resolveColumnTint("missing", "labels", withLabel)).toEqual({});
+  });
+
+  it("createdBy / project / none 维度不着色", () => {
+    for (const key of ["createdBy", "project", "none"] as const) {
+      expect(resolveColumnTint("any", key, ctx)).toEqual({});
+    }
+  });
 });