Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

feat(quill-charts): add a stacked bar list and build bar list on it (#121877)

Sam Pennington4e329ec599e3
diff --git a/packages/quill/packages/charts/AGENTS.md b/packages/quill/packages/charts/AGENTS.md
index 668e4c3888a5..71c28ee1156f 100644
--- a/packages/quill/packages/charts/AGENTS.md
+++ b/packages/quill/packages/charts/AGENTS.md
@@ -18,6 +18,7 @@ This file is the map. Prop-level semantics live in the JSDoc on the config and p
| `PieChart` | Part of whole, one value per series; `innerRadiusRatio` for a donut |
| `ProportionBar` | Part of whole as one flat 100% bar with no axes, legend rows show `share · value`; takes the same `series` as `PieChart` |
| `BarList` | Ranked rows of label, bar on a neutral track, and value; takes the same `series` as `PieChart`, one row per series |
+| `StackedBarList` | `BarList` rows where each bar stacks several series, with your own label and value cells; takes `labels` and `series` like `BarChart` |
| `ScatterChart` | Two continuous numeric axes — one marker per `{ x, y }` point; takes `points`, not `labels` |
| `BoxPlot` | Distribution summaries — `{ min, p25, median, mean, p75, max }` per label |
| `Heatmap` | 2D density grid (latency over time) — `xLabels` × `yLabels`, `cells[row][col]` |
diff --git a/packages/quill/packages/charts/src/charts/BarChart/utils/draw-bar-chart.ts b/packages/quill/packages/charts/src/charts/BarChart/utils/draw-bar-chart.ts
index 8f0a7b68b576..75e019542d68 100644
--- a/packages/quill/packages/charts/src/charts/BarChart/utils/draw-bar-chart.ts
+++ b/packages/quill/packages/charts/src/charts/BarChart/utils/draw-bar-chart.ts
@@ -189,8 +189,13 @@ export function drawBarChartStatic(
if (start == null) {
return []
}
+ const ceilings = coloredSeries
+ .filter((s) => !s.visibility?.excluded)
+ .map((s) => s.trackData?.[dataIndex])
+ .filter((ceiling): ceiling is number => ceiling != null && isFinite(d3Scales.value(ceiling)))
+ const farEnd = ceilings.length > 0 ? d3Scales.value(Math.max(...ceilings)) : axisEnd
const band = { x: start, y: start, width: bandwidth, height: bandwidth, corners: ALL_CORNERS, dataIndex }
- return [computeBarTrackRect(band, axisStart, axisEnd, isHorizontal)]
+ return [computeBarTrackRect(band, axisStart, farEnd, isHorizontal)]
})
drawSolidBarTracks(ctx, tracks, theme.gridColor ?? SOLID_TRACK_FALLBACK_COLOR, barCornerRadius)
}
diff --git a/packages/quill/packages/charts/src/charts/BarList/BarList.tsx b/packages/quill/packages/charts/src/charts/BarList/BarList.tsx
index 06f9c0bd9c4e..4c6c46fae0f5 100644
--- a/packages/quill/packages/charts/src/charts/BarList/BarList.tsx
+++ b/packages/quill/packages/charts/src/charts/BarList/BarList.tsx
@@ -1,16 +1,13 @@
-/* eslint-disable react/forbid-dom-props -- row sizes and positions come from props */
import React, { useMemo } from 'react'
import { ChartErrorBoundary } from '../../core/ChartErrorBoundary'
-import type { BarChartConfig, ChartTheme, Series, TooltipContext } from '../../core/types'
-import { percentage } from '../../utils/format'
-import { BarChart } from '../BarChart/BarChart'
+import type { ChartTheme, Series, TooltipContext } from '../../core/types'
import { partValue } from '../ProportionBar/proportion-bar-data'
+import { BarListLabel } from './BarListLabel'
+import { BarListValue } from './BarListValue'
+import { StackedBarList, type StackedBarListConfig } from './StackedBarList'
-export interface BarListConfig {
- /** `start` (default) puts the label left of the bar and the value right of it. `top` puts the
- * label and the value on one line above the bar, so the bar and a long label get the full width. */
- labelPosition?: 'start' | 'top'
+export interface BarListConfig extends Omit<StackedBarListConfig, 'valueDomain' | 'tooltip'> {
/** `max` (default) fills the track with the largest row, to compare the rows with each other.
* `total` makes the track the whole, so each bar shows its share of `total`. */
scale?: 'max' | 'total'
@@ -18,12 +15,6 @@ export interface BarListConfig {
* `share · value`. Default `value`. With `labelPosition: 'start'`, a list narrower than 28rem
* shows only the share for `both`, and the tooltip still shows the value. */
valueDisplay?: 'value' | 'percent' | 'both'
- /** Row height in px, label line included. Default 28, or 40 with `labelPosition: 'top'`. */
- rowHeight?: number
- /** Bar thickness in px. Default 12, or 8 with `labelPosition: 'top'`. */
- barHeight?: number
- /** Corner radius in px for the bar and its track. Default 4. */
- barCornerRadius?: number
tooltip?: {
enabled?: boolean
}
@@ -51,12 +42,6 @@ export interface BarListProps<Meta = unknown> {
onError?: (error: Error, info: React.ErrorInfo) => void
}
-const DEFAULT_ROW_HEIGHT = { start: 28, top: 40 }
-const DEFAULT_BAR_HEIGHT = { start: 12, top: 8 }
-const TOP_LABEL_LINE_HEIGHT = 16
-const TOP_LABEL_GAP = 4
-const DEFAULT_CORNER_RADIUS = 4
-const MIN_BAR_SIZE = 4
const BAR_SERIES_KEY = 'bar-list'
export function BarList<Meta = unknown>({ onError, ...rest }: BarListProps<Meta>): React.ReactElement {
@@ -71,10 +56,6 @@ function defaultValueFormatter(value: number): string {
return value.toLocaleString()
}
-function formatShare(fraction: number): string {
- return fraction > 0 && fraction < 0.001 ? '<0.1%' : percentage(fraction, 1)
-}
-
function BarListInner<Meta = unknown>({
series,
theme,
@@ -86,16 +67,7 @@ function BarListInner<Meta = unknown>({
dataAttr,
onError,
}: BarListProps<Meta>): React.ReactElement | null {
- const labelPosition = config?.labelPosition ?? 'start'
- const {
- scale = 'max',
- valueDisplay = 'value',
- rowHeight = DEFAULT_ROW_HEIGHT[labelPosition],
- barHeight = DEFAULT_BAR_HEIGHT[labelPosition],
- barCornerRadius = DEFAULT_CORNER_RADIUS,
- tooltip: tooltipConfig,
- } = config ?? {}
- const isTop = labelPosition === 'top'
+ const { scale = 'max', valueDisplay = 'value', labelPosition = 'start' } = config ?? {}
const rows = useMemo(
() =>
@@ -123,37 +95,29 @@ function BarListInner<Meta = unknown>({
[rows]
)
- const barOffsetInRow = (rowHeight - barHeight) / 2
- const plotTop = isTop ? Math.max(0, TOP_LABEL_LINE_HEIGHT + TOP_LABEL_GAP - barOffsetInRow) : 0
-
- const barConfig = useMemo<BarChartConfig>(
+ const stackedConfig = useMemo<StackedBarListConfig>(
() => ({
- barLayout: 'stacked',
- axisOrientation: 'horizontal',
- hideXAxis: true,
- hideYAxis: true,
- showGrid: false,
- showAxisLines: false,
- showTickMarks: false,
- showCrosshair: false,
- margins: { top: plotTop, right: 0, bottom: 0, left: 0 },
- barCornerRadius,
- bars: {
- track: 'solid',
- bandPadding: Math.max(0, 1 - barHeight / rowHeight),
- minBandSize: 0,
- minBarSize: MIN_BAR_SIZE,
- roundStackEnds: true,
- valueDomain: { min: 0, max: domainMax > 0 ? domainMax : 1 },
- },
+ labelPosition,
+ rowHeight: config?.rowHeight,
+ barHeight: config?.barHeight,
+ barCornerRadius: config?.barCornerRadius,
+ valueDomain: { min: 0, max: domainMax > 0 ? domainMax : 1 },
tooltip: {
- enabled: tooltipConfig?.enabled !== false,
- hitArea: 'band',
+ enabled: config?.tooltip?.enabled,
valueFormatter,
labelFormatter: (key) => rows.find((row) => row.series.key === key)?.series.label ?? key,
},
}),
- [barCornerRadius, barHeight, rowHeight, plotTop, domainMax, tooltipConfig?.enabled, valueFormatter, rows]
+ [
+ labelPosition,
+ config?.rowHeight,
+ config?.barHeight,
+ config?.barCornerRadius,
+ config?.tooltip?.enabled,
+ domainMax,
+ valueFormatter,
+ rows,
+ ]
)
if (rows.length === 0) {
@@ -161,56 +125,24 @@ function BarListInner<Meta = unknown>({
}
return (
- <div
- className={isTop ? 'relative min-w-0 text-xs' : '@container grid min-w-0 items-center gap-x-3 text-xs'}
- style={
- isTop
- ? { height: plotTop + rows.length * rowHeight }
- : {
- gridTemplateColumns: 'fit-content(min(40%, 12rem)) minmax(0, 1fr) auto',
- gridTemplateRows: `repeat(${rows.length}, ${rowHeight}px)`,
- }
- }
- >
- <div
- className={
- isTop ? 'absolute inset-0 flex flex-col' : 'col-start-2 row-start-1 flex flex-col self-stretch'
- }
- style={isTop ? undefined : { gridRowEnd: `span ${rows.length}` }}
- >
- <BarChart
- series={barSeries}
- labels={labels}
- theme={theme}
- config={barConfig}
- tooltip={tooltip}
- dataAttr={dataAttr}
- onError={onError}
+ <StackedBarList
+ labels={labels}
+ series={barSeries}
+ theme={theme}
+ config={stackedConfig}
+ renderLabel={(rowIndex) => <BarListLabel series={rows[rowIndex].series} renderLabel={renderLabel} />}
+ renderValue={(rowIndex) => (
+ <BarListValue
+ value={rows[rowIndex].value}
+ whole={whole}
+ valueDisplay={valueDisplay}
+ labelPosition={labelPosition}
+ valueFormatter={valueFormatter}
/>
- </div>
- {rows.map((row, i) => (
- <div
- key={row.series.key}
- className={isTop ? 'absolute inset-x-0 flex h-4 items-center justify-between gap-2' : 'contents'}
- style={
- isTop
- ? { top: plotTop + i * rowHeight + barOffsetInRow - TOP_LABEL_GAP - TOP_LABEL_LINE_HEIGHT }
- : undefined
- }
- >
- <div className="flex min-w-0 items-center gap-1.5" title={row.series.label}>
- {renderLabel ? renderLabel(row.series) : <span className="truncate">{row.series.label}</span>}
- </div>
- <div className="shrink-0 whitespace-nowrap text-right text-(--color-graph-axis-label) tabular-nums">
- {valueDisplay === 'value'
- ? valueFormatter(row.value)
- : formatShare(whole > 0 ? row.value / whole : 0)}
- {valueDisplay === 'both' ? (
- <span className={isTop ? undefined : '@max-md:hidden'}> · {valueFormatter(row.value)}</span>
- ) : null}
- </div>
- </div>
- ))}
- </div>
+ )}
+ tooltip={tooltip}
+ dataAttr={dataAttr}
+ onError={onError}
+ />
)
}
diff --git a/packages/quill/packages/charts/src/charts/BarList/BarListLabel.tsx b/packages/quill/packages/charts/src/charts/BarList/BarListLabel.tsx
new file mode 100644
index 000000000000..c6949cca9260
--- /dev/null
+++ b/packages/quill/packages/charts/src/charts/BarList/BarListLabel.tsx
@@ -0,0 +1,16 @@
+import React from 'react'
+
+import type { Series } from '../../core/types'
+
+export interface BarListLabelProps<Meta> {
+ series: Series<Meta>
+ renderLabel?: (series: Series<Meta>) => React.ReactNode
+}
+
+export function BarListLabel<Meta>({ series, renderLabel }: BarListLabelProps<Meta>): React.ReactElement {
+ return (
+ <span className="flex min-w-0 items-center gap-1.5" title={series.label}>
+ {renderLabel ? renderLabel(series) : <span className="truncate">{series.label}</span>}
+ </span>
+ )
+}
diff --git a/packages/quill/packages/charts/src/charts/BarList/BarListValue.tsx b/packages/quill/packages/charts/src/charts/BarList/BarListValue.tsx
new file mode 100644
index 000000000000..ac0671bbd880
--- /dev/null
+++ b/packages/quill/packages/charts/src/charts/BarList/BarListValue.tsx
@@ -0,0 +1,36 @@
+import React from 'react'
+
+import { percentage } from '../../utils/format'
+import type { BarListConfig } from './BarList'
+
+export interface BarListValueProps {
+ value: number
+ whole: number
+ valueDisplay: NonNullable<BarListConfig['valueDisplay']>
+ labelPosition: NonNullable<BarListConfig['labelPosition']>
+ valueFormatter: (value: number) => string
+}
+
+function formatShare(fraction: number): string {
+ return fraction > 0 && fraction < 0.001 ? '<0.1%' : percentage(fraction, 1)
+}
+
+export function BarListValue({
+ value,
+ whole,
+ valueDisplay,
+ labelPosition,
+ valueFormatter,
+}: BarListValueProps): React.ReactElement {
+ return (
+ <>
+ {valueDisplay === 'value' ? valueFormatter(value) : formatShare(whole > 0 ? value / whole : 0)}
+ {valueDisplay === 'both' ? (
+ <span className={labelPosition === 'start' ? '@max-md:hidden' : undefined}>
+ {' '}
+ · {valueFormatter(value)}
+ </span>
+ ) : null}
+ </>
+ )
+}
diff --git a/packages/quill/packages/charts/src/charts/BarList/StackedBarList.tsx b/packages/quill/packages/charts/src/charts/BarList/StackedBarList.tsx
new file mode 100644
index 000000000000..769f58f5d362
--- /dev/null
+++ b/packages/quill/packages/charts/src/charts/BarList/StackedBarList.tsx
@@ -0,0 +1,198 @@
+/* eslint-disable react/forbid-dom-props -- row sizes and positions come from props */
+import React, { useMemo } from 'react'
+
+import { ChartErrorBoundary } from '../../core/ChartErrorBoundary'
+import type {
+ BarChartConfig,
+ ChartTheme,
+ PointClickData,
+ Series,
+ TooltipConfig,
+ TooltipContext,
+ ValueDomain,
+} from '../../core/types'
+import { BarChart } from '../BarChart/BarChart'
+
+export interface StackedBarListConfig {
+ /** `start` (default) puts the label left of the bar. `top` puts the label and value on a line above it. */
+ labelPosition?: 'start' | 'top'
+ /** Row height in px, label line included. Default 28, or 40 with `labelPosition: 'top'`. */
+ rowHeight?: number
+ /** Bar thickness in px. Default 12, or 8 with `labelPosition: 'top'`. */
+ barHeight?: number
+ /** Corner radius in px for the bar and its track. Default 4. */
+ barCornerRadius?: number
+ /** Value-axis domain. Defaults to 0 up to the largest row total. */
+ valueDomain?: ValueDomain
+ tooltip?: Pick<TooltipConfig, 'enabled' | 'valueFormatter' | 'labelFormatter'>
+}
+
+export interface StackedBarListProps<Meta = unknown> {
+ /** One row per label. Labels must be unique. */
+ labels: string[]
+ /** Stacked segments: `data[i]` is the value in row `i`, and `trackData[i]` caps that row's track. */
+ series: Series<Meta>[]
+ theme: ChartTheme
+ config?: StackedBarListConfig
+ /** Wrap long text in a `truncate` element. */
+ renderLabel: (rowIndex: number) => React.ReactNode
+ renderValue: (rowIndex: number) => React.ReactNode
+ tooltip?: (ctx: TooltipContext<Meta>) => React.ReactNode
+ onPointClick?: (data: PointClickData<Meta>) => void
+ dataAttr?: string
+ onError?: (error: Error, info: React.ErrorInfo) => void
+}
+
+const DEFAULT_ROW_HEIGHT = { start: 28, top: 40 }
+const DEFAULT_BAR_HEIGHT = { start: 12, top: 8 }
+const DEFAULT_CORNER_RADIUS = 4
+// Keeps a tiny row visible as a nub.
+const MIN_BAR_SIZE = 4
+// Matches the label line's `h-4` class.
+const TOP_LABEL_LINE_HEIGHT = 16
+const TOP_LABEL_GAP = 4
+
+export function StackedBarList<Meta = unknown>({ onError, ...rest }: StackedBarListProps<Meta>): React.ReactElement {
+ return (
+ <ChartErrorBoundary onError={onError}>
+ <StackedBarListInner {...rest} onError={onError} />
+ </ChartErrorBoundary>
+ )
+}
+
+function StackedBarListInner<Meta = unknown>({
+ labels,
+ series,
+ theme,
+ config,
+ renderLabel,
+ renderValue,
+ tooltip,
+ onPointClick,
+ dataAttr,
+ onError,
+}: StackedBarListProps<Meta>): React.ReactElement {
+ const labelPosition = config?.labelPosition ?? 'start'
+ const {
+ rowHeight = DEFAULT_ROW_HEIGHT[labelPosition],
+ barHeight = DEFAULT_BAR_HEIGHT[labelPosition],
+ barCornerRadius = DEFAULT_CORNER_RADIUS,
+ valueDomain,
+ tooltip: tooltipConfig,
+ } = config ?? {}
+
+ const resolvedValueDomain = useMemo<ValueDomain>(() => {
+ if (valueDomain) {
+ return valueDomain
+ }
+ const rowTotals = labels.map((_, row) =>
+ series.reduce((acc, s) => (s.visibility?.excluded ? acc : acc + Math.max(0, s.data[row] || 0)), 0)
+ )
+ const max = Math.max(0, ...rowTotals)
+ return { min: 0, max: max > 0 ? max : 1 }
+ }, [valueDomain, labels, series])
+
+ const barOffsetInRow = (rowHeight - barHeight) / 2
+ // Moves the plot down when the first row's label does not fit above its bar.
+ const plotTop = labelPosition === 'top' ? Math.max(0, TOP_LABEL_LINE_HEIGHT + TOP_LABEL_GAP - barOffsetInRow) : 0
+
+ // Stacked, because grouped insets each bar in its band and `barHeight` would no longer be exact.
+ const barConfig = useMemo<BarChartConfig>(
+ () => ({
+ barLayout: 'stacked',
+ axisOrientation: 'horizontal',
+ hideXAxis: true,
+ hideYAxis: true,
+ showGrid: false,
+ showAxisLines: false,
+ showTickMarks: false,
+ showCrosshair: false,
+ margins: { top: plotTop, right: 0, bottom: 0, left: 0 },
+ barCornerRadius,
+ bars: {
+ track: 'solid',
+ // Makes each band `rowHeight` tall so it lines up with its label and value cells.
+ bandPadding: Math.max(0, 1 - barHeight / rowHeight),
+ minBandSize: 0,
+ minBarSize: MIN_BAR_SIZE,
+ roundStackEnds: true,
+ valueDomain: resolvedValueDomain,
+ },
+ // Shows the tooltip over the track too, not only over the bar.
+ tooltip: { ...tooltipConfig, enabled: tooltipConfig?.enabled !== false, hitArea: 'band' },
+ }),
+ [barCornerRadius, barHeight, rowHeight, plotTop, resolvedValueDomain, tooltipConfig]
+ )
+
+ const chart =
+ labels.length > 0 ? (
+ <BarChart
+ series={series}
+ labels={labels}
+ theme={theme}
+ config={barConfig}
+ tooltip={tooltip}
+ onPointClick={onPointClick}
+ dataAttr={dataAttr}
+ onError={onError}
+ />
+ ) : null
+
+ if (labelPosition === 'top') {
+ return (
+ <div className="relative min-w-0 text-xs" style={{ height: plotTop + labels.length * rowHeight }}>
+ <div className="absolute inset-0 flex flex-col">{chart}</div>
+ {labels.map((label, i) => (
+ <div
+ key={label}
+ className="absolute inset-x-0 flex h-4 items-center justify-between gap-2"
+ style={{
+ top: plotTop + i * rowHeight + barOffsetInRow - TOP_LABEL_GAP - TOP_LABEL_LINE_HEIGHT,
+ }}
+ >
+ <div className="flex min-w-0 items-center gap-1.5">{renderLabel(i)}</div>
+ <div
+ className="shrink-0 whitespace-nowrap text-(--color-graph-axis-label) tabular-nums"
+ translate="no"
+ >
+ {renderValue(i)}
+ </div>
+ </div>
+ ))}
+ </div>
+ )
+ }
+
+ return (
+ <div
+ className="@container grid min-w-0 items-center gap-x-3 text-xs"
+ style={{
+ gridTemplateColumns: 'fit-content(min(40%, 12rem)) minmax(0, 1fr) auto',
+ gridTemplateRows: `repeat(${labels.length}, ${rowHeight}px)`,
+ }}
+ >
+ {labels.map((label, i) => (
+ <React.Fragment key={label}>
+ <div className="flex min-w-0 items-center gap-1.5 col-start-1" style={{ gridRow: i + 1 }}>
+ {renderLabel(i)}
+ </div>
+ <div
+ className="col-start-3 whitespace-nowrap text-right text-(--color-graph-axis-label) tabular-nums"
+ style={{ gridRow: i + 1 }}
+ translate="no"
+ >
+ {renderValue(i)}
+ </div>
+ </React.Fragment>
+ ))}
+ {chart ? (
+ <div
+ className="col-start-2 row-start-1 flex flex-col self-stretch"
+ style={{ gridRowEnd: `span ${labels.length}` }}
+ >
+ {chart}
+ </div>
+ ) : null}
+ </div>
+ )
+}
diff --git a/packages/quill/packages/charts/src/core/types.ts b/packages/quill/packages/charts/src/core/types.ts
index 0812d50f2c0c..9f470bb7e05e 100644
--- a/packages/quill/packages/charts/src/core/types.ts
+++ b/packages/quill/packages/charts/src/core/types.ts
@@ -62,8 +62,9 @@ export interface Series<Meta = unknown> {
/** Bar charts only: per-bar ceiling (in value-axis units) of the bar's interactive extent. The
* region beyond the ceiling is a blank, fully inert gap — no hover, tooltip, highlight, or
* click (`onPointClick` passes through). On grouped charts with `bars.track`, the hatched
- * "share of a whole" track also fills only up to `trackData[i]` instead of the whole axis; on
- * stacked charts no track is drawn — the ceiling only bounds interactivity. Used by funnel
+ * "share of a whole" track also fills only up to `trackData[i]` instead of the whole axis. With
+ * `bars.track: 'solid'`, the band's track stops at its largest ceiling. On stacked charts
+ * without a solid track, the ceiling only bounds interactivity. Used by funnel
* compare to show a shorter period's volume gap as empty space rather than drop-off. Omit (or
* leave an entry undefined) for the default full-axis extent. */
trackData?: number[]
@@ -443,7 +444,8 @@ export interface BarsConfig {
* highlights the track region on hover; pass `{ hover: false }` to draw the track
* but leave it inert (no highlight when the cursor is over the empty remainder).
* `'solid'` draws one neutral track per band instead, in `theme.gridColor`, behind every bar
- * in the band. It works on every layout, ignores `trackData`, and has no hover highlight. */
+ * in the band. It works on every layout, stops at the largest `trackData` ceiling in the band,
+ * and has no hover highlight. */
track?: boolean | 'solid' | { hover?: boolean }
/** Drop shadow under each bar so it reads as layered over a `track`. */
shadow?: boolean | { color: string; blur: number; offsetX?: number; offsetY?: number }
diff --git a/packages/quill/packages/charts/src/docs/bars.md b/packages/quill/packages/charts/src/docs/bars.md
index c95fbae250fb..9b649520f39f 100644
--- a/packages/quill/packages/charts/src/docs/bars.md
+++ b/packages/quill/packages/charts/src/docs/bars.md
@@ -39,7 +39,7 @@ The default `'always'` floors the static layer too.
`bars.track: 'solid'` draws one neutral track per band, in `theme.gridColor`, behind every bar in the band, on any layout.
It is the "remainder of the whole" backdrop for horizontal bar lists, as in `BarList`.
-Unlike the hatched track it ignores `trackData` and has no hover highlight.
+It stops at the largest `trackData` ceiling in the band, and unlike the hatched track it has no hover highlight.
## Interactive extent: `trackData`
diff --git a/packages/quill/packages/charts/src/docs/chart-types.md b/packages/quill/packages/charts/src/docs/chart-types.md
index d90d40ae1777..9c1e334598d1 100644
--- a/packages/quill/packages/charts/src/docs/chart-types.md
+++ b/packages/quill/packages/charts/src/docs/chart-types.md
@@ -79,7 +79,9 @@ It takes the same `series` as `PieChart` and sizes each part the same way as a p
## BarList
Ranked rows: a label, a bar on a neutral track, and a value, one row per series.
-It is a preset over a one-series stacked `BarChart` with `axisOrientation: 'horizontal'` and `bars.track: 'solid'`.
+It is a preset over `StackedBarList` with one series and a color per bar.
+`StackedBarList` is a stacked `BarChart` with `axisOrientation: 'horizontal'` and `bars.track: 'solid'`, laid out in label, bar and value columns.
+Use `StackedBarList` directly when a row stacks several segments, such as a funnel step split by breakdown: it takes `labels` and `series` like `BarChart`, plus `renderLabel(rowIndex)` and `renderValue(rowIndex)` for the cells, `onPointClick`, and `config.valueDomain`.
- It takes the same `series` as `PieChart` and values a row the same way, as the sum of its data floored at 0. Rows keep the order of `series`, so sort them first.
- `config.scale: 'max'` (default) fills the track with the largest row. `'total'` makes the track the whole, so a bar shows its share.
diff --git a/packages/quill/packages/charts/src/index.ts b/packages/quill/packages/charts/src/index.ts
index 6c7767972c28..0dd13b918f08 100644
--- a/packages/quill/packages/charts/src/index.ts
+++ b/packages/quill/packages/charts/src/index.ts
@@ -121,6 +121,8 @@ export type { ProportionBarConfig, ProportionBarProps } from './charts/Proportio
// Bar list
export { BarList } from './charts/BarList/BarList'
export type { BarListConfig, BarListProps } from './charts/BarList/BarList'
+export { StackedBarList } from './charts/BarList/StackedBarList'
+export type { StackedBarListConfig, StackedBarListProps } from './charts/BarList/StackedBarList'
// Sankey
export { SankeyChart } from './charts/SankeyChart/SankeyChart'