@howells/hairline 0.0.0-stage → 0.2.0

package/lib/types/charts/forms/circle-pack.data.d.ts

@@ -0,0 +1,23 @@
+/**
+ * O9 Towers by county: church towers with a ring of bells hung for full-circle
+ * ringing, by country and county.
+ * Source: Dove's Guide for Church Bell Ringers (Central Council of Church Bell
+ * Ringers), https://dove.cccbr.org.uk/downloads (CC BY-SA 4.0; changes made:
+ * counted and trimmed, below).
+ * Fetched 2026-10-15.
+ * File: dove.csv (one row per full-circle or lightweight ring). Transform:
+ * rows with RingType "Full-circle ring" only; the distinct TowerID values
+ * counted for each Country and County. Three countries are shown: England
+ * (the six counties with most towers, of 49 with any; 6,656 towers in all),
+ * Wales (the four with most, of 22; 228 in all) and Australia (the four with
+ * most, of 8; 70 in all). Each cut falls where the next county has fewer
+ * towers than the last one kept.
+ */
+/** A node in the hierarchy: a country with counties, or a county with its tower count. */
+export interface OrgNode {
+    children?: OrgNode[];
+    name: string;
+    value?: number;
+}
+/** Towers with a full-circle ring in the largest counties of England, Wales and Australia. */
+export declare const orgDemo: OrgNode;

package/lib/types/charts/forms/hatched-stack.d.ts

@@ -0,0 +1,10 @@
+import type { ShareTable } from "./hatched-stack.data.js";
+/**
+ * O10 Land by nation. Part-to-whole bars told apart by four engraving
+ * families at four greys, not by colour: dense upright rules, a halftone
+ * screen, crosshatch and sparse level rules. The largest share, England's
+ * farmland, is the one segment in ink.
+ */
+export declare const HatchedStack: (props: {
+    data?: ShareTable;
+}) => import("react").JSX.Element;

package/lib/types/charts/forms/hatched-stack.data.d.ts

@@ -0,0 +1,36 @@
+/**
+ * O10 Land by nation: how the land of each UK nation is covered.
+ * Source: UK Centre for Ecology and Hydrology, Land Cover Map 2021 (LCM2021),
+ * Marston et al. 2023, Earth System Science Data 15, 4631-4649 (CC BY 4.0),
+ * Table 5, https://essd.copernicus.org/articles/15/4631/2023/essd-15-4631-2023.pdf
+ * Fetched 2026-10-15.
+ * Transform: Table 5 gives the area in km2 of 21 classes for the UK and each
+ * nation. Farmland is arable (3) plus improved grassland (4); Woodland is
+ * broadleaved (1) plus coniferous (2); Built is urban (20) plus suburban
+ * (21); Other is the remaining 15 classes (semi-natural grassland, heather,
+ * bog, fen, rock, water and the coast). Each share is the group's area over
+ * the sum of the 21 classes (which differs from the printed total by 0 to 5
+ * km2 of rounding), to one decimal, the four rounded by largest remainder so
+ * each row sums to 100.0.
+ */
+/**
+ * The engraving that marks a kind of land, one of four families: upright
+ * rules, a halftone dot screen, crosshatch, and level rules.
+ */
+export type WorkTexture = "cross" | "dots" | "level" | "upright";
+/** One kind of land, and the engraving that marks it. */
+export interface WorkKind {
+    name: string;
+    texture: WorkTexture;
+}
+/** One nation's land, as percentage shares in `kinds` order. */
+export interface TeamShares {
+    shares: number[];
+    team: string;
+}
+export interface ShareTable {
+    kinds: WorkKind[];
+    rows: TeamShares[];
+}
+/** How the land of each UK nation is covered, in percent of its area. */
+export declare const timeSharesDemo: ShareTable;

package/lib/types/charts/forms/radial-year.d.ts

@@ -0,0 +1,8 @@
+import type { MonthValue } from "./radial-year.data.js";
+/**
+ * O7 Year in the round. Twelve months as one closed, hatched shape under
+ * evenly dotted rings; the peak month is the single ink mark, with its value.
+ */
+export declare const RadialYear: (props: {
+    data?: MonthValue[];
+}) => import("react").JSX.Element;

