agentic-mermaid 0.1.1 → 0.2.0

package/src/pie/layout.ts

@@ -1,168 +0,0 @@
-import type {
-  PieChart,
-  PositionedPieChart,
-  PositionedPieSlice,
-  PositionedPieLegendItem,
-} from './types.ts'
-import type { RenderOptions } from '../types.ts'
-import { measureTextWidth } from '../text-metrics.ts'
-
-// ============================================================================
-// Pie chart layout engine
-//
-// Lays out a circle on the left and a vertical legend on the right. Slice
-// angles run clockwise from 12 o'clock, in source order, so the rendered
-// order matches Mermaid. All coordinates are direct pixel positions — the
-// renderer never recomputes geometry.
-// ============================================================================
-
-const PIE = {
-  paddingX: 24,
-  paddingY: 24,
-  titleFontSize: 18,
-  titleFontWeight: 600,
-  titleGap: 20,
-  radius: 95,
-  /** Gap between the circle and the legend column. */
-  circleToLegendGap: 32,
-  legendFontSize: 13,
-  legendFontWeight: 500,
-  legendSwatch: 14,
-  legendRowGap: 8,
-  legendSwatchToText: 8,
-} as const
-
-/** Format a numeric value compactly (drops trailing `.0`). */
-export function formatPieValue(value: number): string {
-  if (Number.isInteger(value)) return String(value)
-  return String(Math.round(value * 100) / 100)
-}
-
-/** Format a fraction in [0,1] as a percentage string with one decimal. */
-export function formatPiePercent(fraction: number): string {
-  return `${(fraction * 100).toFixed(1)}%`
-}
-
-/**
- * Build the SVG `d` for a pie wedge from `startAngle` to `endAngle`
- * (radians, clockwise from 12 o'clock). A full-circle slice (single entry)
- * is emitted as two arcs so it renders as a closed circle.
- */
-export function slicePath(cx: number, cy: number, r: number, startAngle: number, endAngle: number): string {
-  const sweep = endAngle - startAngle
-  // Full circle: SVG arcs can't draw a 360° arc in one segment.
-  if (sweep >= Math.PI * 2 - 1e-9) {
-    const x0 = round(cx)
-    const top = round(cy - r)
-    const bottom = round(cy + r)
-    return `M ${x0} ${top} A ${round(r)} ${round(r)} 0 1 1 ${x0} ${bottom} A ${round(r)} ${round(r)} 0 1 1 ${x0} ${top} Z`
-  }
-  const start = pointOnCircle(cx, cy, r, startAngle)
-  const end = pointOnCircle(cx, cy, r, endAngle)
-  const largeArc = sweep > Math.PI ? 1 : 0
-  return `M ${round(cx)} ${round(cy)} L ${round(start.x)} ${round(start.y)} ` +
-    `A ${round(r)} ${round(r)} 0 ${largeArc} 1 ${round(end.x)} ${round(end.y)} Z`
-}
-
-function pointOnCircle(cx: number, cy: number, r: number, angle: number): { x: number; y: number } {
-  // angle 0 = 12 o'clock (straight up); positive = clockwise.
-  return {
-    x: cx + r * Math.sin(angle),
-    y: cy - r * Math.cos(angle),
-  }
-}
-
-function round(n: number): number {
-  return Math.round(n * 100) / 100
-}
-
-/**
- * Lay out a parsed pie chart. Sorting is intentionally NOT applied — slices
- * follow source order, matching Mermaid's documented clockwise ordering.
- */
-export function layoutPieChart(
-  chart: PieChart,
-  options: RenderOptions = {},
-): PositionedPieChart {
-  const total = chart.entries.reduce((sum, e) => sum + e.value, 0)
-
-  const radius = PIE.radius
-  const diameter = radius * 2
-
-  // Title band.
-  const titleHeight = chart.title ? PIE.titleFontSize + PIE.titleGap : 0
-
-  // Legend metrics — one row per entry.
-  const legendLabels = chart.entries.map((e, i) => {
-    const fraction = total > 0 ? e.value / total : 0
-    const valuePart = chart.showData ? ` [${formatPieValue(e.value)}]` : ''
-    const text = `${e.label}${valuePart} (${formatPiePercent(fraction)})`
-    return { text, fraction, entry: e, index: i }
-  })
-  const legendTextWidth = legendLabels.length > 0
-    ? Math.max(...legendLabels.map(l => measureTextWidth(l.text, PIE.legendFontSize, PIE.legendFontWeight)))
-    : 0
-  const legendWidth = PIE.legendSwatch + PIE.legendSwatchToText + legendTextWidth
-  const legendRowHeight = Math.max(PIE.legendSwatch, PIE.legendFontSize) + PIE.legendRowGap
-  const legendHeight = legendLabels.length * legendRowHeight - PIE.legendRowGap
-
-  // Geometry: circle on the left, legend column on the right.
-  const contentTop = PIE.paddingY + titleHeight
-  const contentHeight = Math.max(diameter, legendHeight)
-  const cx = PIE.paddingX + radius
-  const cy = contentTop + contentHeight / 2
-
-  const legendX = PIE.paddingX + diameter + PIE.circleToLegendGap
-  const legendTop = contentTop + (contentHeight - legendHeight) / 2
-
-  const width = legendX + legendWidth + PIE.paddingX
-  const height = contentTop + contentHeight + PIE.paddingY
-
-  // Slices — clockwise from 12 o'clock, source order.
-  const slices: PositionedPieSlice[] = []
-  let angle = 0
-  chart.entries.forEach((entry, index) => {
-    const fraction = total > 0 ? entry.value / total : 0
-    const startAngle = angle
-    const endAngle = total > 0 ? angle + fraction * Math.PI * 2 : angle
-    angle = endAngle
-    slices.push({
-      label: entry.label,
-      value: entry.value,
-      fraction,
-      startAngle,
-      endAngle,
-      path: slicePath(cx, cy, radius, startAngle, endAngle),
-    })
-  })
-
-  // Legend rows.
-  const legend: PositionedPieLegendItem[] = legendLabels.map((l, i) => {
-    const rowY = legendTop + i * legendRowHeight
-    return {
-      label: l.entry.label,
-      value: l.entry.value,
-      fraction: l.fraction,
-      x: legendX,
-      y: rowY,
-      swatchSize: PIE.legendSwatch,
-      textX: legendX + PIE.legendSwatch + PIE.legendSwatchToText,
-      textY: rowY + PIE.legendSwatch / 2,
-    }
-  })
-
-  return {
-    width: round(width),
-    height: round(height),
-    title: chart.title
-      ? { text: chart.title, x: round(width / 2), y: PIE.paddingY + PIE.titleFontSize / 2 }
-      : undefined,
-    cx: round(cx),
-    cy: round(cy),
-    radius,
-    slices,
-    legend,
-    showData: chart.showData,
-    total,
-  }
-}

