@allbluecn/web-app 0.18.2 → 0.19.0

package/src/components/story/display/use-paged-story-groups.ts

@@ -15,7 +15,7 @@
 // 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 { useMemo } from "react";
+import { useCallback, useMemo } from "react";
 import { usePagedGroupsCore } from "@/hooks/use-paged-groups";
 import type { StoryListItem, UserBrief } from "../types";
 import type { StoryFilters } from "../story-toolbar";
@@ -24,7 +24,7 @@ import { serializeFilters } from "../filters";
 import { listStoriesInGroupFn, listStoryGroupsFn, listAllGroupsItemsFn } from "@/server/serverFns/story";
 import { resolveGroupLabel, resolveGroupIcon, resolveGroupColor } from "./group-resolver";
 import type { DisplayOptions, GroupContext, GroupKey, GroupNode } from "./types";
-import type { StoryPatch } from "./group-fields";
+import { applyStoryPatchToItem, type StoryPatch } from "./group-fields";
 import { PRIORITY_RANK, STORY_PRIORITIES, STORY_STATES } from "../constants";
 import { m } from "@/paraglide/messages.js";
 
@@ -98,6 +98,8 @@ const GROUP_TRIGGER_FIELD: Record<GroupKey, keyof StoryPatch | "labels" | null>
   project: "projectId",
   createdBy: null,
   labels: "labels",
+  // 甘特专属维度：仅 timeline 消费，不走服务端分页分组路径
+  iteration: null,
   none: null,
 };
 
