This repository was archived by the owner on Nov 4, 2026. It is now read-only.
Repository navigation
This repository was archived by the owner on Nov 4, 2026. It is now read-only.
object-grid 声明的 data 输入类型是 array(内联行),而契约类型是 ViewData(对象)—— 照设计器写出的元数据 spec 解析不过 #5090
Description
发现于 #5065 的实施(plugin-grid README 示例键面重写)。Filed unassigned, not claiming.
#5065 是 README 侧;本卡是声明面与契约类型不一致,另一性质,按纪律不夹带进那个 PR。
现象
同一个 data 键,三处说法不同:
| 处 | 说的是什么 |
|---|---|
packages/plugin-grid/src/index.tsx:154(GRID_QUERY_INPUTS) |
{ name: 'data', type: 'array', label: 'Static Data', description: 'Inline rows, …' } —— 声明成数组 |
packages/types/src/objectql.ts:556 |
data?: ViewData —— ViewData 是 spec 的辨识联合对象(provider: 'object' | 'api' | 'value' | 'schema',每支 strict);内联行那一档是 { provider: 'value', items: [...] } |
packages/plugin-grid/src/ObjectGrid.tsx:392(getDataConfig) |
if (Array.isArray(schema.data)) → 转成 { provider: 'value', items: schema.data } —— 运行时两种都吃 |
GRID_QUERY_INPUTS 是发布给设计器面板与生成 sdui-intrinsics.d.ts 的那份声明面
(该块的注释明确说,发布它的目的正是「让 manifest、.d.ts、设计器与渲染器终于一致」)。
所以照它写 data: [ …行… ] 的作者:
- 运行时能跑(靠
getDataConfig的数组容忍支路); - 但
tsc不过 ——ObjectGridSchema['data']是ViewData,数组不属于任何一支; - 严格按 spec 解析同样不过。
顺带:该 description 写「the deprecated staticData is the same thing」。staticData
(objectql.ts:637,any[],已 @deprecated)确实就是数组档 —— 也就是说 data 的这条
声明实际描述的是那个已弃用键的形状,而不是 data 自己的。
复核方式
sed -n '154p' packages/plugin-grid/src/index.tsx
grep -n 'data?: ViewData' packages/types/src/objectql.ts
sed -n '388,400p' packages/plugin-grid/src/ObjectGrid.tsx # Array.isArray 容忍支路
编译探针(strict、对 dist/index.d.ts):
const a: ObjectGridSchema = { type: 'object-grid', objectName: 'u', data: [{ id: 1 }] };
报 TS2322,右侧列出 provider: 'object' | 'api' | 'value' | 'schema' 四支,数组不在其中。
同族
- finding(plugin-grid): ObjectGrid 在
ObjectGridSchema.columns上容忍未声明的accessorKey/header拼写 —— 声明类型是 strict 的 ListColumn,#3104 的列身份门禁结构上看不见这条支路 #5068:columns上accessorKey/header的运行时容忍支路 —— 同一家族(strict 声明
类型 + 运行时另开一条容忍支路),不同键。本卡额外多一层:容忍的那个形状还被声明面
正式发布了。 - [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 的裁定(2026-08-16,option B + carve-out)是把「渲染器读得到但声明面否认」的键补进
GRID_QUERY_INPUTS;本卡是补进去之后类型标注与契约不符的残留。
分级
交 PM 分诊。今天没有人被报错拦住(运行时容忍),但设计器教出来的元数据过不了 spec 解析。
Activity
yinlianghui commentedon Aug 17, 2026
补:正文由 issues 端点存储时会剥掉末尾 footer,故以评论补齐。已读回确认正文完整、无
<+字母被吞。Generated by Claude Code
yinlianghui commentedon Aug 17, 2026
认领(PM 派发,objectui 分片):session_01GTRjn8xBqp75dk7kFupVRt,分支
claude/issue-5090-grid-data-input-decl,os-dev 席即将开工。范围声明:半径是
packages/plugin-grid/src/index.tsx的GRID_QUERY_INPUTS声明块(+ 其生成物/测试/changeset)—— 把data的声明面对齐契约类型ViewData(#4648 option B + carve-out 裁定后的残留修正)。⛔ 不动ObjectGrid.tsx的运行时容忍支路(#5068 家族,另案)、⛔ 不动packages/types。与在飞席位(SchemaForm a11y、plugin-form/plugin-view README、plugin-grid mdx)文件不相交 —— 注意 #5087 席动的是content/docs/plugins/plugin-grid.mdx,本卡动的是packages/plugin-grid/src/index.tsx,同包不同文件。Generated by Claude Code
docs(plugin-grid): README 的 src/index.tsx 行号锚点跟上声明块的位移
fix(plugin-grid): object-grid 的 data 输入按契约声明为 ViewData 对象 (objectstac…