fix(form): spec-vocabulary fields stop crashing the standalone form; every surface names the boundary (#3090 PR2) by os-zhuang · Pull Request #3092 · objectstack-ai/objectui

os-zhuang · 2026-07-31T04:36:42Z

#3090 的 PR2(边界响亮化)。写复现测试时把预设推翻了一次:spec 形态条目在独立表单里不是静默消失,是把整个表单弄崩 —— { field: 'owner' } 溜过各处 f?.name 守卫、进到 react-hook-form Controller 时 name === undefined,name.split('.') TypeError 崩掉全表,且没有任何信息指向肇事条目。

1. 独立表单渲染器(components)

把 spec 形态条目从渲染列表剔除(其余字段照常渲染,不再全表崩),同时:

表单内联 destructive Alert 点名未渲染的字段(data-testid="form-spec-vocabulary-error")
console.error 的文案就是修复指令 —— 这是迭代元数据的 agent 实际会读并执行的东西:改 name,或用 object-bound form(sections 走枢纽翻译)
混合词汇(name + string field)→ console.warn,按 name 渲染
双关不误伤(测试钉死):runtime 字段的 field 槽合法地装着解析后的元数据对象,只有 string field 且无 name 才标记违例

2. `objectui validate`(cli)

实测原始报错只有 Invalid input / invalid_union(union 坍缩)—— 或在非 union 上下文里是 name: expected string,读起来像「补个 name」,会把 spec 元数据改坏(裸改名丢掉对象 schema 合并语义)。现在:

失败分支:检测到 spec 形态 → 「Likely cause」定向提示,指出层边界与两条真修法
成功分支:混合词汇 → Warning(校验通过但 spec 键是死重,渲染器忽略、strip 丢弃)
检测器 findSpecVocabularyFormFields 是纯函数,精度即要点:只扫 type: 'form' 直挂的 fields;object-form 的 sections[].fields[] 合法接受 spec 形态,不报

已用真实 CLI dist 对两个 fixture 冒烟验证,两分支输出如设计。

3. `normalizeSectionField`(plugin-form)

分区路径的混合词汇 lint:spec 分支从 field 推导 runtime name,作者写的 name 被静默覆盖 —— 现在每站点一次 console.warn 说明谁赢了、该删哪个。

验证

718 tests 全过(components form 全套 + plugin-form + cli),新增 12 个断言
components/plugin-form/cli 三包 tsc 干净;改动文件 eslint 0 errors
真实 CLI 冒烟两分支验证

Closes 部分 #3090(PR2 复选框)。

🤖 Generated with Claude Code

…every surface names the boundary (#3090) Writing the regression test against the unfixed renderer proved the failure was worse than the assumed silent drop: a { field: 'x' } entry (spec form-VIEW vocabulary) slipped past the f?.name guards into a react-hook-form Controller with name === undefined and crashed the WHOLE standalone form on name.split('.'), with nothing naming the culprit. The renderer now partitions such entries out — the rest of the form renders — and surfaces them: an inline alert naming the fields, plus a console.error whose text is the fix instruction an iterating agent will actually follow. objectui validate grows the same boundary awareness: on failure a directed "likely cause" hint replaces the bare invalid_union for spec-shaped entries (the old message read as "bolt a name on", which converts spec metadata wrongly); on success, mixed-vocabulary entries get a warning that the spec key is dead weight. normalizeSectionField warns once per site on mixed identity keys, where the authored name was silently overwritten. Detector precision is pinned by tests: section fields (object-form) legitimately accept the spec shape, and a runtime field's `field` key legitimately holds the resolved metadata OBJECT — only a STRING field without a name marks the boundary violation. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

vercel · 2026-07-31T04:36:48Z

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectui	Ignored		Jul 31, 2026 4:36am

github-actions · 2026-07-31T04:40:24Z

✅ Console Performance Budget

Metric	Value	Budget
Main entry (gzip)	27.9 KB	350 KB
Entry file	`index-B-bz_bFh.js`	—
Status	PASS	—

📦 Bundle Size Report

Package	Size	Gzipped
app-shell (index.js)	8.26KB	2.99KB
app-shell (runtime-config.js)	7.42KB	2.32KB
app-shell (types.js)	0.01KB	0.04KB
app-shell (urlParams.js)	7.57KB	2.97KB
auth (AuthContext.js)	0.31KB	0.24KB
auth (AuthGuard.js)	1.17KB	0.53KB
auth (AuthProvider.js)	22.10KB	4.37KB
auth (AuthShell.js)	3.49KB	1.40KB
auth (ForgotPasswordForm.js)	12.12KB	3.41KB
auth (LoginForm.js)	17.86KB	5.29KB
auth (PreviewBanner.js)	0.90KB	0.50KB
auth (RegisterForm.js)	6.43KB	2.09KB
auth (SocialSignInButtons.js)	9.60KB	3.89KB
auth (UserMenu.js)	3.40KB	1.22KB
auth (auth-gate-events.js)	1.29KB	0.66KB
auth (authStyles.js)	5.04KB	1.72KB
auth (createAuthClient.js)	35.76KB	9.11KB
auth (createAuthenticatedFetch.js)	4.37KB	1.69KB
auth (index.js)	2.35KB	1.07KB
auth (org-roles.js)	6.66KB	2.78KB
auth (phone-identifier.js)	1.11KB	0.66KB
auth (types.js)	0.59KB	0.35KB
auth (useAuth.js)	4.91KB	0.87KB
auth (useIsWorkspaceAdmin.js)	1.61KB	0.85KB
collaboration (CommentThread.js)	18.38KB	4.49KB
collaboration (LiveCursors.js)	3.17KB	1.27KB
collaboration (PresenceAvatars.js)	3.65KB	1.42KB
collaboration (PresenceProvider.js)	2.79KB	1.13KB
collaboration (index.js)	1.25KB	0.53KB
collaboration (useCommentSearch.js)	1.98KB	0.88KB
collaboration (useConflictResolution.js)	7.75KB	1.86KB
collaboration (useMentionNotifications.js)	1.81KB	0.68KB
collaboration (usePresence.js)	6.33KB	1.84KB
collaboration (useRealtimeSubscription.js)	7.91KB	2.01KB
components (index.js)	473.75KB	103.77KB
core (index.js)	2.16KB	0.78KB
create-plugin (index.js)	9.28KB	2.98KB
data-objectstack (index.js)	136.34KB	34.64KB
fields (index.js)	222.07KB	54.35KB
i18n (LocalizationContext.js)	1.76KB	0.96KB
i18n (currency.js)	1.22KB	0.64KB
i18n (i18n.js)	4.32KB	1.77KB
i18n (index.js)	2.46KB	0.96KB
i18n (pickLocalized.js)	1.70KB	0.83KB
i18n (provider.js)	5.37KB	1.72KB
i18n (useObjectLabel.js)	25.17KB	5.80KB
i18n (useSafeTranslation.js)	3.26KB	1.44KB
layout (index.js)	38.44KB	10.66KB
mobile (MobileProvider.js)	0.92KB	0.49KB
mobile (ResponsiveContainer.js)	0.94KB	0.38KB
mobile (breakpoints.js)	1.51KB	0.70KB
mobile (createOfflineDataSource.js)	5.61KB	1.74KB
mobile (index.js)	1.50KB	0.62KB
mobile (offlineQueue.js)	3.91KB	1.35KB
mobile (pwa.js)	0.97KB	0.49KB
mobile (serviceWorker.js)	1.48KB	0.62KB
mobile (serviceWorkerSource.js)	3.41KB	1.48KB
mobile (useBreakpoint.js)	1.54KB	0.65KB
mobile (useGesture.js)	6.96KB	1.98KB
mobile (useOfflineSync.js)	1.99KB	0.72KB
mobile (usePullToRefresh.js)	2.53KB	0.85KB
mobile (useResponsive.js)	0.71KB	0.42KB
mobile (useResponsiveConfig.js)	1.36KB	0.63KB
mobile (useSpecGesture.js)	4.05KB	1.53KB
mobile (useTouchTarget.js)	1.01KB	0.54KB
permissions (MePermissionsProvider.js)	8.76KB	3.06KB
permissions (PermissionContext.js)	0.31KB	0.25KB
permissions (PermissionGuard.js)	0.89KB	0.45KB
permissions (PermissionProvider.js)	3.67KB	1.12KB
permissions (evaluator.js)	4.41KB	1.44KB
permissions (index.js)	0.91KB	0.41KB
permissions (retry.js)	3.48KB	1.61KB
permissions (store.js)	0.91KB	0.42KB
permissions (useFieldPermissions.js)	1.28KB	0.52KB
permissions (usePermissions.js)	1.55KB	0.71KB
plugin-ai (index.js)	15.71KB	3.79KB
plugin-calendar (index.js)	44.90KB	12.35KB
plugin-charts (index.js)	60.52KB	17.11KB
plugin-chatbot (index.js)	180.09KB	42.72KB
plugin-dashboard (index.js)	111.59KB	28.74KB
plugin-designer (index.js)	210.51KB	42.50KB
plugin-detail (index.js)	221.81KB	54.28KB
plugin-editor (index.js)	2.46KB	1.10KB
plugin-form (index.js)	111.38KB	26.93KB
plugin-gantt (index.js)	162.26KB	39.53KB
plugin-grid (index.js)	182.21KB	48.24KB
plugin-kanban (index.js)	47.82KB	13.18KB
plugin-list (index.js)	103.85KB	24.80KB
plugin-map (index.js)	16.80KB	5.24KB
plugin-markdown (index.js)	13.65KB	4.67KB
plugin-report (index.js)	40.32KB	10.53KB
plugin-timeline (index.js)	25.75KB	7.32KB
plugin-tree (index.js)	8.36KB	2.81KB
plugin-view (index.js)	83.54KB	20.39KB
providers (DataSourceProvider.js)	0.75KB	0.39KB
providers (MetadataProvider.js)	1.37KB	0.59KB
providers (ThemeProvider.js)	1.90KB	0.85KB
providers (UploadProvider.js)	11.71KB	3.53KB
providers (index.js)	0.44KB	0.22KB
providers (types.js)	0.01KB	0.04KB
react-runtime (index.js)	5.67KB	2.37KB
react (LazyPluginLoader.js)	3.77KB	1.33KB
react (SchemaRenderer.js)	19.28KB	6.38KB
react (data-invalidation.js)	5.05KB	2.08KB
react (index.js)	1.02KB	0.55KB
sdui-parser (codegen.js)	4.09KB	1.74KB
sdui-parser (index.js)	3.47KB	1.54KB
sdui-parser (parse.js)	10.04KB	2.82KB
sdui-parser (types.js)	0.29KB	0.24KB
sdui-parser (validate.js)	4.69KB	1.48KB
types (ai.js)	0.20KB	0.17KB
types (api-types.js)	0.20KB	0.18KB
types (app.js)	2.87KB	0.99KB
types (base.js)	0.20KB	0.18KB
types (blocks.js)	0.20KB	0.18KB
types (complex.js)	0.20KB	0.18KB
types (crud.js)	0.20KB	0.18KB
types (data-display.js)	0.20KB	0.18KB
types (data-protocol.js)	0.20KB	0.19KB
types (data.js)	0.20KB	0.18KB
types (designer.js)	1.87KB	0.85KB
types (disclosure.js)	0.20KB	0.18KB
types (error-code.js)	1.54KB	0.88KB
types (feedback.js)	0.20KB	0.18KB
types (field-types.js)	0.20KB	0.18KB
types (form.js)	0.20KB	0.18KB
types (index.js)	2.07KB	0.99KB
types (layout.js)	0.20KB	0.18KB
types (managed-by.js)	0.19KB	0.18KB
types (mobile.js)	0.20KB	0.18KB
types (navigation.js)	0.20KB	0.18KB
types (objectql.js)	0.20KB	0.18KB
types (overlay.js)	0.20KB	0.18KB
types (permissions.js)	0.20KB	0.18KB
types (plugin-scope.js)	0.20KB	0.18KB
types (record-components.js)	0.20KB	0.19KB
types (record-semantics.js)	1.28KB	0.67KB
types (registry.js)	0.20KB	0.18KB
types (reports.js)	0.20KB	0.18KB
types (spec-report.js)	5.05KB	1.93KB
types (system-fields.js)	3.33KB	1.54KB
types (theme.js)	0.20KB	0.18KB
types (ui-action.js)	1.08KB	0.64KB
types (views.js)	0.20KB	0.18KB
types (widget.js)	0.20KB	0.18KB

Size Limits

✅ Core packages should be < 50KB gzipped
✅ Component packages should be < 100KB gzipped
⚠️ Plugin packages should be < 150KB gzipped

github-actions Bot added package: components plugin tests labels Jul 31, 2026

os-zhuang merged commit c735bf7 into main Jul 31, 2026
16 checks passed

os-zhuang deleted the claude/form-field-boundary-loudening branch July 31, 2026 04:43

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

fix(form): spec-vocabulary fields stop crashing the standalone form; every surface names the boundary (#3090 PR2) - #3092

fix(form): spec-vocabulary fields stop crashing the standalone form; every surface names the boundary (#3090 PR2)#3092
os-zhuang merged 1 commit into
mainfrom
claude/form-field-boundary-loudening

os-zhuang commented Jul 31, 2026

Uh oh!

vercel Bot commented Jul 31, 2026

Uh oh!

github-actions Bot commented Jul 31, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

os-zhuang commented Jul 31, 2026

1. 独立表单渲染器(components)

2. objectui validate(cli)

3. normalizeSectionField(plugin-form)

验证

Uh oh!

vercel Bot commented Jul 31, 2026

Uh oh!

github-actions Bot commented Jul 31, 2026

✅ Console Performance Budget

📦 Bundle Size Report

Size Limits

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

2. `objectui validate`(cli)

3. `normalizeSectionField`(plugin-form)