@@ -114,12 +116,51 @@ const ORDER_TRIGGER_FIELD: Record<string, keyof StoryPatch | "any" | null> = {
 type PatchContext = {
   users: UserBrief[];
   labels: { id: string; name: string; color: string }[];
+  projects: { id: string; name: string; displayId: string | null; icon: string }[];
   groupBy: GroupKey;
   subGroupBy: GroupKey;
   orderBy: string;
   orderDir: "asc" | "desc";
 };
 
+/** 分组维度 → 稳定排序 rank（priority/state 有既定顺序；其他维度无 rank → 追加末尾，refresh 校正） */
+function groupRank(groupBy: GroupKey, key: string): number | null {
+  if (groupBy === "priority") {
+    const rank = (PRIORITY_RANK as Record<string, number>)[key];
+    return rank ?? null;
+  }
+  if (groupBy === "state") {
+    const idx = STORY_STATES.findIndex((s) => s.value === key);
+    return idx < 0 ? null : idx;
+  }
+  return null;
+}
+
+/** 按 rank 把节点插入已排序数组（rank 未知则追加末尾） */
+function insertNodeSorted<T extends { key: string }>(arr: T[], node: T, rank: (k: string) => number | null): T[] {
+  const r = rank(node.key);
+  if (r == null) return [...arr, node];
+  const idx = arr.findIndex((x) => {
+    const xr = rank(x.key);
+    return xr != null && xr > r;
+  });
+  const next = [...arr];
+  next.splice(idx < 0 ? next.length : idx, 0, node);
+  return next;
+}
+
+function createSubNode(key: string, items: StoryListItem[], ctx: PatchContext): PagedGroupNode {
+  return {
+    key,
+    label: resolveGroupLabel(key, ctx.subGroupBy, ctx),
+    icon: resolveGroupIcon(key, ctx.subGroupBy, ctx),
+    color: resolveGroupColor(key, ctx.subGroupBy),
+    items,
+    total: items.length,
+    hasMore: true,
+  };
+}
+
 /** "refresh"：触发分组规则（或客户端无法精确挪组）；null：未找到行；数组：乐观更新后的 groups */
 type PatchResult = PagedGroupNode[] | "refresh" | null;
 
@@ -149,22 +190,7 @@ function deriveStoryGroupKey(groupBy: GroupKey, s: StoryListItem): string | null
 
 /** 把 StoryPatch 合并进 StoryListItem（id → 完整对象，供乐观显示），并刷新 updatedAt */
 function applyStoryPatch(story: StoryListItem, patch: StoryPatch, ctx: PatchContext): StoryListItem {
-  const next: StoryListItem = { ...story, updatedAt: new Date().toISOString() };
-  if (patch.state !== undefined) next.state = patch.state;
-  if (patch.priority !== undefined) next.priority = patch.priority;
-  if (patch.assigneeId !== undefined) {
-    next.assignee = patch.assigneeId
-      ? ctx.users.find((u) => u.id === patch.assigneeId) ?? story.assignee
-      : null;
-  }
-  if (patch.startDate !== undefined) next.startDate = patch.startDate;
-  if (patch.targetDate !== undefined) next.targetDate = patch.targetDate;
-  if (patch.labelIds !== undefined) {
-    next.labels = patch.labelIds
-      .map((id) => ctx.labels.find((l) => l.id === id))
-      .filter((l): l is { id: string; name: string; color: string } => l != null);
-  }
-  return next;
+  return applyStoryPatchToItem(story, patch, ctx);
 }
 
 /** null = +∞（对齐 PostgreSQL：asc nulls last / desc nulls first） */
@@ -255,6 +281,104 @@ function applyPatchToGroups(groups: PagedGroupNode[], storyId: string, patch: St
   return null;
 }
 
+/** 顶层分组变化：把 story 从源（子）组移到目标（子）组；目标组未加载时本地创建并按 rank 插入。
+ *  与行内编辑共用——列表视图与看板一样即时反映分组迁移，不依赖网络重拉。 */
+function moveStoryBetweenParents(
+  groups: PagedGroupNode[],
+  fromGi: number,
+  fromSi: number,
+  nextStory: StoryListItem,
+  ctx: PatchContext,
+): PatchResult {
+  const targetKey = deriveStoryGroupKey(ctx.groupBy, nextStory);
+  if (targetKey == null) return "refresh";
+  const subKey = ctx.subGroupBy !== "none" ? deriveStoryGroupKey(ctx.subGroupBy, nextStory) : null;
+  if (subKey == null) return "refresh";
+
+  // 从源（父组 fromGi 的子组 fromSi）移除；源子组清空后删除，父组子组全空则删除父组
+  const source = groups[fromGi];
+  const sourceSubs = (source.subGroups ?? []).map((sg, j) =>
+    j === fromSi ? bumpTotal({ ...sg, items: sg.items.filter((s) => s.id !== nextStory.id) }, -1) : sg,
+  );
+  const cleanedSubs = sourceSubs.filter((sg) => sg.items.length > 0);
+  const withoutSource: PagedGroupNode[] =
+    cleanedSubs.length === 0
+      ? groups.filter((_, i) => i !== fromGi)
+      : groups.map((g, i) =>
+          i === fromGi ? recountParentTotalCount({ ...g, subGroups: cleanedSubs }) : g,
+        );
+
+  const targetGi = withoutSource.findIndex((g) => g.key === targetKey);
+  if (targetGi < 0) {
+    const newGroup: PagedGroupNode = {
+      key: targetKey,
+      label: resolveGroupLabel(targetKey, ctx.groupBy, ctx),
+      icon: resolveGroupIcon(targetKey, ctx.groupBy, ctx),
+      color: resolveGroupColor(targetKey, ctx.groupBy),
+      items: [],
+      subGroups: [createSubNode(subKey, [nextStory], ctx)],
+      total: 1,
+      totalCount: 1,
+    };
+    return insertNodeSorted(withoutSource, newGroup, (k) => groupRank(ctx.groupBy, k));
+  }
+
+  const targetSubs = withoutSource[targetGi].subGroups ?? [];
+  const targetSubIdx = targetSubs.findIndex((sg) => sg.key === subKey);
+  if (targetSubIdx < 0) {
+    const newSubs = insertNodeSorted(targetSubs, createSubNode(subKey, [nextStory], ctx), (k) => groupRank(ctx.subGroupBy, k));
+    return withoutSource.map((g, i) =>
+      i === targetGi
+        ? recountParentTotalCount({ ...g, subGroups: newSubs, totalCount: (g.totalCount ?? 0) + 1 })
+        : g,
+    );
+  }
+  const targetSub = targetSubs[targetSubIdx];
+  const targetSubItems = reinsert(targetSub.items, nextStory.id, nextStory, ctx.orderBy, ctx.orderDir);
+  const updatedTargetSubs = targetSubs.map((sg, i) =>
+    i === targetSubIdx ? bumpTotal({ ...sg, items: targetSubItems }, 1) : sg,
+  );
+  return withoutSource.map((g, i) =>
+    i === targetGi ? recountParentTotalCount({ ...g, subGroups: updatedTargetSubs }) : g,
+  );
+}
+
+/** 顶层分组变化（行直挂顶层组模式）：把 story 从源组移到目标组；目标组未加载时本地创建并按 rank 插入 */
+function moveStoryInFlatGroups(
+  groups: PagedGroupNode[],
+  fromGi: number,
+  nextStory: StoryListItem,
+  ctx: PatchContext,
+): PatchResult {
+  const targetKey = deriveStoryGroupKey(ctx.groupBy, nextStory);
+  if (targetKey == null) return "refresh";
+
+  const source = groups[fromGi];
+  const sourceItems = source.items.filter((s) => s.id !== nextStory.id);
+  let withoutSource = groups.map((g, i) => (i === fromGi ? bumpTotal({ ...g, items: sourceItems }, -1) : g));
+  // 源组清空后删除（与服务端 showEmptyGroups=false 一致）
+  if (source.items.length > 0 && sourceItems.length === 0) {
+    withoutSource = withoutSource.filter((_, i) => i !== fromGi);
+  }
+
+  const targetGi = withoutSource.findIndex((g) => g.key === targetKey);
+  if (targetGi < 0) {
+    const newGroup: PagedGroupNode = {
+      key: targetKey,
+      label: resolveGroupLabel(targetKey, ctx.groupBy, ctx),
+      icon: resolveGroupIcon(targetKey, ctx.groupBy, ctx),
+      color: resolveGroupColor(targetKey, ctx.groupBy),
+      items: [nextStory],
+      total: 1,
+      hasMore: true,
+    };
+    return insertNodeSorted(withoutSource, newGroup, (k) => groupRank(ctx.groupBy, k));
+  }
+
+  const targetItems = reinsert(withoutSource[targetGi].items, nextStory.id, nextStory, ctx.orderBy, ctx.orderDir);
+  return withoutSource.map((g, i) => (i === targetGi ? bumpTotal({ ...g, items: targetItems }, 1) : g));
+}
+
 /** 行在父组 g 的子组 si 内：父组（顶层维度）不变，仅可能在兄弟子组间挪动 */
 function patchInParentWithSubGroups(
   groups: PagedGroupNode[],
@@ -270,8 +394,10 @@ function patchInParentWithSubGroups(
 
   const subTrigger = GROUP_TRIGGER_FIELD[ctx.subGroupBy];
   const topTrigger = GROUP_TRIGGER_FIELD[ctx.groupBy];
-  // 顶层分组维度被编辑（或 labels）→ 跨父组挪动，交给 refresh
-  if (patchTouches(topTrigger, patch) || subTrigger === "labels") return "refresh";
+  // labels 无法精确归属（客户端无全量 label 组）→ 交给 refresh；
+  // 顶层分组维度被编辑 → 本地移动到目标父组（目标未加载则 refresh 校正）
+  if (subTrigger === "labels") return "refresh";
+  if (patchTouches(topTrigger, patch)) return moveStoryBetweenParents(groups, gi, si, nextStory, ctx);
 
   let targetSub = source;
   let moved = false;
@@ -321,8 +447,8 @@ function patchInFlatGroups(
       i === gi ? { ...g, items: reinsert(g.items, nextStory.id, nextStory, ctx.orderBy, ctx.orderDir) } : g,
     );
   }
-  // 分组维度被编辑（含 labels）→ 交给 refresh
-  return "refresh";
+  // 分组维度被编辑 → 本地移动到目标组（目标组未加载则交给 refresh 校正）
+  return moveStoryInFlatGroups(groups, gi, nextStory, ctx);
 }
 
 function replaceInSubGroups(
@@ -370,8 +496,11 @@ export function usePagedStoryGroups(args: PagedStoriesArgs): {
   patchStory: (storyId: string, patch: StoryPatch) => void;
 } {
   const { filters, conditions, display, users, labels, projects, enabled = true } = args;
-  const groupBy = display.groupBy;
-  const subGroupBy = display.subGroupBy;
+  // iteration 为甘特专属维度：分页分组仅 list/board 消费（groupBy 运行时已被
+  // filterDisplayOptionsForLayout clamp），此处归一收窄类型面对齐 serverFn
+  // validator 的 GROUP_KEYS 严格集
+  const groupBy = display.groupBy === "iteration" ? "none" : display.groupBy;
+  const subGroupBy = display.subGroupBy === "iteration" ? "none" : display.subGroupBy;
   const pageSize = display.pageSize;
 
   const sig = useMemo(
@@ -380,17 +509,17 @@ export function usePagedStoryGroups(args: PagedStoriesArgs): {
         filters,
         conditions,
         groupBy,
-        display.subGroupBy,
+        subGroupBy,
         display.orderBy,
         display.orderDir,
         pageSize,
       ]),
-    [filters, conditions, groupBy, display.subGroupBy, display.orderBy, display.orderDir, pageSize],
+    [filters, conditions, groupBy, subGroupBy, display.orderBy, display.orderDir, pageSize],
   );
 
   const core = usePagedGroupsCore<PagedGroupNode, StoryListItem, {
     groupBy: typeof groupBy;
-    subGroupBy: GroupKey;
+    subGroupBy: typeof subGroupBy;
     pageSize: number;
     orderBy: typeof display.orderBy;
     orderDir: typeof display.orderDir;
@@ -576,6 +705,7 @@ export function usePagedStoryGroups(args: PagedStoriesArgs): {
       applyPatchToGroups(groups, storyId, patch as StoryPatch, {
         users: args.users,
         labels: args.labels,
+        projects: args.projects,
         groupBy: req.groupBy,
         subGroupBy: req.subGroupBy,
         orderBy: req.orderBy,
@@ -583,13 +713,26 @@ export function usePagedStoryGroups(args: PagedStoriesArgs): {
       }),
   });
 
+  // 引用稳定（看板 memo 契约，任务 42 对照 bug 侧 54bc6c65c 先例）：core 的
+  // loadMore/dispatchPatch/refresh 经 ref 读最新实现、引用恒定（use-paged-groups
+  // 回调注释），包装层不得用内联箭头——每次渲染换引用会把消费方直传的回调依赖
+  // 拖垮，下游经 useMemo 装配的 config/props 全部失效。
+  const loadMore = useCallback(
+    (groupKey: string, subGroupKey?: string) => {
+      core.loadMore(groupKey, subGroupKey);
+    },
+    [core.loadMore],
+  );
+  const patchStory = useCallback(
+    (storyId: string, patch: StoryPatch) => core.dispatchPatch(storyId, patch),
+    [core.dispatchPatch],
+  );
+
   return {
     groups: core.groups,
     isLoading: core.isLoading,
-    loadMore: (groupKey, subGroupKey) => {
-      core.loadMore(groupKey, subGroupKey);
-    },
+    loadMore,
     refresh: core.refresh,
-    patchStory: (storyId, patch) => core.dispatchPatch(storyId, patch),
+    patchStory,
   };
 }

package/src/components/story/filters/field-configs.tsx

@@ -0,0 +1,263 @@
+// 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/>.
+
+// story 筛选字段配置层（原 story/filters/filter-types.ts + 值编辑器/chip 渲染
+// 的属性 switch 收拢于此）：类型与序列化已上移至 list-kit 共享层，此文件只保留
+// story 专属的 key 联合、i18n 文案/图标配置、值编辑器与值 chip 渲染器及窄化实例。
+// 组件运行时由共享 createFiltersModule 实例化（见 ./index.tsx），消费方 import 路径不变。
+import { m } from '@/paraglide/messages.js';
+import { ListFilter, Flag, CircleUser, Tag, Calendar, Type, type LucideIcon } from "lucide-react";
+import { parseISO, isValid } from "date-fns";
+import type { ReactNode } from "react";
+import { UserAvatar } from "@/components/shared-kit";
+import {
+  createDefaultCondition as createDefaultConditionIn,
+  FilterDateSelect,
+  FilterFallbackValue,
+  FILTER_VALUE_CHIP_CLASS,
+  type FilterValueChipContext,
+  type FilterValueEditorContext,
+  type FiltersModuleOptions,
+} from "@/components/shared-kit/list-kit/filters";
+import type {
+  FilterCondition as SharedFilterCondition,
+  FilterFieldConfig as SharedFilterFieldConfig,
+  FilterOperator,
+  FilterFieldType,
+} from "@/components/shared-kit/list-kit/filters/types";
+import { cn } from "@/lib/utils";
+import { PriorityIcon } from "../priority-icon";
+import { STORY_STATES, STATE_ICON, PRIORITY_LABEL, type StoryPriority, type StoryState } from "../constants";
+import { StateEditor } from "../inline-editors/state-editor";
+import { PriorityEditor } from "../inline-editors/priority-editor";
+import { AssigneeEditor } from "../inline-editors/assignee-editor";
+import { LabelsEditor } from "../inline-editors/labels-editor";
+import { TitleEditor } from "../inline-editors/title-editor";
+import type { UserBrief } from "../types";
+
+export { serializeFilters, deserializeFilters, OPERATOR_LABELS, generateConditionId } from "@/components/shared-kit/list-kit/filters";
+export type { FilterOperator, FilterFieldType };
+
+export type FilterKey = "state" | "priority" | "assigneeId" | "labelId" | "createdDate" | "targetDate" | "title";
+
+export interface FilterCondition extends SharedFilterCondition<FilterKey> {}
+
+export interface FilterFieldConfig extends SharedFilterFieldConfig<FilterKey> {}
+
+const SELECT_OPERATORS: FilterOperator[] = ["is", "is_not", "is_any_of", "is_not_any_of", "is_empty", "is_not_empty"];
+const USER_OPERATORS: FilterOperator[] = ["is", "is_not", "is_any_of", "is_not_any_of", "is_empty", "is_not_empty"];
+const DATE_OPERATORS: FilterOperator[] = ["is", "is_not", "before", "after", "on_or_before", "on_or_after", "between", "is_empty", "is_not_empty"];
+const TEXT_OPERATORS: FilterOperator[] = ["contains", "not_contains", "is_empty", "is_not_empty"];
+
+// ---------------------------------------------------------------------------
+// 值编辑器渲染器（原 filter-value-input.tsx 的 property switch 原样搬移；
+// multi/selected/toggleMultiValue 由共享 FilterValueInput 计算后经 ctx 注入）
+// ---------------------------------------------------------------------------
+
+const compactBtn = "h-6 rounded-sm bg-muted px-2 text-xs font-normal";
+
+function renderValueEditor({ property, operator, value, onChange, multi, selected, toggleMultiValue, users, labels }: FilterValueEditorContext<FilterKey>): ReactNode {
+  switch (property) {
+    case "state":
+      return (
+        <StateEditor
+          value={(selected[0] as StoryState) ?? "backlog"}
+          onChange={(v) => onChange(v)}
+          mode={multi ? "multi" : "single"}
+          selected={selected}
+          onMultiChange={toggleMultiValue}
+          className={compactBtn}
+        />
+      );
+    case "priority":
+      return (
+        <PriorityEditor
+          value={(selected[0] as StoryPriority) ?? "none"}
+          onChange={(v) => onChange(v)}
+          mode={multi ? "multi" : "single"}
+          selected={selected}
+          onMultiChange={toggleMultiValue}
+          className={compactBtn}
+        />
+      );
+    case "assigneeId": {
+      const realSelected = selected.filter((id) => id !== "__none__");
+      const selectedUser = !multi && realSelected[0] ? users?.find((u) => u.id === realSelected[0]) ?? null : null;
+      return (
+        <AssigneeEditor
+          assignee={selectedUser as UserBrief | null}
+          users={(users ?? []) as UserBrief[]}
+          onChange={(id) => onChange(id === null ? "__none__" : (id ?? ""))}
+          mode={multi ? "multi" : "single"}
+          selected={selected}
+          onMultiChange={toggleMultiValue}
+          className={compactBtn}
+        />
+      );
+    }
+    case "labelId":
+      return (
+        <LabelsEditor
+          labelIds={selected}
+          labels={labels ?? []}
+          onChange={(ids) => onChange(ids.length ? ids.join(",") : "")}
+          mode={multi ? "multi" : "single"}
+          className={compactBtn}
+          maxVisibleLabels={5}
+        />
+      );
+    case "createdDate":
+    case "targetDate":
+      return <FilterDateSelect operator={operator} value={value} onChange={onChange} />;
+    case "title":
+      return <TitleEditor value={value} onChange={onChange} className="w-32" />;
+    default:
+      return null;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 值 chip 渲染器（原 applied-filters.tsx 的 ValueChip switch 原样搬移；
+// between 范围段仍由共享 AppliedFilters 的 DateRangeChip 处理，不经此函数）
+// ---------------------------------------------------------------------------
+
+function renderValueChip({ property, valueItem, users, labels }: FilterValueChipContext<FilterKey>): ReactNode {
+  switch (property) {
+    case "state": {
+      const st = STORY_STATES.find((s) => s.value === valueItem);
+      if (!st) return <FilterFallbackValue value={valueItem} />;
+      const SI = STATE_ICON[st.value];
+      const tc = st.color.split(" ").find((c) => c.startsWith("text")) ?? "";
+      return (
+        <span className={FILTER_VALUE_CHIP_CLASS}>
+          <SI className={cn("size-3", tc)} />
+          <span className={cn("whitespace-nowrap", tc)}>{st.label()}</span>
+        </span>
+      );
+    }
+    case "priority": {
+      const p = valueItem as StoryPriority;
+      return (
+        <span className={FILTER_VALUE_CHIP_CLASS}>
+          <PriorityIcon priority={p} />
+          <span className="whitespace-nowrap">{PRIORITY_LABEL[p]?.() ?? valueItem}</span>
+        </span>
+      );
+    }
+    case "assigneeId": {
+      if (valueItem === "__none__") {
+        return (
+          <span className={FILTER_VALUE_CHIP_CLASS}>
+            <CircleUser className="size-3 text-muted-foreground" />
+            <span className="whitespace-nowrap text-muted-foreground">{m.story_filter_unassignedAssignee()}</span>
+          </span>
+        );
+      }
+      const u = users?.find((user) => user.id === valueItem);
+      if (!u) return <FilterFallbackValue value={valueItem} />;
+      return (
+        <span className={FILTER_VALUE_CHIP_CLASS}>
+          <UserAvatar
+            avatarConfig={u.avatarConfig}
+            bgShape="circle"
+            bgColor={u.bgColor}
+            name={u.username}
+            size="xs"
+            className="!w-4 !h-4"
+          />
+          <span className="whitespace-nowrap">{u.username}</span>
+        </span>
+      );
+    }
+    case "labelId": {
+      const l = labels?.find((lb) => lb.id === valueItem);
+      if (!l) return <FilterFallbackValue value={valueItem} />;
+      return (
+        <span className={FILTER_VALUE_CHIP_CLASS}>
+          <span className="inline-block size-2 rounded-full" style={{ backgroundColor: l.color }} />
+          <span className="whitespace-nowrap">{l.name}</span>
+        </span>
+      );
+    }
+    case "createdDate":
+    case "targetDate": {
+      const d = parseISO(valueItem);
+      return (
+        <span className={FILTER_VALUE_CHIP_CLASS}>
+          <Calendar className="size-3 text-muted-foreground" />
+          {/* 单值日期 chip 与共享 between chip 同一口径（Task 37 Ruling 收口，任务 42 必带④）：
+              zh「M月d日」/ en「M/d」，不再走 date-fns 的硬编码 MM/dd */}
+          <span className="whitespace-nowrap">
+            {isValid(d)
+              ? m.list_kit_filter_date_short({ month: d.getMonth() + 1, day: d.getDate() })
+              : valueItem}
+          </span>
+        </span>
+      );
+    }
+    default:
+      return <FilterFallbackValue value={valueItem} />;
+  }
+}
+
+// 原 AppliedFilters 的归档显隐判定（state 含 done/cancelled 且非排除型操作符）
+function hasArchiveableState(conditions: FilterCondition[]): boolean {
+  return conditions.some((c) => {
+    if (c.property !== "state") return false;
+    if (c.operator === "is_not" || c.operator === "is_not_any_of") return false;
+    const values = c.value.split(",").filter(Boolean);
+    return values.some((v) => v === "done" || v === "cancelled");
+  });
+}
+
+export const STORY_FILTER_FIELD_CONFIGS: Record<FilterKey, FilterFieldConfig> = {
+  title: { key: "title", label: m.story_filter_field_title, icon: Type, fieldType: "text", operators: TEXT_OPERATORS, defaultOperator: "contains" },
+  state: { key: "state", label: m.story_filter_field_state, icon: ListFilter, fieldType: "select", operators: SELECT_OPERATORS, defaultOperator: "is", defaultValue: "backlog" },
+  priority: { key: "priority", label: m.story_filter_field_priority, icon: Flag, fieldType: "select", operators: SELECT_OPERATORS, defaultOperator: "is", defaultValue: "none" },
+  assigneeId: { key: "assigneeId", label: m.story_filter_field_assignee, icon: CircleUser, fieldType: "user", operators: USER_OPERATORS, defaultOperator: "is", defaultValue: "__none__" },
+  labelId: { key: "labelId", label: m.story_filter_field_label, icon: Tag, fieldType: "multi_select", operators: SELECT_OPERATORS, defaultOperator: "is_any_of" },
+  createdDate: { key: "createdDate", label: m.story_filter_field_createdDate, icon: Calendar, fieldType: "date", operators: DATE_OPERATORS, defaultOperator: "is" },
+  targetDate: { key: "targetDate", label: m.story_filter_field_targetDate, icon: Calendar, fieldType: "date", operators: DATE_OPERATORS, defaultOperator: "is" },
+};
+
+// 消费方兼容：原 FILTER_FIELD_CONFIGS 数组（顺序 = 配置表声明序）
+export const FILTER_FIELD_CONFIGS: FilterFieldConfig[] = Object.values(STORY_FILTER_FIELD_CONFIGS);
+
+export const STORY_FILTERS_MODULE_OPTIONS: FiltersModuleOptions<FilterKey> = {
+  renderValueEditor,
+  renderValueChip,
+  hasArchiveableConditions: hasArchiveableState,
+  archiveAllLabel: m.story_filters_archiveAll,
+};
+
+export function getFilterConfig(key: FilterKey): FilterFieldConfig {
+  // own-property 守卫：存量视图 JSON 的 property 可能撞上 Object.prototype 键名
+  // （如 "constructor"），直接索引会沿原型链取到 truthy 函数，必须回落首配置。
+  return Object.hasOwn(STORY_FILTER_FIELD_CONFIGS, key) ? STORY_FILTER_FIELD_CONFIGS[key] : FILTER_FIELD_CONFIGS[0];
+}
+
+export function getFilterLabel(key: FilterKey): () => string {
+  return getFilterConfig(key).label;
+}
+
+export function getFilterIcon(key: FilterKey): LucideIcon {
+  return getFilterConfig(key).icon;
+}
+
+export function createDefaultCondition(property: FilterKey): FilterCondition {
+  return createDefaultConditionIn(STORY_FILTER_FIELD_CONFIGS, property);
+}

package/src/components/story/filters/index.tsx

@@ -15,8 +15,17 @@
 // 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/>.
 
-export { StoryFilterToggle } from "./filter-toggle";
-export { StoryFilterRow } from "./filter-row";
-export { AppliedFilters } from "./applied-filters";
-export { deserializeFilters, serializeFilters, createDefaultCondition, getFilterConfig, getFilterLabel, getFilterIcon, FILTER_FIELD_CONFIGS, OPERATOR_LABELS } from "./filter-types";
-export type { FilterCondition, FilterKey, FilterOperator, FilterFieldType } from "./filter-types";
+// story 筛选桶导出 = 共享 createFiltersModule 的七字段实例（UI 对齐一期 PR-3
+// 任务 11：原六组件收拢至 shared-kit/list-kit/filters 参数化工厂，此处仅装配；
+// 导出名与组件 props 签名对消费方完全不变，字段配置与业务渲染器见 ./field-configs）。
+import { createFiltersModule } from "@/components/shared-kit/list-kit/filters";
+import { STORY_FILTERS_MODULE_OPTIONS, STORY_FILTER_FIELD_CONFIGS } from "./field-configs";
+
+const storyFilters = createFiltersModule(STORY_FILTER_FIELD_CONFIGS, STORY_FILTERS_MODULE_OPTIONS);
+
+export const StoryFilterToggle = storyFilters.FilterToggle;
+export const StoryFilterRow = storyFilters.FilterRow;
+export const AppliedFilters = storyFilters.AppliedFilters;
+
+export { deserializeFilters, serializeFilters, createDefaultCondition, getFilterConfig, getFilterLabel, getFilterIcon, FILTER_FIELD_CONFIGS, OPERATOR_LABELS } from "./field-configs";
+export type { FilterCondition, FilterKey, FilterOperator, FilterFieldType } from "./field-configs";

package/src/components/story/inline-editors/__tests__/labels-editor.test.tsx

@@ -37,11 +37,13 @@ vi.mock("@/components/ui/toast", () => ({
 const mocks = vi.hoisted(() => ({
   suggestStoryLabelsFn: vi.fn(),
   createLabelFn: vi.fn(),
+  listLabelsFn: vi.fn().mockResolvedValue([]),
 }));
 
 vi.mock("@/server/serverFns/story", () => ({
   suggestStoryLabelsFn: mocks.suggestStoryLabelsFn,
   createLabelFn: mocks.createLabelFn,
+  listLabelsFn: mocks.listLabelsFn,
 }));
 
 const LABELS = [

package/src/components/story/inline-editors/__tests__/priority-editor.test.tsx

@@ -166,4 +166,19 @@ describe("PriorityEditor", () => {
     const chip = screen.getByText("紧急").closest("span.border-border");
     expect(chip).toBeNull();
   });
+
+  it("variant=button + none 只渲染图标按钮（不显示「无」文案）", () => {
+    renderEditor({ variant: "button", value: "none" });
+    expect(screen.queryByText("无")).toBeNull();
+    expect(document.querySelector("button svg")).not.toBeNull();
+  });
+
+  it("variant=button + none 仍可打开弹窗选择优先级", () => {
+    const onChange = vi.fn();
+    renderEditor({ variant: "button", value: "none", onChange });
+    fireEvent.click(document.querySelector("button")!);
+    const target = getOptionButtons().find((b) => b.textContent?.includes("高"));
+    fireEvent.click(target!);
+    expect(onChange).toHaveBeenCalledWith("high");
+  });
 });

package/src/components/story/inline-editors/assignee-editor.tsx

@@ -40,9 +40,11 @@ interface AssigneeEditorProps {
   variant?: "chip" | "button";
   /** 成员范围：'project'=仅项目成员（默认），'team'=所有团队成员 */
   scope?: "project" | "team";
+  /** open 状态外泄（协同 editing 标记挂点，任务 20） */
+  onOpenChange?: (open: boolean) => void;
 }
 
-export function AssigneeEditor({ assignee, users, onChange, mode = "single", selected, onMultiChange, className, variant = "chip", scope = "project" }: AssigneeEditorProps) {
+export function AssigneeEditor({ assignee, users, onChange, mode = "single", selected, onMultiChange, className, variant = "chip", scope = "project", onOpenChange }: AssigneeEditorProps) {
   const [open, setOpen] = useState(false);
   const [search, setSearch] = useState("");
   const isMulti = mode === "multi";
@@ -55,9 +57,9 @@ export function AssigneeEditor({ assignee, users, onChange, mode = "single", sel
   const isProjectScope = currentScope === "project";
 
   return (
-    <Popover open={open} onOpenChange={(v) => { setOpen(v); if (v) setSearch(""); }}>
+    <Popover open={open} onOpenChange={(v) => { setOpen(v); if (v) setSearch(""); onOpenChange?.(v); }}>
       {showChip && isMulti && selected && selected.length > 0 ? (
-        <PopoverTrigger render={<div className="flex items-center gap-1" />}>
+        <PopoverTrigger nativeButton={false} render={<div className="flex items-center gap-1" />}>
             {selected.map((id) => {
               const u = users.find((user) => user.id === id);
               return u ? (
@@ -76,7 +78,7 @@ export function AssigneeEditor({ assignee, users, onChange, mode = "single", sel
             })}
           </PopoverTrigger>
       ) : showChip && !isMulti && assignee ? (
-        <PopoverTrigger render={<div className="flex items-center gap-1" />}>
+        <PopoverTrigger nativeButton={false} render={<div className="flex items-center gap-1" />}>
             <span className="inline-flex items-center gap-1 rounded-sm border border-border px-1.5 py-0.5">
               <UserAvatar
                 avatarConfig={assignee.avatarConfig}
@@ -171,7 +173,7 @@ export function AssigneeEditor({ assignee, users, onChange, mode = "single", sel
                   )}
                   <UserAvatar
                     avatarConfig={u.avatarConfig}
-                    bgShape={u.bgShape as "circle" | "rounded" | "square" | null}
+                    bgShape={u.bgShape}
                     bgColor={u.bgColor}
                     name={u.username}
                     size="sm"