package/lib/types/charts/forms/radial-year.data.d.ts

@@ -0,0 +1,17 @@
+/**
+ * O7 A year by month: the mean of O8's daily maxima for each month of 2022.
+ * Source: Met Office Hadley Centre Central England Temperature (HadCET),
+ * v2.1.1.0 + provisional, https://www.metoffice.gov.uk/hadobs/hadcet/data/download.html
+ * Fetched 2026-10-15.
+ * File: maxtemp_daily_totals.txt, as reduced in brushed-overview.data.ts.
+ * Transform: each month's mean of its daily maximum values (31 days, or 30,
+ * or 28), rounded to 0.1 °C.
+ */
+/** One month's mean daily maximum temperature, in °C. */
+export interface MonthValue {
+    /** The month's first day. */
+    date: Date;
+    value: number;
+}
+/** Central England mean daily maximum by month, 2022 (°C). */
+export declare const signupMonthsDemo: MonthValue[];

package/lib/types/charts/frame.d.ts

@@ -0,0 +1,21 @@
+import type { ReactNode } from "react";
+export interface FrameProps {
+    /** The chart. */
+    children: ReactNode;
+    /** A line under the chart for what the plot cannot say: a caveat, a date. */
+    footnote?: ReactNode;
+    /** The chart's name, above it and the figure's accessible name. */
+    name: string;
+    /** What the (i) opens: one sentence on what the numbers are. Without it there is no (i). */
+    note?: ReactNode;
+    /** Where the data comes from, under the chart. */
+    source?: ReactNode;
+}
+/**
+ * The house frame, for hosts that want it: the chart's name and (i) above, the
+ * chart centred in the room left, and a source line and footnote under it.
+ * Charts draw only the plot, so a host that sets its own type can compose
+ * these itself; this is the gallery's cell, made available. The note opens in
+ * a native popover, so it needs no script.
+ */
+export declare const Frame: (props: FrameProps) => import("react").JSX.Element;

package/lib/types/charts/glance/aggregate-sankey.d.ts

@@ -0,0 +1,23 @@
+import type { NoteProps } from "../../schema/options.js";
+import type { AggregateSankeyData } from "./aggregate-sankey.data.js";
+interface AggregateSankeyProps extends NoteProps {
+    data?: AggregateSankeyData;
+    height?: number;
+    format?: (v: number) => string;
+    /** Unit noun for the tooltip, e.g. "MPs". */
+    unit?: string;
+    /** Source label to keep in the hero colour. */
+    highlight?: string;
+}
+/**
+ * G22 Free vote. Two columns: sources on the left, destinations on
+ * the right; ribbon width = amount. Each source's ribbons are engraved in
+ * its own grain on paper (hatches leaning alternately, then stipple and
+ * rules), keyed by its node bar; the biggest source (or the highlight) is
+ * the one ink node and its ribbons are crosshatched and laid on top. A
+ * crossing ribbon covers the one beneath, so screens never mix into moiré.
+ * Target totals sit inline with their names. Hover a node or a ribbon to
+ * trace it.
+ */
+export declare const AggregateSankey: (props: AggregateSankeyProps) => import("react").JSX.Element;
+export {};

package/lib/types/charts/glance/aggregate-sankey.data.d.ts

@@ -0,0 +1,32 @@
+export interface SankeyFlow {
+    from: string;
+    to: string;
+    value: number;
+}
+export interface AggregateSankeyData {
+    flows: SankeyFlow[];
+    /** Left column, top to bottom. */
+    sources: string[];
+    /** Right column, top to bottom. */
+    targets: string[];
+}
+/**
+ * Free vote: how the MPs of each party voted in the House of Commons on the
+ * second reading of the Terminally Ill Adults (End of Life) Bill, 29 November
+ * 2024, a free vote on which parties split (330 ayes, 275 noes).
+ *
+ * Source: UK Parliament Commons Votes API, division 1877 (Open Parliament
+ * Licence v3.0):
+ * https://commonsvotes-api.parliament.uk/data/division/1877.json
+ * (found with https://commonsvotes-api.parliament.uk/data/divisions.json/search?queryParameters.searchTerm=Terminally%20Ill%20Adults)
+ * Fetched 2026-10-15.
+ *
+ * Transform: each member in the lists Ayes, Noes and NoVoteRecorded counted by
+ * their Party: Labour, Conservative and Liberal Democrat kept apart, every
+ * other party and independent as Other. "Did not vote" is the NoVoteRecorded
+ * list, which also holds the Speaker and three deputies and the seven Sinn
+ * Fein MPs who do not take their seats.
+ * Sanity: ayes 330 and noes 275 match the division's counts; Labour split 234
+ * to 147, the Conservatives 23 to 92.
+ */
+export declare const aggregateSankeyDemo: AggregateSankeyData;

