Skip to content

fix(fields,components): read the selectFirst gate joiner from the locale pack - #4739

Merged
yinlianghui merged 2 commits into
mainfrom
claude/issue-4026-selectfirst-joiner
Aug 15, 2026
Merged

fix(fields,components): read the selectFirst gate joiner from the locale pack#4739
yinlianghui merged 2 commits into
mainfrom
claude/issue-4026-selectfirst-joiner

Conversation

@yinlianghui

Copy link
Copy Markdown
Collaborator

Fixes #4026

The dependency-gate hint now enumerates its controlling fields with the locale's own
list separator, and reads identically whichever caller produced it.

The defect

lookup.selectFirst and fields.options.selectFirst are deliberately one wording — the
form renderer's own comment says the two callers exist so "the gate can never read
differently depending on which side produced it". That invariant held for the sentence
but not for its {{fields}} slot, which each call site filled with its own hardcoded
separator, and not even the same one:

Call site Sentence Separator
packages/fields/src/widgets/LookupField.tsx (dependsOnFieldsText) lookup.selectFirst ', '
packages/components/src/renderers/form/form.tsx (gatedHint memo) fields.options.selectFirst ' / '
packages/fields/src/widgets/OptionsEmptyState.tsx fields.options.selectFirst ' / '

So a field gated on two parents read Select Account, Lead Source first from the lookup
and Select Account / Lead Source first from the form. A list separator is a property of
the locale rather than of the code, so under zh/ja both spellings were also wrong for the
script (U+3001 is the CJK enumeration comma), as they were under ar (U+060C).

The fix

All three call sites now read validation.formInvalidJoiner — the key objectstack#5407
already shipped in all ten packs for the invalid-submit toast's field list, which is the
same class of truncated-name list. One key, every caller: a second, gate-specific key
would have recreated exactly the divergence the shared sentence exists to prevent, which
is the constraint the card pins.

No locale-pack edits. The only new declaration is validation.formInvalidJoiner in
@object-ui/fields' createSafeTranslation defaults table, whose value is the en pack's
', ' — byte-identical to the literal LookupField previously hardcoded, so a
provider-less English render is unchanged. That table's own discipline is that a default is
declared where it is read.

The third call site, and why it is in scope

