Repository navigation
TLDR
We have better maps now! and layouts are getting more robust!! :)
Details
Maps
- Boundaries: maps draw customizable boundaries (
chartProperties.boundaries): a named set, or a file of your own. - Framing: a map frames the country, region or continent its rows cover (
fit), in a projection centred on it. - Globes:
projection: "orthographic"turns to face the data and hides the far side; drag to turn it. - Choropleth classes: five quantile classes by default;
classestakesequal,jenksorcontinuous. - Map styles:
mapStylenames a ground (atlas,dark,muted, …) or restates its colours ({ sea, land, coast, border }). - US counties:
level: "auto"draws states, then counties as you zoom in. - Routes:
orderjoins points into routes, each leg bowed with an arrowhead whose tip sits on its stop;strokeWidthsets each leg's width. A route draws a dot at its start; every stop takes a dot wheresize,shape,textor a quantity'scolorasks for one, laid beneath the lines. - Route density: arrowheads are sized to their lines, and a map crowded with long legs draws them thinner. Short legs keep a small head; where many legs arrive at one stop, their heads fan round it and only the widest twelve keep one.
- Labels:
textnames a map's points beside them and a choropleth's regions at their middles. A crowded map names its most salient points first (the largest, or the ends of the colour scale), leaving the rest to their tooltips. - Updates on maps: overlays and region notes are placed by longitude and latitude, and follow a pan, a zoom or a turning globe.
Layout
- A Vega-Lite chart given a
canvasSizeis drawn within it: the house's chrome, the headline, keys and labels are measured first, and the plot takes the room left. - ECharts, Chart.js and Plotly lay out their frame by the same rules: headlines broken to full lines, long names wrapped, keys and axis titles measured. Plotly draws the house's header and source line.
- A distribution's value axis (boxplot, violin, density, ridgeline, ECDF) fits its data instead of reaching to zero.
- A bar split only by
detailreads as one bar: no seams between its segments, and its label shows the bar's total.
Annotations
- A note (
annotate-text) is a caption beside what it names, with a leader only where it stands off. The bordered card is gone; draw a callout box withset-overlay. - A spec carries its own
updates(notes, overlays, emphasis, viewport), so a copied spec keeps them. set-annotationis deprecated: writeannotate-text.
MCP
- Chart guides:
list_chart_typeswithchartTypereturns that type in full: what it is for, its guidance, itschartPropertiesand interaction presets. - App skill:
get_flint_skillservesapp(flint-app-author) for code that usesflint-chartin an app, a notebook or a script. - Board colours: a board's
colorsbinds colours to values per field, so a value keeps one colour on every chart and across turns. - Clearer reports:
showlists what must be fixed before a chart draws apart from what it draws with.
Performance
Faster compiles on large data, from Shayne Boyer (Shayne Boyer (@spboyer), #160). Each change keeps its output identical and ships with the script that measured it.
- Long category lists in a stated order. Trimming an overflowing category axis to an explicit order no longer scans the order once per value: at 10,000 categories it takes 6 ms instead of 119 ms in JS, and 2 ms instead of 421 ms in Python (#167).
- Sort repair does only the work it needs. A chart whose sort needs no lookup of the raw fields no longer walks every row and field (100k rows × 10 fields: about 21 ms to under 0.01 ms); a sort that does look fields up collects them once (about 21 ms to 6.5 ms, with a third of the memory) (#168).
- Python: dates convert with less memory. Temporal columns are inferred one at a time, cutting peak memory by 90% on a wide numeric table (10k rows × 20 columns) and 16% on a mixed one, at the same speed (#169).
- Python: one full semantics pass fewer. Only the encodings' preliminary types are resolved before overrides are composed; a 10k-row scatter assembles about 20% faster (152 ms to 121 ms), with identical output across all 705 fixtures (#170).
- Render baselines.
npm run benchmark:renderrecords cold and warm compile and MCP render times and memory per backend, so later changes can be compared against a baseline (#171).
Fixes
Reading data
- ISO timestamps are read as dates. Dates that arrive as timestamps (
"2005-05-01T00:00:00.000","…Z","2005-05-01 00:00:00", as a databaseDATEcolumn often serialises) are read as dates underYear,YearMonth,Dateand the other calendar types. A midnight timestamp becomes its date, so the axis prints short labels (Jun · Jul · Aug) instead of full timestamps. Marks sit on their date in every time zone (a Pacific machine used to draw them 7 hours late), and a time of day without a zone is labelled at the hour it says. - Percentages stored as fractions print as percentages. A
Percentagefield holding 0.164 prints16.4%, not0.164, without needing anintrinsicDomain. Numberis not added up. A field typedNumberhas unknown additivity, so it is no longer summed or stacked by default: a bar's label or share takes the encoding'saggregate, else the mean. Type totals asCount,Amount,QuantityorProfit; an untyped numeric field still sums.- One-letter units keep their case. A unit of
Mis millions, not metres. - A percentage's scale can be stated. The new
percentScaleannotation ("fraction"or"percent") settles how a percentage is stored instead of guessing from the values. Before, a growth rate stored as 2.4 (for 240%) printed as "2.4%", and the same column could be formatted two ways depending on which rows a query returned. Axes, tooltips, domains and KPI cards all follow it (#154).
Layout and sizing
- A chart stays inside its
canvasSize. A Vega-Lite chart that read well only when drawn larger than its box (a key beside a full-width plot, a title over a full-height one) used to overflow and get cut off by hosts that draw the SVG at its own size. It is now laid out again for the smaller room: the plot gives up space so keys, labels and title fit. The plot keeps at least half of each side, and no value is cut or label turned to make room.canvasFit: 'off'keeps the old drawing. - No more few-pixel overrun. The canvas fit reserved 8 px of padding where Vega-Lite pads by 5, so a chart sized to its box ran slightly over it.
- Value labels past horizontal bars extend the axis. The room kept for labels at bar ends now runs the axis, ticks and gridlines on to the plot's edge, instead of leaving an empty stretch with no scale. Bars keep their lengths.
- Stepped colour keys fit beside short plots. A binned colour key next to the plot no longer runs past it: Vega-Lite drew the ramp at its 200 px default, twice the height of a short heatmap.
- Bars sorted by value stay sorted under every house. With
sortBy: "x", the NYT, Economist, Power BI, Pop and De Stijl houses drew bars in name order, because their value labels and row names sit on the same band and Vega-Lite drops a sort the layers don't share. Datawrapper's names-above-bars layout failed to compile in 1.0.1. Every layer now states the same order. - A chart with no theme draws on the host's background.
options.backgroundand thebackgroundtaken by the React view, the interactive renderer andrenderSvgnow reach the chart, where Vega-Lite's default white used to win. A theme with its own canvas keeps it.
Keys and labels
- Compact numbers roll over. A value that rounds up to the next unit prints in it: 999,600 is
1M, not1000k(#172). - Size keys print the values they list. A size key for 0.5, 1 and 2.5 used to read "1, 1, 3". Each key now carries a format precise enough for its values, and its width is measured from those labels. Plotly and ECharts size keys no longer round small values to 0.
- Colour keys beside short plots keep round labels. A continuous colour key shortened to fit a short plot printed only its two raw ends (
−53,901,43,635); it now prints round values.
Heatmaps
- Cells along a time axis tile. Each date covers the period it repeats at, read from the values (dates, timestamps or epoch milliseconds): its month, quarter or year whatever day it falls on (month ends, the 5th, quarter ends); a day, week or hour where the step is exact; or until the next date where the dates are about one step apart (13 or 14 days). Dates 13 or 14 days apart, or at month ends, used to draw as one-day slivers. A missing period stays an empty gap.
- A whole run of months is a time scale too, with time-axis labels, instead of one band per month.
- No internal field in the axis title. A heatmap on a time axis titled it
Date, __cell_x_end. - Dates on a bar chart about 45 days apart now read as a run of time and stand on a time scale; eight or fewer dates are still one band each.
Interactions and updates
- Filters work on aggregated charts.
filterControlson a chart with anaggregateencoding (average, count, sum) or several y fields used to empty the plot, because filtered rows were swapped in raw. They are now shaped the way the chart's own rows were. - No internal sort index in tooltips. A tooltip on a filtered stacked chart no longer lists Vega-Lite's
_<field>_sort_index. - Updates that validated now draw. Four kinds of update that
validateChartaccepted were silently dropped when drawn: a numeric key on a field drawn as categories ({ Year: 2016 }on a banded year), a single-row series on a line chart (now drawn as a point a note can point at), a region caption asked to sit where it doesn't fit (now placed where it fits), and overlays withstrokeDash: 'dash'or'dot'. An overlay the renderer can't read no longer stops the chart's other updates. - Line dots are drawn once. In the live view, a line chart under a house with its own vertex dots (
cartoon,pop) drew a second, full-size set beneath them. - Live legends keep their order and colours. An unsorted colour (
sort: null) kept the static chart's order but turned alphabetical when drawn live, recolouring every series; a faint ink's darker edge also landed on the wrong series. - Tooltips and hover read in the house's type. A tooltip is set in the house's label face (11–13 px); a hovered line vertex shows as a dot a little wider than the line.
- Notes attach to points on a line. A note keyed to an interior point of a line drawn with points matched both the point and the segment starting there, and reported "matched nothing".
Annotations
- Captions keep off the chart's furniture. A note's, region's or enclosure's caption no longer lands on the source line, a map's credit, or a house's header and rules; and on a map it no longer treats land and water as marks to avoid.
- Enclosures at the plot's edge are drawn whole. Where an enclosed dot sits within 12 px of a continuous axis's end, the axis is padded so the outline isn't cut.
- Enclosures take the cluster's colour. An outline round a cluster of dots uses the dots' fill, not the outline a house draws round every dot (every cluster came out black under
pop).
Themes
- An area's edge takes its ink. A single series inked on the mark drew Vega-Lite's default blue edge.
- Extended houses keep readable type. A theme that
extendsa house and recolours its text or page takes the house's typography with it, and colours that would no longer read on the new page are adjusted. A dark page extendingnytno longer sets its title in near-black.
Installing
npm install flint-chartis the whole install (#155). An app no longer fails to build for want of a backend it doesn't use:flint-chartnow depends on every backend it draws with. For single-file bundles, newflint-chart/react/<backend>andflint-chart/interactive/<backend>entries carry just one library.
New Contributors
- Jack (@jaxor24) made their first contribution in #138
- Max (@onmax) made their first contribution in #147
Full Changelog: 1.0...1.1