package/lib/types/charts/glance/bar-race.d.ts

@@ -0,0 +1,20 @@
+import type { NoteProps } from "../../schema/options.js";
+import type { RaceData } from "./bar-race.data.js";
+interface BarRaceProps extends NoteProps {
+    data?: RaceData;
+    height?: number;
+    format?: (v: number) => string;
+    /** Milliseconds per period. */
+    speed?: number;
+    /** Label of a series to keep in the hero colour whatever its rank. */
+    highlight?: string;
+}
+/**
+ * G16 Busiest stations. A ranking that re-sorts as the values animate through
+ * the periods. Bars are squared with a 2px corner; the leader is solid ink
+ * and the rest are hatched inside a crisp 1px outline. The scrubber's current period is the only date. Starts
+ * when scrolled into view, pauses off-screen, and shows the final period
+ * under reduced motion.
+ */
+export declare const BarRace: (props: BarRaceProps) => import("react").JSX.Element;
+export {};

package/lib/types/charts/glance/bar-race.data.d.ts

@@ -0,0 +1,32 @@
+export interface RaceSeries {
+    label: string;
+    /** One value per period. */
+    values: number[];
+}
+export interface RaceData {
+    periods: string[];
+    series: RaceSeries[];
+}
+/**
+ * Busiest stations: passenger entries and exits in millions a year at eight
+ * London stations, financial years 2017-18 to 2024-25 (April to March).
+ *
+ * Source: Office of Rail and Road, Estimates of station usage, Table 1415
+ * "Time series of passenger entries, exits and interchanges by station",
+ * worksheet 1415a_Entries_and_Exits (Open Government Licence v3.0):
+ * https://dataportal.orr.gov.uk/statistics/usage/estimates-of-station-usage/
+ * file https://dataportal.orr.gov.uk/media/1908/table-1415-time-series-of-passenger-entries-and-exits-and-interchanges-by-station.ods
+ * Fetched 2026-10-15.
+ *
+ * Transform: for each of the eight stations (rows "London Waterloo", "London
+ * Victoria", "London Liverpool Street", "London Bridge", "Stratford (London)",
+ * "London Paddington", "London Euston", "Farringdon"), the eight columns
+ * "Apr 2017 to Mar 2018" to "Apr 2024 to Mar 2025", divided by 1,000,000 and
+ * rounded to one decimal. The stations were picked because their order
+ * changes: Waterloo is first until 2021-22 except in 2020-21, when Stratford
+ * leads, and Liverpool Street is first from 2022-23, the year the Elizabeth
+ * line opened. Station names
+ * are shortened ("London Waterloo" to "Waterloo"). The workbook marks 2022-23
+ * with a break in the series [b].
+ */
+export declare const barRaceDemo: RaceData;

package/lib/types/charts/glance/big-slice.d.ts

@@ -0,0 +1,27 @@
+import type { NoteProps } from "../../schema/options.js";
+import type { SliceDatum } from "./big-slice.data.js";
+interface BigSliceProps extends NoteProps {
+    data?: SliceDatum[];
+    height?: number;
+    /** Intensity values for the reference rings. */
+    rings?: number[];
+    /** Labels for the reference rings. */
+    ringFormat?: (v: number) => string;
+    /** Formats a share (already in percent). */
+    formatShare?: (v: number) => string;
+    /** Formats an intensity value. */
+    format?: (v: number) => string;
+    /** Words after the intensity in the tooltip, e.g. "a day". */
+    intensityLabel?: string;
+    /** Index of the slice to draw in the hero colour. */
+    highlight?: number;
+}
+/**
+ * G13 Free time. A pie where the angle is the share and the radius is
+ * the intensity. Radius runs on a radial (square-root) scale so slice area
+ * stays honest. Evenly dotted 1px rings mark the intensity scale; the most
+ * intense slice (or the highlight) is solid ink, the rest hatched on paper
+ * inside a 1px outline.
+ */
+export declare const BigSlice: (props: BigSliceProps) => import("react").JSX.Element;
+export {};

