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.
div 的废弃警告会对 kind: 'html' tier 自己解析出的节点开火 —— 作者无法消除,且意味着 div 结构上退不掉 #4000
Description
发现于 #3965 的实施(PR #3998),不在该 PR 处理 —— 那一单改的是警告的去重和 catalog 内容,这一条是废弃本身的作用域问题。
现象
kind: 'html' 作者面(ADR-0080)把 JSX 标签名原样当成组件 type:
packages/sdui-parser/src/parse.ts:85——const node: SchemaElement = { type: tag, ...props }packages/sdui-parser/src/index.ts:33——const allowedTags = new Set(Object.keys(manifest.components))packages/components/src/renderers/layout/page.tsx:438-470—— 白名单来自ComponentRegistry.getKnownTypes(),裸div在内(所以 div 标签是合法的)packages/components/src/renderers/basic/html-elements.tsx:15,36—— 该模块的 TAGS 列表故意排除 div,注释写明「div / span / table / code / label 和语义分节标签已在别处注册」
于是一个 kind: 'html' 页面里写一个 div 标签 —— 完全合法、有意支持的写法 —— 编译出的就是 { "type": "div" },落到 basic/div.tsx 的废弃渲染器上,dev 构建下报一条「The div component is deprecated, use card / flex / container / stack / grid instead」。
作者对此无能为力:那几个替代类型没有一个是 html tier 里能写的等价标签,而且这条建议本身是给 JSON 作者面的。同族的 span 同理(basic/span.tsx)。
为什么归为 observation-class
- 只在非 production 构建下
console.warn,今天没有用户会撞到;PR fix(components): div 废弃提示每次模块加载只报一次;catalog 换类型那一半升级待定夺 (#3965) #3998 落地去重后,一页最多一条,连噪声都算不上了。 - 但它说明这条废弃的作用域是错的:警告在对引擎自己解析器的输出开火,而那条产出路径没有迁移目标。
- 推论(examples/schema-catalog: 48 个示例仍用已废弃的
div组件类型,docs 站每张缩略图都刷一条 deprecation warning #3965 第一半卡住的直接原因):既然 html tier 必须保留 div 作为词表成员,「全仓零div」永远不可能成为一条不变量,div也不可能真正退休。examples/schema-catalog: 48 个示例仍用已废弃的div组件类型,docs 站每张缩略图都刷一条 deprecation warning #3965 的 catalog sweep 因此需要先有一个决定 —— 补一个中性容器类型(如box)、还是收窄这条废弃承认残余div合法。三选项与两轴分析见 PR fix(components): div 废弃提示每次模块加载只报一次;catalog 换类型那一半升级待定夺 (#3965) #3998 正文。
参考位置
packages/components/src/renderers/basic/div.tsx(废弃警告;PR fix(components): div 废弃提示每次模块加载只报一次;catalog 换类型那一半升级待定夺 (#3965) #3998 已加去重,作用域未改)packages/components/src/renderers/basic/span.tsx(同族)- 另:
@objectstack/spec的element:*词表里既没有div也没有box——div是 objectui 本地ui命名空间的类型,所以这是本仓自己的公共契约取舍,不是 spec 层的。
Activity
os-zhuang commentedon Aug 10, 2026
Finding-triage ruling: Escalate —
findingtoneeds-user-decision.The div deprecation warning fires on nodes the kind:'html' tier's own parser produces (div.tsx warnDeprecatedOnce; html-elements.tsx deliberately excludes div; parse.ts maps the tag straight through), so authors cannot silence it and div is structurally unretirable — the warning's promise is false either way. This blocks the first half of #3965, and three candidate directions are documented in PR #3998.
Question for the maintainer: which deprecation contract should div have — narrow the warning to authored nodes, bless div as permanent vocabulary, or actually retire it?
Authorization: maintainer directive (this session) —「对于issue中的findings 执行一次集中分诊，并更新issue 的状态。」Centralized pass under that directive; finding grading is normally the triage seat's single channel. Round: objectstack#4949 finding-triage, 2026-08-10.
Session: 01JaVVMrSxt7Tgi1uwEuDtH7
Generated by Claude Code
os-zhuang commentedon Aug 10, 2026
Maintainer ruling (2026-08-10, directed in session
session_01BPWqbmEFU8gJepBJTHESXd): split the warning by provenance.The deprecation warning exempts nodes emitted by the
kind: 'html'tier's own parser (internal provenance the author cannot spell differently), and keeps firing for authoreddiv. This makes the warning actionable again and unblocks the retirement path structurally. objectui#3965's example sweep is ordered after this lands.needs-user-decision→pm:queue.Generated by Claude Code
yinlianghui commentedon Aug 17, 2026
认领(objectui 车道分片 PM,会话
session_01GTRjn8xBqp75dk7kFupVRt,批次 17):branchclaude/issue-4000-div-warning-provenance。按 2026-08-10 维护者裁定实施:废弃警告按 provenance 拆分 ——
kind: 'html'tier 解析器自产节点(作者无法换拼写的内部来源)豁免,作者手写div继续告警;#3965 的示例清扫排在本卡落地之后。文件面:div 组件的 warnDeprecatedOnce 路径、html tier 解析(parse.ts / html-elements.tsx)的 provenance 标记。Generated by Claude Code
fix(components): div 废弃提示按 provenance 收窄到 JSON 作者面 (objectstack-ai#4000…
fix(components): span deprecation notice warns once, and only at JSON…
test(components): assert the deprecation notice and `deprecated.repla…