Skip to content

fix(core): draw a null second-dimension group instead of orphaning its measure - #4681

Merged
yinlianghui merged 2 commits into
mainfrom
claude/issue-4673-null-second-dim-series
Aug 15, 2026
Merged

fix(core): draw a null second-dimension group instead of orphaning its measure#4681
yinlianghui merged 2 commits into
mainfrom
claude/issue-4673-null-second-dim-series

Conversation

@yinlianghui

Copy link
Copy Markdown
Collaborator

Fixes#4673

buildChartSeries' pivot branch kept the pre-#4466 answer on the second
dimension. It bucketed groups by String(row[groupKey] ?? '') behind a
gId !== '' gate, so a group whose second dimension is null, undefined or
'' never joined seriesKeys — while the line below the gate still wrote its
measure into the emitted row under the '' key. The number was in the data and
bound to no mark, which is #4466's harm verbatim one dimension over: the chart
understated its own data without saying so.

Measured, before the fix

The card's repro, run through the transform and then through the real renderer:

data: [{ status: 'Backlog', High: 5, '': 40 }]
series: [{ dataKey: 'High', label: 'High' }]
rects: 1

The 40 hours are in the row, accommodated by the y-axis scale, and painted on
nothing. Two such groups were worse than unbound: null and '' both key '',
so the later group silently overwrote the earlier one's measure and one of the
two numbers did not survive the transform at all (measured: series: [], zero
bars, for a fixture with both).

What changed