package/lib/types/charts/glance/big-slice.data.d.ts

@@ -0,0 +1,30 @@
+export interface SliceDatum {
+    /** How intense the slice is (drives the radius), e.g. minutes per day. */
+    intensity: number;
+    label: string;
+    /** Share of the whole (drives the angle). Any unit; normalised to the total. */
+    share: number;
+}
+/**
+ * Free time by age: adults in seven age bands (angle: each band's share of all
+ * adults in the United Kingdom) and the minutes a day each band spent on
+ * "entertainment, socialising and other free time" (radius), March 2024.
+ *
+ * Source: Office for National Statistics, Time use in the UK: 9 to 17 March
+ * 2024 (Online Time Use Survey, NatCen Opinion Panel; Open Government Licence
+ * v3.0), worksheet 7 "Average daily time (minutes) spent doing specified
+ * activities, all adults: by age group":
+ * https://www.ons.gov.uk/peoplepopulationandcommunity/personalandhouseholdfinances/incomeandwealth/datasets/timeuseintheuk
+ * file https://www.ons.gov.uk/file?uri=/peoplepopulationandcommunity/personalandhouseholdfinances/incomeandwealth/datasets/timeuseintheuk/march2024/timeuseintheukmarch24.xlsx
+ * Fetched 2026-10-15.
+ *
+ * Transform: in Table 7a the row "Entertainment, socialising and other free
+ * time", and in Table 7c the row "Weighted count", for the seven columns
+ * "Aged 18 to 24 March 2024" to "Aged 75 and over March 2024", as given. The
+ * weighted counts (adults) are the shares and add up to 53.1 million adults,
+ * the survey's total; the means (minutes a day) are the radii. Sample sizes run from 127
+ * (18 to 24) to 663 (55 to 64).
+ * Sanity: free time climbs with age, from 157 minutes (25 to 34) to 335
+ * (75 and over).
+ */
+export declare const bigSliceDemo: SliceDatum[];

package/lib/types/charts/glance/chunky-bars.d.ts

@@ -0,0 +1,18 @@
+import type { NoteProps } from "../../schema/options.js";
+import type { ChunkyDatum } from "./chunky-bars.data.js";
+interface ChunkyBarsProps extends NoteProps {
+    data?: ChunkyDatum[];
+    height?: number;
+    format?: (v: number) => string;
+    /** Footnote under the labels. */
+    /** Index of the bar to draw in the hero colour. */
+    highlight?: number;
+}
+/**
+ * G3 A pint over time. A handful of wide bars, squared off with a 2px corner,
+ * standing on a hairline baseline with the value above each. The leader is
+ * solid ink; the rest are engraved: 45° hatching in one grey inside a crisp
+ * 1px outline.
+ */
+export declare const ChunkyBars: (props: ChunkyBarsProps) => import("react").JSX.Element;
+export {};

package/lib/types/charts/glance/chunky-bars.data.d.ts

@@ -0,0 +1,24 @@
+/**
+ * G3 A pint over time: the average price of a pint of draught lager, in
+ * pence, in four years ten years apart.
+ *
+ * Source: Office for National Statistics, "RPI: Ave price - Draught lager,
+ * per pint", series CZMS in dataset MM23 (Average prices of selected items),
+ * release of 16 September 2026, Open Government Licence v3.0:
+ * https://www.ons.gov.uk/economy/inflationandpriceindices/timeseries/czms/mm23
+ * File: https://www.ons.gov.uk/generator?format=csv&uri=/economy/inflationandpriceindices/timeseries/czms/mm23
+ * Fetched 2026-10-15.
+ *
+ * Transform: the annual values (the rows keyed by a bare year) for 1994, 2004,
+ * 2014 and 2024, in pence as they stand. The plan's 1995, 2005, 2015 and 2025
+ * would have ended on 2025, which has no annual value yet (the file holds only
+ * January 2025, 483p), and 2020 and 2021 are blank, so the span ends in 2024.
+ * A pint cost 158p in 1994 and 477p in 2024.
+ */
+export interface ChunkyDatum {
+    label: string;
+    /** Pence. */
+    value: number;
+}
+/** Average price of a pint of draught lager, pence. */
+export declare const chunkyBarsDemo: ChunkyDatum[];

