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.
catalog:106 个 className 明确写着布局意图的 div 节点转成 flex/stack/grid/container props(#3965 的词表无关部分) #4003
Description
Part of #3965(其词表终态 A/B 决策挂 needs-user-decision,本单是 PR #3998 测量确认任何终态下都成立的部分,提前拆出)。
范围(测量出处:PR #3998 正文的判定表,基 0cbdca888)
189 个 div 节点中 106 个的 className 字面写着一等公民布局组件的能力,JSON 手写 Tailwind 复刻 props 本就是反模式,转换是纯赚:
| 类别 | 节点数 | 目标 |
|---|---|---|
className 含 flex(不含 flex-col) |
84 | flex + align/justify/gap props |
className 含 space-y-* |
9 | stack + gap |
className 含 max-w-* |
8 | container + maxWidth/padding(注意默认 padding 4,需显式 padding: 0 保等价) |
className 含 grid/grid-cols-* |
5 | grid + columns 对象 + gap(此类逐字节等价) |
已知坑(PR3998 已测量,照做省一轮返工)
- 4 个节点用
body而非children:flex/stack/grid/container 只渲染children,naive 换类型会静默丢内容 —— 这 4 个先改body→children再换。 - flex 的 gap 是 mobile-first 阶梯(gap:3 渲染
gap-2 sm:gap-3),转换语义保持但 640px 下非逐字节等价 —— 这是正确的范本写法,⛔ 不要用gap:0 + className 保留 gap-3硬凑逐字节(自相矛盾的授权)。 - 83 个无对等物节点与 div.mdx 的 2 个刻意 legacy 示例不在本单范围(等 examples/schema-catalog: 48 个示例仍用已废弃的
div组件类型,docs 站每张缩略图都刷一条 deprecation warning #3965 决策)。 ⚠️ 13 个 grid 示例的cols错键由 examples/schema-catalog: 13 个 grid 示例用了未声明的cols键,列数被静默丢弃 —— 要 3/4 列的示例在 docs 站实际渲染成 2 列 #4001 修 —— 若两单相邻执行,后派的基于先合的 main。
验收
- 106 节点逐个转换,转换清单(文件→原 className→新 props)进 PR;
- 渲染等价抽样断言(沿 fields-form-hosted 的 harness 形态);
- 浏览器抽查 2-3 页缩略图正常;
- ⛔ 不碰 releases/;changeset 按 catalog ignore 判(报告写依据)。
Activity
yinlianghui commentedon Aug 17, 2026
【认领】objectui 分片 PM(session_01GTRjn8xBqp75dk7kFupVRt)批次 15 派发,os-dev 实施。分支:
claude/issue-4003-catalog-layout-props。分诊判断:PR3998 测量确认本单在 #3965 任何终态下都成立(提前拆出的无决策依赖部分),四类 106 节点范围与四个已知坑(4 个 body→children 静默丢内容、flex gap 阶梯语义 ⛔ 硬凑逐字节、83 个无对等物与 legacy 示例不在范围、#4001 相邻单)卡内写全。派发前置:先查 #4001(grid cols 错键)是否已落 main,基最新 main 动工;立卡至今一周,106 节点清单按 origin/main 重扫对账(catalog 可能有增删)。文件面:
examples/schema-catalog/src/schemas/**JSON + 渲染等价抽样测试(fields-form-hosted harness 形态)。与在飞 #4884(plugin-gantt)零交集。Generated by Claude Code
refactor(schema-catalog): author layout intent as props on 103 div no…
fix(components): honour a declared `container.maxWidth: false` as no …
fix(components): honour a declared `container.maxWidth: false` as no …