A known-empty group draws; an unprojected key still refuses. That is the
split the first dimension already used (#4466 versus hasNoCategoryKey,
framework#4033), now answering the same way on both dimensions. A row that does
not carry the group key at all gets no bucket and contributes no column, where
it previously wrote its measure under ''. null and '' are two different
groups with two series, following #4508's collision-1 ruling.

One place decides what a group is, what it says, and which column carries
it.
pivotSeriesBuckets returns { id, label, dataKey } per group and both
helpers go through it, so the writer and the reader cannot drift.

The series key is collision-safe, not merely unlikely to collide. Unlike an
axis bucket's private map key, a series key is a column of the emitted row and
the dataKey a renderer binds to, so it must be unique within that row. A group
keys its column by its own display label — leaving an ordinary pivot's rows,
series, legend, tooltip and drill title exactly as they were — unless that label
cannot name it:

Those key by identity instead, which no other group has. The third exclusion is
what makes the assignment injective rather than merely unlikely to collide: no
surviving label is any group's identity, so the two key spaces cannot meet. A
record whose stored group value literally spells [null] is a real value with a
real bar, and it keeps it.

Drill-through follows the same assignment. A clicked series key resolves back
to the group identity it names, and rows are matched on that.
String(r[gDim] ?? '') was the display-string matching #4508 removed on the
x-axis — it spelled a null group and an empty-string group alike, so the
empty-string group's segment resolved to the null group's records. This is the
card's premise C: extend the identity answer, do not re-widen the tolerance.

No renderer change was needed. The null group's series carries the same
nullCategoryLabel the renderers already pass for the first dimension, so the
existing plumbing (#4466 / #4497) covers it. The handleCartesianClick region
held by #4672 is untouched — see "Not addressed here" below.

The bounding sweep, named

Two keys beyond the card's own list are treated as reserved, because the
assignment's whole job is to be injective into the emitted row's key space and
that space already contains them:

Both are pinned by their own cases. Leaving a known hole in a function whose
entire purpose is collision-safety was the alternative.

Verification

Gate union run at a6a2282bb, which is this branch's head:

  • pnpm exec vitest run packages/core/ packages/plugin-charts/ packages/plugin-dashboard/
    171 files, 2497 tests, all passing.
  • pnpm --filter @object-ui/core --filter @object-ui/plugin-charts --filter @object-ui/plugin-dashboard --workspace-concurrency=2 run type-check
    — clean (scope confirmed non-empty: "3 of 47 workspace projects", each running
    a real tsc, with the dependency closure built first).
  • eslint --quiet on the three changed files — clean.
  • check-changeset-presence / check-changeset-no-major /
    check-changeset-fixed / check-control-bytes — all green.

Reverse verification, direction predicted before running

Writer ablated (the gId !== '' gate restored). Predicted red in the
buildChartSeries blocks and the DOM file, green in the reader-only drill
cases. Measured exactly that: 14 red / 50 green in core, and 3 red / 1 green at
the DOM. The drill cases that do not derive their key from the writer —
resolves the null group's segment to the null row, resolves the empty-string group to ITS row, never matches a row that lacks the second dimension key
stayed green, which is the honest statement that the reader half is
independently correct. Every first-dimension suite (#4466 / #4497 / #4508)
stayed green, confirming the change is confined to the second dimension.

Reader ablated (String(r[gDim] ?? '') === s restored). Predicted red in the
drill block only. Measured 7 red / 57 green — including expected 1 to be 2,
which is the wrong-row failure rather than a dead one: under display-string
matching the empty-string group's click resolves to the null group's row. The
ordinary-series drills and the #4497 / #4508 pivot drill suites stayed green.

The DOM leg ran against a rebuilt dist/ in both directions, and the mutation
was proved to have reached the artifact before each run (4 ablation markers
present when ablated, 0 after restore, so no mutated code stays live for later
runs).

Not addressed here


Generated by Claude Code

…s measure
`buildChartSeries`' pivot branch kept the pre-objectui#4466 answer on the
SECOND dimension: `String(row[groupKey] ?? '')` behind a `gId !== ''` gate, so a
null (or empty-string) group never joined `seriesKeys` — while the next line
still wrote its measure into the bucket under the `''` key. The number was in
the emitted row and bound to no mark, which is #4466's harm verbatim one
dimension over: the chart understated its own data without saying so. Two such
groups were worse than unbound — null and `''` both keyed `''`, so the later
one silently overwrote the earlier one's measure.
A known-empty group now DRAWS, exactly as on the first dimension, while an
unprojected key still refuses (framework#4033): a row that does not carry the
group key gets no bucket and contributes no column, where it used to write its
measure under `''`.
`pivotSeriesBuckets` is the one place that decides what a group IS, what it
SAYS and which column carries it, and both helpers go through it. A series key
is a row column and a renderer `dataKey`, not a private map key, so it must be
unique within the emitted row: a bucket keys by its own label, unless that
label is shared with another bucket (objectui#4508's collision 2, on this
axis), reserved by the row itself (`xKey`, `CHART_BUCKET_ID_KEY`), or equal to
some bucket's identity — then it keys by its identity, which no other bucket
has. That third exclusion is what makes the assignment injective rather than
merely unlikely to collide. An ordinary pivot's rows and series are unchanged,
so no encoded key reaches an authoring surface.
`findChartSeriesRow` resolves a clicked series key back through the same
assignment and matches on IDENTITY. `String(r[gDim] ?? '')` was the display
matching objectui#4508 removed on the x-axis for spelling a null group and an
empty-string group alike; premise C of the card is to extend that answer, not
re-widen the tolerance.
The empty-string group keys by `''`. That recharts binds a falsy `dataKey` is a
fact about recharts, so it is measured at the DOM rather than assumed.
Fixes#4673
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RnQd8iMMUwXQEV1crFmQiQ
@vercel

vercelBot commented Aug 15, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredAug 15, 2026 8:26am

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)24.7 KB350 KB
Entry fileindex-BZmTNE_G.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)9.56KB3.59KB
app-shell (runtime-config.js)7.42KB2.32KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)8.92KB3.41KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)25.13KB5.40KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)12.21KB3.45KB
auth (LoginForm.js)18.13KB5.39KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.64KB2.21KB
auth (SocialSignInButtons.js)9.60KB3.89KB
auth (UserMenu.js)3.40KB1.22KB
auth (auth-gate-events.js)1.29KB0.66KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)38.46KB10.17KB
auth (createAuthenticatedFetch.js)6.34KB2.43KB
auth (index.js)2.35KB1.07KB
auth (org-roles.js)6.66KB2.78KB
auth (phone-identifier.js)1.11KB0.66KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)5.02KB0.88KB
auth (useIsWorkspaceAdmin.js)1.61KB0.85KB
collaboration (CommentThread.js)26.07KB7.56KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)6.49KB2.64KB
collaboration (PresenceProvider.js)2.79KB1.13KB
collaboration (index.js)1.65KB0.73KB
collaboration (useCollaborationTranslation.js)6.05KB2.52KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)489.91KB108.67KB
core (index.js)3.79KB1.52KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)163.56KB44.83KB
fields (index.js)230.37KB57.17KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (i18n.js)4.32KB1.77KB
i18n (index.js)3.35KB1.38KB
i18n (pickLocalized.js)3.69KB1.73KB
i18n (provider.js)23.12KB7.62KB
i18n (useDisplayLocale.js)2.84KB1.45KB
i18n (useObjectLabel.js)27.59KB6.63KB
i18n (useSafeTranslation.js)7.77KB3.13KB
layout (index.js)38.98KB10.85KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.74KB
mobile (index.js)1.50KB0.62KB
mobile (offlineQueue.js)3.91KB1.35KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (serviceWorkerSource.js)3.41KB1.48KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)6.96KB1.98KB
mobile (useOfflineSync.js)1.99KB0.72KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)4.32KB1.64KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)8.75KB3.06KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.67KB1.12KB
permissions (evaluator.js)4.41KB1.44KB
permissions (index.js)0.91KB0.41KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)1.55KB0.71KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.86KB12.91KB
plugin-charts (index.js)62.32KB17.77KB
plugin-chatbot (index.js)181.21KB43.14KB
plugin-dashboard (index.js)121.87KB31.76KB
plugin-designer (index.js)212.39KB42.83KB
plugin-detail (index.js)239.93KB60.01KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)114.72KB27.70KB
plugin-gantt (index.js)164.30KB40.02KB
plugin-grid (index.js)190.02KB50.48KB
plugin-kanban (index.js)52.74KB14.53KB
plugin-list (index.js)111.82KB27.23KB
plugin-map (index.js)18.16KB5.81KB
plugin-markdown (index.js)13.72KB4.69KB
plugin-report (index.js)41.38KB11.09KB
plugin-timeline (index.js)26.68KB7.66KB
plugin-tree (index.js)8.50KB2.88KB
plugin-view (index.js)83.81KB20.49KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.90KB0.85KB
providers (UploadProvider.js)11.71KB3.53KB
providers (index.js)0.44KB0.22KB
providers (types.js)0.01KB0.04KB
react-runtime (index.js)5.67KB2.37KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)27.64KB9.44KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)1.26KB0.67KB
react (schema-input.js)1.45KB0.83KB
react (spec-input.js)0.20KB0.18KB
sdui-parser (codegen.js)4.09KB1.74KB
sdui-parser (index.js)4.47KB2.03KB
sdui-parser (parse.js)10.04KB2.82KB
sdui-parser (types.js)0.29KB0.24KB
sdui-parser (validate.js)4.69KB1.48KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (dashboard-filter-alias.js)6.23KB2.74KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)1.87KB0.85KB
types (disclosure.js)0.20KB0.18KB
types (error-code.js)1.54KB0.88KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (http-retry.js)4.32KB2.02KB
types (index.js)3.05KB1.52KB
types (layout.js)0.20KB0.18KB
types (managed-by.js)0.19KB0.18KB
types (mobile.js)2.59KB1.31KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (record-semantics.js)1.28KB0.67KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (spec-report.js)5.05KB1.93KB
types (system-fields.js)3.33KB1.54KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)3.40KB1.71KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.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 08:43
@yinlianghui
yinlianghui added this pull request to the merge queueAug 15, 2026
Merged via the queue into main with commit af025eeAug 15, 2026
21 checks passed
@yinlianghui
yinlianghui deleted the claude/issue-4673-null-second-dim-series branch August 15, 2026 08:44
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants

@yinlianghui@claude