package/lib/types/charts/glance/circular-graph.d.ts

@@ -0,0 +1,19 @@
+import type { NoteProps } from "../../schema/options.js";
+import type { CircleLink, CircleNode } from "./circular-graph.data.js";
+interface CircularGraphProps extends NoteProps {
+    nodes?: CircleNode[];
+    links?: CircleLink[];
+    height?: number;
+    format?: (v: number) => string;
+    /** Node id to draw in the hero colour. */
+    highlight?: string;
+}
+/**
+ * G6 Moving between regions. Up to a dozen nodes on a ring, area = size,
+ * links bowed through the middle, each a bundle of 1–4 hairlines by the moves
+ * between the pair. Hover a node to trace it. The biggest region is the one
+ * solid node and its strongest link the one ink bundle; the rest are hollow
+ * rings and l4 hairlines.
+ */
+export declare const CircularGraph: (props: CircularGraphProps) => import("react").JSX.Element;
+export {};

package/lib/types/charts/glance/circular-graph.data.d.ts

@@ -0,0 +1,43 @@
+/**
+ * G6 Moving between regions: the nine regions of England, node size the moves
+ * in and out of each, links the moves between each pair, year ending June 2025.
+ *
+ * Source: Office for National Statistics, "Internal migration in England and
+ * Wales", moves by local authorities and regions by age and sex including
+ * origin and destination, year ending June 2025 (2023 local authority
+ * boundaries), Open Government Licence v3.0:
+ * https://www.ons.gov.uk/peoplepopulationandcommunity/populationandmigration/populationestimates/datasets/internalmigrationinenglandandwales
+ * File: internalmigration2025tables.xlsx, fetched 2026-10-15 from
+ * https://www.ons.gov.uk/file?uri=/peoplepopulationandcommunity/populationandmigration/populationestimates/datasets/internalmigrationinenglandandwales/movesbylocalauthoritiesandregionsbyageandsexincludingoriginanddestinationmovesyearendingjune20252023localauthorityboundaries/internalmigration2025tables.xlsx
+ *
+ * The region Yorkshire and The Humber is shortened to Yorkshire so the ring's
+ * names fit a phone.
+ *
+ * Transform: node value is Inflow plus Outflow for each English region from
+ * sheet IM2025-T5 (moves with every other part of England and Wales,
+ * including Wales), in thousands, rounded. Link value comes from sheet
+ * IM2025-T6, a square matrix of moves with rows the destination and columns
+ * the origin: for two regions it is the cell each way added together, in
+ * thousands, rounded. The 36 pairs of English regions were ranked and the
+ * twenty largest kept; the cut falls at North East and Yorkshire and The
+ * Humber (33,917 moves), which keeps every region linked. London and the
+ * South East swap 243,035 moves, the most of any pair; London lost 131,961
+ * more people to the rest of England and Wales than it gained.
+ */
+export interface CircleNode {
+    id: string;
+    /** Moves in and out, thousands. */
+    value: number;
+}
+export interface CircleLink {
+    source: string;
+    target: string;
+    /** Moves between the two regions, both ways, thousands. */
+    value: number;
+}
+export interface CircleGraphData {
+    nodes: CircleNode[];
+    links: CircleLink[];
+}
+/** Moves between English regions in the year to June 2025. */
+export declare const circularGraphDemo: CircleGraphData;

