Architect layer
Design
The name, addresses, meta and appearance of this project. Saved settings are read at runtime — a change shows on the next page load, with no rebuild.
Blocks
Every block this project can build a page from, drawn by the real renderer. Grouped by what the block is for.
A block is the unit a page is made of. A page here is not a laid-out file — it is a LIST OF BLOCKS. The renderers are already compiled; the page says which kinds stand on it, in what order and with what text. That is why every page in the project looks like one product rather than like the work of five different people.
Two series stacked over a time series, with a range picker in the header. Take it when the question is HOW A TOTAL MOVED and what it was made of — the stack answers both at once. Not for shares of a whole at one moment: that is a pie. Data is optional; without it the view draws the sample, so the catalogue never shows an empty card.
Bars over a time series with a switch in the header: two totals, one series drawn at a time. Take it when values are compared point by point and the exact height matters. Two series as bars over ninety days turn into noise — that is why the source switches instead of stacking.
A line over a time series with the same header switch as the bars. Take it when the SHAPE of the movement matters — growth, dips, seasonality — rather than the height of a single value. Points are hidden on purpose: ninety-one dots read as a dotted line, not as a curve.
A whole split into parts at ONE moment, with the share labels sitting on the sectors. Take it when the question is what the total is made of. Never for movement over time: a pie has no time axis, and two pies side by side are read as one picture, not as change.
Several measures at once, each on its own axis around a circle, with two series laid over each other. Take it when the shape of a profile matters — where a thing is strong and where it sags — rather than exact values. Six axes is the ceiling: beyond it the labels collide.
The same shares as a pie, but each one gets its own track: the bar is read against the track, so the absolute size shows as well as the ratio. Labels sit on the bars themselves and survive any palette, because they blend by luminosity.
A short stack of bars whose point is the TOOLTIP: no indicator, no cursor highlight, and it is open from the first frame rather than waiting for a hover. Take it to show what a tooltip looks like, or on a page read from a phone, where hovering does not exist.