Skip to content

fix(fields): compose the host onBlur in CurrencyField and TagsField - #6858

Merged
os-sam merged 2 commits into
mainfrom
claude/issue-6802-currency-tags-onblur-passthrough
Aug 30, 2026
Merged

fix(fields): compose the host onBlur in CurrencyField and TagsField#6858
os-sam merged 2 commits into
mainfrom
claude/issue-6802-currency-tags-onblur-passthrough

Conversation

@os-sam

@os-sam os-sam commented Aug 30, 2026

Copy link
Copy Markdown
Collaborator

Fixes #6802

CurrencyField and TagsField each wrote their own onBlur AFTER the
{...toDomProps(props)} spread, so a host-supplied handler was overridden and
never reached the control. onBlur is a DECLARED DOM pass-through key — named
in FieldWidgetDomProps (packages/fields/src/widgets/types.ts), named in
SDUI_DOM_PASS_THROUGH_KEYS (packages/core/src/utils/dom-props.ts), and
forwarded by toDomProps — so this is the declared-but-not-delivered class
(#3290 / #3222).

Both now use the idiom PR #6801 landed for the other three widgets: resolve
toDomProps(props) into domProps, spread {...domProps}, and call
domProps.onBlur?.(e) at the end of the local handler. No second idiom
invented; no public surface widened.

⛔ Read this first — the card's "latent, no-op today" premise is FALSE

The card and its triage both rest on one measurement, taken on d06059f24:
"no host in this repo passes onBlur to a field widget", which made composing
a no-op today and the change a free buy-forward.

Re-measured on this branch's base (1e14d70), that is not true, and the
reproduction is committed as hostOnBlurDelivery-e2e.test.tsx.

The call site. The form renderer hosts every field through
react-hook-form's Controller — the FormField wrapper in
packages/components/src/ui/form.tsx is a thin Controller — and spreads the
controller's field object straight into the widget's props:

render={({ field: formField, fieldState }) => (
   renderFieldComponent(resolvedType, { ...fieldProps,, ...formField,})

packages/components/src/renderers/form/form.tsx (the ...formField spread)

A react-hook-form controller field is { name, value, onChange, onBlur, ref, disabled }. Measured directly — a probe widget registered into the real form
renderer reported its own prop keys:

["field","name","value","onChange","onBlur","ref","options","placeholder",
 "disabled","readonly","error","aria-required","id","aria-describedby","aria-invalid"]
                        ^^^^^^^  typeof: function

So every registered field widget in every form this repo renders is already
handed an onBlur
, and it is the handler that marks the field touched and,
under validationMode 'onBlur' / 'onTouched', runs its validation.
validationMode is authorable on ObjectFormSchema and is wired straight to
react-hook-form's mode, so metadata alone reaches this.

What that means for the change. The defect is not latent — it is active and
user-visible: currency and tags fields were silently opted out of blur-mode
validation while every sibling field type on the same form kept it. The fix is
therefore a REAL behaviour change, not the free no-op the card priced it as.
The direction is unchanged (it restores declared = enforced, and the four
type="number" widgets already behave this way), but the risk note triage
wrote — "could start firing onBlur-mode validation on currency fields that
never saw it"
— is now the actual, intended effect rather than a hypothetical.
Flagged rather than absorbed, because the reason for doing it now was the
premise that just failed. The changeset says so in the release notes.

Verification

Pre-fix red, with a control (base 1e14d70, hostOnBlurDelivery-e2e.test.tsx):

✓ CONTROL: NumberField — repaired in objectui#6780 — announces on blur
× CurrencyField announces on blur instead of swallowing the host handler
× TagsField announces on blur instead of swallowing the host handler
    Unable to find an element with the text: Amount is required
    Unable to find an element with the text: Labels is required
Tests  2 failed | 1 passed (3)

The control passing is what makes the two red rows about the widgets rather
than about the fixture.

Ablation on the committed fix — remove only domProps.onBlur?.(e) from both
widgets, run, restore. Mutation confirmed on disk before the run (grep -c
for the composition: 1 10 0; both blob hashes differed from their HEAD
blobs). No rebuild leg applies: the pins import the widgets by relative source
path and the suite resolves @object-ui/components to source, so nothing is
read out of dist/.

× CurrencyField still calls a host onBlur                       (badInputAnnounce §5)
× CurrencyField announces on blur …                             (e2e)
× TagsField announces on blur …                                 (e2e)
× calls the host onBlur                                         (TagsField.hostOnBlur)
× hands the host the real focus event, not a fabricated one     (TagsField.hostOnBlur)
× still commits the typed draft as a tag on that same blur      (TagsField.hostOnBlur)
Tests  6 failed | 77 passed (83)

PercentField / NumberField / GeolocationField and the fourth TagsField
case (works with no host handler at all) stay green under the ablation, as
they should — they do not depend on the removed line. Restore leg proven, not
assumed: git diff HEAD empty and both files byte-identical to their HEAD
blobs (07a8ac4…, b4067b7…).

Union re-run at the shipping head d931710:

pnpm exec vitest run --maxWorkers=2 packages/fields/
  Test Files  123 passed (123)
       Tests  2081 passed (2081)

pnpm --filter @object-ui/fields type-check     → exit 0
  (tsc --noEmit && tsc -p tsconfig.test.json)

--listFiles confirms this is a real measurement of the edited files, not a
green that excluded them: all three edited/added test files are in the
tsconfig.test.json program, and both widgets are in the main program.

Gates derived for this diff's paths (packages/fields/src/**, .changeset/**):

gate verdict line
check:control-bytes ✅ check-control-bytes: OK (scanned 5710 tracked text file(s); skipped 85 binary).
check-changeset-presence ✅ 5 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s)
check-changeset-fixed ✅ All workspace packages are in the changeset fixed group.
check-changeset-no-major ✅ No changeset declares a major bump.
check-changeset-overwrite ✅ No pre-existing changeset was modified or deleted.
check:vi-mock-specifiers ✅ check-vi-mock-specifiers: OK (3991 tracked source file(s) …)
check:i18n-keys exit 0 — every in-scope call-site key resolves against the en pack
pnpm --filter @object-ui/fields lint exit 0 — ✖ 907 problems (0 errors, 907 warnings); the package's standing warning baseline. The three files touched here contribute only @typescript-eslint/no-explicit-any warnings, matching the sibling e2e tests.

Declared narrowing. Lint was run package-scoped (--filter @object-ui/fields), not repo-wide; the repo-wide turbo run lint is CI's
run. check:sdui-registration-pins and check:eager-closure are recorded as
NOT MEASURED, not as passes: both refuse to run without an apps/console
build and say so themselves ("a run with nothing to read has measured
nothing"
). Neither reads anything this diff touches; CI builds console and
runs them.

Scope

Both halves of the class, per triage — repairing only CurrencyField would
have left TagsField open with no card tracking it. TagsField's onBlur IS
load-bearing in a way the currency one is not (it commits the typed draft as a
tag), so its pin asserts both effects on one blur; addTag runs first so a
blur-mode validator reads the committed list. Currency likewise emits its
rounded value before handing the event on.

The now-false exclusion note in NumberInputWidgets.badInputAnnounce.test.tsx
§5 ("CurrencyField is deliberately absent … no host in this repo passes one
today"
) is corrected in place rather than deleted, and CurrencyField joins
that file's it.each.

Session (durable copy, since a body edit rewrites the footer):
https://claude.ai/code/session_013hfmP9hoMd3dJwTh85J4yB

Generated by Claude Code

claude added 2 commits August 30, 2026 06:30
Both widgets wrote their own `onBlur` AFTER the `{...toDomProps(props)}`
spread, so a host-supplied handler was overridden and never reached the
control. `onBlur` is a DECLARED DOM pass-through key — named in
`FieldWidgetDomProps` and in `SDUI_DOM_PASS_THROUGH_KEYS`, and forwarded by
`toDomProps` — so this is the declared-but-not-delivered class.

Resolve `toDomProps(props)` into `domProps` and call `domProps.onBlur?.(e)`
at the end of the local handler, the idiom the other four widgets of this
package already use.

Not the no-op it was filed as: the form renderer hosts every field through
react-hook-form's `Controller` and spreads the controller field — which
always carries an `onBlur` — into the widget's props, so these two widgets
were opting currency and tags fields out of blur-mode validation on every
form in the repo.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013hfmP9hoMd3dJwTh85J4yB
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 45 chunks) 3176.5 KB 3222.7 KB
Main entry chunk (gzip) 143.6 KB 350 KB
Entry file index-DnwtCZFj.js
Status PASS

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 12.46KB 4.71KB
app-shell (runtime-config.js) 20.61KB 7.35KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 25.05KB 9.16KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.18KB 10.59KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.41KB 1.23KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.46KB 3.43KB
auth (index.js) 3.19KB 1.44KB
auth (invitation-status.js) 1.22KB 0.70KB
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.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 5.13KB 2.35KB
collaboration (CommentThread.js) 26.08KB 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.68KB 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) 511.68KB 116.36KB
core (index.js) 5.30KB 2.13KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 173.17KB 47.98KB
fields (index.js) 243.36KB 61.51KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (currency.js) 1.22KB 0.64KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 4.28KB 1.75KB
i18n (index.js) 3.44KB 1.39KB
i18n (pickLocalized.js) 7.62KB 3.26KB
i18n (provider.js) 26.89KB 9.04KB
i18n (useDisplayLocale.js) 2.85KB 1.45KB
i18n (useObjectLabel.js) 33.40KB 8.71KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 38.95KB 10.97KB
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.75KB
mobile (index.js) 1.55KB 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.72KB 0.42KB
mobile (useResponsiveConfig.js) 1.37KB 0.63KB
mobile (useSpecGesture.js) 4.32KB 1.64KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 9.53KB 3.38KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 4.64KB 1.50KB
permissions (evaluator.js) 5.12KB 1.74KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 15.75KB 3.80KB
plugin-calendar (index.js) 46.92KB 12.93KB
plugin-charts (index.js) 64.68KB 18.35KB
plugin-chatbot (index.js) 190.53KB 45.18KB
plugin-dashboard (index.js) 133.48KB 34.51KB
plugin-designer (index.js) 212.87KB 43.19KB
plugin-detail (index.js) 245.43KB 62.46KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 133.32KB 32.69KB
plugin-gantt (index.js) 165.23KB 40.37KB
plugin-grid (index.js) 201.72KB 54.58KB
plugin-kanban (index.js) 53.14KB 14.64KB
plugin-list (index.js) 113.15KB 27.59KB
plugin-map (index.js) 20.20KB 6.66KB
plugin-markdown (index.js) 13.72KB 4.69KB
plugin-report (index.js) 43.51KB 11.94KB
plugin-timeline (index.js) 28.95KB 8.33KB
plugin-tree (index.js) 9.00KB 3.08KB
plugin-view (index.js) 85.83KB 21.11KB
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.66KB 3.50KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 76.75KB 25.49KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 3.11KB 1.48KB
react (schema-input.js) 2.32KB 1.24KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 5.41KB 2.34KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 4.93KB 2.24KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 20.57KB 5.88KB
sdui-parser (provenance.js) 3.66KB 1.82KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 10.35KB 3.60KB
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) 2.74KB 1.41KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 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-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 4.72KB 2.24KB
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 (spec-ui-namespace.js) 0.20KB 0.19KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

finding: CurrencyField overrides a host onBlur, dropping a declared DOM pass-through key

2 participants