package/lib/types/charts/glance/control-slot.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+/**
+ * The one place a glance chart's controls sit (CONTROL_SLOT_H tall, in
+ * util-b): a 44px row at the top left,
+ * above the plot, the pills flush with the chart's left edge.
+ */
+export declare const ControlSlot: (props: {
+    children: ReactNode;
+}) => import("react").JSX.Element;

package/lib/types/charts/glance/diverging-bar.d.ts

@@ -0,0 +1,19 @@
+import type { NoteProps } from "../../schema/options.js";
+import type { DivergingDatum } from "./diverging-bar.data.js";
+interface DivergingBarProps extends NoteProps {
+    data?: DivergingDatum[];
+    height?: number;
+    format?: (v: number) => string;
+    /** Draw losses in the alert colour instead of a light ladder tone. */
+    alertLosses?: boolean;
+    /** Index of the bar to draw in the hero colour. */
+    highlight?: number;
+}
+/**
+ * G10 Names rising, falling. Signed values either side of a solid ink zero rule. The
+ * biggest gain (or the highlight) is solid ink; other gains are hatched and
+ * losses stippled, each inside a crisp 1px outline (or solid alert). Bar
+ * ends are squared with a 2px corner.
+ */
+export declare const DivergingBar: (props: DivergingBarProps) => import("react").JSX.Element;
+export {};

package/lib/types/charts/glance/diverging-bar.data.d.ts

@@ -0,0 +1,27 @@
+/**
+ * G10 Names rising, falling: the change in the number of babies given each of
+ * seven names in England and Wales, 2015 to 2025.
+ *
+ * Source: Office for National Statistics, "Baby names in England and Wales
+ * from 1996", Tables 1 (girls) and 2 (boys), counts by name for 2015 and
+ * 2025, Open Government Licence v3.0:
+ * https://www.ons.gov.uk/peoplepopulationandcommunity/birthsdeathsandmarriages/livebirths/datasets/babynamesinenglandandwalesfrom1996
+ * File: babynames1996to2025.xlsx, fetched 2026-10-15 from
+ * https://www.ons.gov.uk/file?uri=/peoplepopulationandcommunity/birthsdeathsandmarriages/livebirths/datasets/babynamesinenglandandwalesfrom1996/1996to2025/babynames1996to2025.xlsx
+ *
+ * Transform: for every row of both tables, count 2025 minus count 2015 (a
+ * redacted count, 2 or fewer, is taken as 0). The four largest rises and the
+ * three largest falls are kept, largest rise first; all seven are boys' names.
+ * The plan's 2014 to 2024 became 2015 to 2025, the latest ten years in the
+ * file. The ONS counts the exact spelling registered, with similar spellings
+ * counted separately, so Muhammad is one spelling among several and a fall
+ * can partly be a split into other spellings. Oliver was given to 6,941 boys
+ * in 2015 and 3,154 in 2025.
+ */
+export interface DivergingDatum {
+    label: string;
+    /** Change in the number of babies given the name. */
+    value: number;
+}
+/** Change in babies given each name, England and Wales, 2015 to 2025. */
+export declare const divergingBarDemo: DivergingDatum[];

package/lib/types/charts/glance/dot-waffle.d.ts

@@ -0,0 +1,19 @@
+import type { NoteProps } from "../../schema/options.js";
+import type { WaffleDatum } from "./dot-waffle.data.js";
+interface DotWaffleProps extends NoteProps {
+    data?: WaffleDatum[];
+    height?: number;
+    format?: (v: number) => string;
+    /** Footnote under the grid. */
+    /** Index of the category to draw in the hero colour. */
+    highlight?: number;
+}
+/**
+ * G4 Pollen in honey. A 10 × 10 grid of small squares, one square = 1% of the
+ * whole, filled row by row in data order. The largest share is solid ink;
+ * each other category is engraved in its own grammar (crosshatch, hatch,
+ * rules, stipple) inside a crisp outline. The legend is one line per
+ * category, its share flush right.
+ */
+export declare const DotWaffle: (props: DotWaffleProps) => import("react").JSX.Element;
+export {};

package/lib/types/charts/glance/dot-waffle.data.d.ts

