docs(plugins): 三个插件文档页按真实 register 键表重写虚构的 *Components 手动注册

[yinlianghui]

Fixes#5076

基线 origin/main @ 03e5f972a160998a694742bd7c72149ae2fa3d8e(卡面读数取自 6098ecd08,本 PR 在 03e5f972a 上逐行复测,行号与判定完全一致)。

前提复测:卡面四行照抄复核,全部成立

$ git grep -nw -E "formComponents|gridComponents|viewComponents|dashboardComponents" -- content/docs
content/docs/plugins/plugin-dashboard.mdx:73:import { dashboardComponents } from '@object-ui/plugin-dashboard';
content/docs/plugins/plugin-dashboard.mdx:76:Object.entries(dashboardComponents).forEach(([type, component]) => {
content/docs/plugins/plugin-form.mdx:165:import { formComponents } from '@object-ui/plugin-form';
content/docs/plugins/plugin-form.mdx:168:Object.entries(formComponents).forEach(([type, component]) => {
content/docs/plugins/plugin-grid.mdx:121:import { gridComponents } from '@object-ui/plugin-grid';
content/docs/plugins/plugin-grid.mdx:124:Object.entries(gridComponents).forEach(([type, component]) => {
content/docs/plugins/plugin-view.mdx:70:import { viewComponents } from '@object-ui/plugin-view';
content/docs/plugins/plugin-view.mdx:73:Object.entries(viewComponents).forEach(([type, component]) => {
$ git grep -nw formComponents -- packages/plugin-form/src # 零命中
$ git grep -nw gridComponents -- packages/plugin-grid/src # 零命中
$ git grep -nw viewComponents -- packages/plugin-view/src # 零命中

邻近词反查(全仓 git grep -nw)确认三个名字只出现在这三个 mdx 与三份已落地 changeset 的引述里,源码零命中。

三文件判定表

文件	行(6098ecd08 / 03e5f972a 一致)	名字	该名字在对应包 dist/index.d.ts 导出面	判定	本 PR
content/docs/plugins/plugin-form.mdx	:165 / :168	formComponents	不在(51 个导出名)	虚构,照抄抛 TypeError / 编译 TS2305	✅ 改写
content/docs/plugins/plugin-grid.mdx	:121 / :124	gridComponents	不在(49 个导出名)	虚构,同上	✅ 改写
content/docs/plugins/plugin-view.mdx	:70 / :73	viewComponents	不在(39 个导出名)	虚构,同上	✅ 改写
content/docs/plugins/plugin-dashboard.mdx	:73 / :76	dashboardComponents	名字真实(packages/plugin-dashboard/src/index.tsx)	错的是键词汇表,归 #5064	⛔ 未碰

content/docs/plugins/plugin-map.mdx 归 #5019,未碰。content/docs/releases/** 零触碰。未新增任何导出或 re-export。

改法

与 README 侧已落地的三单同一口径(#5011 → PR #5079、#5013 → PR #5071、#5014 → PR #5078,先读了这三个 PR 的对应节作基准)。每处删掉虚构段,换成三节真话:

1. 注册是 import 的副作用 —— 没有可迭代的组件表;
2. 各包真实 register 键表 —— namespaced 键 + bare 兜底,含 skipFallback 语义;
3. 「把导出组件挂到自己的键上」才是这里的手动注册 —— 示例用真实导出名。

键表出处:从 ComponentRegistry.register( 调用现场抄,⛔ 不从文档反推

$ git grep -nE "ComponentRegistry\.register\(" -- packages/plugin-form/src packages/plugin-grid/src packages/plugin-view/src
packages/plugin-form/src/index.tsx:100: ComponentRegistry.register('object-form', ObjectFormRenderer, {
packages/plugin-form/src/index.tsx:159: ComponentRegistry.register('form', ObjectFormRenderer, {
packages/plugin-form/src/index.tsx:211: ComponentRegistry.register('embeddable-form', EmbeddableFormRenderer, {
packages/plugin-form/src/index.tsx:232: ComponentRegistry.register('form-analytics', FormAnalyticsRenderer, {
packages/plugin-form/src/index.tsx:276: ComponentRegistry.register('object-master-detail-form', MasterDetailFormRenderer, {
packages/plugin-form/src/index.tsx:356: ComponentRegistry.register('line_items', LineItemsPanelRenderer, {
packages/plugin-grid/src/index.tsx:181: ComponentRegistry.register('object-grid', ObjectGridRenderer, {
packages/plugin-grid/src/index.tsx:193: ComponentRegistry.register('grid', ObjectGridRenderer, {
packages/plugin-grid/src/index.tsx:216: ComponentRegistry.register('import-wizard', ImportWizardRenderer, {
packages/plugin-view/src/index.tsx:66: ComponentRegistry.register('object-view', ObjectViewRenderer, {
packages/plugin-view/src/index.tsx:100: ComponentRegistry.register('view', ObjectViewRenderer, {
packages/plugin-view/src/index.tsx:106: ComponentRegistry.register('view-switcher', ViewSwitcher, {
packages/plugin-view/src/index.tsx:132: ComponentRegistry.register('filter-ui', FilterUI, {
packages/plugin-view/src/index.tsx:160: ComponentRegistry.register('sort-ui', SortUI, {
packages/plugin-view/src/index.tsx:183: ComponentRegistry.register('shared-view-link', SharedViewLink, {
packages/plugin-view/src/index.tsx:217: ComponentRegistry.register('view:simple', SimpleViewRenderer, {

skipFallback 语义来自 packages/core/src/registry/Registry.ts:194(register 签名),兜底分支在 :226(if (meta?.namespace && !meta?.skipFallback))。全仓 skipFallback: true 在这三个包里只有三处:

$ git grep -n "skipFallback" -- packages/plugin-view/src packages/plugin-grid/src packages/plugin-form/src
packages/plugin-form/src/index.tsx:161: skipFallback: true, # 'form' + namespace 'view' -> 只有 view:form
packages/plugin-form/src/index.tsx:358: skipFallback: true, # 'line_items' + namespace 'record' -> 只有 record:line_items
packages/plugin-grid/src/index.tsx:195: skipFallback: true, # 'grid' + namespace 'view' -> 只有 view:grid

因此 plugin-view 的七处全部同时有 namespaced 键与 bare 兜底(页面里明写 "No call in this package sets skipFallback"),plugin-form 与 plugin-grid 各有 bare 键被刻意让出 —— bare form 留给 @object-ui/components 的基础表单,bare line_items 留给别的认领者,bare grid 留给 packages/components/src/renderers/layout/grid.tsx:50 的 CSS Grid 布局容器。

名集合核对与探针

导出名逐一对已构建的dist/index.d.ts 核过,方法照 #5043 规格(TS 编译器 API checker.getExportsOfModule),不是 grep src。

• import 位:三个 mdx 代码块里所有 @object-ui/* 具名导入 —— 改前 8 条不成立,改后 5 条(全部是本卡边界外、已另立卡的错包路径类型导入,见文末)。
• 散文位:三段新文字里以「在导出面上」名义提到的 46 个标识符全部核过,含 3 条缺席断言(ObjectViewRenderer / SimpleViewRenderer 不导出、formComponents / gridComponents 不导出)—— 断言缺席与断言在场同样可证伪,同一趟跑。

Checked 46 prose-named identifier(s).
OK every prose claim holds against dist.

• 可编译处探针:三段新示例块逐字抽出,在 strict 下对同一批 dist/index.d.ts 编译 —— TSC_EXIT=0。⚠️ 键面盲区纪律:这条只证明示例块能编译,不冒充键表的证据 —— 键表的证据是上面的 register 调用现场。

反向验证(预判先写,再跑)

(a) 改前 mdx 段回填 —— 预判:核对/探针必须抓出三个虚构名。符合。

改前整树跑名集合核对,预判 8 条(3 个虚构名 + 5 条错包路径),实测逐字命中:

8 problem(s):
content/docs/plugins/plugin-form.mdx:165 formComponents is NOT exported by @object-ui/plugin-form
content/docs/plugins/plugin-form.mdx:251 FormSchema is NOT exported by @object-ui/plugin-form
content/docs/plugins/plugin-form.mdx:251 FormField is NOT exported by @object-ui/plugin-form
content/docs/plugins/plugin-grid.mdx:121 gridComponents is NOT exported by @object-ui/plugin-grid
content/docs/plugins/plugin-grid.mdx:336 GridSchema is NOT exported by @object-ui/plugin-grid
content/docs/plugins/plugin-grid.mdx:336 GridColumn is NOT exported by @object-ui/plugin-grid
content/docs/plugins/plugin-view.mdx:70 viewComponents is NOT exported by @object-ui/plugin-view
content/docs/plugins/plugin-view.mdx:263 ObjectViewSchema is NOT exported by @object-ui/plugin-view

改后剩 5 条,恰为边界外的错包路径类型导入(本 PR 不动,见文末)。

被删的那段逐字回填进探针,预判 TS2305,实测:

snippet-old-form.ts(2,10): error TS2305: Module '"@object-ui/plugin-form"' has no exported member 'formComponents'.

(b) 名集合塞假名自证 —— 预判:必须被抓。符合。 往 grid 的新示例块塞 gridComponentsRedux:

content/docs/plugins/plugin-grid.mdx:146 gridComponentsRedux is NOT exported by @object-ui/plugin-grid

随即还原,git diff --stat 回到 40/5,无残留。

⚠️ 一条如实记录的反常读数:check-doc-component-types 改前改后计数完全一致(632 code blocks / 558 type literals / 469 registered / 89 exempted)。这不是本修复生效的证据 —— 该门禁核的是组件 type 值,不是 import 的名字,#5076 正文已指出这一族从它下面穿过去了。它的绿只说明本 PR 没有碰坏它;修复本身的证据是上面的名集合核对与 tsc 探针。

门禁读数

命令	结果
node scripts/check-doc-component-types.mjs	✅ Every documented component type is registered.(143 mdx / 632 blocks / 558 type literals / 659 registered keys;改前改后同数,见上)
node scripts/check-doc-links.mjs	✅ Links are valid across 13 scan roots.
node scripts/check-control-bytes.mjs	✅ OK (scanned 4522 tracked text file(s); skipped 85 binary)
改动文件自扫 grep -naP '[\x00-\x08\x0b\x0c\x0e-\x1f]'	✅ 零命中(超出门禁扫描面的自查)
pnpm exec turbo run type-check --concurrency=2(仓根)	✅ 81 successful, 81 total
MDX 3 编译(仓内 @mdx-js/mdx@3.1.1)	✅ 三文件全 OK(散文里零裸 {)

重活一律经 flock -w 3600 /tmp/os-heavy-verify.lock + NODE_OPTIONS=--max-old-space-size=4096。

changeset:门禁实测判定「不需要」

卡面判断 .mdx 不随 npm 发布故不需要 changeset,以门禁实测为准而非沿用判断:

$ node scripts/check-changeset-presence.mjs
Compared the working tree with 03e5f972a (merge-base with origin/main): 3 file(s) changed,
0 of them under the src/ of a package the release covers, 0 under a package changesets ignores,
0 changeset(s) added.
✅ No source of a released package changed in this range, so no changeset is owed.

changeset:check(check-changeset-fixed + check-changeset-no-major)同样绿。故本 PR 不带 changeset —— 是门禁明确判定不欠,不是省略。

边界外发现(已另立 issue,本 PR 一行未动)

改写过程中名集合核对稳定抓到的、与本卡不同性质的缺陷,按 Prime Directive #10 另立、未认领、未打 finding 标签(都是读者今天照抄就撞得上的具体缺陷,交 PM 分诊):

• content/docs/plugins/plugin-{form,grid,view}.mdx 三处 import type 从错误的包导入真实类型 —— 照抄即 TS2305(#5011/#5013/#5014 第二条的文档站镜像) #5086 —— 三页 import type 从错误的包导入真实类型(TS2305,非虚构名):plugin-form.mdx:251 的 FormSchema / FormField、plugin-grid.mdx:336 的 GridSchema / GridColumn、plugin-view.mdx:263 的 ObjectViewSchema。是 plugin-form README 教三个不存在的导入:formComponents 手动注册、FormSchema / FormField 从本包导入 #5011 / plugin-grid README 教 gridComponents 手动注册与 GridSchema / GridColumn 类型 —— 前两者不存在,GridSchema 这个名字在 types 里是 CSS Grid #5013 / plugin-view README 教的 viewComponents 手动注册不存在,ObjectViewSchema 也不从本包导出 #5014 第二条的文档站镜像,也正是本 PR 改后名集合核对剩下的那 5 条。
• content/docs/plugins/plugin-grid.mdx 整片示例教 type: 'grid' + header / accessorKey 列词汇表 —— 落到 CSS Grid 布局容器,列声明被 strict 的 ListColumn 拒绝(#5065 的文档站镜像) #5087 —— plugin-grid.mdx 整片示例的 type: 'grid'(落到 CSS Grid 布局容器)与 header / accessorKey 列词汇表(被 strict 的 ListColumn 拒绝)。plugin-grid README 的 10 个示例块整片 schema 键面不成立 —— type: 'grid' 落到布局容器,sortable / filterable / onRowClick 等零命中 #5065(README 侧)的文档站镜像,与渲染器侧的 finding(plugin-grid): ObjectGrid 在 ObjectGridSchema.columns 上容忍未声明的 accessorKey / header 拼写 —— 声明类型是 strict 的 ListColumn,#3104 的列身份门禁结构上看不见这条支路 #5068 同族不同层。
• content/docs/plugins/plugin-view.mdx 整片示例的 object / viewMode / fields 键面在 ObjectViewSchema 上一个都不成立(#5077 的文档站镜像) #5088 —— plugin-view.mdx 整片示例的 object / viewMode / fields 键面在 ObjectViewSchema 上一个都不成立(必填的是 objectName),照抄即空视图。plugin-view README 整片 schema 键面渲染器一个都不读 —— object / viewMode / fields / mode / recordId / fieldConfig 全非声明成员,照抄即空视图 #5077(README 侧)的文档站镜像。

三者的修都不落在#5065 / #5077 的完成范围内(那两单的范围是 packages/*/README.md),故按 #5076 自身「为什么单立一卡」的同一理由独立立卡,而非挂为子 issue。立卡前已按关键词 + 文件路径检索过 open issues,未见孪生。

[yinlianghui]

PM 验收:ACCEPT(session session_01GTRjn8xBqp75dk7kFupVRt,objectui 分片 PM,批次 22)

实物核验:merge-base 03e5f972a,3 files +126/−17 与报告一致,单 commit,模型标识 msg/diff 双零,releases 与 dashboard/map 两页零触碰,与在飞 #5065 零交集;changeset 缺席是门禁实测判定不欠(0 of them under the src/)而非省略。CI 亲读:17 个 check-run 全 completed 零失败,Build Docs 真跑 Build Site(对三个 mdx 做了一次真实站点渲染)。

验收要点:

1. 三处虚构注册段按已落地三单同口径改写(键从 register 调用现场抄、含 skipFallback 语义),名集合核对 8 条不成立 → 5 条(余者全为边界外错包路径,已立 content/docs/plugins/plugin-{form,grid,view}.mdx 三处 import type 从错误的包导入真实类型 —— 照抄即 TS2305(#5011/#5013/#5014 第二条的文档站镜像) #5086);散文位 46 个标识符全绿且含 3 条缺席断言 —— 账本形完整。
2. 反常读数的诚实处理是本单亮点:check-doc-component-types 改前改后计数完全一致 —— dev 明确指出该门禁的绿不是本修复生效的证据(它核 type 值不核 import 名,这一族正是从它下面穿过去的),修复证据是名集合核对与 tsc 探针。不把无关的绿据为己有,合格。
3. 反向探针的方向说明准确:运行期 TypeError 与编译期 TS2305 是同一缺陷的两面,探针抓后者。

派生物分诊(本评论即记录):#5086(三 mdx 的错包路径类型导入 —— 家族第二条的文档站镜像)、#5087(grid.mdx 键面 —— #5065 的镜像)、#5088(view.mdx 键面 —— #5077 的镜像)均 → pm:queue + bug + documentation;三卡与本 PR 同文件,本 PR 落 main 后才可派,且 #5087/#5088 宜在各自 README 侧(#5065 在飞、#5077 排队)落地后按其基准改写,验证一律 cast 感知口径。

转 ready 并挂 auto-merge(squash)。

---

Generated by Claude Code