fix(fields): a detail-page address reads as a formatted address, not stringified JSON

[yinlianghui]

Fixes#4037

The gap

The display (read) registry mapped address straight to JsonCellRenderer, so a populated address rendered as {"street":"中策路 1 号","city":"杭州",…} on a record detail page — while a location field in the same field group rendered formatted, and the create/edit dialog rendered the same value as proper Street / City / State / ZIP / Country inputs. Display-side only: the input registry has always carried address.

Premise verified against origin/main before implementing, and it still holds: packages/fields/src/index.tsx had address: JsonCellRenderer in getCellRenderer's map, exactly as the source thread's triage recorded.

Both read surfaces, one path

The card names two surfaces — detail read mode and the inline-edit read state. DetailSection builds onedisplayValue (packages/plugin-detail/src/DetailSection.tsx:244) and renders it from both the mobile read row and the desktop row that carries the pencil affordance, so a single registry entry fixes both. Both are pinned by tests driving the real DetailSection, not the renderer.

Layout choice and its source

The layout is not invented here. AddressField's readonly branch already collapsed a stored address to one line, and that rule is now the only implementation:

Street, City, State ZIP, Country — state and the postal code share one comma group, space-separated inside it ("CA 94102"), either one able to occupy the group alone.

It moved into a pure packages/fields/src/widgets/address-format.ts that both the widget and the new AddressCellRenderer call, so a readonly form and a detail page cannot spell one stored address two ways. A copy next to the renderer would have been a rule that drifts — which is the failure the issue reports, one surface later. The module is deliberately React-free so the eager barrel can format a cell without pulling AddressField and its inputs out of the lazy widget chunk.

On locale-aware ordering: the report was zh-CN, and Chinese postal convention is largest-to-smallest (country first). I did not introduce locale-dependent ordering. Neither the issue nor the source thread objectstack#5019 (read in full, including both triage comments) establishes a format ruling, and the sub-field set is the input widget's own. Reordering by locale would make the read line disagree with the readonly form line and with the input order users type in — a bigger inconsistency than the one being fixed, decided unilaterally. The existing single rule is applied uniformly; if the maintainer wants locale-ordered addresses, that is one deliberate change to formatAddress affecting every surface at once, which is exactly the point of it having one home.

Graceful partials

