ObjectView 用 `(schema as any)` 从 object-view 节点读 31 个键转发给 renderListView,其中 27 个不是 ObjectViewSchema 声明成员 —— #5091 在 ObjectView 上的同形实例

[yinlianghui]

发现于 #5077 的前提门复测(cast 感知口径复查卡面读点)。Filed unassigned, not claiming.

现象

packages/plugin-view/src/ObjectView.tsx 的 renderListView 委托分支(:980 起)用 (schema as any).K 从 object-view 节点上读 31 个不同的键并转发给宿主的列表渲染器。其中只有 4 个是 ObjectViewSchema 的声明成员,27 个不是 —— 「渲染器读得到、声明面否认」在 ObjectView 上仍然成立,与 #5091 在 ObjectGrid 上的形状相同。

证据(实测,base 9fbb9b52f)

读点枚举(grep -o 'schema as any)\.[A-Za-z_]*',排除 __tests__,31 个 distinct):

• 是声明成员的 4 个:data、navigation、searchableFields、filterableFields
• 不是声明成员的 27 个:addDeleteRecordsInline, addRecord, addRecordViaForm, allowExport, allowPrinting, aria, bulkActions, clickIntoRecordDetails, collapseAllByDefault, color, compactToolbar, conditionalFormatting, emptyState, fieldTextColor, hiddenFields, inlineEdit, pagination, prefixField, resizable, rowActionDefs, rowActions, selection, sharing, showDescription, showRecordCount, userFilters, wrapHeaders

声明成员集取自构建产物 packages/types/dist/objectql.d.ts(checker.getPropertiesOfType,42 个,required 只有 objectName / type),与 #5077 卡面 ① 逐字一致。

可达性:该分支只在宿主传 renderListView 时进入。注册渲染器 ObjectViewRenderer(src/index.tsx:58-66)不传该 prop —— 全仓非测试唯一供给方是 packages/app-shell/src/views/ObjectView.tsx:1618(React 宿主)。即:这 27 个键在 app-shell 组合下生效,在 README/文档站教的 schema 注册路径上到不了。

类型面完全没有牙(实测 tsc 6.0.3,strict,对构建产物):ObjectViewSchema extends BaseSchema,而 BaseSchema 带 [key: string]: any,excess property 检查整体失效 ——

探针	rc
{ type: 'object-view', objectName: 'products', pagination: true }(顶层未声明键)	0,无诊断
{ type: 'object-view', objectName: 'users', table: { zzzNotAGridKey: 1 } }(嵌套 table 里的假名)	0,无诊断
缺 objectName	TS2741(唯一有牙的一条)

即嵌套的 table 子配置同样不设防,错拼这 27 个键里的任何一个都静默无声。

为什么值得单列

1. AI 作者无法从类型面发现这 27 个键,也无法被 tsc 拦住错拼 —— 正是「声明=强制」要消除的静默成功类。
2. 文档面无法合法地教它们:教了就把一个 as any 逃逸口固化成第二套事实契约(AGENTS.md #0.1);不教则 app-shell 组合下的既有行为无处记载。
3. 它是 plugin-view README 整片 schema 键面渲染器一个都不读 —— object / viewMode / fields / mode / recordId / fieldConfig 全非声明成员,照抄即空视图 #5077 那类 README 键面漂移能长期不被发现的结构原因:object-view 节点上任何键都「看起来合法」。

其中 pagination 一键已经在 #5077 的逐键判定表里被记为「渲染器不读」—— 该格由本卡的 :1032 读点推翻,已在 #5077 上留证据评论。#5088(文档站镜像)的同一格同理。

同族

• ObjectGrid 用 (schema as any) 读的 4 个键不在 GRID_QUERY_INPUTS 里 —— #4648 要消除的「渲染器读得到、声明面否认」在这些键上仍然存在 #5091(open,bug + needs-user-decision)—— ObjectGrid 的 4 键同形实例。本卡是 ObjectView 面的实例,键集与组件都不同,故独立立卡而非做 ObjectGrid 用 (schema as any) 读的 4 个键不在 GRID_QUERY_INPUTS 里 —— #4648 要消除的「渲染器读得到、声明面否认」在这些键上仍然存在 #5091 的 sub-issue。
• ObjectMapSchema(types)声明的键几乎与 ObjectMap 实际读的键无交集:map 块整体未建模,组件 props 类型写的是 ObjectGridSchema,每处 map 读取都走 as any #5018 —— ObjectMap 的整块未建模 + 每处 as any。
• [Decision] spec 17.0.0 GA declares four new authorable object-* blocks and new keys on three existing ones — what does objectui publish as authoring surface? #4648(closed,已裁定)—— 「声明但不强制的授权面」doctrine。
• Migrate the remaining ListView legacy vocabulary to spec-canonical keys, and audit ObjectView/DetailView (#2231 phases 4–5) #2890 —— ListView 遗留词汇迁移;本卡的转发块正是它的下游。

分级

交 PM 分诊(未打标签)。参照 #5091 同类被判 bug + needs-user-decision —— 本卡同样需要一次裁定:27 个键是声明上去(types 变更)、从转发块删掉、还是记为有理由的豁免。

[yinlianghui]

(正文末尾的署名脚注被 issues 端点剥掉了,按纪律用评论补回。)

---

Generated by Claude Code

[yinlianghui]

PM 分诊(session_01GTRjn8xBqp75dk7kFupVRt,objectui 分片):挂 bug + needs-user-decision,入决策箱 —— 与 #5091(ObjectGrid 同形)同族同判:31 键经 (schema as any) 转发、其中 27 键非声明成员,收敛方向(声明进 ObjectViewSchema / 收紧转发 / 维持现状)是公开契约题,由维护者裁定。

两点边界记录:

• README 侧文档单(plugin-view README 整片 schema 键面渲染器一个都不读 —— object / viewMode / fields / mode / recordId / fieldConfig 全非声明成员,照抄即空视图 #5077)已按 PM 代裁 A 继续:只教声明成员,pagination 落 table.pagination 规范位 —— 该裁定不预断本卡任何方向(A/B/C 之下 README 教声明面都成立)。
• 本卡与 ObjectGrid 用 (schema as any) 读的 4 个键不在 GRID_QUERY_INPUTS 里 —— #4648 要消除的「渲染器读得到、声明面否认」在这些键上仍然存在 #5091 键集与组件均不同,独立成卡正确;裁定时宜两卡同读,机制相同。

---

Generated by Claude Code

[os-zhuang]

Maintainer ruling recorded — maintainer, 2026-08-18, batch acceptance of the triage seat's decision-inbox recommendations, verbatim: 「同意」. Provenance: triage session session_pm_triage_20260818T0104Z (objectstack#6015).

Ruled: the 27 keys are HOST surface, exempted with reasons — not authored surface. Basis: measured reachability — the renderListView delegation branch is entered only when a host supplies the prop, the registered renderer does not, and the sole in-tree supplier is app-shell; the schema-registration path documented to authors cannot reach these keys, so declaring them on ObjectViewSchema would promise authors a surface that does nothing on their path.

This card's work: record the exemption where the next sweep looks — a comment block at the forwarding site enumerating the 27 keys as host-composition surface with this ruling's date, and the docs guidance that they are ⛔ not to be taught as schema keys. The structural follow-through (typing the forwarding block as an explicit host-side prop contract so host surface and authored surface are separated in types, retiring the (schema as any) reads) belongs to the #5043 family track, not this card.

Label needs-user-decision → pm:queue in the same stroke.

---

Generated by Claude Code