FilterBuilder 值落在选项集之外时值控件显示空 —— 文本值切到 picklist 列后行仍带着该值

[yinlianghui]

发现于 #4781 的实施，回传立单。又一处 #4768 / #4781 家族的「控件显示空、行却带着看不见的值」，这次成因是值域而不是类型。

事实

packages/components/src/custom/filter-builder.tsx（origin/main 65e88e6）：带 options 的 select/lookup 列，其值控件是一个受控的 Select，value={String(condition.value || "")}。Radix 的 SelectValue 只认已挂载的 SelectItem，值不在 options 里就什么都不渲染 —— 与 #4768 里 operator trigger 显示空是同一个机制。

复现：筛选面板加一行 → 字段选文本列 → 值输入 acme → 字段改成一个 picklist 列（选项 won / lost）→ 值控件显示空，行里仍是 value: "acme"，照样持久化、照样下发查询。

实测（jsdom）：切换后 onChange 最后一次给出的行 value 为 "acme"，值 trigger 的文本为空串。

与 #4781 的边界

#4781 已落的类型重整刻意不覆盖这一条：select/lookup 属于文本族，"acme" 在类型上是装得下的，被清掉的只有类型装不下的值。这里要答的是「值在不在该列的选项集里」，是值域问题。

定语义前要先答的

lookup 类字段的候选值可能是远程/异步的（LookupValuePicker 走远程搜索，options 常常为空或未到位）。照本地 options 一律清空，会把一个完全合法的 lookup id 清掉 —— 这个风险决定了不能照抄 #4781 的做法：

• A. 只对「静态 options 已到位」的字段做成员判定，不匹配就清空；远程/无 options 的一律保留。边界清楚，但同一个控件对两类字段行为不同。
• B. 一律保留值，改为让它可见（例如在选项外时退回可编辑文本并提示），信息不丢，但把一个选项外的值留在了 spec 面前 —— 这正是 FilterBuilder 切换行的 field 后 value 原样留下 —— 文本值落到 number 列，输入框显示空而行仍带着该值 #4781 裁定里否掉的 C 方案。
• C. 让 Select 在值不匹配时把该值显示为一个临时项，不改存储，只解决「看不见」。

倾向 A + C 的组合（静态选项列清空，远程列显示为临时项），但这是公共行为，建议按 #4781 的路子交维护者裁定。

参考

• FilterBuilder 切换行的 field 后 operator 不重置 —— select 改 text 后 operator 可停留在下拉里已不存在的 in,trigger 显示空 #4768（operator trigger 显示空，同一 Radix 机制）
• FilterBuilder 切换行的 field 后 value 原样留下 —— 文本值落到 number 列，输入框显示空而行仍带着该值 #4781（value 的类型重整；本单是它明确留在范围外的值域一半）

[os-zhuang]

Triage: needs-user-decision, type Bug. The #4781 mother ruling does not carry over: it decided the type-domain half and explicitly left this value-domain half out of scope, and its rationale (clear what the type cannot hold) does not answer the remote/async lookup case — clearing on local options membership would delete perfectly valid lookup ids. Real semantic difference ⇒ new decision, not an inherited one.

Decision facets:

• Platform long-term coherence: option A (+C for remote columns) keeps the FilterBuilder 切换行的 field 后 value 原样留下 —— 文本值落到 number 列，输入框显示空而行仍带着该值 #4781 line — a value the column cannot legitimately hold does not silently ride the row — while B re-introduces the tolerated-out-of-domain-value shape that FilterBuilder 切换行的 field 后 value 原样留下 —— 文本值落到 number 列，输入框显示空而行仍带着该值 #4781's ruling already rejected in its own option C.
• Measured business pull: reproduced in jsdom — value: "acme" persists and is sent in the query while the control renders empty. A filter that silently filters on an invisible value is user-facing wrong data, today.
• AI-agent error-resistance: an invisible stored value is the silent-tolerance shape; both A (loud clearing) and C (make it visible as a temporary item) are strictly better than the status quo. B keeps out-of-domain values in front of the spec.
• Startup scope discipline: contained to filter-builder.tsx; no new contract surface. The A/C split (static options ⇒ clear; remote/async ⇒ visible temporary item) is the filer's recommendation and triage concurs.

Recommendation: A + C combined, per the card. Escalated rather than auto-adjudicated because it changes user-visible clearing behaviour on a public control and the sibling precedent was maintainer-ruled.

---

Generated by Claude Code

[os-zhuang]

Maintainer ruling (2026-08-17, recorded by PM session session_01NYgmGheCzM6NrHZN436Cxf). The maintainer accepted the decision-inbox report's recommendations in full, verbatim: 「同意」. For this card:

Ruled: A + C combined (as the filer and triage recommended):

• Columns with static, present options: membership check on field switch — a value not in the option set clears to the family's empty shape (the FilterBuilder 切换行的 field 后 value 原样留下 —— 文本值落到 number 列，输入框显示空而行仍带着该值 #4781 logic extended to the value domain: locally decidable "cannot hold" ⇒ clear).
• Remote/async columns (lookup with remote search, options absent or not yet loaded): the value is kept but made visible as a temporary item in the Select — never cleared (a valid lookup id must not be deleted on a local non-membership guess), never invisible.
• ⛔ B (keep-and-tolerate invisibly) stays rejected — it is the shape FilterBuilder 切换行的 field 后 value 原样留下 —— 文本值落到 number 列，输入框显示空而行仍带着该值 #4781's ruling already refused.

This closes the FilterBuilder family: operator (#4768), type domain (#4781), value domain (this card). Label flipped needs-user-decision → pm:queue in the same stroke.

---

Generated by Claude Code

[yinlianghui]

认领(objectui 分片 PM 座席,批次 21)。Session session_01GTRjn8xBqp75dk7kFupVRt,分支 claude/issue-4874-filter-value-domain,os-dev 子代理实施。

实施依据 = 楼上维护者裁定(05:03Z,A+C 组合,B 维持否决):静态 options 在位 → 切列时成员判定、不匹配清到该族空形;远程/异步列(lookup 远程搜索、options 缺席或未到位)→ 保值并可见(Select 临时项),永不因本地非成员猜测清掉合法 lookup id、永不隐形。文件面:packages/components/src/custom/filter-builder.tsx + 测试,与在飞 #4989(plugin-form)/#4917(renderers/basic)不相交。同族先例:#4768(operator 显空)、#4781(类型域,其空形定义沿用)。

---

Generated by Claude Code