`page:card.visible` 是页面该改、不是 schema 该补:showcase 两处改写为 ADR-0089 组件级 `visibleWhen`(#5775 拆出)

[qq9340100]

从 #5775 拆出。维护者 2026-08-06 裁决评论明写:「page:card.visible 属页面改写(正统 visibleWhen,ADR-0089),可顺带或拆小单」。#5775 的实施 PR 选择拆单,理由记在下面。

事实(对 origin/main + objectui HEAD 7dfbeb7 实测)

page:card.visible 是把组件级可见性谓词写进了 properties,靠 SchemaRenderer 的 hoist 生效(packages/react/src/SchemaRenderer.tsx 读 schema.visible)。ADR-0089 的正统拼法是组件级 visibleWhen —— visible 连别名表都不在。所以这是页面写错了位置,不是 PageCardProps 少一个键:给它补声明会把一个第三方拼法固化成契约(Prime Directive #12),正是 #5775 在 displayField 上刚拆掉的形状。

站点(2 处,同一文件):

文件	行	现状
examples/app-showcase/src/ui/pages/my-work.page.ts	properties.visible on the "Leadership View" page:card	visible: "user.email == 'admin@objectos.ai'"

(#5068 的 warning 清单里 page:card.visible 记为 1 条 component-props-unknown-key。)

为什么 #5775 没有顺带做

不是工作量,是一处语义待确认,做错了会静默改变 showcase 的渲染:

• 页面现在写的绑定名是 user.email(该行的注释说「the renderer now feeds user into the expression context」);
• 而 ADR-0089 visibleWhen 声明绑定的是 record / current_user / page.<var>,没有 user。

所以机械改写 visible → visibleWhen 会得到一个恒假谓词 —— 卡片直接消失,且没有任何诊断。正确的改写多半是 visibleWhen: "current_user.email == 'admin@objectos.ai'",但这需要一次浏览器实测(以 admin 与非 admin 两个身份各看一次)来确认绑定名,而不是靠读 ADR 推断。#5775 是 spec 车道的退役单,把一个需要 dogfood 半径的页面语义改写夹带进去会让那个 PR 的验收面失焦。

验收

1. 确认 visibleWhen 环境里管理员身份的实际绑定名(current_user 还是 user);若 objectui 侧两者都不通,先在 objectui 提对应单。
2. 改写 my-work.page.ts 的 2 处 page:card(其中 1 处带 visible),properties.visible → 组件级 visibleWhen(注意是组件节点的兄弟键,不是 properties 里的键)。
3. pnpm --filter @objectstack/example-showcase typecheck + 该 example 的测试。
4. 按 .claude/skills/dogfood-verification 以 admin / 非 admin 两个身份各看一次 My Work 页,确认卡片该显示时显示、该隐藏时隐藏。
5. 复跑 SDUI 组件 props 没有解析闸门:PageComponent.properties 是开放 record,ComponentPropsMap 的 29 个站点从不被 parse(#4001 批 17 的 no gate 判定) #5068 闸门,确认 page:card.visible 这条从 component-props-unknown-key 清单里消失。

关系

• SDUI props 声明与 renderer 不一致:6 处「renderer 兑现但 ComponentPropsMap 未声明」+ 2 处「声明了没人读」(#5068 error 升级的 spec 侧前置) #5775(本单来源,已实施):spec 侧的 9 补声明 + 4 退役,已把 component.zod.ts 那一半清单清空。
• SDUI 组件 props 没有解析闸门:PageComponent.properties 是开放 record,ComponentPropsMap 的 29 个站点从不被 parse(#4001 批 17 的 no gate 判定) #5068:error 升级的前置清单。本单 + component.zod.ts 的 I18nLabelSchema 键声明为纯字符串,但 3 个平台页在 31 处授权内联多语言 map #5728 + showcase 的 project-detail 页在 page:tabs 上授权 items[].key,renderer 读的是 items[].value —— 两个 tab 的稳定 URL token 从未生效 #5776 落地后该清单才为空。
• 与 component.zod.ts 的 I18nLabelSchema 键声明为纯字符串,但 3 个平台页在 31 处授权内联多语言 map #5728(内联多语言 label)同为 SDUI 组件 props 没有解析闸门:PageComponent.properties 是开放 record,ComponentPropsMap 的 29 个站点从不被 parse(#4001 批 17 的 no gate 判定) #5068 warning 期清单的剩余项,但不同族:那是 schema 的 I18nLabelSchema 形状问题,这是页面写错了键的位置。

[claude]

Triage (lane-label repair): domain:spec.

pm:queue + target:v17 with no lane label since 12:52Z, i.e. dispatchable-looking but claimable by nobody. Repaired here.

Landing site: examples/app-showcase/src/ui/pages/my-work.page.ts (two lines, one file) plus a browser check of the visibleWhen binding name. examples/** belongs to the subsystem it exercises, so this is decided by precedent rather than by the package table: the two sibling cards of exactly this shape — a showcase page written against a spelling the renderer/contract does not honour — are #5776 and #5777, both domain:spec, and this card was split out of #5775 (domain:spec) by the maintainer's own "可顺带或拆小单" ruling. Keeping the split halves in one lane is what makes the ADR-0089 alias-table judgment sit with the seat that owns it.

Not routed to repo:objectui: the edit lands in this repo. Acceptance step 1 may still produce an objectui card if neither current_user nor user resolves in the component-level visibleWhen context — that would be a new issue there, filed by whoever measures it, not a re-route of this one.

⚠️ The body's warning is the load-bearing part and survives triage unchanged: a mechanical visible → visibleWhen rewrite yields a constantly-false predicate and the card silently disappears. The binding name must be measured in a browser (admin and non-admin), not inferred from the ADR.

本评论来自分诊座位 Routine(#5474 试点),不构成认领。

---

Generated by Claude Code