`element:record_picker` 的 `sort` / `limit` 扁平简写:renderer 兑现、schema 未声明(#5775 实施中新测出,A 表之外的第 7 处)

[qq9340100]

实施 #5775(维护者裁决方向 A)时,为核实 A 表前提对 objectui HEAD 7dfbeb7 逐行读了 element:record_picker 的 renderer,顺带测出一处 A 表没有记录的同类分歧。#5775 的裁决评论逐键点名了处置对象,sort / limit 不在其中,所以没有夹带进那个 PR —— 单独记在这里。

实测

packages/components/src/renderers/basic/record-picker.tsx(objectui 7dfbeb7):

const ds = (schema?.dataSource ?? {}) as { object?: string; filter?: unknown; sort?: unknown; limit?: number };
const object = ds.object ?? props.object;
const filter = ds.filter ?? props.filter;
const sort = ds.sort ?? props.sort; // ← props.sort 未声明
const limit = ds.limit ?? props.limit ?? 50; // ← props.limit 未声明

四个键都走同一个「dataSource 优先、扁平简写兜底」的模式,而 ComponentPropsMap 里(#5775 落地后)object 与 filter 已声明、sort 与 limit 未声明。也就是说同一个 renderer 的同一组兜底里,一半是契约、一半是暗门 —— 一个照着 object/filter 的写法推断出 properties.limit: 20 的作者,会拿到默认的 50 条,零诊断。这正是 ADR-0078 的形状,和 #5775 处理的 labelField 同族。

仓内暂无作者写扁平 sort/limit(showcase 的 page-variables.page.ts:61 走的是 dataSource: { object, limit: 50 },即已声明的那条路),所以今天不打红任何东西 —— 但它是 #5068 error 升级前该清空的同一份清单上的一条。

三个方向(需裁定,不建议顺手补声明)

• A:补声明 sort / limit,与 object / filter 对齐 —— 四个扁平简写要么都是契约、要么都不是。代价:把「组件级 dataSource 是数据绑定的正统位置」这件事又稀释一次。
• B:反过来 —— 让 dataSource 成为唯一入口,object / filter 的扁平简写也走 ADR-0087 退役,四个键一起收敛到 dataSource。契约最干净;代价:breaking 面比 A 大得多,且 object 的扁平写法在语料里是主流(element:form / element:filter 等兄弟 element 也都是扁平 object),需要一次跨 element 的统一裁决而不是只看 picker。
• C:维持现状并在 dataSource 的 .describe() 里写明「sort/limit 只能从这里给」。代价:ADR-0049 的债务原地不动,且和 SDUI props 声明与 renderer 不一致:6 处「renderer 兑现但 ComponentPropsMap 未声明」+ 2 处「声明了没人读」(#5068 error 升级的 spec 侧前置) #5775 刚刚确立的「以被兑现的形状为准」相矛盾。

注:B 的正确范围恐怕不止 picker —— packages/lint/src/validate-component-props.ts 里那条「dataSource 供给了 object 就不报缺失」的豁免正是为这一族写的。所以本单若走 B,应先扩成 element 家族的统一单。

关系

• SDUI props 声明与 renderer 不一致:6 处「renderer 兑现但 ComponentPropsMap 未声明」+ 2 处「声明了没人读」(#5068 error 升级的 spec 侧前置) #5775:本单的来源。那一单已按裁决处置了 displayField(退役)/ labelField·valueField·label·emptyText(补声明),sort/limit 不在裁决点名范围内,故拆出。
• SDUI 组件 props 没有解析闸门:PageComponent.properties 是开放 record,ComponentPropsMap 的 29 个站点从不被 parse(#4001 批 17 的 no gate 判定) #5068:error 升级的 warning 期清单。本单属该清单的 spec 侧剩余项。

[qq9340100]

[claim —— PM 代办] wave-6 工头会话 session_01G3U9PJm1hEJitS9LtZz8TC,分支 claude/issue-6276-record-picker-sort-limit-shorthand(串行第 2 张)。dev 云会话无 GitHub 工具,走交付降级通道:dev 实现并 push,PM(session_011M7UwH25Unfi73UHim7ajY)代开 PR、转录终报。

---

Generated by Claude Code

[qq9340100]

[claim 撤回 —— PM] wave-6 派发词把本单描述成「方向 A」,但复核后确认:本单没有维护者裁决。议题本体明写三个方向需裁定、不建议顺手补声明,且来源单 #5775 的裁决评论逐键点名不含 sort/limit。工头(session_01G3U9PJm1hEJitS9LtZz8TC)已按纪律停手回问,本单从 wave-6 序列撤出,转 pm:blocked 待裁。

待维护者裁定(三选一,议题正文有完整代价分析):

• A 补声明 sort/limit,四个扁平简写全部成为契约;
• B 收敛到 dataSource 唯一入口(注意:正确范围恐怕是 element 家族统一单,不止 picker);
• C 维持现状 + describe 注明(与 SDUI props 声明与 renderer 不一致:6 处「renderer 兑现但 ComponentPropsMap 未声明」+ 2 处「声明了没人读」(#5068 error 升级的 spec 侧前置) #5775 确立的「以被兑现的形状为准」相矛盾,不推荐)。

裁决落地前不派发。工头跳过本卡,直接进卡 3(#6080)。

---

Generated by Claude Code