The card names two sites. OptionsEmptyState is a third, and it is the "standalone widget"
caller of fields.options.selectFirst that the form renderer's comment refers to — it
hardcoded ' / ' too. Changing only the two named sites would have left the shared
sentence still reading two ways within one key, defeating the card's stated invariant, so
it is fixed here and named rather than filed. It meets the in-place bar: same defect class,
same mechanical fix already pinned by the adjudicated route, same package and gate
families, and no open PR touches the file (checked against the open PR list at dispatch
time — #4655, #4639, #4093, none of which touch these three files).

Verification

All of the below run at 954e71ec4, the pushed head, working tree clean.

Gate Result
vitest run packages/fields/ packages/components/ 222 files / 2551 tests passed
type-check (fields, components) PASS
eslint . --quiet (fields, components) PASS, 0 errors
check:control-bytes PASS
check:i18n-keys PASS
check:i18n-drift PASS
check:i18n-dead-keys PASS
check:phantom-deps PASS
check-changeset-presence PASS
check-changeset-no-major PASS

The check:i18n-* family was not in the dispatched gate list; it was re-derived from the
actual changed paths (a new t() call site plus a defaults-table entry) and added.

Reverse verification

The fix was committed first, then ablated by restoring all four changed source files from
origin/main, and the new test re-run. It went red in the expected direction, 10 of 19
cases failing, and the failure messages reproduce the reported defect verbatim:

AssertionError: expected 'Select Account / Lead Source first'
                to be 'Select Account, Lead Source first'
AssertionError: expected '请先选择Account, Lead Source' to contain 'Account、Lead Source'
AssertionError: expected 'اختر Account, Lead Source أولاً' to contain 'Account، Lead Source'
AssertionError: expected '请先选择Account, Lead Source' not to contain ', '

Worth recording honestly: 9 cases stayed green under the ablation, and that is
informative rather than a gap. The OptionsEmptyState-vs-form comparison passed because
both sides hardcoded the same wrong ' / ' — they agreed while both were broken, which
is precisely why the lookup-vs-form equality is the load-bearing assertion. The en/de/ko
separator cases passed because ', ' happens to be those packs' correct value, which is
the "right by accident" half objectstack#5407 documented. The fix was then restored from
the branch and the union re-run at the final head.

Test

One new file, packages/fields/src/__tests__/selectFirst-gate-joiner-locale-parity.test.tsx
(19 cases over en/de/ko/zh/ja/ar). It lives in @object-ui/fields because that is the only
package that can see both sides — fields depends on components, not the reverse, and the
existing split in form-depends-on-labels.test.tsx exists for that same reason.

It asserts equality between the callers rather than three copies of an expected string:
a joiner that later changes wrongly-but-consistently is a translation bug, while one that
changes inconsistently is this defect returning. The per-script cases (zh/ja get U+3001, ar
gets U+060C + space, Latin scripts and ko get ', ') cover the first half, mirroring the
shape of the existing validation-list-joiner-locale-parity test.

The form side is read through a probe widget registered as field:select, so the compared
string is gatedHint's own output with no other widget's formatting in between; the lookup
side is read from the gated trigger's title, which is the whole sentence and nothing
else. The probe renders what it received rather than writing to a module variable during
render — the latter is a side effect react-hooks/globals rejects.

Changeset

.changeset/selectfirst-gate-joiner-locale.md, patch for @object-ui/fields and
@object-ui/components. No major, per the version-alignment rule. objectui has no
skip-changeset mechanism and none was applied.


Generated by Claude Code

claude added 2 commits August 15, 2026 20:53
…ale pack

The dependency-gate sentence is deliberately shared between the lookup widget
and the form renderer, but each caller filled its {{fields}} slot with its own
hardcoded separator — ', ' in LookupField, ' / ' in the form renderer and in
OptionsEmptyState — so a field gated on two parents read two different ways
depending on which side produced it. A list separator is a locale property, so
all three now read validation.formInvalidJoiner, the key already shipped in the
ten packs for the invalid-submit toast's field list.

Fixes #4026
…locale

The probe renders the hint it received rather than writing it to a module
variable during render (react-hooks/globals). Adds the changeset for the
fields + components patch.
@vercel

vercel Bot commented Aug 15, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectui Ignored Ignored Aug 15, 2026 9:43pm

Request Review

Copy link
Copy Markdown
Collaborator Author

PM review — ACCEPT (reviewer of record, session session_01RnQd8iMMUwXQEV1crFmQiQ)

Independently verified against the branch, not the report:

  1. One key, every caller. All three call sites — LookupField.tsx (dependsOnFieldsText), form.tsx (gatedHint memo), and OptionsEmptyState.tsx — now join through t('validation.formInvalidJoiner'); my branch grep confirms the three read sites plus the two defaults-table declarations and nothing else. Zero locale-pack edits, exactly as the adjudicated route required; no fields.gateJoiner twin exists.
  2. The third call site was correctly in scope. OptionsEmptyState fills the same fields.options.selectFirst key; fixing only the two named sites would have left one sentence reading two ways within one key — the precise invariant the card pins. The in-place bar was checked against the open-PR list, not asserted.
  3. The defaults-table addition is load-bearing, not scope creep: without validation.formInvalidJoiner in FIELD_DEFAULTS, the provider-less path would join names with the literal key string. Declared-where-read, valued byte-identical to the en pack, pinned by the existing no-provider tests.
  4. Reverse verification with honest accounting: 10 of 19 red reproducing the defect verbatim, and the 9 survivors explained rather than waved at — the standalone-vs-form comparison agreed while both were broken (same wrong ' / '), which is exactly why lookup-vs-form equality is the load-bearing assertion, and en/de/ko were right by accident (', ' is their correct value).

Correction accepted, publicly: the dev observed that "objectui has no skip-changeset label" is not literally accurate — the label exists in the registry (open PR #4639 carries it). The operative fact stands (no gate consumes it; applying it exempts nothing, which is why three PRs were corrected today), but future dispatches from this seat will say "no skip-changeset mechanism — the label exists but nothing reads it." Thanks for measuring rather than repeating me.

Body: Fixes #4026 sole closing keyword; objectstack#5407, #3231, #2942 references keyword-free. Changeset: fields + components patch. Gates at 954e71ec4: awaiting CI convergence — will flip ready + auto-merge once Lint + Type Check + Test shards 1-4 conclude success at this head.


Generated by Claude Code

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Main entry (gzip) 24.7 KB 350 KB
Entry file index-B-gOCssf.js
Status PASS

📦 Bundle Size Report

Package Size Gzipped
app-shell (index.js) 9.56KB 3.59KB
app-shell (runtime-config.js) 7.42KB 2.32KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 8.92KB 3.41KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 1.17KB 0.53KB
auth (AuthProvider.js) 25.13KB 5.40KB
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) 38.46KB 10.17KB
auth (createAuthenticatedFetch.js) 6.34KB 2.43KB
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) 5.02KB 0.88KB
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) 490.23KB 108.70KB
core (index.js) 3.79KB 1.52KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 157.05KB 43.28KB
fields (index.js) 230.42KB 57.17KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (currency.js) 1.22KB 0.64KB
i18n (i18n.js) 4.32KB 1.77KB
i18n (index.js) 3.35KB 1.38KB
i18n (pickLocalized.js) 3.69KB 1.73KB
i18n (provider.js) 23.12KB 7.62KB
i18n (useDisplayLocale.js) 2.84KB 1.45KB
i18n (useObjectLabel.js) 27.59KB 6.63KB
i18n (useSafeTranslation.js) 7.77KB 3.13KB
layout (index.js) 38.98KB 10.85KB
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) 9.35KB 3.31KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 3.89KB 1.22KB
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.81KB 0.83KB
plugin-ai (index.js) 15.75KB 3.80KB
plugin-calendar (index.js) 46.86KB 12.91KB
plugin-charts (index.js) 64.44KB 18.28KB
plugin-chatbot (index.js) 181.21KB 43.14KB
plugin-dashboard (index.js) 121.90KB 31.76KB
plugin-designer (index.js) 212.39KB 42.83KB
plugin-detail (index.js) 239.81KB 59.97KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 114.72KB 27.70KB
plugin-gantt (index.js) 164.30KB 40.02KB
plugin-grid (index.js) 192.10KB 51.24KB
plugin-kanban (index.js) 52.72KB 14.54KB
plugin-list (index.js) 111.14KB 26.92KB
plugin-map (index.js) 18.16KB 5.81KB
plugin-markdown (index.js) 13.72KB 4.69KB
plugin-report (index.js) 41.38KB 11.09KB
plugin-timeline (index.js) 26.68KB 7.66KB
plugin-tree (index.js) 8.50KB 2.88KB
plugin-view (index.js) 83.81KB 20.49KB
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) 27.64KB 9.44KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 1.28KB 0.68KB
react (schema-input.js) 1.45KB 0.83KB
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 (dashboard-filter-alias.js) 6.23KB 2.74KB
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) 3.05KB 1.52KB
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

@yinlianghui
yinlianghui marked this pull request as ready for review August 15, 2026 21:56
@yinlianghui
yinlianghui added this pull request to the merge queue Aug 15, 2026
Merged via the queue into main with commit 75444e3 Aug 15, 2026
21 checks passed
@yinlianghui
yinlianghui deleted the claude/issue-4026-selectfirst-joiner branch August 15, 2026 21:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

objectui: the two selectFirst gate hints join controlling-field names with hardcoded separators — and with two DIFFERENT ones

2 participants