Absent, non-string and whitespace-only parts collapse and are dropped rather than spaced over: a street-only address is 中策路 1 号, never , , , and never the string undefined. Legacy records whose postal code was written under zipCode (objectstack#5143) still render it, matching what the input widget reads.

Nothing is silently swallowed: an object carrying no recognized part keeps today's compact-JSON rendering rather than disappearing, {} and null show the usual empty placeholder, and a plain string address passes straight through.

Reverse verification

Predicted direction first, then measured. Reverting only the two fix files to origin/main (git checkout origin/main -- …, never git stash) and re-running:

Tests 12 failed | 5 passed (17)
→ expected '{"street":"中策路 1 号","city":"杭州","stat…' not to match /[{}]/
→ expected '{"city":"SF","state":"CA"}' to be 'SF, CA'
→ expected '{"city":"San Francisco","state":"CA",…' to be 'San Francisco, CA 94102'
→ Unable to find an element with the text: 中策路 1 号, 杭州, 浙江 310000, 中国

That is the issue's own signature. Two reported deviations from the naive expectation, both honest:

1. "carries the full value: every authored sub-field appears" stays GREEN when reverted — stringified JSON also contains every part. It is a completeness assertion, not a defect pin, and is reported as such rather than counted as red-first evidence.
2. The location control was initially red too, because it asserted the no-JSON signature over a container that also held the address field — it restated the tests above instead of controlling for them. Fixed in its own commit: the control now renders location alone and is green in both directions, which is what "the sibling formatter is untouched" actually claims.

Controls: location / geolocation formatting unchanged, json / object / composite / record still stringify, address inputs unchanged on every surface including the dialog.

Verification

• npx vitest run packages/fields/ packages/plugin-detail/ — 142 files, 1725 tests passed
• New: 13 cases in AddressCellRenderer.test.tsx (resolved through getCellRenderer, so a registry regression is caught, not merely a formatter change) + 4 in DetailSection.addressDisplay.test.tsx
• type-check both packages: Done. lint both packages: 0 errors
• check:control-bytes: OK (3909 files); explicit control-byte self-scan of every touched file: clean
• i18n gates green — "No en value changed in this range". No i18n discipline needed here: this is pure value formatting with no labels or copy; the only user-visible strings are the record's own stored data
• Changeset: patch for @object-ui/fields. plugin-detail's only change is a test, which releases nothing

Scope

index.tsx diff is strictly the address entries (one import, one renderer, one registry line) — no ImageField (#4141), no app-shell/ListView (#4155), no data-objectstack (#4139), no AppHeader (#4197).

Out of scope, filed separately: actively inline-editing an address collapses it into one raw text box reading [Object] via coerceToSafeValue, and typing writes a string over the structured value. That is the inline-edit input path missing the address widget, a different defect from this display-registry gap — not fixed here.

---

Generated by Claude Code

[vercel]

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectui	Ignored		Aug 11, 2026 2:47am

[github-actions]

✅ Console Performance Budget

Metric	Value	Budget
Main entry (gzip)	28.3 KB	350 KB
Entry file	index-CpKkhLym.js	—
Status	PASS	—

---

📦 Bundle Size Report

Package	Size	Gzipped
app-shell (index.js)	8.88KB	3.25KB
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.21KB	3.45KB
auth (LoginForm.js)	18.13KB	5.39KB
auth (PreviewBanner.js)	0.90KB	0.50KB
auth (RegisterForm.js)	6.64KB	2.21KB
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)	26.07KB	7.56KB
collaboration (LiveCursors.js)	3.17KB	1.27KB
collaboration (PresenceAvatars.js)	6.49KB	2.64KB
collaboration (PresenceProvider.js)	2.79KB	1.13KB
collaboration (index.js)	1.65KB	0.73KB
collaboration (useCollaborationTranslation.js)	6.05KB	2.52KB
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)	486.47KB	107.53KB
core (index.js)	3.04KB	1.15KB
create-plugin (index.js)	10.08KB	3.26KB
data-objectstack (index.js)	140.66KB	36.25KB
fields (index.js)	227.64KB	56.42KB
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.65KB	1.06KB
i18n (pickLocalized.js)	1.70KB	0.83KB
i18n (provider.js)	9.48KB	3.27KB
i18n (useObjectLabel.js)	27.59KB	6.63KB
i18n (useSafeTranslation.js)	4.52KB	1.96KB
layout (index.js)	38.87KB	10.80KB
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.32KB	1.64KB
mobile (useTouchTarget.js)	1.01KB	0.54KB
permissions (MePermissionsProvider.js)	8.75KB	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 (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)	45.23KB	12.45KB
plugin-charts (index.js)	61.52KB	17.49KB
plugin-chatbot (index.js)	180.33KB	42.79KB
plugin-dashboard (index.js)	118.52KB	30.68KB
plugin-designer (index.js)	210.51KB	42.51KB
plugin-detail (index.js)	237.80KB	59.48KB
plugin-editor (index.js)	2.46KB	1.10KB
plugin-form (index.js)	114.58KB	27.68KB
plugin-gantt (index.js)	164.14KB	39.98KB
plugin-grid (index.js)	187.97KB	49.90KB
plugin-kanban (index.js)	48.60KB	13.41KB
plugin-list (index.js)	110.04KB	26.67KB
plugin-map (index.js)	17.00KB	5.32KB
plugin-markdown (index.js)	13.72KB	4.69KB
plugin-report (index.js)	40.58KB	10.58KB
plugin-timeline (index.js)	26.21KB	7.52KB
plugin-tree (index.js)	8.50KB	2.88KB
plugin-view (index.js)	84.03KB	20.55KB
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)	23.71KB	7.95KB
react (data-invalidation.js)	5.05KB	2.08KB
react (index.js)	1.23KB	0.66KB
react (spec-input.js)	0.20KB	0.18KB
sdui-parser (codegen.js)	4.09KB	1.74KB
sdui-parser (index.js)	4.47KB	2.03KB
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 (http-retry.js)	4.32KB	2.02KB
types (index.js)	2.71KB	1.34KB
types (layout.js)	0.20KB	0.18KB
types (managed-by.js)	0.19KB	0.18KB
types (mobile.js)	2.59KB	1.31KB
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)	3.40KB	1.71KB
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