package/src/pie/parser.ts

@@ -1,136 +0,0 @@
-import type { PieChart, PieEntry } from './types.ts'
-import { accessibilityDirectiveEnd } from '../shared/accessibility-directives.ts'
-import { normalizeBrTags } from '../multiline-utils.ts'
-import { syntaxError } from '../shared/syntax-error.ts'
-
-// ============================================================================
-// Pie chart parser
-//
-// Parses Mermaid pie syntax into a PieChart structure.
-//
-// Supported syntax:
-//   pie [showData]
-//   title <text>
-//   "<label>" : <positive number>
-//
-// Faithfulness contract (see docs/project/lessons-learned.md, ER lesson):
-// malformed entries ERROR LOUDLY — they are never silently dropped. A line
-// that looks like a data entry (contains a `:` separator) but doesn't parse
-// as `"label" : positiveNumber` throws, rather than being skipped.
-// ============================================================================
-
-/** Entry line: a quoted label, a colon, and a numeric value. */
-const ENTRY_RE = /^"((?:[^"\\]|\\.)*)"\s*:\s*(.+)$/
-/** Mermaid pie values: positive numbers, up to two decimal places. */
-const NUMBER_RE = /^\+?(?:\d+(?:\.\d+)?|\.\d+)$/
-
-/**
- * Parse a Mermaid pie chart from preprocessed lines (trimmed, comment-stripped).
- * The first line is expected to be the `pie [showData]` header.
- *
- * Throws on malformed input:
- *   - a header that isn't `pie`
- *   - an entry whose value is not a positive number (negative / zero / NaN)
- *   - an entry-shaped line (`... : ...`) that isn't `"label" : number`
- *   - an unquoted label
- */
-export function parsePieChart(lines: string[]): PieChart {
-  if (lines.length === 0) {
-    throw new Error('Pie chart is empty')
-  }
-
-  const header = lines[0]!.trim()
-  const headerMatch = header.match(/^pie\b(.*)$/i)
-  if (!headerMatch) {
-    throw new Error(`Pie chart must start with "pie", got: "${header}"`)
-  }
-
-  // Header tail may carry `showData` and/or an inline `title <text>`.
-  let showData = false
-  let title: string | undefined
-  let tail = headerMatch[1]!.trim()
-  const showDataMatch = tail.match(/^showData\b\s*(.*)$/i)
-  if (showDataMatch) {
-    showData = true
-    tail = showDataMatch[1]!.trim()
-  }
-  const inlineTitle = tail.match(/^title\s+(.+)$/i)
-  if (inlineTitle) {
-    title = normalizeBrTags(inlineTitle[1]!.trim())
-  } else if (tail.length > 0) {
-    throw new Error(`Unexpected text after pie header: "${tail}"`)
-  }
-
-  const entries: PieEntry[] = []
-
-  for (let i = 1; i < lines.length; i++) {
-    const line = lines[i]!.trim()
-    if (line.length === 0 || line.startsWith('%%')) continue
-
-    // Mermaid-universal accessibility directives: accept and skip
-    // (sequence models them fully; pie has no aria slot to carry them yet).
-    const accEnd = accessibilityDirectiveEnd(lines, i)
-    if (accEnd !== -1) { i = accEnd; continue }
-
-    // showData may also appear as a standalone directive on its own line.
-    if (/^showData\s*$/i.test(line)) {
-      showData = true
-      continue
-    }
-
-    const titleMatch = line.match(/^title\s+(.+)$/i)
-    if (titleMatch) {
-      title = normalizeBrTags(titleMatch[1]!.trim())
-      continue
-    }
-
-    const entryMatch = line.match(ENTRY_RE)
-    if (entryMatch) {
-      const label = normalizeBrTags(decodeEscapes(entryMatch[1]!))
-      const rawValue = entryMatch[2]!.trim()
-      if (!NUMBER_RE.test(rawValue)) {
-        throw new Error(
-          `Pie slice "${label}" has invalid value "${rawValue}". ` +
-            'Values must be non-negative numbers.',
-        )
-      }
-      const value = Number.parseFloat(rawValue)
-      // Upstream parity: a zero-value slice is legal (renders as a zero-width
-      // wedge whose label still appears in the legend); only negatives and
-      // non-numbers are rejected.
-      if (!Number.isFinite(value) || value < 0) {
-        throw new Error(
-          `Pie slice "${label}" has invalid value "${rawValue}". ` +
-            'Values must be non-negative numbers.',
-        )
-      }
-      entries.push({ label, value })
-      continue
-    }
-
-    // A line that has a `:` looks like a data entry but didn't match the
-    // strict shape — surface it loudly instead of dropping it.
-    if (line.includes(':')) {
-      throw new Error(
-        `Invalid pie entry: "${line}". Expected: "label" : positiveNumber`,
-      )
-    }
-
-    // Anything else is unrecognized syntax for the pie family.
-    throw syntaxError({
-      what: `Unrecognized pie chart line: "${line}"`,
-      expectedForm: 'a title, showData, or a slice ("Label" : number)',
-      example: '"Free" : 60',
-    })
-  }
-
-  if (entries.length === 0) {
-    throw new Error('Pie chart must include at least one "label" : value entry')
-  }
-
-  return { title, showData, entries }
-}
-
-function decodeEscapes(raw: string): string {
-  return raw.replace(/\\(["\\])/g, '$1')
-}

package/src/pie/renderer.ts

@@ -1,234 +0,0 @@
-import type { PositionedPieChart } from './types.ts'
-import type { RenderContext } from '../types.ts'
-import type { DiagramColors } from '../theme.ts'
-import { svgOpenTag, buildStyleBlock, buildShadowDefs } from '../theme.ts'
-import { renderMultilineText, escapeXml } from '../multiline-utils.ts'
-import { formatPieValue, formatPiePercent } from './layout.ts'
-import { getSeriesColor, CHART_ACCENT_FALLBACK, isValidHex } from '../xychart/colors.ts'
-import { STROKE_WIDTHS, applyTextTransform, resolveRenderStyle } from '../styles.ts'
-import type { RenderStyleDefaults, ResolvedRenderStyle } from '../styles.ts'
-import type { SceneDoc, SceneNode } from '../scene/ir.ts'
-import * as marks from '../scene/marks.ts'
-import { DefaultBackend } from '../scene/backend.ts'
-
-// ============================================================================
-// Pie chart SVG renderer
-//
-// The chart is first lowered to a SceneGraph (SPEC §3.1): every visual mark
-// becomes a scene node carrying semantic fields (role, geometry, paint,
-// channels, stable id) plus its exact crisp serialization, built here from
-// the same inputs. renderPieSvg() is DefaultBackend serialization of that
-// scene, so the default path stays byte-identical to the historical string
-// renderer (corpus-gated by svg-equivalence.test.ts).
-//
-// Visual language:
-//   - circle of clockwise slices (SVG <path> wedges) with a theme-derived,
-//     same-family palette (reuses the xychart getSeriesColor utility)
-//   - a vertical legend: color swatch + label, with percentage and, when
-//     `showData`, the raw numeric value
-//   - optional title centered above the chart
-//
-// Deterministic: no Math.random / Date.now. Slice colors come from RenderContext.
-// ============================================================================
-
-const PIE = {
-  titleFontSize: 18,
-  titleFontWeight: 600,
-  legendFontSize: 13,
-  legendFontWeight: 500,
-  sliceStrokeWidth: 1.5,
-} as const
-
-const PIE_STYLE_DEFAULTS: RenderStyleDefaults = {
-  nodeLabelFontSize: PIE.legendFontSize,
-  edgeLabelFontSize: PIE.legendFontSize,
-  groupHeaderFontSize: PIE.titleFontSize,
-  nodeLabelFontWeight: PIE.legendFontWeight,
-  edgeLabelFontWeight: PIE.legendFontWeight,
-  groupHeaderFontWeight: PIE.titleFontWeight,
-  nodePaddingX: 0,
-  nodePaddingY: 0,
-  nodeLineWidth: PIE.sliceStrokeWidth,
-  edgeLineWidth: STROKE_WIDTHS.connector,
-  groupCornerRadius: 0,
-  groupPaddingX: 0,
-  groupPaddingY: 0,
-  groupLineWidth: STROKE_WIDTHS.outerBox,
-}
-
-/**
- * Render a positioned pie chart as an SVG string.
- */
-export function renderPieSvg(
-  ctx: RenderContext<PositionedPieChart>,
-): string {
-  return DefaultBackend.render(lowerPieScene(ctx), { seed: 0 })
-}
-
-/**
- * Lower a positioned pie chart to the SceneGraph IR. Mark order matches the
- * historical parts[] order exactly; DefaultBackend joins crisps with '\n'.
- */
-export function lowerPieScene(
-  ctx: RenderContext<PositionedPieChart>,
-): SceneDoc {
-  const { positioned: chart, colors, options } = ctx
-  const font = colors.font ?? 'Inter'
-  const transparent = options.transparent ?? false
-  const style = resolveRenderStyle(options, PIE_STYLE_DEFAULTS)
-  const parts: SceneNode[] = []
-
-  // Document shell: custom pie <svg> open tag + shared style block + optional
-  // shadow defs + pie <style>, in the exact pushed order. Every piece is
-  // derivable from the prelude fields (shadow defs from colors, pie CSS via
-  // extraCss), so styled backends can re-derive the shell without parsing.
-  const headParts: string[] = []
-  headParts.push(openPieSvgTag(chart, colors, transparent))
-  headParts.push(buildStyleBlock(font, false, colors.shadow, colors.embedFontImport))
-  const shadowDefs = buildShadowDefs(colors)
-  if (shadowDefs) headParts.push(`<defs>${shadowDefs}</defs>`)
-  const pieCss = pieStyles(style)
-  headParts.push(pieCss)
-  parts.push(marks.prelude(
-    {
-      id: 'prelude',
-      width: chart.width,
-      height: chart.height,
-      colors,
-      transparent,
-      font,
-      hasMonoFont: false,
-      extraCss: pieCss,
-    },
-    headParts.join('\n'),
-  ))
-
-  // Slices. Duplicate labels get occurrence suffixes so scene ids stay
-  // unique (the §8 seed contract keys substreams on them).
-  const labelOccurrence = new Map<string, number>()
-  const occurrenceId = (prefix: string, label: string) => {
-    const key = `${prefix}:${label}`
-    const k = labelOccurrence.get(key) ?? 0
-    labelOccurrence.set(key, k + 1)
-    return k === 0 ? key : `${key}#${k}`
-  }
-  for (let index = 0; index < chart.slices.length; index++) {
-    const slice = chart.slices[index]!
-    const pct = formatPiePercent(slice.fraction)
-    const fill = sliceColor(index, colors)
-    parts.push(marks.shape(
-      {
-        id: occurrenceId('slice', slice.label),
-        role: 'pie-slice',
-        geometry: { kind: 'path', d: slice.path },
-        // Stroke comes from the .pie-slice rule in pieStyles().
-        paint: { fill, stroke: style.nodeBorderColor ?? 'var(--bg)', strokeWidth: String(style.nodeLineWidth) },
-        channels: { category: slice.label, value: slice.fraction },
-      },
-      `<path class="pie-slice" d="${slice.path}" fill="${fill}" ` +
-        `data-label="${escapeXml(slice.label)}" data-value="${slice.value}" data-percent="${pct}" />`,
-    ))
-  }
-
-  // Legend.
-  for (let index = 0; index < chart.legend.length; index++) {
-    const item = chart.legend[index]!
-    const fill = sliceColor(index, colors)
-    parts.push(marks.shape(
-      {
-        id: occurrenceId('legend', item.label),
-        role: 'legend',
-        geometry: { kind: 'rect', x: item.x, y: item.y, width: item.swatchSize, height: item.swatchSize, rx: 2, ry: 2 },
-        // Stroke comes from the .pie-legend-swatch rule in pieStyles().
-        paint: {
-          fill,
-          stroke: style.nodeBorderColor ?? 'var(--_node-stroke)',
-          strokeWidth: String(style.nodeBorderColor ? Math.max(1, style.nodeLineWidth) : 1),
-        },
-        channels: { category: item.label, value: item.fraction },
-      },
-      `<rect class="pie-legend-swatch" x="${item.x}" y="${item.y}" width="${item.swatchSize}" height="${item.swatchSize}" rx="2" ry="2" fill="${fill}" />`,
-    ))
-    const valuePart = chart.showData ? ` [${formatPieValue(item.value)}]` : ''
-    const text = applyTextTransform(`${item.label}${valuePart} (${formatPiePercent(item.fraction)})`, style.nodeTextTransform)
-    parts.push(marks.text(
-      {
-        id: occurrenceId('legend-label', item.label),
-        role: 'legend',
-        text,
-        x: item.textX,
-        y: item.textY,
-        fontSize: style.nodeLabelFontSize,
-        anchor: 'start',
-        // Fill comes from the .pie-legend-text rule in pieStyles().
-        paint: { fill: style.nodeTextColor ?? 'var(--_text)' },
-        channels: { category: item.label, value: item.fraction },
-      },
-      renderMultilineText(
-        text,
-        item.textX,
-        item.textY,
-        style.nodeLabelFontSize,
-        `class="pie-legend-text" text-anchor="start" dominant-baseline="middle" font-size="${style.nodeLabelFontSize}" font-weight="${style.nodeLabelFontWeight}"${letterAttr(style.nodeLetterSpacing)}`,
-      ),
-    ))
-  }
-
-  // Title.
-  if (chart.title) {
-    const title = applyTextTransform(chart.title.text, style.groupTextTransform)
-    parts.push(marks.text(
-      {
-        id: 'title',
-        role: 'title',
-        text: title,
-        x: chart.title.x,
-        y: chart.title.y,
-        fontSize: style.groupHeaderFontSize,
-        anchor: 'middle',
-        // Fill comes from the .pie-title rule in pieStyles().
-        paint: { fill: style.groupTextColor ?? style.nodeTextColor ?? 'var(--_text)' },
-      },
-      renderMultilineText(
-        title,
-        chart.title.x,
-        chart.title.y,
-        style.groupHeaderFontSize,
-        `class="pie-title" text-anchor="middle" dominant-baseline="middle" font-size="${style.groupHeaderFontSize}" font-weight="${style.groupHeaderFontWeight}"${letterAttr(style.groupLetterSpacing)}`,
-      ),
-    ))
-  }
-
-  parts.push(marks.raw({ id: 'svg-close', role: 'chrome' }, '</svg>'))
-
-  return { family: 'pie', width: chart.width, height: chart.height, colors, parts }
-}
-
-function sliceColor(index: number, colors: DiagramColors): string {
-  const safeAccent = colors.accent && isValidHex(colors.accent) ? colors.accent : CHART_ACCENT_FALLBACK
-  const safeBg = colors.bg && isValidHex(colors.bg) ? colors.bg : undefined
-  return getSeriesColor(index, safeAccent, safeBg)
-}
-
-function openPieSvgTag(
-  chart: PositionedPieChart,
-  colors: DiagramColors,
-  transparent: boolean,
-): string {
-  return svgOpenTag(chart.width, chart.height, colors, transparent, {
-    attrs: { role: 'img', 'aria-roledescription': 'pie chart' },
-  })
-}
-
-function pieStyles(style: ResolvedRenderStyle): string {
-  return `<style>
-  .pie-slice { stroke: ${style.nodeBorderColor ?? 'var(--bg)'}; stroke-width: ${style.nodeLineWidth}; }
-  .pie-legend-swatch { stroke: ${style.nodeBorderColor ?? 'var(--_node-stroke)'}; stroke-width: ${style.nodeBorderColor ? Math.max(1, style.nodeLineWidth) : 1}; }
-  .pie-legend-text { fill: ${style.nodeTextColor ?? 'var(--_text)'}; }
-  .pie-title { fill: ${style.groupTextColor ?? style.nodeTextColor ?? 'var(--_text)'}; }
-</style>`
-}
-
-function letterAttr(value: number): string {
-  return value !== 0 ? ` letter-spacing="${value}"` : ''
-}

package/src/pie/types.ts

@@ -1,82 +0,0 @@
-// ============================================================================
-// Pie chart types
-//
-// Models Mermaid pie chart diagrams in parsed and positioned form.
-//
-// Mermaid pie syntax:
-//   pie [showData]
-//   [title <text>]
-//   "<label>" : <positive number>
-//   ...
-//
-// `showData` renders the raw numeric value alongside each legend label.
-// Values must be positive numbers (> 0); negative values are a hard error.
-// ============================================================================
-
-import type { PositionedDiagram } from '../types.ts'
-
-/** A single labelled slice of the pie. */
-export interface PieEntry {
-  /** The slice label (contents of the `"..."` quotes). */
-  label: string
-  /** The slice value — a positive number (supported to two decimal places). */
-  value: number
-}
-
-/** Parsed pie chart — logical structure from Mermaid text. */
-export interface PieChart {
-  /** Optional diagram title (`title <text>`). */
-  title?: string
-  /** When true (`pie showData`), render the numeric value after each label. */
-  showData: boolean
-  /** Slices in source order. Pie slices are drawn clockwise in this order. */
-  entries: PieEntry[]
-}
-
-// ============================================================================
-// Positioned pie chart — ready for SVG rendering
-// ============================================================================
-
-export interface PositionedPieSlice {
-  /** The original entry label. */
-  label: string
-  /** The original entry value. */
-  value: number
-  /** value / total, in [0, 1]. */
-  fraction: number
-  /** Start angle in radians (clockwise from 12 o'clock). */
-  startAngle: number
-  /** End angle in radians. */
-  endAngle: number
-  /** SVG path `d` attribute for the slice wedge. */
-  path: string
-}
-
-export interface PositionedPieLegendItem {
-  label: string
-  value: number
-  fraction: number
-  /** Top-left of the swatch. */
-  x: number
-  y: number
-  swatchSize: number
-  /** Baseline-ish y for the legend text. */
-  textX: number
-  textY: number
-}
-
-export interface PositionedPieChart extends PositionedDiagram {
-  width: number
-  height: number
-  title?: { text: string; x: number; y: number }
-  /** Pie circle center + radius. */
-  cx: number
-  cy: number
-  radius: number
-  slices: PositionedPieSlice[]
-  legend: PositionedPieLegendItem[]
-  /** Whether numeric values are shown in the legend (`showData`). */
-  showData: boolean
-  /** Sum of all entry values (for percentage / value formatting). */
-  total: number
-}