Series options

The value labels of a bar series (T9): LabelOptions with the bar's four places. A label at 'inside-end' or 'inside-base' needs its length plus offset inside the bar along the value direction, and the label colour must read on the bar; otherwise fallback: 'auto' moves it outside (a stack segment's label is hidden instead) and 'hide' hides it. A stack segment's ends are its own, never the stack's: the stack's end carries stackTotal.

Where a bar's value label goes (CF1, T9). 'outside' (default) beyond the bar's value end; 'inside' centred in the bar; 'inside-end' inside, against its VALUE end; 'inside-base' inside, against its BASE (zero, or the segment's own base on a stack). The ends are semantic: a negative bar's value end is the end its value points to, and a reversed axis keeps the roles, wherever the pixels put them.

How wide a bar draws across its category (CF1). Read by bar, waterfall and range-bar series. Both fields are optional; without them Active sizes the bars itself (a deliberate column, never a slab: W-VQ-3).

Bars shrink, they never overflow: a bar draws maxWidth where its share of the category has room for it, and narrower where it has not, down to one pixel; no bar is dropped and none draws wider than its share. On a chart with several bar series the bars of one category form one group, sized as a whole and centred; the first bar series that declares a field decides it for the group.

Curve interpolation type for line/area series.

The labels of a mark with two ends (BC-LB1): a range bar, a range area or a dumbbell. Each end's label sits beyond that end, away from the other, whatever the axis direction, so a reversed axis never swaps their roles. The formatter's context names the end (role). Off by default.

Error bars of a series (T3): the uncertainty of each mark as two ABSOLUTE bounds read from the host's own columns, on the series' value axis. A symmetric source is the host's arithmetic (low = v − σ, high = v + σ).

• The whisker runs from the low to the high bound through the mark, with a cap at each drawn end, in the chart's neutral foreground ink (not the series colour): uncertainty never reads as another series. It follows its series' visibility and emphasis; it is no pointer or keyboard target of its own. There is no style option.
• Both bounds join the automatic value domain. An explicit min/max still wins: the whisker is then cut at the plot edge without a cap, and the text still states the true bound. A bound a log axis cannot show (at or below 0) is drawn the same way.
• The tooltip, the data table and the keyboard announcement read value (low–high); one bound alone is named as the lower or upper bound. CSV and copy-as-table carry the raw bound columns after the value. The legend is unchanged.
• A missing or non-finite bound draws the other side only; a low bound above the high bound draws no whisker (development diagnostic); a row without a value draws none.
• A series with error bars keeps every row: it is not reduced and it blocks time grouping (development diagnostic), because the bounds of an aggregate are not an aggregate of the bounds.

Visual styling overrides for hover highlight states.

• dimOpacity is the opacity this series steps back to while another item is addressed: it replaces the far context step for this series. Default: the far context step (0.64 light, 0.70 dark).
• brightness is reserved for future use (active-series brightness boost).

What a bin's height is (T9). By default its amount: the count, or the sum or mean of yKey. areaProportional: true draws, for a count or a sum, the amount per narrowest bin width (amount × narrowest width / bin width), so a bar's AREA is proportional to its amount where bins differ in width; equal bins draw exactly the same either way. Labels, the tooltip value and the announcement keep the amount; the tooltip adds the drawn rate "per {narrowest width}". A mean is not additive over a width, so it takes no areaProportional.

The one bin rule of a histogram (T9): a target binCount (default 10, round boundaries), a binWidth in x units (every bin that wide, on multiples of it; at most 1 000 bins, else the default applies with a development diagnostic), or explicit consecutive bins. Only one may be set; an untyped caller that sets several gets bins, then binWidth, then binCount, with a development diagnostic. Every bin includes its lower bound; the last also its upper bound.

Error bars of a scatter series (T3): the value-axis pair of ErrorBarOptions and, on a numeric x axis, an x pair (both keys or neither), which joins the x domain and the x reading of the tooltip, table and announcement.

A series' own motion: only what a series owns, its entrance and its exit. Update, tooltip, attention and replay are the chart's. false turns both off for this series; reduced motion always wins.

A series' own entrance: the chart's entrance with a delay of its own.

A series <Chart> renders: the thirteen Cartesian types, each drawn by its registered plug-in. A pie, donut or heatmap is a family of its own (<PieChart>, <HeatmapChart>); its options are not a <Chart> series.

The series types a <Chart> renders: exactly the type of every SeriesOptions member, each drawn by a series plug-in. A standalone family (pie, heatmap, treemap, …) or a scalar is a component of its own, never a <Chart> series, so it is no SeriesType.

What a stack total's formatter knows besides the number.

One total label per stack and category: the net sum of the stack's visible members, the number the shared tooltip names as the stack's total. It sits beyond the end of the side its sign points to (above a positive vertical stack, below a negative one), in the one label colour. It has one place: a total that would leave the plot, or collide with another total, is hidden, and its value stays in the tooltip, the data table and the announcement. A percentage stack has no total (it always makes 100 %).

Declared on a member of the stack; the first member (in series order) that declares it sets the stack's total. Present means on, unless enabled: false.