Skip to content

fix(plugin-dashboard): DatasetWidget localizes the null-bucket label (#4500) - #4509

Merged
yinlianghui merged 1 commit into
mainfrom
claude/issue-4500-datasetwidget-null-label
Aug 13, 2026
Merged

fix(plugin-dashboard): DatasetWidget localizes the null-bucket label (#4500)#4509
yinlianghui merged 1 commit into
mainfrom
claude/issue-4500-datasetwidget-null-label

Conversation

@yinlianghui

Copy link
Copy Markdown
Collaborator

Closes #4500

The gap

buildChartSeries (core) buckets a null-keyed category under options.nullCategoryLabel, falling back to the English constant NULL_CATEGORY_LABEL = '(None)' when the caller passes none. @object-ui/core is React-free and cannot read the locale bundle, so the resolved label has to come from the renderer. ObjectChart (plugin-charts) passes tt('chart.nullCategory', '(None)') and localizes; DatasetWidget called the same helper with no options at all, so a dashboard widget in a zh app labelled the bucket (None) while the standalone chart one panel over labelled it (未指定).

The failure is quiet by construction: the bar draws, the count is right, only the word is wrong.

The fix

Both call sites in DatasetWidget.tsx now read one binding:

  • buildChartSeries(chartRows, dimensions, values, state.fields, { nullCategoryLabel })
  • findChartSeriesRow(chartRows, dimensions, values, ev?.category, ev?.series, { nullCategoryLabel })

where nullCategoryLabel = tt('chart.nullCategory', '(None)'). tt was already in the component; the chart.nullCategory key already exists in all ten locale packs (PR #4498).

The second call site is the sharp edge, not a symmetry nicety. findChartSeriesRow is the inverse map behind segment-click drill-through: it compares the clicked category against its own nullCategoryLabel, defaulting to the same English floor. Localizing only the forward call draws a bar reading (未指定) while the drill matches (None) — the click resolves to -1, handleChartDrill returns before openDrill, and the drawer never opens. That is a strictly worse outcome than the untranslated label this card is about (the dead-click rule from #4498). One binding, so the pair cannot drift.

Grep confirms these are the only two call sites in the file, and the only two in plugin-dashboard.

Red-first

New pin: packages/plugin-dashboard/src/__tests__/DatasetWidget.nullCategoryI18n.test.tsx — 7 cases, 3 red before the change, 4 green on both sides.

Pre-fix, verbatim:

FAIL packages/plugin-dashboard/src/__tests__/DatasetWidget.nullCategoryI18n.test.tsx
  > labels the null group `(未指定)` under `zh`, not the English floor
AssertionError: expected [ 'Ada Lovelace', '(None)' ] to include '(未指定)'

  > keeps the measure attached to the (now translated) bucket
AssertionError: expected { 'Ada Lovelace': 5, '(None)': 3 } to match object { '(未指定)': 3 }

 Test Files  1 failed (1)
      Tests  3 failed | 4 passed (7)

Post-fix: Test Files 1 passed (1) / Tests 7 passed (7).

Reverse verification of the pair property. The interesting direction is not pre/post — it is the half-fix a reviewer would most plausibly ship. Applying only the forward argument and re-running isolates the dead click exactly:

 ✓ labels the null group `(未指定)` under `zh`, not the English floor
 ✓ keeps the measure attached to the (now translated) bucket
 × PAIR — a click on the localized bucket bar still drills to ITS row 1025ms
AssertionError: expected 0 to be greater than 0

 Tests  1 failed | 6 passed (7)

The labels go green and only the drill dies — drillFilters stays empty because the drawer never opened. Both call sites restored afterwards, verified byte-identical against the pre-revert patch.

Must-not-change (green on both sides)

  • the non-null group charts byte-identically: { owner_name: 'Ada Lovelace', deals: 5 }
  • a click on the non-null bar still drills by the stored id ({ owner_id: 'user-ada' }), not the display label
  • en still reads (None) — through the locale pack after the change rather than core's hardcoded floor, same bytes
  • a widget over data with no null group is untouched in either locale

Verification

Scope

DatasetWidget.tsx + one test file + one changeset. The multi-dimension pivot arm is #4497's in-flight surface and is deliberately untouched — this card is the single-dimension label argument, and core is consumed read-only. Branched from origin/main after confirming PR #4504 had landed (it is the tip commit).


Generated by Claude Code

…4500)

`buildChartSeries` buckets a null-keyed category under
`options.nullCategoryLabel` and falls back to the English constant
`NULL_CATEGORY_LABEL = '(None)'` when the caller passes none. Core is
React-free and cannot read the locale bundle, so the label has to come
from the renderer. ObjectChart passes its resolved label; DatasetWidget
called the same helper with no options, so a dashboard widget in a zh app
rendered `(None)` while the standalone chart rendered `(未指定)`.

Both call sites now read ONE binding: `buildChartSeries` writes the label
into the rendered rows and `findChartSeriesRow` matches a clicked category
against it. Localizing only the forward call would draw a bar reading
`(未指定)` while the drill matched `(None)` — the click resolves to -1 and
the drawer never opens, a worse outcome than the untranslated word.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Qqyix2QcnpUC9XeYVDzx3
@vercel

vercel Bot commented Aug 12, 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 12, 2026 10:40pm

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Main entry (gzip) 24.7 KB 350 KB
Entry file index-CWOZ1FAN.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) 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) 36.76KB 9.60KB
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) 489.32KB 108.45KB
core (index.js) 3.37KB 1.34KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 153.79KB 41.35KB
fields (index.js) 230.07KB 57.07KB
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.33KB 1.20KB
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) 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.75KB 3.80KB
plugin-calendar (index.js) 46.86KB 12.91KB
plugin-charts (index.js) 62.07KB 17.65KB
plugin-chatbot (index.js) 181.21KB 43.14KB
plugin-dashboard (index.js) 120.95KB 31.53KB
plugin-designer (index.js) 212.58KB 42.83KB
plugin-detail (index.js) 239.03KB 59.77KB
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) 188.13KB 50.00KB
plugin-kanban (index.js) 48.62KB 13.42KB
plugin-list (index.js) 111.07KB 27.08KB
plugin-map (index.js) 18.16KB 5.81KB
plugin-markdown (index.js) 13.72KB 4.69KB
plugin-report (index.js) 41.16KB 10.96KB
plugin-timeline (index.js) 26.21KB 7.52KB
plugin-tree (index.js) 8.50KB 2.88KB
plugin-view (index.js) 84.08KB 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.73KB 7.96KB
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 (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

Copy link
Copy Markdown
Collaborator Author

Independent re-verification (session handoff) + #4497 coordination

A host restart ended the authoring session after this PR was pushed but before its report landed. A second session inherited the branch at 0bbdf0028 and re-derived every claim in the description from scratch rather than trusting it. No code changed — the tree is byte-identical to what was pushed (sha256 checked after each revert/restore cycle), and no new commit was needed.

Red-first, re-derived. DatasetWidget.tsx reverted to origin/main with the new test kept (via git checkout origin/main -- path, never git stash):

FAIL ... > labels the null group `(未指定)` under `zh`, not the English floor
AssertionError: expected [ 'Ada Lovelace', '(None)' ] to include '(未指定)'

FAIL ... > keeps the measure attached to the (now translated) bucket
AssertionError: expected { 'Ada Lovelace': 5, '(None)': 3 } to match object { '(未指定)': 3 }

Tests  3 failed | 4 passed (7)

Restored: Tests 7 passed (7).

One nuance worth stating, because it is what makes the half-fix run load-bearing rather than decorative: under a full revert the PAIR case fails at its label precondition, not at the drill — it never reaches the click. So the full revert cannot by itself prove the drill half is needed. Applying only the forward argument isolates it exactly:

✓ labels the null group `(未指定)` under `zh`, not the English floor
✓ keeps the measure attached to the (now translated) bucket
× PAIR — a click on the localized bucket bar still drills to ITS row
AssertionError: expected 0 to be greater than 0

Tests  1 failed | 6 passed (7)

The labels go green and only the drill dies — drillFilters stays empty because the drawer never opened. That is the dead-click, reproduced.

#4497 / PR #4506 — no collision, and a positive interaction. The two PRs are file-disjoint: #4506 touches core/chart-series.ts, its test, and a plugin-charts test; this one touches only plugin-dashboard. Verified against core as it stands here, buildChartSeries' pivot arm does not bucket nulls at all, so the option this PR passes is currently inert on that arm — which is why the single-dimension scope is honest. The interaction when #4506 lands is favourable rather than conflicting: because both call sites already read one binding, DatasetWidget's pivot arm inherits the localized bucket label for free and correctly paired, with no follow-up edit. No gating needed in either direction.

Gates re-run locally (all green): pnpm exec vitest run packages/plugin-dashboard/47 files, 388 tests passed (the #4487 flake did not fire); type-check clean; eslint 0 errors; check:control-bytes, check:changeset-fixed, check:changeset-no-major green. check:i18n-call-site-keys is the one worth quoting, since this card adds a tt() call site — it confirms the key resolves and the inline default matches the pack:

Every in-scope call-site key resolves against the en pack (2881 keys), every literal inline defaultValue matches the value the pack serves

.d.ts re-diffed both ways (built from this branch, then from origin/main): index.d.ts and DatasetWidget.d.ts identicalpatch grading stands.

CI converged green: all 20 check runs completed, zero failures — Lint, Type Check, all four test shards, Control Byte Scan and all three changeset gates. Staying draft for PM review.


Generated by Claude Code


Generated by Claude Code

@yinlianghui
yinlianghui marked this pull request as ready for review August 13, 2026 00:12
@yinlianghui
yinlianghui added this pull request to the merge queue Aug 13, 2026
Merged via the queue into main with commit 54d34d2 Aug 13, 2026
21 checks passed
@yinlianghui
yinlianghui deleted the claude/issue-4500-datasetwidget-null-label branch August 13, 2026 00:12
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.

DatasetWidget renders the English '(None)' null-bucket floor in a zh app — one argument short of localized

2 participants