expressive-charts 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -25,6 +25,52 @@ From 0.1.0:
25
25
 
26
26
  Everything else can still change in a minor release while the library is 0.x: the motion core (`motion`, `createMotion`, the clocks, `tween`, `animated`, `playback`, and the types the list doesn't name), the charts, the adapters, the built-in effects and the controls. Those changes are listed here too. [docs/effects-guide.md](https://github.com/Deaversbp/expressive-charts/blob/main/docs/effects-guide.md) is the guide to the author API.
27
27
 
28
+ ## 0.8.0 (2 November 2026)
29
+
30
+ Time zones by name on a line chart's date axis, and a word for a missing value; charts that measure their text again when it changes size, so spacing a viewer adds after load lays them out again; every bar recoloured at once on `update({ colors })`, and a line chart's decorations drawn below its points; a bar chart's labels fading as they thin, and its bars taking the room of the value labels it hides; and `link()` linking an x with every value missing. Nothing in the effect-author API changes. Every change is outside the promise, and none needs anything written instead.
31
+
32
+ ### Added
33
+
34
+ - **`timeZone` on `lineChart` takes a zone's name** as `Intl` knows it, such as `"Europe/London"`, beside `"UTC"` and `"local"`. Ticks fall on the zone's own midnights, months, years, hours and minutes through summer time, so a day can be 23 or 25 hours, and a midnight the clocks skip is the first time after it, as in local time. Page Up and Page Down go a calendar month in the zone. Names, the tooltip, the table and the announcements say times in it with no zone's name. The zone is read through `Intl.DateTimeFormat`, so no zone data ships. A name it won't take throws a `TypeError`, whose message now says a zone's name is allowed, and `update()` rejects it. `"UTC"` and `"local"` draw as before.
35
+ - **`missing` on `lineChart`:** the word for a missing value, in the table's cell, and after the series' label in the x's name, the tooltip and `markLabel`'s default text ("3: goals no data, 3.6 xg"). Default `"missing"`, so a chart without it reads as before, byte for byte. A string that's empty or only spaces, or anything that isn't a string, throws a `TypeError`, and `update()` rejects it. `update({ missing })` words them again. The bar and donut charts have no missing values, so they don't take it.
36
+
37
+ ### Changed
38
+
39
+ - **A line chart's decorations draw below its points.** The overlay where runs draw is above the lines, their end dots and end labels, and below the points, so nothing an effect draws covers a point being read: on the line page, week 12's hovered goals point shows above the red run. An end dot is part of its line, so a decoration still draws over it. Effects draw as before, and no other chart's overlay moves. In the `<svg>`, the points are in a second `.ec-marks` after the overlay, and `hover: "point"`'s stops come after the x's.
40
+ - **A bar chart's labels fade as an update thins them.** A category or value label the new layout leaves out fades out over the change's first half, and one it draws fades in over its second, as a chart switch fades its unmatched marks. Until now they switched on the change's first frame, and stood on each other while the bars passed. A label drawn on both sides is as before. With motion off, in Analysis, and on a resize or web fonts loading, they switch at once.
41
+ - **A bar chart whose value labels are all hidden lays its bars out longer.** When thinning hides every value label, the layout makes its frame again without their room: past a bar's tip, on the left with negative bars, above the columns and below negative ones. `room` and the ticks' half widths stay, and the names are thinned again on the new frame. A chart whose value labels show lays out as before, and a change between shown and hidden moves the frame as any change does.
42
+
43
+ ### Fixed
44
+
45
+ - **A chart measures its text again when the text changes size.** The bar, donut and line charts measured each text once, as they drew, and again only once web fonts loaded. So spacing a viewer adds after load (WCAG 1.4.12's), or a font or size set on the page, widened the text without a new layout: on Windows, a bar chart's names ran together. Now each chart keeps a hidden line of text, with no class, watched with a `ResizeObserver`. When its width changes, the chart measures again and lays out at once, as when fonts load: a bar chart thins its names again, and its margins fit its text. Until text changes size, every chart draws as before.
46
+ - **`update({ colors })` recolours every bar on the change's first frame.** A bar the change left in place kept its old colour until the change landed. With motion off, and with `colors` alone, it's at once, as before.
47
+ - **Overlays drawn in a stack's later part's colour follow it.** A path drawn in a part's colour (`Paint.part`), as `drawIn` draws a stack's, kept its old colour when a part other than the first changed colour: on our bar chart, and on `expressive()`'s marks when they're read again.
48
+ - **A time that comes twice where the clocks go back reads differently each time.** In local time, and in a zone by its name, each of the two says the zone's short name, as `Intl` words it in the page's locale ("Nov 1, 2026, 1:00 AM EDT" and "Nov 1, 2026, 1:00 AM EST" in `en-US`, "25 Oct 2026, 01:00 BST" and "25 Oct 2026, 01:00 GMT" in `en-GB`), in their names, the tooltip, the table and the announcements. Before, the two read the same. A name that says no time, and the ticks, still name no zone.
49
+ - **`link()` links a line chart's x with every value missing.** It has no point, so its hover told its link nothing, and linked charts ended theirs. Now the link reads a stand-in for a point there: keyed by the x, with the x's row and a sample at the x, whose `value` is `NaN`. So the default linking value and a `by` that reads the row both find it. Hovering or focusing the x hovers the linked charts' marks there, and their hover shows the line chart's crosshair at that x, with no tooltip, as no linked hover has one. No effect runs and no event fires on the line chart for it, as before, and an x with some values links by its points, as before.
50
+
51
+ ## 0.7.0 (1 November 2026)
52
+
53
+ A new effect, `drawIn`, that draws a mark in along its walk as it enters, a stack part by part, each in its own colour; `morph` pairing two lines by x, so their corners and gaps hold on every frame; a chart switch that draws a line's end dot and a point's ring, and keeps its tab stop on the week; and room above a line chart's plot. In the effect-author API, the one change is `part` on `Paint`, an addition. The other changes are outside the promise, and none needs anything written instead.
54
+
55
+ ### Added
56
+
57
+ - **`part` on `Paint`**, under the 0.x promise: the key of one of the mark's segments (`segment.key`). In that paint, `"mark"` and `"mark-strong"` are that segment's colours, so an effect can draw a stack part by part, each in its own colour. Unset, or a key the mark hasn't, they're the mark's own, its first segment's for a stack, as before. Our charts give each segment's colours: the bar chart's by series, and `expressive()`'s from each part's own fill or stroke. The testing entry's recording layer keeps it with the paint. It's an optional field, an addition: a paint without it draws as before.
58
+ - **`drawIn()`**, with `DrawInOptions`: a mark draws itself in along its walk as it enters (`on: { enter: drawIn() }`). Its body goes faint (`faint`, default 0.3), and the overlay draws it from its start to its end at its own width and colour over `duration` (750 ms base, effect timing). A line draws along its stroke, its gaps left out; a bar from its baseline to its tip; a slice round its ring; and a stack each segment in turn, in its own colour, each over its share of the time by its length. A point or a closed shape shows at once. It follows the mark as it grows or moves, and its end state is the mark as it is, so reduced motion shows it at once. Its labels stay as they are. It's for `enter`, not `hover`, where it would make the mark being read faint, and it isn't a preset.
59
+ - **`end` and `ring` on `ChartSwitchPaint`,** both optional. `end` is the radius of the dot a view's chart draws at the end of a mark's walk, and `ring` the width of the ring in `--ec-surface` it draws round the mark, or round that dot. The line chart's handle gives a line's end dot (4.5) and its ring, and a point drawn at rest its ring (2). A view whose paints have neither draws as before.
60
+ - **`moveTabStop(key)` on `ChartSwitchView`,** optional: it moves a chart's tab stop to the stop `focus(key)` would focus, without focus, so no ring shows and nothing hovers, and says whether it did. The bar, donut and line charts' handles have it. A view without it keeps its own tab stop after a switch, as before.
61
+ - **`room` on `lineChart` takes sides:** `{ right, top }`. `top` is px the layout keeps clear above the plot, below the chart's top, for text an effect draws above it, such as a `delta` past a line that ends near the top heading up. The plot is that much shorter, and its value labels and end labels move with it. A side that isn't given is 0, so a number is `{ right }` as before, and a number, `{}` and `{ right }` lay out as before. Anything but a number of px, 0 or more, or an object of them by side, throws a `RangeError`, and `update({ room })` lays the chart out again. `barChart`'s `room` stays a number.
62
+
63
+ ### Changed
64
+
65
+ - **`morph` pairs two lines by x.** Two lines whose vertices' x each go one way, the same way for both, as a line chart's do, morph by x: the point a share of the way across one line's x span moves to the point that share across the other's, so between two line charts of the same weeks each week moves straight up or down, whatever the plots' widths. They're sampled at `points` shares evenly across and at every vertex of both, up to 1,000 of each line's; of a denser line, the first, last, highest and lowest in each of 250 columns. Their middle frames change. Any other two lines, closed outlines and crossfades morph as before, byte for byte. Nothing to write instead.
66
+
67
+ ### Fixed
68
+
69
+ - **A chart switch draws a line's end dot.** It went on the first frame of a switch to or from a line view, and came back as it landed. Now it moves with its line from one end to the other between two line charts, and fades with its line into the columns.
70
+ - **A chart switch draws a point's ring,** the 2 px in the surface's colour round a value alone between gaps and round an end dot. It keeps it into another line chart, and loses it as the point grows into its column.
71
+ - **Tab after a toggle lands on the same week.** With focus outside a switch, on the toggle that started it, Tab went to the new view's own tab stop. Now the switch reads the old view's tab stop before anything hides, and moves the new view's to the first of the keys it stood for, as focus follows when it's in the view.
72
+ - **`morph` keeps a line's corners, and matches its gaps by x.** Between two lines that each run one way, the stroke next to the first and last frames is each line's own polyline: on the morph page's season card, with 160 points, goals' corners were cut by up to 10.9 px. And where both lines miss the same weeks, nothing is drawn on any frame: faint strokes reached up to 54 px across them, since gaps met by how far along each line they were. A page that gives `morph({ points })` more points for its corners can drop them.
73
+
28
74
  ## 0.6.0 (30 October 2026)
29
75
 
30
76
  Line charts in a chart switch, their points growing into columns, change text that keeps clear of other effects' text, with room for it on the line chart, and `morph` keeping a line's gaps and a shape's holes. `expressive()` reads more marks by tag (a turned `<rect>`, a pie's slices and a non-scaling stroke), and the hover on one point reaches a point drawn on another. In the effect-author API, the one change is `texts` on `EffectContext`, with its type, `TextSpace`, an addition. The other changes are outside the promise, and each says what to write instead, if anything.
package/README.md CHANGED
@@ -15,9 +15,9 @@ Composable motion and expressive effects for web charts. Hover, update and morph
15
15
 
16
16
  Each picture plays once and stops where its effect ends. **[The demo site](https://deaversbp.github.io/expressive-charts/)** has every effect to try, on the library's charts and on D3, Vega-Lite and hand-written ones, with the motion modes and reduced motion.
17
17
 
18
- > **Status: 0.6.0 (October 2026).** The effect-author API is under [the 0.x promise](#the-0x-promise); the charts, adapters, built-in effects and motion core can still change in a minor release. [CHANGELOG.md](https://github.com/Deaversbp/expressive-charts/blob/main/CHANGELOG.md#060-30-october-2026) lists what's new and what changed since 0.5.0.
18
+ > **Status: 0.8.0 (November 2026).** The effect-author API is under [the 0.x promise](#the-0x-promise); the charts, adapters, built-in effects and motion core can still change in a minor release. [CHANGELOG.md](https://github.com/Deaversbp/expressive-charts/blob/main/CHANGELOG.md#080-2-november-2026) lists what's new and what changed since 0.7.0.
19
19
 
20
- - **Effects first.** The mark effects `travel`, `flash`, `wiggle`, `pulse`, `trace` and the data effects `threshold`, `delta` and `label`, put together with `sequence`, `parallel`, `only` and `stagger`; and the transition effect `morph`, which `chartSwitch` plays to turn each mark of one chart into its mark in the next (a transition can't go into a combinator). An effect reads only a shared description of the mark, so one effect works on every chart, and effects of your own work everywhere the built-in ones do.
20
+ - **Effects first.** The mark effects `travel`, `flash`, `wiggle`, `pulse`, `trace`, `drawIn` and the data effects `threshold`, `delta` and `label`, put together with `sequence`, `parallel`, `only` and `stagger`; and the transition effect `morph`, which `chartSwitch` plays to turn each mark of one chart into its mark in the next (a transition can't go into a combinator). An effect reads only a shared description of the mark, so one effect works on every chart, and effects of your own work everywhere the built-in ones do.
21
21
  - **Charts and adapters.** Bar, donut and line charts, a switch that morphs one into another, adapters that bring the same effects to SVG marks drawn by other code, and hover linked across them.
22
22
  - **Motion that stays readable.** One clock and three modes: Presentation (staged, about a second), Analysis (at most about 200 ms) and Off. The device's reduced-motion setting is followed unless the viewer picks a mode on the page, and every effect has an end state, which is what reduced motion shows.
23
23
  - **Accessible.** Keyboard focus, a name for every mark, a data table, announcements and a pause control for anything that plays, checked against WCAG 2.2 AA.
@@ -28,13 +28,13 @@ Each picture plays once and stops where its effect ends. **[The demo site](https
28
28
  npm install expressive-charts
29
29
  ```
30
30
 
31
- It has no runtime dependencies. It's an ES module and CommonJS, each with its own types, and its JavaScript has no side effects, so a bundler keeps only what a page imports: a bar chart is about 31 KB gzipped, and everything 85 KB.
31
+ It has no runtime dependencies. It's an ES module and CommonJS, each with its own types, and its JavaScript has no side effects, so a bundler keeps only what a page imports: a bar chart is about 32 KB gzipped, and everything 88 KB.
32
32
 
33
33
  On a page with no bundler, the script-tag bundle defines one global, `ExpressiveCharts`, holding the main entry:
34
34
 
35
35
  ```html
36
36
  <div id="sales"></div>
37
- <script src="https://cdn.jsdelivr.net/npm/expressive-charts@0.6/dist/expressive-charts.global.js"></script>
37
+ <script src="https://cdn.jsdelivr.net/npm/expressive-charts@0.8/dist/expressive-charts.global.js"></script>
38
38
  <script>
39
39
  const { barChart } = ExpressiveCharts;
40
40
  barChart("#sales", {
@@ -124,11 +124,11 @@ playButton("#play", season, { labels: { play: "Play season" } });
124
124
 
125
125
  [docs/api.md](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md) documents every export, with its options, their defaults and what it returns.
126
126
 
127
- - **Charts.** [`barChart`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#barchart) draws bars or columns, plain or stacked; [`donutChart`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#donutchart) shares of a total; [`lineChart`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#linechart) a line per series, straight or, with `curve: "monotone"`, curved through every value without going past it, on a number axis or, when `x` gives `Date`s, a time axis in UTC (or `timeZone: "local"`) worded in the page's locale, with a gap wherever a value is `null` or `undefined`, hovering every series at an x with a crosshair or, with `hover: "point"`, the one point nearest the pointer, the other lines dimmed. Each sizes itself to its container, follows the light or dark theme, and has a tooltip, a legend, a data table and keyboard focus. Its handle has `update()`, which animates a change by the motion mode, and `update({ on })` swaps its effects in place; `focus(key)`; `leave()`, which ends its hover; and `labels()`. `table.series` heads a series' column in the data table.
128
- - **Switching.** [`chartSwitch`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#chartswitch) shows views of the same data one at a time, and turns each mark into its own mark in the next with [`morph()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#morph): a donut becoming columns, a line chart's points growing into columns keyed as they are, or one line chart's lines becoming another's, and back from wherever it is. Each mark keeps its view's colour, and focus follows the x. Its `on()`, `marks()` and `leave()` are the view on show's, and it can be linked like a chart.
127
+ - **Charts.** [`barChart`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#barchart) draws bars or columns, plain or stacked; [`donutChart`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#donutchart) shares of a total; [`lineChart`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#linechart) a line per series, straight or, with `curve: "monotone"`, curved through every value without going past it, on a number axis or, when `x` gives `Date`s, a time axis in UTC (or `timeZone: "local"`, or a zone's name such as `"Europe/London"`) worded in the page's locale, with a gap wherever a value is `null` or `undefined`, which its names, tooltip and table say is `missing` ("missing" by default), hovering every series at an x with a crosshair or, with `hover: "point"`, the one point nearest the pointer, the other lines dimmed. Each sizes itself to its container, follows the light or dark theme, and has a tooltip, a legend, a data table and keyboard focus. Its handle has `update()`, which animates a change by the motion mode, and `update({ on })` swaps its effects in place; `focus(key)`; `leave()`, which ends its hover; and `labels()`. `table.series` heads a series' column in the data table.
128
+ - **Switching.** [`chartSwitch`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#chartswitch) shows views of the same data one at a time, and turns each mark into its own mark in the next with [`morph()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#morph): a donut becoming columns, a line chart's points growing into columns keyed as they are, or one line chart's lines becoming another's, and back from wherever it is. Each mark keeps its view's colour, a line its end dot and a point its ring, and focus follows the x, or the tab stop does when focus is on a toggle. Its `on()`, `marks()` and `leave()` are the view on show's, and it can be linked like a chart.
129
129
  - **Adapters.** [`expressive()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#expressive) reads keys, rows and geometry from SVG marks drawn by D3, Observable Plot or by hand, with only a key: rects as bars, circles as points, a pie's or a donut's paths as slices, clockwise from 12 o'clock, and other paths, lines, polylines, polygons, ellipses and turned rects as shapes, through their transforms, a non-scaling stroke at its width on screen. It draws on an overlay, leaving the host's styling alone; `watch: true` follows the host's own transitions. A curve, or a line drawn with d3's `.defined()`, is read from its own path data, with its gaps, and no effect draws inside them; `geometry` describes anything else, or a mark as you'd rather have it. Observable Plot binds each rect or dot to its row's index, so pass `datum: (el) => rows[el.__data__]`; Plot draws a new `<svg>` each time, so pass `refresh()` the new one's marks. The Plot accessors are tested against Plot 0.6.17. [`fromVegaView()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#fromvegaview) does the same for a Vega or Vega-Lite View rendered as SVG, and follows its renders; a line breaks where Vega-Lite leaves out a missing value, and a curve is read from the path Vega draws. Both change their effects in place with `update({ on })`, as a chart does, and `leave()` ends their hover.
130
- - **Linked hover.** [`link()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#link) links hover across charts, chart switches and attachments by a value their marks share, such as a column's matchweek and the line's x there: hovering one hovers the others' marks with that value, with their emphasis, dimming and hover effects, as `source: "linked"`. Linked charts show no tooltip and take no focus.
131
- - **Effects.** [`travel`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#travel) carries an icon along a mark; [`flash`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#flash), [`wiggle`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#wiggle) and [`pulse`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#pulse) draw attention without changing a value; [`trace`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#trace) draws a highlighter stroke along a mark and leaves it there; [`threshold`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#threshold) colours the parts of a mark below or above a reference; [`delta`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#delta) labels a mark's change since the last update ("+2"), and [`label`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#label) any text worked out from its data, past the mark's own labels and clear of other effects' text. Each goes in an effect slot (`hover`, `enter`, `update`, `exit`, `decorate`), as an effect or a preset's name (`"wiggle"`).
130
+ - **Linked hover.** [`link()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#link) links hover across charts, chart switches and attachments by a value their marks share, such as a column's matchweek and the line's x there: hovering one hovers the others' marks with that value, with their emphasis, dimming and hover effects, as `source: "linked"`. Linked charts show no tooltip and take no focus. A line chart's x with every value missing links by its x, and a link's hover there shows the line's crosshair.
131
+ - **Effects.** [`travel`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#travel) carries an icon along a mark; [`flash`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#flash), [`wiggle`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#wiggle) and [`pulse`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#pulse) draw attention without changing a value; [`trace`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#trace) draws a highlighter stroke along a mark and leaves it there; [`drawIn`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#drawin) draws a mark in along its walk as it enters, a stack part by part in its colours; [`threshold`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#threshold) colours the parts of a mark below or above a reference; [`delta`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#delta) labels a mark's change since the last update ("+2"), and [`label`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#label) any text worked out from its data, past the mark's own labels and clear of other effects' text. Each goes in an effect slot (`hover`, `enter`, `update`, `exit`, `decorate`), as an effect or a preset's name (`"wiggle"`).
132
132
  - **Controls.** [`motionSwitch()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#motionswitch) is the viewer's own choice of mode. [`playback()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#playback) plays a value through a range, and [`playButton()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#playbutton) is its Play/Pause button.
133
133
  - **The motion core.** [`motion`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#motion), [`tween()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#tween) and [`animated()`](https://github.com/Deaversbp/expressive-charts/blob/main/docs/api.md#animated), for animations of your own that follow the same modes.
134
134
 
@@ -127,7 +127,8 @@ interface IconSource {
127
127
  /**
128
128
  * A theme token or any CSS colour. Tokens: "text", "text-muted", "surface", "grid", "axis", "focus",
129
129
  * "negative", "series-N" and "series-N-strong" (palette slots 1–8), and "mark" / "mark-strong", the
130
- * colours of the mark a run belongs to (its first segment's, for a stack).
130
+ * colours of the mark a run belongs to (its first segment's, for a stack, or in a paint with `part`,
131
+ * that segment's).
131
132
  */
132
133
  type Color = string;
133
134
  /**
@@ -141,6 +142,11 @@ interface Paint {
141
142
  readonly width?: number;
142
143
  readonly opacity?: number;
143
144
  readonly linecap?: "butt" | "round";
145
+ /**
146
+ * The key of one of the mark's segments (`segment.key`). In this paint, "mark" and "mark-strong"
147
+ * are that segment's colours. Unset, or a key the mark hasn't, they're the mark's own, as without it.
148
+ */
149
+ readonly part?: string;
144
150
  }
145
151
  interface MarkStyle {
146
152
  /** In chart space. Moves the mark's body; its labels and pointer target stay put. */
@@ -211,4 +217,4 @@ interface Layer {
211
217
  text(content: string, style: TextStyle): TextHandle;
212
218
  }
213
219
  export { Rect as _, MarkStyle as a, PathHandle as c, Icon as d, IconShape as f, Point as g, Outline as h, MarkHandle as i, TextHandle as l, MarkGeometry as m, IconHandle as n, Matrix as o, IconSource as p, Layer as r, Paint as s, Color as t, TextStyle as u };
214
- //# sourceMappingURL=drawing-Ypmq-2h6.d.ts.map
220
+ //# sourceMappingURL=drawing-OmQV-0BB.d.cts.map
@@ -127,7 +127,8 @@ interface IconSource {
127
127
  /**
128
128
  * A theme token or any CSS colour. Tokens: "text", "text-muted", "surface", "grid", "axis", "focus",
129
129
  * "negative", "series-N" and "series-N-strong" (palette slots 1–8), and "mark" / "mark-strong", the
130
- * colours of the mark a run belongs to (its first segment's, for a stack).
130
+ * colours of the mark a run belongs to (its first segment's, for a stack, or in a paint with `part`,
131
+ * that segment's).
131
132
  */
132
133
  type Color = string;
133
134
  /**
@@ -141,6 +142,11 @@ interface Paint {
141
142
  readonly width?: number;
142
143
  readonly opacity?: number;
143
144
  readonly linecap?: "butt" | "round";
145
+ /**
146
+ * The key of one of the mark's segments (`segment.key`). In this paint, "mark" and "mark-strong"
147
+ * are that segment's colours. Unset, or a key the mark hasn't, they're the mark's own, as without it.
148
+ */
149
+ readonly part?: string;
144
150
  }
145
151
  interface MarkStyle {
146
152
  /** In chart space. Moves the mark's body; its labels and pointer target stay put. */
@@ -211,4 +217,4 @@ interface Layer {
211
217
  text(content: string, style: TextStyle): TextHandle;
212
218
  }
213
219
  export { Rect as _, MarkStyle as a, PathHandle as c, Icon as d, IconShape as f, Point as g, Outline as h, MarkHandle as i, TextHandle as l, MarkGeometry as m, IconHandle as n, Matrix as o, IconSource as p, Layer as r, Paint as s, Color as t, TextStyle as u };
214
- //# sourceMappingURL=drawing-Ypmq-2h6.d.cts.map
220
+ //# sourceMappingURL=drawing-OmQV-0BB.d.ts.map
@@ -1,4 +1,4 @@
1
- import { _ as Rect, i as MarkHandle, m as MarkGeometry, p as IconSource, r as Layer, u as TextStyle } from "./drawing-Ypmq-2h6.cjs";
1
+ import { _ as Rect, i as MarkHandle, m as MarkGeometry, p as IconSource, r as Layer, u as TextStyle } from "./drawing-OmQV-0BB.cjs";
2
2
  /** Where frames come from. The default uses requestAnimationFrame, or a 16 ms timer outside the browser. */
3
3
  interface FrameSource {
4
4
  now(): number;
@@ -253,4 +253,4 @@ type Combined<E extends readonly AnyMarkEffect[]> = [Extract<E[number], {
253
253
  kind: "data";
254
254
  }>] extends [never] ? GeometryEffect : DataEffect<AllRowNeeds<E>>;
255
255
  export { scaleDuration as A, manualClock as B, ScalingRule as C, defaultScaling as D, createMotion as E, Clock as F, FrameSource as I, ManualClock as L, easeInOutCubic as M, easeOutCubic as N, mediaReducedMotion as O, linear as P, createClock as R, ScalingOverrides as S, Timing as T, Motion as _, GeometryEffect as a, MotionView as b, TransitionContext as c, Sample as d, MotionEnv as f, tween as g, TweenResult as h, EffectContext as i, Easing as j, motion as k, TransitionEffect as l, TweenOptions as m, Combined as n, MarkEffect as o, Tween as p, DataEffect as r, TextSpace as s, AnyMarkEffect as t, MarkData as u, MotionMode as v, ScalingTable as w, ReducedMotionSource as x, MotionOptions as y, defaultClock as z };
256
- //# sourceMappingURL=effect-D8W4ZmmG.d.cts.map
256
+ //# sourceMappingURL=effect-DYCLY_6e.d.cts.map
@@ -1,4 +1,4 @@
1
- import { _ as Rect, i as MarkHandle, m as MarkGeometry, p as IconSource, r as Layer, u as TextStyle } from "./drawing-Ypmq-2h6.js";
1
+ import { _ as Rect, i as MarkHandle, m as MarkGeometry, p as IconSource, r as Layer, u as TextStyle } from "./drawing-OmQV-0BB.js";
2
2
  /** Where frames come from. The default uses requestAnimationFrame, or a 16 ms timer outside the browser. */
3
3
  interface FrameSource {
4
4
  now(): number;
@@ -253,4 +253,4 @@ type Combined<E extends readonly AnyMarkEffect[]> = [Extract<E[number], {
253
253
  kind: "data";
254
254
  }>] extends [never] ? GeometryEffect : DataEffect<AllRowNeeds<E>>;
255
255
  export { scaleDuration as A, manualClock as B, ScalingRule as C, defaultScaling as D, createMotion as E, Clock as F, FrameSource as I, ManualClock as L, easeInOutCubic as M, easeOutCubic as N, mediaReducedMotion as O, linear as P, createClock as R, ScalingOverrides as S, Timing as T, Motion as _, GeometryEffect as a, MotionView as b, TransitionContext as c, Sample as d, MotionEnv as f, tween as g, TweenResult as h, EffectContext as i, Easing as j, motion as k, TransitionEffect as l, TweenOptions as m, Combined as n, MarkEffect as o, Tween as p, DataEffect as r, TextSpace as s, AnyMarkEffect as t, MarkData as u, MotionMode as v, ScalingTable as w, ReducedMotionSource as x, MotionOptions as y, defaultClock as z };
256
- //# sourceMappingURL=effect-DyzluQD1.d.ts.map
256
+ //# sourceMappingURL=effect-HCWnmB72.d.ts.map