@spec annotate(Fude.Chart.t(), Fude.Annotation.type(), keyword()) :: Fude.Chart.t()

Writes a note on the chart, at a place of its data (see Fude.Annotation):

chart
|> Fude.annotate(:label, x: "North", y: 136_000, text: "Best quarter on record")
|> Fude.annotate(:band, x: {~D[2026-03-01], ~D[2026-05-01]}, text: "Launch")
|> Fude.annotate(:line, y: 4000, text: "Goal")

@spec area(term(), keyword()) :: Fude.Chart.t()

Areas: as lines, filled down to zero; stacked when they have a color.

Fude.area(data, ...)
Fude.area(...)          # a layer, for Fude.layers/2

@spec bar(term(), keyword()) :: Fude.Chart.t()

Bars: a category on x and a number on y; horizontal: true turns them.

Fude.bar(data, ...)
Fude.bar(...)          # a layer, for Fude.layers/2

@spec bubble(term(), keyword()) :: Fude.Chart.t()

Points at x and y, sized by size.

Fude.bubble(data, ...)
Fude.bubble(...)          # a layer, for Fude.layers/2

@spec bubble_map(term(), keyword()) :: Fude.Chart.t()

A map with a circle at each region, sized by size.

Fude.bubble_map(data, ...)
Fude.bubble_map(...)          # a layer, for Fude.layers/2

@spec choropleth(term(), keyword()) :: Fude.Chart.t()

A map of regions colored by color: each region an ISO code ("PRT", "PT"), a number code or a name; map is "world" (the default) or "us-states".

Fude.choropleth(data, ...)
Fude.choropleth(...)          # a layer, for Fude.layers/2

@spec donut(term(), keyword()) :: Fude.Chart.t()

A donut: a pie with a hole (inner, the hole's share of the radius).

Fude.donut(data, ...)
Fude.donut(...)          # a layer, for Fude.layers/2

@spec facet(Fude.Chart.t(), atom() | String.t(), keyword()) :: Fude.Chart.t()

Small multiples: the chart drawn once for each value of a field, side by side, on the same scales, so that the panels compare at a glance.

Fude.line(sales, x: :month, y: :revenue)
|> Fude.facet(:region, columns: 3)

columns is how many panels make a row; as many as fit when not given.

@spec funnel(term(), keyword()) :: Fude.Chart.t()

A funnel: the stages on x with their y, each with its share of the first.

Fude.funnel(data, ...)
Fude.funnel(...)          # a layer, for Fude.layers/2

@spec gauge(term(), keyword()) :: Fude.Chart.t()

One number on an arc from min to max (0 and 100 when not given), with a target.

Fude.gauge(data, ...)
Fude.gauge(...)          # a layer, for Fude.layers/2

@spec heatmap(term(), keyword()) :: Fude.Chart.t()

A heatmap: a cell for each x and y, colored by color.

Fude.heatmap(data, ...)
Fude.heatmap(...)          # a layer, for Fude.layers/2

@spec histogram(term(), keyword()) :: Fude.Chart.t()

A histogram: the numbers of x counted in bins (bins, about how many).

Fude.histogram(data, ...)
Fude.histogram(...)          # a layer, for Fude.layers/2

@spec layers(term(), [Fude.Chart.t()], keyword()) :: Fude.Chart.t()

A chart of layers drawn one over the other, on the same axes: the first at the back. Each layer is a chart of one kind, made without data; the layers read the same data.

@spec line(term(), keyword()) :: Fude.Chart.t()

Lines: a time or a number on x, a number on y, a line for each color.

Fude.line(data, ...)
Fude.line(...)          # a layer, for Fude.layers/2

@spec number(term(), keyword()) :: Fude.Chart.t()

One number, large, with a label.

Fude.number(data, ...)
Fude.number(...)          # a layer, for Fude.layers/2

@spec pie(term(), keyword()) :: Fude.Chart.t()

A pie: a slice for each color, as large as its value.

Fude.pie(data, ...)
Fude.pie(...)          # a layer, for Fude.layers/2

@spec progress(term(), keyword()) :: Fude.Chart.t()

One number on a bar towards a goal.

Fude.progress(data, ...)
Fude.progress(...)          # a layer, for Fude.layers/2

@spec put_data(Fude.Chart.t(), term()) :: Fude.Chart.t()

Gives the chart its data, under its data's name. A chart loaded from a spec gets its data again this way, or from <.chart data={...}>.

@spec put_data(Fude.Chart.t(), String.t(), term()) :: Fude.Chart.t()

Gives the chart a dataset of a name, for a layer that reads it.

@spec query(Ecto.Queryable.t(), module(), keyword()) :: Fude.Query.t()

The data of an Ecto query or schema, grouped and aggregated in the database when the chart draws (see Fude.Query):

Order |> Fude.query(Repo) |> Fude.bar(x: :status, y: {:count, :id})

@spec rule(term(), keyword()) :: Fude.Chart.t()

A rule across the chart at x or at y, with a label.

Fude.rule(data, ...)
Fude.rule(...)          # a layer, for Fude.layers/2

@spec scatter(term(), keyword()) :: Fude.Chart.t()

Points at x and y, colored by color and sized by size.

Fude.scatter(data, ...)
Fude.scatter(...)          # a layer, for Fude.layers/2

@spec sparkline(term(), keyword()) :: Fude.Chart.t()

A small line with no axes, for a table or a card.

Fude.sparkline(data, ...)
Fude.sparkline(...)          # a layer, for Fude.layers/2

@spec text(term(), keyword()) :: Fude.Chart.t()

Text at x and y.

Fude.text(data, ...)
Fude.text(...)          # a layer, for Fude.layers/2

@spec title(Fude.Chart.t(), String.t(), keyword()) :: Fude.Chart.t()

Sets the chart's title, and with :subtitle, its subtitle.

@spec trend(term(), keyword()) :: Fude.Chart.t()

One number with its change from compare.

Fude.trend(data, ...)
Fude.trend(...)          # a layer, for Fude.layers/2

@spec version() :: String.t()

Fude's version.

@spec waterfall(term(), keyword()) :: Fude.Chart.t()

A waterfall: how each change of y (a step on x) moves a running total; total adds a bar of the end, start names the first bar as a total.

Fude.waterfall(data, ...)
Fude.waterfall(...)          # a layer, for Fude.layers/2