@@ -0,0 +1,31 @@
+/**
+ * G4 Pollen in honey: which plant families the pollen in UK honey came from,
+ * 2019. One square is one per cent of the DNA reads.
+ *
+ * Source: Woodcock, B.A., Oliver, A.E., Newbold, L.K., Gweon, H.S., Roy, D.B.
+ * and Pywell, R.F. (2022), "Data describing pollen identified from honey
+ * samples originating from the UKCEH National Honey Monitoring Scheme for
+ * 2019", NERC EDS Environmental Information Data Centre,
+ * https://doi.org/10.5285/e9ec63be-3f2b-4d1b-b9bf-77ca2b96c7f5 . Licence: Open
+ * Government Licence v3; "Contains data supplied by UK Centre for Ecology &
+ * Hydrology." Files data/nhms-2019-regional-data.csv and data/taxonomy.csv,
+ * fetched 2026-10-15 from
+ * https://data-package.ceh.ac.uk/data/e9ec63be-3f2b-4d1b-b9bf-77ca2b96c7f5.zip
+ *
+ * Transform: each of the 12 regional rows gives the average rarefied DNA reads
+ * of pollen per plant species (every row sums to about 15,000). The reads of
+ * each species were added over the 12 rows (equal weight per region, 180,566
+ * reads in all), grouped by Family from taxonomy.csv, and turned into shares.
+ * The four largest families are kept and the rest is "Everything else":
+ * Rosaceae 23.6, Brassicaceae 20.5, Fabaceae 16.1, Boraginaceae 7.9 and the
+ * remaining 31.9, which add up to 100.0. The names are the common names of
+ * the families (rose, cabbage, pea, borage). Reads count DNA, not grains or
+ * weight of pollen.
+ */
+export interface WaffleDatum {
+    label: string;
+    /** Share of pollen DNA reads, %. */
+    value: number;
+}
+/** Share of the pollen DNA reads in UK honey, 2019, by plant family, %. */
+export declare const dotWaffleDemo: WaffleDatum[];

package/lib/types/charts/glance/draw-in.d.ts

@@ -0,0 +1,20 @@
+import type { NoteProps } from "../../schema/options.js";
+import type { DrawInDatum } from "./draw-in.data.js";
+interface DrawInProps extends NoteProps {
+    data?: DrawInDatum[];
+    height?: number;
+    format?: (v: number) => string;
+    /** Caption under the big number, e.g. "2024-25". */
+    caption?: string;
+    /** Draw duration in ms. */
+    duration?: number;
+}
+/**
+ * G18 Premier League goals. One cumulative 2px line over a dot-screened area,
+ * drawn left to right while the big number counts up in step with the tip of
+ * the line. The scale reads at the right, each value on its rule.
+ * Plays once when scrolled into view; Replay runs it again. Reduced motion
+ * shows the end.
+ */
+export declare const DrawIn: (props: DrawInProps) => import("react").JSX.Element;
+export {};

package/lib/types/charts/glance/draw-in.data.d.ts

@@ -0,0 +1,6 @@
+export interface DrawInDatum {
+    date: Date;
+    /** Running total up to and including this date. */
+    value: number;
+}
+export declare const drawInDemo: DrawInDatum[];

package/lib/types/charts/glance/dynamic-stream.d.ts

@@ -0,0 +1,22 @@
+import type { NoteProps } from "../../schema/options.js";
+import type { StreamFeed } from "./dynamic-stream.data.js";
+interface DynamicStreamProps extends NoteProps {
+    /** Value for step n (n ≥ 0). Must be deterministic. */
+    feed?: StreamFeed;
+    /** Values visible at once. */
+    window?: number;
+    /** Milliseconds between values. */
+    interval?: number;
+    /** Fixed value domain; defaults to the range of the first 400 values. */
+    domain?: [number, number];
+    height?: number;
+    format?: (v: number) => string;
+}
+/**
+ * G17 Rolling swell. A line that keeps moving: a new value arrives every
+ * `interval` ms and the window scrolls left to make room. The latest value is
+ * printed beside the head, and the scale reads at the right, each value on its
+ * rule. Runs only while on screen; the Running control pauses and resumes.
+ */
+export declare const DynamicStream: (props: DynamicStreamProps) => import("react").JSX.Element;
+export {};

package/lib/types/charts/glance/dynamic-stream.data.d.ts

