A report's embedded chart never buckets a NULL category — the #4466 family fix lives in `buildChartSeries`, which the report path does not call

[yinlianghui]

Summary

DatasetReportChart builds its chart rows as relabelDimensions(state.rows, dimensionLabels) and forwards them straight to the chart component. Nothing on that path buckets a null dimension value, so a report chart hands the renderer a null category — the exact input #4466 measured as drawing no mark at all.

The dashboard and chart-view surfaces do not have this problem because they route through buildChartSeries (packages/core/src/utils/chart-series.ts), whose bucketNullCategories limb is where #4466 / #4497 / #4673 / #4500 were all fixed. The report chart calls none of it.

Found while implementing #4020 on the same forwarding line; out of that card's scope, so filed here.

Measured

A dataset-bound report chart over rows containing a null group, capturing the props handed to the registered chart component:

data = [{"owner":null,"n":51},{"owner":"Dev Admin","n":2}]

The null reaches the renderer verbatim. On the dashboard path the same rows arrive as the bucket label ((None), localized per #4500) and draw a bar.

Why it matters

#4466 recorded that the cost is not an empty chart but a quietly wrong one: the dominant group vanishes while the y-axis scale still accommodates it, so the chart reads as valid data. A report chart is the surface most likely to be exported or read in a background tab, where there is no second view to cross-check against.

The report renderer is also missing the collision-safe bucketing that came with #4508 (a stored value literally spelling the bucket label) and the (None) localization of #4500 — those are properties of the shared helper, so they arrive together if the path is unified rather than re-implemented.

Suggested direction

Route the report chart's rows through buildChartSeries rather than passing state.rows through, so the whole null-category family is inherited instead of re-derived. Two things to check first, which is why this is not a one-liner:

1. buildChartSeries also DERIVES the series (one per measure, with fields[].label). The report chart plots exactly one measure and, since Report charts render the raw dataset measure name as the axis title, ignoring the measure's label — the same measure on a dashboard chart resolves correctly #4020, resolves its display name through a three-level fallback that outranks the plain fields[].label pick. The authored chart.series[].label override must survive the switch.
2. The null bucket label must come from the i18n bundle at the call site (@object-ui/core is React-free — see the nullCategoryLabel option and DatasetWidget renders the English '(None)' null-bucket floor in a zh app — one argument short of localized #4500), otherwise a zh console gains an English (None).

Related

• A NULL-keyed group is dropped from a bar chart, leaving an axis with no marks and no empty state — the default first-boot state of System Overview's "Events by User" #4466 / A NULL first-dimension value is still dropped by the multi-dimension pivot branch of buildChartSeries (the sibling of #4466) #4497 / buildChartSeries' pivot branch silently drops a null SECOND-dimension group: its measure is written to the bucket but never becomes a series, so the value vanishes from the chart #4673 — the null-category family, all fixed inside buildChartSeries.
• The chart null-category bucket has two identity collisions: it merges a null group with an empty-string group, and collides with a stored value spelling the label #4508 — bucket identity collisions, same helper.
• DatasetWidget renders the English '(None)' null-bucket floor in a zh app — one argument short of localized #4500 — the localized null-bucket label, same helper.
• A report's embedded chart drops every authored chart chrome key — showLegend: false still draws a legend, colors / showDataLabels are inert #4877 — the sibling gap on the same forwarding line (authored chart chrome dropped).
• Report charts render the raw dataset measure name as the axis title, ignoring the measure's label — the same measure on a dashboard chart resolves correctly #4020 — the measure display name, fixed on this line.

[os-zhuang]

Triage: lands in packages/plugin-report/src/DatasetReportRenderer.tsx (route the report chart's rows through buildChartSeries in packages/core/src/utils/chart-series.ts) ⇒ pm:queue, type Bug — the null-category family (#4466/#4497/#4673/#4500/#4508) is already ruled and fixed in the shared helper; this surface just never adopted it, so no new decision is owed.

⚠️ Same-file serial constraint with #4877: both cards land on the same forwarding line in DatasetReportRenderer.tsx. Do not dispatch concurrently — whichever goes second must re-read the merged state. The two cards' preserved constraints from the body are load-bearing: the #4020 three-level display-name fallback must outrank fields[].label, and the null-bucket label must come from the i18n bundle at the call site (@object-ui/core is React-free).

Size/model suggestion: M, opus.

---

Generated by Claude Code

[yinlianghui]

认领(objectui 车道分片 PM,会话 session_01GTRjn8xBqp75dk7kFupVRt,批次 16)。

与 #4877 合单派发给同一 dev(遵分诊的同文件串行约束):分支 claude/issue-4877-4878-report-chart,一个 PR 同时 Fixes 两卡,changeset 与验收证据按卡分开。卡面两条承重约束原样带入派发词:#4020 三级显示名回落必须压过 fields[].label;null 桶标签在调用侧走 i18n bundle(@object-ui/core 无 React)。

---

Generated by Claude Code