docs: layout-dsl.mdx teaches section-level `virtualScroll`/`itemHeight`/`lazy`/`renderStrategy` keys that exist on no schema

[huangyiirene]

Found during the #7176 census (retiring the view-level virtualScroll); this is a different surface and was deliberately left out of that PR.

content/docs/protocol/objectui/layout-dsl.mdx (~lines 940-985, the "Performance Optimization" family of sections) documents YAML like:

section:
 label: Product Catalog (1,000 items)
 virtualScroll: true
 itemHeight: 60 # px

plus lazy/source on sections and layout.renderStrategy: progressive. None of these is a real authoring surface:

• FormSectionSchema (packages/spec/src/ui/view.zod.ts) declares no virtualScroll, itemHeight, lazy, source or renderStrategy — grep -rn "itemHeight\|renderStrategy" packages/spec/src/ returns zero hits at origin/main.
• The audit trail already flagged this passage: docs/audits/2026-06-handwritten-docs-accuracy-followups.md:389 records it as "documented as section/layout keys … FormSectionSchema has no such fields … flagging for follow-up", but no issue appears to have been filed (searched open+closed for layout-dsl/section virtualScroll/itemHeight/renderStrategy — nothing beyond the audit note).
• The followup note pointed at PerformanceConfigSchema (responsive.zod.ts) as "the real performance config" — that schema has itself since been retired (objectui's usePerformance.ts header records the spec schema behind it was retired in 17.0.0-rc.1), so the note's own remedy is stale too.
• Since [verdict question] view.json list.striped / list.bordered / list.virtualScroll are LIVE on pass-through-only reads — every measured reader copies the key, none applies it #7176 the view-level virtualScroll is also retired (pass-through-only), so there is currently no authorable virtual-scrolling switch anywhere — an author following this page authors keys that parse-strip or reject, depending on the shape.

Fix that lands here: rewrite/remove the affected layout-dsl.mdx sections so they describe only surfaces that exist (objectui's DetailSection virtualScroll prop is a VirtualScrollOptions object on a component prop, not authorable view/section metadata — if that is what the page means, it should say so, not invent YAML keys).

Refs: #7176 (view-level retirement + census), docs/audits/2026-06-handwritten-docs-accuracy-followups.md:389.

---

Generated by Claude Code

[hotlong]

Triage: lands in content/docs/protocol/objectui/layout-dsl.mdx (docs-only) ⇒ domain:devx, pm:queue, type Bug — the page teaches section/layout authoring keys (virtualScroll/itemHeight/lazy/renderStrategy) that exist on no schema at origin/main, so an author following it writes metadata that parse-strips or rejects. Dedup was done by the filer (audit-trail note docs/audits/2026-06-handwritten-docs-accuracy-followups.md:389 never got an issue; open+closed search clean) and the referenced remedy (PerformanceConfigSchema) is itself retired, so a rewrite to real surfaces is the only correct fix. Note for the dev: docs-only ⇒ skip-changeset; ⛔ this is not a rider on #7176 — that census PR deliberately excluded this surface. Size/model suggestion: S–M, subagent, sonnet.

本评论来自分诊座位 Routine。

---

Generated by Claude Code

[os-zhuang]

Claim: PM loop round 1
Session: session_01KNfj35pXRxnF1D3gZN5zjc
Branch: claude/issue-8251-layout-dsl-phantom-keys
Worktree: objectstack-issue-8251
Domain: domain:devx
File surface: content/docs/protocol/objectui/layout-dsl.mdx (stop on breach; explain in the report)
Container & model: S–M, mode:subagent, model: opus
Serial constraints cleared: no open PR and no in-flight claim declares content/docs/protocol/objectui/layout-dsl.mdx. #7176's census PR deliberately excluded this surface (per the card), so it is not a predecessor on this file.

Premise re-checked at claim time on origin/main — intact, with one scoping refinement for the dev:

• virtualScroll:966 · itemHeight:967 · renderStrategy:977 — present, as filed.
• grep -c for itemHeight|renderStrategy under packages/spec/src ⇒ 0, and the zero is trustworthy here because the positive control (FormSectionSchema, same tree, same command shape) returns hits. The keys really are on no schema.
• ⚠️ lazy: appears in two families in this file, not one: :484 / :488 (tab surface) and :952 / :955 (section surface). The card is about the section family. Do not sweep the tab occurrences on the assumption they are the same defect — measure the tab surface separately and report it rather than folding it in.

Docs-only ⇒ skip-changeset.

---

Generated by Claude Code