@@ -0,0 +1,7 @@
+/** A rolling line: the value for step n (n ≥ 0). Must be deterministic. */
+export type StreamFeed = (step: number) => number;
+/**
+ * A slow swell with a quicker ripple and a little noise. Pure in `step`; not
+ * measured data.
+ */
+export declare const dynamicStreamDemo: StreamFeed;

package/lib/types/charts/glance/force-graph.d.ts

@@ -0,0 +1,16 @@
+import type { NoteProps } from "../../schema/options.js";
+import type { ForceLink, ForceNode } from "./force-graph.data.js";
+interface ForceGraphProps extends NoteProps {
+    nodes?: ForceNode[];
+    links?: ForceLink[];
+    height?: number;
+    format?: (v: number) => string;
+}
+/**
+ * G11 Into the Thames. A hub and its satellites in a d3-force layout, node
+ * area = flow, each link a bundle of 1–4 hairlines by strength. The hub is
+ * the one solid node and its strongest link the one ink bundle; satellites
+ * are hollow rings. Drag a node: the springs pull it back when you let go.
+ */
+export declare const ForceGraph: (props: ForceGraphProps) => import("react").JSX.Element;
+export {};

package/lib/types/charts/glance/force-graph.data.d.ts

@@ -0,0 +1,45 @@
+/**
+ * G11 Into the Thames: the Thames at Kingston as the hub, seven tributaries
+ * round it, each sized by its mean flow.
+ *
+ * Source: Environment Agency Hydrology API, daily mean flow in m3/s,
+ * Open Government Licence v3.0, https://environment.data.gov.uk/hydrology/ ,
+ * fetched 2026-10-15. For each station the measure
+ * <station guid>-flow-m-86400-m3s-qualified, read with
+ * https://environment.data.gov.uk/hydrology/id/measures/<measure>/readings.json?mineq-date=1996-10-01&maxeq-date=2024-09-30&_limit=20000
+ *   Thames: Kingston (3400TH, 8496ce69-482c-406a-a2f0-ac418ef8f099)
+ *   Wey: Weybridge (3090TH, 2629abeb-e504-49f7-9996-080f37e15930)
+ *   Cherwell: Oxford (1490TH, 839866a2-80ca-42a8-a695-8e6d6b165fa6)
+ *   Mole: Esher (3290TH, 024f218d-9a70-43b7-8ea2-7d038eeb2cff)
+ *   Colne: Denham Colne (2870TH, cb5596d4-deb7-4784-ad4e-5c21279082ab)
+ *   Evenlode: Cassington (1290TH, 8afc6e20-b0bd-4b79-bf65-345dac8cafee_1290TH)
+ *   Thame: Wheatley (1980TH, b86817d4-c71b-4bd4-ab64-4982bf812b12)
+ *   Windrush: Newbridge (1090TH, 37f9d60e-0bdc-4578-b03b-77103b250a09)
+ *
+ * Transform: the mean of all daily readings that have a value between
+ * 1996-10-01 and 2024-09-30 (28 water years), in m3/s. Stations differ in
+ * how many of the 10,227 days they cover: Thames, Colne and Thame all 10,227;
+ * Wey 10,221; Evenlode 10,103; Mole 10,077; Windrush 9,980 (its record stops
+ * in February 2024); Cherwell 8,842 (86%). A hub link carries the tributary's
+ * mean flow. The seven means add up to 36.5 m3/s against 65.4 m3/s at
+ * Kingston; the rest is the main river above the confluences and the
+ * tributaries not drawn. The Kennet, a larger tributary, reports level only
+ * at Theale and Knighton on this API, so it is left out.
+ */
+export interface ForceNode {
+    id: string;
+    /** Mean flow, m3/s. */
+    value: number;
+}
+export interface ForceLink {
+    source: string;
+    target: string;
+    /** Mean flow of the tributary, m3/s. */
+    value: number;
+}
+export interface ForceGraphData {
+    nodes: ForceNode[];
+    links: ForceLink[];
+}
+/** The Thames at Kingston and seven tributaries, mean daily flow in m3/s. */
+export declare const forceGraphDemo: ForceGraphData;