{
  "id": "dashboards",
  "title": "Dashboards and charts",
  "summary": "Chart geometry as data in any language (scales, ticks, axes, lines, bars, pies, sparklines) plus the statistics and number formatting a dashboard shows.",
  "synonyms": [
    "dashboard",
    "charts",
    "graphs",
    "plots",
    "data visualisation",
    "data visualization",
    "kpi",
    "reporting",
    "analytics",
    "metrics display",
    "sparklines"
  ],
  "apps": [
    "dashboard",
    "analytics dashboard",
    "admin dashboard",
    "reporting page",
    "kpi dashboard",
    "charting library",
    "metrics display"
  ],
  "language": "rust",
  "includes": [
    "dates-basics"
  ],
  "includedBy": [
    "monitoring"
  ],
  "caveats": [],
  "sections": [
    {
      "key": "complete-charts",
      "title": "Whole charts",
      "purpose": "Get complete chart geometry in one call, for the common charts.",
      "from": "dashboards",
      "members": [
        {
          "id": "charts.line-chart",
          "tier": "core",
          "why": "Plot area, number or date axes, gridlines, series paths, colours and legend for a line chart.",
          "section": "complete-charts",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Complete line chart geometry as data: plot area, number or date axes, gridlines, series paths, colours, legend.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "lineChart"
          ],
          "signatures": [
            "pub fn line_chart(spec: &LineChartSpec) -> LineChart"
          ],
          "reference": "fune!(charts.line-chart@^1);  // then call line_chart(…)",
          "url": "http://www.functionalweave.com/functions/charts.line-chart"
        },
        {
          "id": "charts.bar-chart",
          "tier": "core",
          "why": "Grouped or stacked bar chart geometry: axes, gridlines, bars, colours and legend.",
          "section": "complete-charts",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Complete bar chart geometry as data, grouped or stacked: plot area, axes, gridlines, bar rectangles, colours, legend.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "barChart"
          ],
          "signatures": [
            "pub fn bar_chart(spec: &BarChartSpec) -> BarChart"
          ],
          "reference": "fune!(charts.bar-chart@^1);  // then call bar_chart(…)",
          "url": "http://www.functionalweave.com/functions/charts.bar-chart"
        },
        {
          "id": "charts.sparkline",
          "tier": "optional",
          "why": "A sparkline path and end marker for a series in a small box.",
          "section": "complete-charts",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "A sparkline's SVG path and end marker from a series, fitted into a box, with gaps left as breaks.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "sparkline"
          ],
          "signatures": [
            "pub fn sparkline(values: &[Option<f64>], width: f64, height: f64, padding: f64) -> Sparkline"
          ],
          "reference": "fune!(charts.sparkline@^1);  // then call sparkline(…)",
          "url": "http://www.functionalweave.com/functions/charts.sparkline"
        }
      ],
      "gaps": []
    },
    {
      "key": "building-blocks",
      "title": "Chart building blocks",
      "purpose": "Compose charts of your own from the same parts.",
      "from": "dashboards",
      "members": [
        {
          "id": "charts.scale",
          "tier": "core",
          "why": "Maps values to positions and back: linear, log, time, band and point scales, nice domains.",
          "section": "building-blocks",
          "from": "dashboards",
          "version": "1.1.0",
          "summary": "Map data values onto screen positions and back: linear, log, time, band and point scales, and nice domains.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": true,
          "functions": [
            "linearScale",
            "invertLinear",
            "niceDomain",
            "logScale",
            "timeScale",
            "bandScale",
            "pointScale"
          ],
          "signatures": [
            "pub fn linear_scale(domain: &[f64], range: &[f64], value: f64, clamp: bool) -> f64",
            "pub fn invert_linear(domain: &[f64], range: &[f64], value: f64) -> f64",
            "pub fn nice_domain(domain: &[f64], count: i64) -> NiceDomain",
            "pub fn log_scale(domain: &[f64], range: &[f64], value: f64, clamp: bool) -> f64",
            "pub fn time_scale(domain: &[String], range: &[f64], value: &str, clamp: bool) -> f64",
            "pub fn band_scale(domain: &[String], range: &[f64], value: &str, padding_inner: f64, padding_outer: f64, align: f64) -> Band",
            "pub fn point_scale(domain: &[String], range: &[f64], value: &str, padding: f64, align: f64) -> f64"
          ],
          "reference": "fune!(charts.scale@^1);  // then call linear_scale, invert_linear, nice_domain, log_scale, time_scale, band_scale, point_scale",
          "url": "http://www.functionalweave.com/functions/charts.scale"
        },
        {
          "id": "charts.ticks",
          "tier": "core",
          "why": "Round tick steps and calendar ticks from days to years.",
          "section": "building-blocks",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Axis ticks: a round step (1, 2 or 5 x 10^k), the ticks on it, and calendar ticks from days to years.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": true,
          "functions": [
            "tickStep",
            "niceTicks",
            "timeTickInterval",
            "timeTicks"
          ],
          "signatures": [
            "pub fn tick_step(start: f64, stop: f64, count: i64) -> f64",
            "pub fn nice_ticks(start: f64, stop: f64, count: i64) -> Vec<f64>",
            "pub fn time_tick_interval(start: &str, stop: &str, count: i64) -> TimeTickInterval",
            "pub fn time_ticks(start: &str, stop: &str, interval: &str, step: i64) -> Vec<String>"
          ],
          "reference": "fune!(charts.ticks@^1);  // then call tick_step, nice_ticks, time_tick_interval, time_ticks",
          "url": "http://www.functionalweave.com/functions/charts.ticks"
        },
        {
          "id": "charts.axis",
          "tier": "core",
          "why": "Tick positions, labels and gridlines for number, time and category axes.",
          "section": "building-blocks",
          "from": "dashboards",
          "version": "1.0.1",
          "summary": "Axis geometry as data: tick positions, tick marks, label anchors and gridlines for number, time and category axes.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": true,
          "functions": [
            "axisFromTicks",
            "numberAxis",
            "timeAxis",
            "bandAxis",
            "gridLines"
          ],
          "signatures": [
            "pub fn axis_from_ticks(positions: &[f64], labels: &[String], range: &[f64], orient: &str, position: f64, tick_size: f64) -> Axis",
            "pub fn number_axis(domain: &[f64], range: &[f64], count: i64, orient: &str, position: f64, tick_size: f64) -> Axis",
            "pub fn time_axis(domain: &[String], range: &[f64], count: i64, orient: &str, position: f64, tick_size: f64) -> Axis",
            "pub fn band_axis(domain: &[String], range: &[f64], padding_inner: f64, padding_outer: f64, orient: &str, position: f64, tick_size: f64) -> Axis",
            "pub fn grid_lines(axis: &Axis, length: f64) -> Vec<Line>"
          ],
          "reference": "fune!(charts.axis@^1);  // then call axis_from_ticks, number_axis, time_axis, band_axis, grid_lines",
          "url": "http://www.functionalweave.com/functions/charts.axis"
        },
        {
          "id": "charts.shape",
          "tier": "optional",
          "why": "SVG paths for lines, areas, steps, curves, bars, arcs and pie slices.",
          "section": "building-blocks",
          "from": "dashboards",
          "version": "1.0.1",
          "summary": "SVG path strings for lines, areas, steps, monotone curves, bars, arcs and pie slices, identical in every language.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": true,
          "functions": [
            "linePath",
            "areaPath",
            "stepPath",
            "monotoneCurve",
            "barRects",
            "arcPath",
            "pieAngles"
          ],
          "signatures": [
            "pub fn line_path(points: &[Point]) -> String",
            "pub fn area_path(points: &[AreaPoint]) -> String",
            "pub fn step_path(points: &[Point], position: &str) -> String",
            "pub fn monotone_curve(points: &[Point]) -> String",
            "pub fn bar_rects(bars: &[BarSpec], orientation: &str) -> Vec<Rect>",
            "pub fn arc_path(arc: &Arc) -> String",
            "pub fn pie_angles(values: &[f64], start_angle: f64, end_angle: f64, pad_angle: f64) -> Vec<PieSlice>"
          ],
          "reference": "fune!(charts.shape@^1);  // then call line_path, area_path, step_path, monotone_curve, bar_rects, arc_path, pie_angles",
          "url": "http://www.functionalweave.com/functions/charts.shape"
        },
        {
          "id": "charts.stack",
          "tier": "optional",
          "why": "Stacks series on zero, normalised to 100% or diverging.",
          "section": "building-blocks",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Stack several series for stacked bars and areas: on zero, normalised to 100%, or diverging around zero.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "stack"
          ],
          "signatures": [
            "pub fn stack(series: &[Vec<f64>], offset: &str) -> Vec<Vec<StackedValue>>"
          ],
          "reference": "fune!(charts.stack@^1);  // then call stack(…)",
          "url": "http://www.functionalweave.com/functions/charts.stack"
        },
        {
          "id": "charts.layout",
          "tier": "optional",
          "why": "Plot area inside margins, legend rows, label collision avoidance.",
          "section": "building-blocks",
          "from": "dashboards",
          "version": "1.0.1",
          "summary": "Chart layout: the plot area inside margins, legend items wrapped into rows, and greedy label collision avoidance.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": true,
          "functions": [
            "plotArea",
            "legendRows",
            "avoidCollisions"
          ],
          "signatures": [
            "pub fn plot_area(width: f64, height: f64, margins: &Margins) -> PlotArea",
            "pub fn legend_rows(labels: &[String], max_width: f64, char_width: f64, swatch_size: f64, gap: f64, row_height: f64) -> Vec<LegendItem>",
            "pub fn avoid_collisions(boxes: &[LabelBox], padding: f64) -> Vec<bool>"
          ],
          "reference": "fune!(charts.layout@^1);  // then call plot_area, legend_rows, avoid_collisions",
          "url": "http://www.functionalweave.com/functions/charts.layout"
        },
        {
          "id": "charts.extent",
          "tier": "optional",
          "why": "Min and max of a series, skipping gaps.",
          "section": "building-blocks",
          "from": "dashboards",
          "version": "1.0.1",
          "summary": "The minimum and maximum of a series as [min, max], skipping gaps (null), or null when there is no value.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "extent"
          ],
          "signatures": [
            "pub fn extent(values: &[Option<f64>]) -> Option<Vec<f64>>"
          ],
          "reference": "fune!(charts.extent@^1);  // then call extent(…)",
          "url": "http://www.functionalweave.com/functions/charts.extent"
        },
        {
          "id": "charts.histogram-bins",
          "tier": "optional",
          "why": "Bins values for a histogram (Sturges, Freedman-Diaconis or fixed width).",
          "section": "building-blocks",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Bin values into histogram bins on round edges, by Sturges' rule, Freedman-Diaconis, or a fixed width.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "histogramBins"
          ],
          "signatures": [
            "pub fn histogram_bins(values: &[f64], method: &str, bin_width: Option<f64>) -> Vec<Bin>"
          ],
          "reference": "fune!(charts.histogram-bins@^1);  // then call histogram_bins(…)",
          "url": "http://www.functionalweave.com/functions/charts.histogram-bins"
        },
        {
          "id": "charts.downsample",
          "tier": "optional",
          "why": "Thins a long series by LTTB so it draws fast but keeps its shape.",
          "section": "building-blocks",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Reduce a long series to a few points that keep its visual shape, by Largest-Triangle-Three-Buckets (LTTB).",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "downsample"
          ],
          "signatures": [
            "pub fn downsample(points: &[Sample], threshold: i64) -> Vec<Sample>"
          ],
          "reference": "fune!(charts.downsample@^1);  // then call downsample(…)",
          "url": "http://www.functionalweave.com/functions/charts.downsample"
        }
      ],
      "gaps": []
    },
    {
      "key": "colour",
      "title": "Colour",
      "purpose": "Readable, colour-blind-safe colours.",
      "from": "dashboards",
      "members": [
        {
          "id": "charts.palette",
          "tier": "core",
          "why": "n colour-blind-safe series colours (Okabe-Ito or Tol bright).",
          "section": "colour",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "A categorical palette of n colour-blind-safe colours for chart series: Okabe-Ito or Paul Tol's bright scheme.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "palette"
          ],
          "signatures": [
            "pub fn palette(scheme: &str, count: i64, cycle: bool) -> Vec<String>"
          ],
          "reference": "fune!(charts.palette@^1);  // then call palette(…)",
          "url": "http://www.functionalweave.com/functions/charts.palette"
        },
        {
          "id": "charts.interpolate-color",
          "tier": "optional",
          "why": "Colour along a sequential or diverging ramp, for heatmaps.",
          "section": "colour",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "The colour at a point along a sequential or diverging ramp, mixed in OKLab so steps look even; hex in, hex out.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "interpolateColor"
          ],
          "signatures": [
            "pub fn interpolate_color(ramp: &[String], t: f64) -> String"
          ],
          "reference": "fune!(charts.interpolate-color@^1);  // then call interpolate_color(…)",
          "url": "http://www.functionalweave.com/functions/charts.interpolate-color"
        },
        {
          "id": "charts.contrast",
          "tier": "optional",
          "why": "WCAG contrast ratio and the readable text colour on a background.",
          "section": "colour",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "WCAG 2.x contrast ratio between two colours, and which text colour reads best on a background.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": true,
          "functions": [
            "contrastRatio",
            "readableTextColor"
          ],
          "signatures": [
            "pub fn contrast_ratio(foreground: &str, background: &str) -> f64",
            "pub fn readable_text_color(background: &str, candidates: &[String]) -> String"
          ],
          "reference": "fune!(charts.contrast@^1);  // then call contrast_ratio, readable_text_color",
          "url": "http://www.functionalweave.com/functions/charts.contrast"
        },
        {
          "id": "charts.color",
          "tier": "optional",
          "why": "Hex to RGB and back, and sRGB to linear light.",
          "section": "colour",
          "from": "dashboards",
          "version": "1.0.1",
          "summary": "Hex colours to RGB and back, and sRGB channels to linear light and back, identically in every language.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": true,
          "functions": [
            "parseHex",
            "toHex",
            "srgbToLinear",
            "linearToSrgb"
          ],
          "signatures": [
            "pub fn parse_hex(hex: &str) -> Rgb",
            "pub fn to_hex(rgb: &Rgb) -> String",
            "pub fn srgb_to_linear(channel: i64) -> f64",
            "pub fn linear_to_srgb(value: f64) -> i64"
          ],
          "reference": "fune!(charts.color@^1);  // then call parse_hex, to_hex, srgb_to_linear, linear_to_srgb",
          "url": "http://www.functionalweave.com/functions/charts.color"
        }
      ],
      "gaps": []
    },
    {
      "key": "figures",
      "title": "Figures and statistics",
      "purpose": "The numbers in the tiles and tooltips.",
      "from": "dashboards",
      "members": [
        {
          "id": "charts.format",
          "tier": "core",
          "why": "Tick and label text: SI prefixes (1.2k), percentages, dates and money.",
          "section": "figures",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Axis and label text for charts: tick numbers, SI prefixes (1.2k, 3.4M), percentages, dates and money.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": true,
          "functions": [
            "formatTick",
            "formatSi",
            "formatPercent",
            "formatDate",
            "formatMoneyTick"
          ],
          "signatures": [
            "pub fn format_tick(value: f64, step: f64) -> String",
            "pub fn format_si(value: f64, significant: i64) -> String",
            "pub fn format_percent(value: f64, decimals: i64) -> String",
            "pub fn format_date(iso: &str, label: &str) -> String",
            "pub fn format_money_tick(minor: f64, currency: &str) -> String"
          ],
          "reference": "fune!(charts.format@^1);  // then call format_tick, format_si, format_percent, format_date, format_money_tick",
          "url": "http://www.functionalweave.com/functions/charts.format"
        },
        {
          "id": "stats.mean-median",
          "tier": "optional",
          "why": "Mean, median and mode, exactly.",
          "section": "figures",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Mean, median and mode of a list of integers, with the mean and median as exact fractions.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "meanMedianMode"
          ],
          "signatures": [
            "pub fn mean_median_mode(values: &[i64]) -> CentralTendency"
          ],
          "reference": "fune!(stats.mean-median@^1);  // then call mean_median_mode(…)",
          "url": "http://www.functionalweave.com/functions/stats.mean-median"
        },
        {
          "id": "stats.percentile",
          "tier": "optional",
          "why": "Percentiles (nearest-rank or linear), for p95 tiles.",
          "section": "figures",
          "from": "dashboards",
          "version": "2.0.0",
          "summary": "Percentile of a list of numbers by a named method: nearest-rank, or linear interpolation (R-7, Excel PERCENTILE.INC).",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "percentile"
          ],
          "signatures": [
            "pub fn percentile(values: &[f64], p: f64, method: &str, decimals: i64) -> f64"
          ],
          "reference": "fune!(stats.percentile@^2);  // then call percentile(…)",
          "url": "http://www.functionalweave.com/functions/stats.percentile"
        },
        {
          "id": "stats.moving-average",
          "tier": "optional",
          "why": "Simple and exponential moving averages for trend lines.",
          "section": "figures",
          "from": "dashboards",
          "version": "2.0.0",
          "summary": "Simple or exponential moving average over a series, one value per full window, rounded to stated decimals.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "movingAverage"
          ],
          "signatures": [
            "pub fn moving_average(values: &[f64], window: i64, kind: &str, decimals: i64) -> Vec<f64>"
          ],
          "reference": "fune!(stats.moving-average@^2);  // then call moving_average(…)",
          "url": "http://www.functionalweave.com/functions/stats.moving-average"
        },
        {
          "id": "stats.standard-deviation",
          "tier": "optional",
          "why": "Standard deviation, for bands and variability.",
          "section": "figures",
          "from": "dashboards",
          "version": "2.0.0",
          "summary": "Population or sample standard deviation of a list of numbers, two-pass, rounded to stated decimals.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "standardDeviation"
          ],
          "signatures": [
            "pub fn standard_deviation(values: &[f64], kind: &str, decimals: i64) -> f64"
          ],
          "reference": "fune!(stats.standard-deviation@^2);  // then call standard_deviation(…)",
          "url": "http://www.functionalweave.com/functions/stats.standard-deviation"
        },
        {
          "id": "stats.weighted-average",
          "tier": "optional",
          "why": "Weighted averages with explicit rounding.",
          "section": "figures",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Weighted average of integers, computed exactly and rounded once to stated decimals with an explicit rounding mode.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "weightedAverage"
          ],
          "signatures": [
            "pub fn weighted_average(values: &[i64], weights: &[i64], decimals: i64, mode: &RoundingMode) -> f64"
          ],
          "reference": "fune!(stats.weighted-average@^1);  // then call weighted_average(…)",
          "url": "http://www.functionalweave.com/functions/stats.weighted-average"
        },
        {
          "id": "math.percent-change",
          "tier": "optional",
          "why": "Change between two values in basis points, for \"up 4.2%\".",
          "section": "figures",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Percentage change from one value to another, in basis points, with an explicit rounding mode.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "percentChange"
          ],
          "signatures": [
            "pub fn percent_change(from_value: i64, to_value: i64, mode: &RoundingMode) -> Option<i64>"
          ],
          "reference": "fune!(math.percent-change@^1);  // then call percent_change(…)",
          "url": "http://www.functionalweave.com/functions/math.percent-change"
        },
        {
          "id": "text.format-decimal",
          "tier": "optional",
          "why": "Plain decimal text with fixed places and grouping.",
          "section": "figures",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Format a float as plain decimal text with fixed or trimmed places and optional grouping, identically in every language.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "formatDecimal"
          ],
          "signatures": [
            "pub fn format_decimal(value: f64, decimals: i64, trim_zeros: bool, group_separator: &str) -> String"
          ],
          "reference": "fune!(text.format-decimal@^1);  // then call format_decimal(…)",
          "url": "http://www.functionalweave.com/functions/text.format-decimal"
        },
        {
          "id": "money.format",
          "tier": "optional",
          "why": "Money values in tiles with the currency's real decimals.",
          "section": "figures",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Render a monetary amount as text, using the currency's real minor-unit precision.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "formatMoney"
          ],
          "signatures": [
            "pub fn format_money(amount: &Money) -> String"
          ],
          "reference": "fune!(money.format@^1);  // then call format_money(…)",
          "url": "http://www.functionalweave.com/functions/money.format"
        },
        {
          "id": "collections.group-by-key",
          "tier": "optional",
          "why": "Groups records by a key before charting them.",
          "section": "figures",
          "from": "dashboards",
          "version": "1.0.0",
          "summary": "Group records by the value at one key, preserving input order inside each group.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "groupByKey"
          ],
          "signatures": [
            "pub fn group_by_key(records: &[Value], key: &str) -> Vec<(String, Vec<Value>)>"
          ],
          "reference": "fune!(collections.group-by-key@^1);  // then call group_by_key(…)",
          "url": "http://www.functionalweave.com/functions/collections.group-by-key"
        }
      ],
      "gaps": []
    },
    {
      "key": "date-arithmetic",
      "title": "Calendar arithmetic",
      "purpose": "Move and measure ISO dates exactly, with no date library and no clock reads.",
      "from": "dates-basics",
      "members": [
        {
          "id": "dates.add-days",
          "tier": "core",
          "why": "Shifts a date by whole days, for due dates and windows.",
          "section": "date-arithmetic",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Shift an ISO date by a whole number of days, forwards or backwards, with exact calendar arithmetic.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "addDays"
          ],
          "signatures": [
            "pub fn add_days(iso: &str, days: i64) -> String"
          ],
          "reference": "fune!(dates.add-days@^1);  // then call add_days(…)",
          "url": "http://www.functionalweave.com/functions/dates.add-days"
        },
        {
          "id": "dates.add-months",
          "tier": "core",
          "why": "Adds months clamping to month end, so 31 January plus a month is the end of February.",
          "section": "date-arithmetic",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Add calendar months to an ISO date, clamping to the month end: 31 Jan + 1 month is 28 or 29 Feb.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "addMonths"
          ],
          "signatures": [
            "pub fn add_months(iso: &str, months: i64) -> String"
          ],
          "reference": "fune!(dates.add-months@^1);  // then call add_months(…)",
          "url": "http://www.functionalweave.com/functions/dates.add-months"
        },
        {
          "id": "dates.days-between",
          "tier": "core",
          "why": "Signed calendar days between two dates, for ages of invoices and stays.",
          "section": "date-arithmetic",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Calendar days from one ISO date to another, signed: negative when the second date is earlier.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "daysBetween"
          ],
          "signatures": [
            "pub fn days_between(start_iso: &str, end_iso: &str) -> i64"
          ],
          "reference": "fune!(dates.days-between@^1);  // then call days_between(…)",
          "url": "http://www.functionalweave.com/functions/dates.days-between"
        },
        {
          "id": "dates.month-boundaries",
          "tier": "core",
          "why": "First and last day of a date's month, for monthly periods and statements.",
          "section": "date-arithmetic",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "The first day, last day and length of the calendar month containing a date.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "monthBoundaries"
          ],
          "signatures": [
            "pub fn month_boundaries(iso: &str) -> MonthBoundaries"
          ],
          "reference": "fune!(dates.month-boundaries@^1);  // then call month_boundaries(…)",
          "url": "http://www.functionalweave.com/functions/dates.month-boundaries"
        },
        {
          "id": "dates.day-of-week",
          "tier": "core",
          "why": "ISO weekday of a date, for weekend rules and opening hours.",
          "section": "date-arithmetic",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "The ISO 8601 day of the week for a date: 1 is Monday through 7 is Sunday.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "dayOfWeek"
          ],
          "signatures": [
            "pub fn day_of_week(iso: &str) -> i64"
          ],
          "reference": "fune!(dates.day-of-week@^1);  // then call day_of_week(…)",
          "url": "http://www.functionalweave.com/functions/dates.day-of-week"
        },
        {
          "id": "dates.is-leap-year",
          "tier": "optional",
          "why": "Whether a year is a leap year, for 365/366-day calculations.",
          "section": "date-arithmetic",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Whether a year is a Gregorian leap year: every 4th, except centuries, except every 400th.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "isLeapYear"
          ],
          "signatures": [
            "pub fn is_leap_year(year: i64) -> bool"
          ],
          "reference": "fune!(dates.is-leap-year@^1);  // then call is_leap_year(…)",
          "url": "http://www.functionalweave.com/functions/dates.is-leap-year"
        },
        {
          "id": "dates.overlap",
          "tier": "optional",
          "why": "Days two date ranges share, for prorating and clash checks.",
          "section": "date-arithmetic",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Days two date ranges have in common, with the end of each range stated as inclusive or exclusive.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "overlapDays"
          ],
          "signatures": [
            "pub fn overlap_days(a_start: &str, a_end: &str, b_start: &str, b_end: &str, end_inclusive: bool) -> i64"
          ],
          "reference": "fune!(dates.overlap@^1);  // then call overlap_days(…)",
          "url": "http://www.functionalweave.com/functions/dates.overlap"
        },
        {
          "id": "dates.age",
          "tier": "optional",
          "why": "Age in whole years on a date, handling 29 February birthdays.",
          "section": "date-arithmetic",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Age in whole years on a given date, with 29 February birthdays ageing on 1 March in other years.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "age"
          ],
          "signatures": [
            "pub fn age(birth_date: &str, on_date: &str) -> i64"
          ],
          "reference": "fune!(dates.age@^1);  // then call age(…)",
          "url": "http://www.functionalweave.com/functions/dates.age"
        }
      ],
      "gaps": []
    },
    {
      "key": "reporting-periods",
      "title": "Periods and reporting dates",
      "purpose": "Put dates into the periods reports are grouped by.",
      "from": "dates-basics",
      "members": [
        {
          "id": "dates.quarter",
          "tier": "core",
          "why": "Calendar and fiscal quarter of a date for any year-start month.",
          "section": "reporting-periods",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Calendar quarter and fiscal quarter of a date, with the fiscal year and quarter date ranges, for any start month.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "quarter"
          ],
          "signatures": [
            "pub fn quarter(iso: &str, fiscal_year_start_month: i64) -> Quarter"
          ],
          "reference": "fune!(dates.quarter@^1);  // then call quarter(…)",
          "url": "http://www.functionalweave.com/functions/dates.quarter"
        },
        {
          "id": "dates.week-number",
          "tier": "optional",
          "why": "ISO week number and week-year, for weekly reports.",
          "section": "reporting-periods",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "ISO 8601 week number and week-numbering year of a date: weeks start Monday, week 1 holds the first Thursday.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "weekNumber"
          ],
          "signatures": [
            "pub fn week_number(iso: &str) -> IsoWeek"
          ],
          "reference": "fune!(dates.week-number@^1);  // then call week_number(…)",
          "url": "http://www.functionalweave.com/functions/dates.week-number"
        },
        {
          "id": "dates.day-count-fraction",
          "tier": "optional",
          "why": "Year fraction by ACT/365F, ACT/360, 30/360 or ACT/ACT, for interest periods.",
          "section": "reporting-periods",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Year fraction between two dates by ACT/365F, ACT/360, 30/360, 30E/360 or ACT/ACT ISDA, as an exact fraction.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "dayCountFraction"
          ],
          "signatures": [
            "pub fn day_count_fraction(start_iso: &str, end_iso: &str, convention: &str) -> YearFraction"
          ],
          "reference": "fune!(dates.day-count-fraction@^1);  // then call day_count_fraction(…)",
          "url": "http://www.functionalweave.com/functions/dates.day-count-fraction"
        }
      ],
      "gaps": []
    },
    {
      "key": "working-days",
      "title": "Working days and holidays",
      "purpose": "Skip weekends and public holidays when counting or adding days.",
      "from": "dates-basics",
      "members": [
        {
          "id": "dates.bank-holidays",
          "tier": "core",
          "why": "UK bank holidays for a region and year, as gov.uk publishes them.",
          "section": "working-days",
          "from": "dates-basics",
          "version": "1.0.1",
          "summary": "UK bank and public holidays for a region and year, as published by gov.uk, including one-off holidays.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "bankHolidays"
          ],
          "signatures": [
            "pub fn bank_holidays(region: &str, year: i64) -> Vec<BankHoliday>"
          ],
          "reference": "fune!(dates.bank-holidays@^1);  // then call bank_holidays(…)",
          "url": "http://www.functionalweave.com/functions/dates.bank-holidays"
        },
        {
          "id": "dates.add-business-days",
          "tier": "core",
          "why": "Moves a date by working days, skipping weekends and a holiday list.",
          "section": "working-days",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Move a date forward or back by working days, skipping weekends and a caller-supplied holiday list.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "addBusinessDays"
          ],
          "signatures": [
            "pub fn add_business_days(iso: &str, days: i64, holidays: &[String]) -> String"
          ],
          "reference": "fune!(dates.add-business-days@^1);  // then call add_business_days(…)",
          "url": "http://www.functionalweave.com/functions/dates.add-business-days"
        },
        {
          "id": "dates.business-days-between",
          "tier": "core",
          "why": "Working days between two dates, for SLAs and notice periods.",
          "section": "working-days",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Working days between two dates, excluding weekends and a caller-supplied holiday list.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "businessDaysBetween"
          ],
          "signatures": [
            "pub fn business_days_between(start_iso: &str, end_iso: &str, holidays: &[String]) -> i64"
          ],
          "reference": "fune!(dates.business-days-between@^1);  // then call business_days_between(…)",
          "url": "http://www.functionalweave.com/functions/dates.business-days-between"
        }
      ],
      "gaps": []
    },
    {
      "key": "repeating-dates",
      "title": "Repeating schedules",
      "purpose": "Generate the dates of something that repeats.",
      "from": "dates-basics",
      "members": [
        {
          "id": "dates.recurrence",
          "tier": "optional",
          "why": "The next n dates of a rule: monthly on the 31st, last Friday, every two weeks.",
          "section": "repeating-dates",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "The next n dates of a repeating rule: monthly on a day, last weekday of the month, every k days or weeks, yearly.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "recurrence"
          ],
          "signatures": [
            "pub fn recurrence(rule: &RecurrenceRule, start_iso: &str, count: i64) -> Vec<String>"
          ],
          "reference": "fune!(dates.recurrence@^1);  // then call recurrence(…)",
          "url": "http://www.functionalweave.com/functions/dates.recurrence"
        }
      ],
      "gaps": []
    },
    {
      "key": "times",
      "title": "Times and durations",
      "purpose": "Work with times of day, durations and timestamps.",
      "from": "dates-basics",
      "members": [
        {
          "id": "time.duration",
          "tier": "optional",
          "why": "Parses and adds durations like 1h30m in whole minutes, and formats the total.",
          "section": "times",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Parse durations written as 1h30m, 90m or 01:30, add them up in whole minutes, and format the total.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "duration"
          ],
          "signatures": [
            "pub fn duration(parts: &[String]) -> Duration"
          ],
          "reference": "fune!(time.duration@^1);  // then call duration(…)",
          "url": "http://www.functionalweave.com/functions/time.duration"
        },
        {
          "id": "time.minutes-between",
          "tier": "optional",
          "why": "Minutes between two local date-times, across midnight.",
          "section": "times",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Minutes from one local date and time to another, correct across midnight; wall-clock time, no time zones.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "minutesBetween"
          ],
          "signatures": [
            "pub fn minutes_between(start_date: &str, start_time: &str, end_date: &str, end_time: &str) -> i64"
          ],
          "reference": "fune!(time.minutes-between@^1);  // then call minutes_between(…)",
          "url": "http://www.functionalweave.com/functions/time.minutes-between"
        },
        {
          "id": "time.round-to-increment",
          "tier": "optional",
          "why": "Rounds minutes to a billing increment such as 6 or 15.",
          "section": "times",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Round a duration in minutes to a billing increment such as 6 or 15 minutes, up, down or to nearest.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "roundToIncrement"
          ],
          "signatures": [
            "pub fn round_to_increment(minutes: i64, increment: i64, mode: &RoundingMode) -> i64"
          ],
          "reference": "fune!(time.round-to-increment@^1);  // then call round_to_increment(…)",
          "url": "http://www.functionalweave.com/functions/time.round-to-increment"
        },
        {
          "id": "time.iso-to-unix",
          "tier": "optional",
          "why": "RFC 3339 timestamps to Unix seconds.",
          "section": "times",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "An RFC 3339 timestamp with a Z or offset, such as 2026-09-26T13:00:00+01:00, to Unix time in whole seconds.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "isoToUnix"
          ],
          "signatures": [
            "pub fn iso_to_unix(timestamp: &str) -> i64"
          ],
          "reference": "fune!(time.iso-to-unix@^1);  // then call iso_to_unix(…)",
          "url": "http://www.functionalweave.com/functions/time.iso-to-unix"
        },
        {
          "id": "time.unix-to-iso",
          "tier": "optional",
          "why": "Unix seconds to an ISO 8601 UTC timestamp.",
          "section": "times",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Unix time in seconds to an ISO 8601 UTC timestamp such as 2026-09-26T12:00:00Z, for years 0001 to 9999.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "unixToIso"
          ],
          "signatures": [
            "pub fn unix_to_iso(seconds: i64) -> String"
          ],
          "reference": "fune!(time.unix-to-iso@^1);  // then call unix_to_iso(…)",
          "url": "http://www.functionalweave.com/functions/time.unix-to-iso"
        },
        {
          "id": "time.countdown",
          "tier": "optional",
          "why": "Seconds left until a moment and a 4:05 style timer text.",
          "section": "times",
          "from": "dates-basics",
          "version": "1.0.0",
          "summary": "Seconds left until a Unix time, whether it has passed, and a timer text like 4:05, for tokens or retry waits.",
          "status": "stable",
          "license": "NOASSERTION",
          "languages": [
            "typescript",
            "python",
            "rust"
          ],
          "available": true,
          "group": false,
          "functions": [
            "countdown"
          ],
          "signatures": [
            "pub fn countdown(until: i64, now: i64) -> Countdown"
          ],
          "reference": "fune!(time.countdown@^1);  // then call countdown(…)",
          "url": "http://www.functionalweave.com/functions/time.countdown"
        }
      ],
      "gaps": []
    }
  ],
  "gaps": [
    {
      "key": "rendering",
      "text": "Drawing: caps returns numbers and SVG path strings; putting them in SVG, canvas or a chart component is yours.",
      "section": null,
      "from": "dashboards"
    },
    {
      "key": "interactivity",
      "text": "Tooltips, zoom, pan, brushing and animation.",
      "section": null,
      "from": "dashboards"
    },
    {
      "key": "data-queries",
      "text": "Querying and aggregating the data at source (SQL, a metrics store); monitor.rollup covers time buckets in memory.",
      "section": null,
      "from": "dashboards"
    },
    {
      "key": "pie-donut-chart",
      "text": "A complete pie or donut chart: charts.shape gives pieAngles and arcPath, assembling legend and labels is yours.",
      "section": null,
      "from": "dashboards"
    },
    {
      "key": "time-zones",
      "text": "Time axes in local time zones: charts work in UTC dates and times.",
      "section": null,
      "from": "dashboards"
    },
    {
      "key": "locale-formatting",
      "text": "Showing dates in a user's language and format (\"3 octobre 2026\"): caps returns ISO dates, not localised text.",
      "section": null,
      "from": "dates-basics"
    },
    {
      "key": "non-uk-holidays",
      "text": "Public holidays outside the UK: dates.bank-holidays is UK only; pass another country's list to the working-day functions yourself.",
      "section": null,
      "from": "dates-basics"
    }
  ],
  "counts": {
    "members": 47,
    "core": 16,
    "optional": 31,
    "unreviewed": 0,
    "deprecated": [],
    "unavailable": [],
    "missing": [],
    "gaps": 7
  },
  "warnings": [],
  "url": "http://www.functionalweave.com/suites/dashboards",
  "owner": null
}