@umriss-ui/calculation 0.5.3 → 0.6.1

package/docs/llms-full.md

@@ -1,4 +1,4 @@
-# @umriss-ui/calculation 0.5.3
+# @umriss-ui/calculation 0.6.1
 
 > React calculation view for data-dense applications - a derivation written as it is shown, evaluated by the library, folded and read line by line.
 
@@ -1114,7 +1114,7 @@ Demo page: https://romanhaendler.github.io/umriss-ui/calculation/calculation/
 
 There is no prop for a result. Every derived number is computed with the operator its line names, at full precision; only the screen rounds.
 
-The nesting is the fold structure and the child order is the operand order. What TypeScript cannot check – a `Ref` to nothing, a circle through references, a wrong operand count, a duplicate id, a component of your own wrapping `Given` – fails on the first render with a message saying which ([ADR-0027](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0027-a-calculation-is-written-as-it-is-shown.md)).
+The nesting is the fold structure and the child order is the operand order. What TypeScript cannot check – a `Ref` to nothing, a circle through references, a wrong operand count, a duplicate id, a component of your own wrapping `Given`, `emphasis` or `rule` on the Result – fails on the first render with a message saying which ([ADR-0027](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0027-a-calculation-is-written-as-it-is-shown.md)). `emphasis` and `rule` set any other line apart without CSS ([ADR-0049](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0049-a-sum-takes-rows-from-data.md)).
 
 Every line is read as one sentence by a screen reader, and every derivation is a disclosure: its button says whether it shows or hides how the line is derived.
 
@@ -1378,6 +1378,120 @@ export default function Invoice() {
 }
 ```
 
+##### A stronger line
+
+`emphasis="strong"` sets a line apart to be read first – here the production cost, the figure a costing sheet is usually questioned on. It changes how the line looks, never what it says: its sentence for a screen reader stays the same. Any quantity takes it but the Result, which is already the heaviest line; there it fails on the first render.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Minus, Plus, Times } from "@umriss-ui/calculation";
+
+export default function AStrongerLine() {
+  return (
+    <Calculation aria-label="Offer price A-2041">
+      <Chain>
+        <Given label="Direct material" value={1840} unit="€" decimals={2} />
+        <Plus label="Material overhead" value={220.8} unit="€" decimals={2} />
+        <Plus label="Direct labour" value={960} unit="€" decimals={2} />
+        <Plus label="Production overhead" value={432} unit="€" decimals={2} />
+        <Interim label="Production cost" unit="€" decimals={2} emphasis="strong" />
+        <Minus label="Customer discount" value={86.4} unit="€" decimals={2} />
+        <Interim label="Net cost" unit="€" decimals={2} />
+        <Times label="Profit mark-up" value={1.08} />
+        <Interim label="Net offer price" unit="€" decimals={2} />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+##### A quieter line
+
+`emphasis="muted"` lets a line recede – a small position the reader may skip. It still counts in full: the interim below includes it, and a reader who redoes the sum needs it.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Plus } from "@umriss-ui/calculation";
+
+export default function AQuieterLine() {
+  return (
+    <Calculation aria-label="Tour cost, 17 March">
+      <Chain>
+        <Given label="Driver, 8.5 h" value={340} unit="€" decimals={2} />
+        <Plus label="Diesel, 212 km" value={98.6} unit="€" decimals={2} />
+        <Plus label="Vehicle, day rate" value={145} unit="€" decimals={2} />
+        <Plus label="Tolls" value={4.2} unit="€" decimals={2} emphasis="muted" />
+        <Plus label="Parking" value={3.5} unit="€" decimals={2} emphasis="muted" />
+        <Interim label="Cost of the tour" unit="€" decimals={2} />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+##### A rule above
+
+`rule="above"` rules a line off from the ones before it, where a new section starts that needs no interim of its own: here the deductions after the earnings. An interim draws its rule across the figures only; this one runs across the whole row.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Minus, Plus } from "@umriss-ui/calculation";
+
+export default function ARuleAbove() {
+  return (
+    <Calculation aria-label="Payslip, March">
+      <Chain>
+        <Given label="Gross salary" value={4200} unit="€" decimals={2} />
+        <Plus label="Night work bonus" value={84} unit="€" decimals={2} />
+        <Plus label="Travel allowance" value={60} unit="€" decimals={2} />
+        <Minus label="Income tax" value={640.2} unit="€" decimals={2} rule="above" />
+        <Minus label="Church tax" value={51.2} unit="€" decimals={2} />
+        <Minus label="Social security contributions" value={889.6} unit="€" decimals={2} />
+        <Interim label="Net salary" unit="€" decimals={2} />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+##### Emphasis inside a group
+
+Emphasis and rule work inside an opened derivation too. Its numbers already recede, so a muted line there recedes one step further; a strong one stands out from the group, and a rule parts the group where its rows do not.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Plus, Sum } from "@umriss-ui/calculation";
+
+/* Cost centres from the controlling system. */
+const CENTRES = [
+  { id: "4100", name: "4100 Assembly", amount: 18400, emphasis: "strong" as const },
+  { id: "4200", name: "4200 Paint shop", amount: 9200 },
+  { id: "4300", name: "4300 Quality", amount: 6100 },
+  { id: "9900", name: "9900 Allocations", amount: 740, emphasis: "muted" as const, rule: "above" as const },
+];
+
+export default function EmphasisInsideAGroup() {
+  return (
+    <Calculation aria-label="Production cost, March">
+      <Chain>
+        <Given label="Material" value={52800} unit="€" />
+        <Plus>
+          <Sum label="Cost centres" unit="€">
+            {CENTRES.map((centre) => (
+              <Given
+                key={centre.id}
+                label={centre.name}
+                value={centre.amount}
+                unit="€"
+                emphasis={centre.emphasis}
+                rule={centre.rule}
+              />
+            ))}
+          </Sum>
+        </Plus>
+        <Interim label="Production cost" unit="€" />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
 #### When to use something else
 
 - A single figure with its verdict, without the working → `Stat` from @umriss-ui/core
@@ -1404,8 +1518,8 @@ Name the calculation with `aria-label`, which lands on the list; without it a re
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `children` *required* | `ReactNode` | — | The result: exactly one quantity - a tree (`<Sum>`, `<Difference>`, `<Product>`, `<Quotient>` with their operands, `<Given>` as leaves) or a `<Chain>`, the two mixing freely; `<Ref>` for a quantity defined elsewhere.<br>Shown in: [Two numbers and a sum](#/calculation/first-sum), [Write a tree](#/calculation/oee), [Write a chain](#/calculation/invoice) and 34 more |
-| `metrics` | `readonly `[`Metric`](#/metrics/type-Metric)`[]` | — | Several numbers per quantity, side by side - headcount and full-time equivalents of the same teams ([ADR-0038](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0038-a-calculation-can-carry-several-metrics.md)). Every `value` is then an object with a number for each metric id; unit and places are the metric's. A calculation with metrics only adds and subtracts, and assesses no target or limits.<br>Shown in: [Headcount and full-time equivalents (Metrics)](#/metrics/two-teams), [A number one metric does not have (Metrics)](#/metrics/not-recorded), [Team, cost centre, business line (Metrics)](#/metrics/business-line) and 3 more |
+| `children` *required* | `ReactNode` | — | The result: exactly one quantity - a tree (`<Sum>`, `<Difference>`, `<Product>`, `<Quotient>` with their operands, `<Given>` as leaves) or a `<Chain>`, the two mixing freely; `<Ref>` for a quantity defined elsewhere.<br>Shown in: [Two numbers and a sum](#/calculation/first-sum), [Write a tree](#/calculation/oee), [Write a chain](#/calculation/invoice) and 48 more |
+| `metrics` | `readonly `[`Metric`](#/metrics/type-Metric)`[]` | — | Several numbers per quantity, side by side - headcount and full-time equivalents of the same teams ([ADR-0038](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0038-a-calculation-can-carry-several-metrics.md)). Every `value` is then an object with a number for each metric id; unit and places are the metric's. A calculation with metrics only adds and subtracts, and assesses no target or limits.<br>Shown in: [Rows of both signs with metrics (Rows from data)](#/rows-from-data/rows-of-both-signs-with-metrics), [Headcount and full-time equivalents (Metrics)](#/metrics/two-teams), [A number one metric does not have (Metrics)](#/metrics/not-recorded) and 4 more |
 
 Also takes every attribute of the rendered element – without `children`.
 
@@ -1426,7 +1540,7 @@ import { Sum, Difference, Product, Quotient, Ref } from "@umriss-ui/calculation"
 
 Demo page: https://romanhaendler.github.io/umriss-ui/calculation/tree/
 
-`Sum`, `Product` and `Difference` (a − b − c) take two or more operands, `Quotient` exactly two. A quantity used twice is defined once with an `id` and stands elsewhere as a `Ref`, which shows its name and number but never its derivation again.
+`Product` and `Difference` (a − b − c) take two or more operands, `Quotient` exactly two, and `Sum` any number – rows from data, one or none included (see [Rows from data](#/rows-from-data)). A quantity used twice is defined once with an `id` and stands elsewhere as a `Ref`, which shows its name and number but never its derivation again.
 
 #### Examples
 
@@ -1633,22 +1747,24 @@ The keys of [Calculation](#/calculation/keyboard-calculation) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `children` | `ReactNode` | — | The operands, in order: quantities, givens and references.<br>Shown in: [Show a share against a target](#/tree/share-with-target), [Take several amounts away](#/tree/difference-of-three), [Multiply quantities with units](#/tree/product-with-units) and 29 more |
-| `label` *required* | `string` | — | What the quantity is called. It stands on its line, wherever it is an operand, and in the accessible sentence. From `QuantityProps`.<br>Shown in: [Show a share against a target](#/tree/share-with-target), [Take several amounts away](#/tree/difference-of-three), [Multiply quantities with units](#/tree/product-with-units) and 34 more |
-| `id` | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once. From `QuantityProps`.<br>Shown in: [Use a quantity twice](#/tree/used-twice), [The availability of a service (Installation)](#/installation/availability), [Write a tree (Calculation)](#/calculation/oee) and 9 more |
-| `unit` | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra. From `QuantityProps`.<br>Shown in: [Show a share against a target](#/tree/share-with-target), [Take several amounts away](#/tree/difference-of-three), [Multiply quantities with units](#/tree/product-with-units) and 28 more |
-| `format` | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation. From `QuantityProps`.<br>Shown in: [Show a share against a target](#/tree/share-with-target), [Use a quantity twice](#/tree/used-twice), [Build operands from data](#/tree/from-data) and 16 more |
-| `decimals` | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value. From `QuantityProps`.<br>Shown in: [Multiply quantities with units](#/tree/product-with-units), [Build operands from data](#/tree/from-data), [Hold a figure to its limits](#/tree/limits) and 18 more |
+| `children` | `ReactNode` | — | The operands, in order: quantities, givens and references.<br>Shown in: [Show a share against a target](#/tree/share-with-target), [Take several amounts away](#/tree/difference-of-three), [Multiply quantities with units](#/tree/product-with-units) and 40 more |
+| `label` *required* | `string` | — | What the quantity is called. It stands on its line, wherever it is an operand, and in the accessible sentence. From `QuantityProps`.<br>Shown in: [Show a share against a target](#/tree/share-with-target), [Take several amounts away](#/tree/difference-of-three), [Multiply quantities with units](#/tree/product-with-units) and 48 more |
+| `id` | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once. From `QuantityProps`.<br>Shown in: [Use a quantity twice](#/tree/used-twice), [The availability of a service (Installation)](#/installation/availability), [Write a tree (Calculation)](#/calculation/oee) and 10 more |
+| `unit` | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra. From `QuantityProps`.<br>Shown in: [Show a share against a target](#/tree/share-with-target), [Take several amounts away](#/tree/difference-of-three), [Multiply quantities with units](#/tree/product-with-units) and 41 more |
+| `format` | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation. From `QuantityProps`.<br>Shown in: [Show a share against a target](#/tree/share-with-target), [Use a quantity twice](#/tree/used-twice), [Build operands from data](#/tree/from-data) and 17 more |
+| `decimals` | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value. From `QuantityProps`.<br>Shown in: [Multiply quantities with units](#/tree/product-with-units), [Build operands from data](#/tree/from-data), [Hold a figure to its limits](#/tree/limits) and 29 more |
 | `target` | `number` | — | The value this quantity is meant to reach - missed, never violated. From `QuantityProps`.<br>Shown in: [Show a share against a target](#/tree/share-with-target), [The availability of a service (Installation)](#/installation/availability), [Write a tree (Calculation)](#/calculation/oee) and 5 more |
 | `limits` | `readonly `[`Limit`](#type-Limit)`[]` | — | Bounds the quantity is assessed against, through core's `assess()`. From `QuantityProps`.<br>Shown in: [Hold a figure to its limits](#/tree/limits), [Hold an interim to its limits (Chain)](#/chain/error-budget), [Say where a number came from (Given)](#/given/where-it-came-from) and 4 more |
 | `explanation` | `string` | — | A sentence of plain text beside the line: why the quantity is here, or what it means. From `QuantityProps`.<br>Shown in: [Say where a number came from (Given)](#/given/where-it-came-from), [A number one metric does not have (Metrics)](#/metrics/not-recorded), [Staff movement as a chain (Metrics)](#/metrics/staff-movement) and 1 more |
 | `aside` | `ReactNode` | — | Content of the caller's own beside the line - a sparkline, a link. It never takes part in the calculation. From `QuantityProps`.<br>Shown in: [Say where a number came from (Given)](#/given/where-it-came-from) |
+| `emphasis` | `"strong" \| "muted"` | — | How much the line stands out among the others ([ADR-0049](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0049-a-sum-takes-rows-from-data.md)): `strong` to be read first, `muted` to recede - a muted line still counts in full. Not on the Result, which is already the heaviest line. From `QuantityProps`.<br>Shown in: [A stronger line (Calculation)](#/calculation/a-stronger-line), [A quieter line (Calculation)](#/calculation/a-quieter-line), [Emphasis inside a group (Calculation)](#/calculation/emphasis-inside-a-group) |
+| `rule` | `"above"` | — | `above` rules the line off from the ones before it, where a section starts that is not an interim. Not on the Result. From `QuantityProps`.<br>Shown in: [A rule above (Calculation)](#/calculation/a-rule-above), [Emphasis inside a group (Calculation)](#/calculation/emphasis-inside-a-group) |
 
 ##### `RefProps`
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `to` *required* | `string` | — | The `id` of the quantity this reference stands for.<br>Shown in: [Use a quantity twice](#/tree/used-twice), [The availability of a service (Installation)](#/installation/availability), [Write a tree (Calculation)](#/calculation/oee) and 9 more |
+| `to` *required* | `string` | — | The `id` of the quantity this reference stands for.<br>Shown in: [Use a quantity twice](#/tree/used-twice), [The availability of a service (Installation)](#/installation/availability), [Write a tree (Calculation)](#/calculation/oee) and 10 more |
 
 ##### Types on this page
 
@@ -1787,7 +1903,7 @@ export default function MarkUpAndVat() {
 
 ##### Fold a group of lines into one
 
-A chain in view never folds; to show items only on request, put them into one line as a tree: a `Sum` held by a `Minus`.
+A chain in view never folds; to show items only on request, put them into one line as a tree: a `Sum` held by a `Minus` – a `Minus`, because contributions are positive by nature. Rows of either sign from data go into a `Plus` instead; the page Rows from data shows every case.
 
 ```tsx
 import { Calculation, Chain, Given, Interim, Minus, Plus, Product, Ref, Sum } from "@umriss-ui/calculation";
@@ -1939,40 +2055,44 @@ The keys of [Calculation](#/calculation/keyboard-calculation) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `children` | `ReactNode` | — | The operands, top to bottom: a first quantity with no operator, then `Plus`, `Minus`, `Times` and `DividedBy` with their operands and `Interim`s naming the value where they stand. The last line is an `Interim`; a `Times` or `DividedBy` stands alone between two named values.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 10 more |
+| `children` | `ReactNode` | — | The operands, top to bottom: a first quantity with no operator, then `Plus`, `Minus`, `Times` and `DividedBy` with their operands and `Interim`s naming the value where they stand. The last line is an `Interim`; a `Times` or `DividedBy` stands alone between two named values.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 22 more |
 
 ##### `ChainOperandProps`
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `label` | `string` | — | The operand's name, where the line is a given written in place. Left out where the line holds a quantity as its child.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 7 more |
-| `value` | `number \| null \| `[`MetricValues`](#type-MetricValues) | — | The operand's number, where the line is a given written in place. Absent as for a `Given`: the line and every interim after it are absent, with the reason. With `metrics`, an object by metric id, as on a `Given`.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 7 more |
-| `children` | `ReactNode` | — | Instead of `label` and `value`: exactly one quantity - a tree, a `<Ref>` or a `<Chain>`.<br>Shown in: [Fold a group of lines into one](#/chain/payslip), [Write a chain (Calculation)](#/calculation/invoice), [Read in German (Given)](#/given/in-german) and 3 more |
+| `label` | `string` | — | The operand's name, where the line is a given written in place. Left out where the line holds a quantity as its child.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 17 more |
+| `value` | `number \| null \| `[`MetricValues`](#type-MetricValues) | — | The operand's number, where the line is a given written in place. Absent as for a `Given`: the line and every interim after it are absent, with the reason. With `metrics`, an object by metric id, as on a `Given`.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 17 more |
+| `children` | `ReactNode` | — | Instead of `label` and `value`: exactly one quantity - a tree, a `<Ref>` or a `<Chain>`.<br>Shown in: [Fold a group of lines into one](#/chain/payslip), [Write a chain (Calculation)](#/calculation/invoice), [Emphasis inside a group (Calculation)](#/calculation/emphasis-inside-a-group) and 12 more |
 | `source` | `string` | — | Where the number came from: a system, a report, a person. From `GivenProps`.<br>Shown in: [Say where a number came from (Given)](#/given/where-it-came-from), [State when a number was true (Given)](#/given/as-of), [Staff movement as a chain (Metrics)](#/metrics/staff-movement) and 7 more |
 | `asOf` | `Date \| number` | — | When the number was true - not when it was fetched. From `GivenProps`.<br>Shown in: [Say where a number came from (Given)](#/given/where-it-came-from), [State when a number was true (Given)](#/given/as-of), [The cost per stop of a day's tours (Worked examples)](#/worked-examples/cost-per-tour) |
 | `ages` | [`FreshnessAges`](#type-FreshnessAges) | — | The ages at which `asOf` turns stale and lost. With both, the given carries a freshness through core; with `asOf` alone, only the time. From `GivenProps`.<br>Shown in: [Say where a number came from (Given)](#/given/where-it-came-from), [The cost per stop of a day's tours (Worked examples)](#/worked-examples/cost-per-tour) |
-| `id` | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once. From `QuantityProps`.<br>Shown in: [Fold a group of lines into one](#/chain/payslip), [Put a chain inside a tree](#/chain/chain-in-a-tree), [The availability of a service (Installation)](#/installation/availability) and 9 more |
-| `unit` | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra. From `QuantityProps`.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 28 more |
-| `format` | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation. From `QuantityProps`.<br>Shown in: [Fold a group of lines into one](#/chain/payslip), [Put a chain inside a tree](#/chain/chain-in-a-tree), [Hold an interim to its limits](#/chain/error-budget) and 16 more |
-| `decimals` | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value. From `QuantityProps`.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 18 more |
+| `id` | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once. From `QuantityProps`.<br>Shown in: [Fold a group of lines into one](#/chain/payslip), [Put a chain inside a tree](#/chain/chain-in-a-tree), [The availability of a service (Installation)](#/installation/availability) and 10 more |
+| `unit` | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra. From `QuantityProps`.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 41 more |
+| `format` | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation. From `QuantityProps`.<br>Shown in: [Fold a group of lines into one](#/chain/payslip), [Put a chain inside a tree](#/chain/chain-in-a-tree), [Hold an interim to its limits](#/chain/error-budget) and 17 more |
+| `decimals` | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value. From `QuantityProps`.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 29 more |
 | `target` | `number` | — | The value this quantity is meant to reach - missed, never violated. From `QuantityProps`.<br>Shown in: [Put a chain inside a tree](#/chain/chain-in-a-tree), [The availability of a service (Installation)](#/installation/availability), [Write a tree (Calculation)](#/calculation/oee) and 5 more |
 | `limits` | `readonly `[`Limit`](#type-Limit)`[]` | — | Bounds the quantity is assessed against, through core's `assess()`. From `QuantityProps`.<br>Shown in: [Hold an interim to its limits](#/chain/error-budget), [Hold a figure to its limits (Tree)](#/tree/limits), [Say where a number came from (Given)](#/given/where-it-came-from) and 4 more |
 | `explanation` | `string` | — | A sentence of plain text beside the line: why the quantity is here, or what it means. From `QuantityProps`.<br>Shown in: [Say where a number came from (Given)](#/given/where-it-came-from), [A number one metric does not have (Metrics)](#/metrics/not-recorded), [Staff movement as a chain (Metrics)](#/metrics/staff-movement) and 1 more |
 | `aside` | `ReactNode` | — | Content of the caller's own beside the line - a sparkline, a link. It never takes part in the calculation. From `QuantityProps`.<br>Shown in: [Say where a number came from (Given)](#/given/where-it-came-from) |
+| `emphasis` | `"strong" \| "muted"` | — | How much the line stands out among the others ([ADR-0049](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0049-a-sum-takes-rows-from-data.md)): `strong` to be read first, `muted` to recede - a muted line still counts in full. Not on the Result, which is already the heaviest line. From `QuantityProps`.<br>Shown in: [A stronger line (Calculation)](#/calculation/a-stronger-line), [A quieter line (Calculation)](#/calculation/a-quieter-line), [Emphasis inside a group (Calculation)](#/calculation/emphasis-inside-a-group) |
+| `rule` | `"above"` | — | `above` rules the line off from the ones before it, where a section starts that is not an interim. Not on the Result. From `QuantityProps`.<br>Shown in: [A rule above (Calculation)](#/calculation/a-rule-above), [Emphasis inside a group (Calculation)](#/calculation/emphasis-inside-a-group) |
 
 ##### `QuantityProps`
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `label` *required* | `string` | — | What the quantity is called. It stands on its line, wherever it is an operand, and in the accessible sentence.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 34 more |
-| `id` | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once.<br>Shown in: [Fold a group of lines into one](#/chain/payslip), [Put a chain inside a tree](#/chain/chain-in-a-tree), [The availability of a service (Installation)](#/installation/availability) and 9 more |
-| `unit` | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 28 more |
-| `format` | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation.<br>Shown in: [Fold a group of lines into one](#/chain/payslip), [Put a chain inside a tree](#/chain/chain-in-a-tree), [Hold an interim to its limits](#/chain/error-budget) and 16 more |
-| `decimals` | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 18 more |
+| `label` *required* | `string` | — | What the quantity is called. It stands on its line, wherever it is an operand, and in the accessible sentence.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 48 more |
+| `id` | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once.<br>Shown in: [Fold a group of lines into one](#/chain/payslip), [Put a chain inside a tree](#/chain/chain-in-a-tree), [The availability of a service (Installation)](#/installation/availability) and 10 more |
+| `unit` | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 41 more |
+| `format` | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation.<br>Shown in: [Fold a group of lines into one](#/chain/payslip), [Put a chain inside a tree](#/chain/chain-in-a-tree), [Hold an interim to its limits](#/chain/error-budget) and 17 more |
+| `decimals` | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value.<br>Shown in: [Take amounts away from a first quantity](#/chain/net-weight), [Mix additions and deductions](#/chain/tour-cost), [Multiply between two interims](#/chain/mark-up-and-vat) and 29 more |
 | `target` | `number` | — | The value this quantity is meant to reach - missed, never violated.<br>Shown in: [Put a chain inside a tree](#/chain/chain-in-a-tree), [The availability of a service (Installation)](#/installation/availability), [Write a tree (Calculation)](#/calculation/oee) and 5 more |
 | `limits` | `readonly `[`Limit`](#type-Limit)`[]` | — | Bounds the quantity is assessed against, through core's `assess()`.<br>Shown in: [Hold an interim to its limits](#/chain/error-budget), [Hold a figure to its limits (Tree)](#/tree/limits), [Say where a number came from (Given)](#/given/where-it-came-from) and 4 more |
 | `explanation` | `string` | — | A sentence of plain text beside the line: why the quantity is here, or what it means.<br>Shown in: [Say where a number came from (Given)](#/given/where-it-came-from), [A number one metric does not have (Metrics)](#/metrics/not-recorded), [Staff movement as a chain (Metrics)](#/metrics/staff-movement) and 1 more |
 | `aside` | `ReactNode` | — | Content of the caller's own beside the line - a sparkline, a link. It never takes part in the calculation.<br>Shown in: [Say where a number came from (Given)](#/given/where-it-came-from) |
+| `emphasis` | `"strong" \| "muted"` | — | How much the line stands out among the others ([ADR-0049](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0049-a-sum-takes-rows-from-data.md)): `strong` to be read first, `muted` to recede - a muted line still counts in full. Not on the Result, which is already the heaviest line.<br>Shown in: [A stronger line (Calculation)](#/calculation/a-stronger-line), [A quieter line (Calculation)](#/calculation/a-quieter-line), [Emphasis inside a group (Calculation)](#/calculation/emphasis-inside-a-group) |
+| `rule` | `"above"` | — | `above` rules the line off from the ones before it, where a section starts that is not an interim. Not on the Result.<br>Shown in: [A rule above (Calculation)](#/calculation/a-rule-above), [Emphasis inside a group (Calculation)](#/calculation/emphasis-inside-a-group) |
 
 ##### Types on this page
 
@@ -2047,6 +2167,448 @@ type Severity = "warning" | "alarm";
 
 What umriss deliberately does not build, and why: [ADR-0032](https://romanhaendler.github.io/umriss-ui/what-umriss-ui-is-not/).
 
+### Rows from data
+
+Rows that come from data (line items, corrections, allowances), however many there are, as one line that folds: a payslip's corrections, an invoice's surcharges, a team's movements.
+
+```ts
+import { Sum, Plus, Minus } from "@umriss-ui/calculation";
+```
+
+Demo page: https://romanhaendler.github.io/umriss-ui/calculation/rows-from-data/
+
+A `Sum` takes the rows of an array as they come: many, one, or none. With one it still folds and opens onto that one; with none it is worth zero, has nothing to open, and says "no entries" where its formula would stand. The line keeps its place either way, so the statement does not change shape with the data ([ADR-0049](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0049-a-sum-takes-rows-from-data.md)).
+
+Rows of both signs go into the sum as they come. A line that adds or takes away shows its contribution: the direction as its operator, the number without a sign – "− Overpaid travel 120.00", never "+ -120.00". The quantity itself keeps its sign where its derivation closes, as an interim, as the result and wherever it is referenced. A factor keeps its sign; a line worth zero or missing keeps the operator it is written with.
+
+`Plus` and `Minus` say how a quantity enters, the number its sign. Signed rows from data go into `Plus`; a quantity that is positive by nature and taken away – income tax, a sum of contributions – into `Minus`, so that it is never quoted as negative.
+
+#### Examples
+
+##### Rows of any count
+
+Hand a `Sum` the rows of an array, as they come from the data, and hold it in a `Plus` or `Minus`: the rows fold into one line, and the interim after it takes their total.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Minus, Plus, Sum } from "@umriss-ui/calculation";
+
+/* Data from a payroll system, written out here so the example runs on its own. */
+const ALLOWANCES = [
+  { id: "night", name: "Night work bonus", amount: 84 },
+  { id: "holiday", name: "Holiday pay", amount: 120 },
+  { id: "on-call", name: "On-call allowance", amount: 45 },
+];
+
+export default function RowsOfAnyCount() {
+  return (
+    <Calculation aria-label="Payslip, March">
+      <Chain>
+        <Given label="Gross salary" value={4200} unit="€" decimals={2} />
+        <Plus>
+          <Sum label="Allowances" unit="€" decimals={2}>
+            {ALLOWANCES.map((allowance) => (
+              <Given key={allowance.id} label={allowance.name} value={allowance.amount} unit="€" decimals={2} />
+            ))}
+          </Sum>
+        </Plus>
+        <Minus label="Income tax" value={668.4} unit="€" decimals={2} />
+        <Interim label="Net salary" unit="€" decimals={2} />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+##### No rows
+
+When the data holds no rows, the sum is zero and its line stays where it was: it has nothing to open and says "no entries" where its formula would stand, so a reader sees that there were none rather than wondering whether a line is missing.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Minus, Plus, Sum } from "@umriss-ui/calculation";
+
+/* A month without allowances: the payroll system returns an empty list. */
+const ALLOWANCES: readonly { id: string; name: string; amount: number }[] = [];
+
+export default function NoRows() {
+  return (
+    <Calculation aria-label="Payslip, April">
+      <Chain>
+        <Given label="Gross salary" value={4200} unit="€" decimals={2} />
+        <Plus>
+          <Sum label="Allowances" unit="€" decimals={2}>
+            {ALLOWANCES.map((allowance) => (
+              <Given key={allowance.id} label={allowance.name} value={allowance.amount} unit="€" decimals={2} />
+            ))}
+          </Sum>
+        </Plus>
+        <Minus label="Income tax" value={612.5} unit="€" decimals={2} />
+        <Interim label="Net salary" unit="€" decimals={2} />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+##### One row
+
+A sum of one row is still a group: its line keeps its name and folds, and opens onto that one row, closing with "= Allowances". The statement keeps its shape as the data changes, and an opened group stays open.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Minus, Plus, Sum } from "@umriss-ui/calculation";
+
+/* A month with a single allowance. */
+const ALLOWANCES = [{ id: "night", name: "Night work bonus", amount: 84 }];
+
+export default function OneRow() {
+  return (
+    <Calculation aria-label="Payslip, May">
+      <Chain>
+        <Given label="Gross salary" value={4200} unit="€" decimals={2} />
+        <Plus>
+          <Sum label="Allowances" unit="€" decimals={2}>
+            {ALLOWANCES.map((allowance) => (
+              <Given key={allowance.id} label={allowance.name} value={allowance.amount} unit="€" decimals={2} />
+            ))}
+          </Sum>
+        </Plus>
+        <Minus label="Income tax" value={631.9} unit="€" decimals={2} />
+        <Interim label="Net salary" unit="€" decimals={2} />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+##### Rows of both signs
+
+Rows that add and rows that take away go into one `Sum` as they come, each with its own sign. Every line shows its contribution: the direction as its operator, the number without a sign – a correction of −120 stands as "− 120.00", never as "+ -120.00".
+
+```tsx
+import { Calculation, Chain, Given, Interim, Minus, Plus, Sum } from "@umriss-ui/calculation";
+
+/* Corrections from a payroll system: positive adds to the pay, negative takes from it. */
+const CORRECTIONS = [
+  { id: "night", name: "Night work bonus, February", amount: 84 },
+  { id: "travel", name: "Overpaid travel, February", amount: -120 },
+  { id: "rounding", name: "Rounding", amount: 0.03 },
+];
+
+export default function RowsOfBothSigns() {
+  return (
+    <Calculation aria-label="Payslip, March">
+      <Chain>
+        <Given label="Gross salary" value={4200} unit="€" decimals={2} />
+        <Minus label="Income tax" value={612.5} unit="€" decimals={2} />
+        <Plus>
+          <Sum label="Corrections" unit="€" decimals={2}>
+            {CORRECTIONS.map((correction) => (
+              <Given key={correction.id} label={correction.name} value={correction.amount} unit="€" decimals={2} />
+            ))}
+          </Sum>
+        </Plus>
+        <Interim label="Net salary" unit="€" decimals={2} />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+##### A group that turns negative
+
+Held by a `Plus`, a group whose total is negative stands as a minus with its number unsigned: "− Corrections 36.00". Opened, its derivation closes with the quantity itself, sign and all: "= Corrections -36.00". The line says what it does to the pay, the closing row what the corrections amount to.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Minus, Plus, Sum } from "@umriss-ui/calculation";
+
+const CORRECTIONS = [
+  { id: "night", name: "Night work bonus, February", amount: 84 },
+  { id: "travel", name: "Overpaid travel, February", amount: -120 },
+];
+
+export default function AGroupThatTurnsNegative() {
+  return (
+    <Calculation aria-label="Payslip, March">
+      <Chain>
+        <Given label="Gross salary" value={4200} unit="€" decimals={2} />
+        <Minus label="Income tax" value={612.5} unit="€" decimals={2} />
+        <Plus>
+          <Sum label="Corrections" unit="€" decimals={2}>
+            {CORRECTIONS.map((correction) => (
+              <Given key={correction.id} label={correction.name} value={correction.amount} unit="€" decimals={2} />
+            ))}
+          </Sum>
+        </Plus>
+        <Interim label="Net salary" unit="€" decimals={2} />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+##### Plus or Minus
+
+`Plus` and `Minus` say how a quantity enters, the number says its sign. Signed rows from data go into `Plus`: their signs do the rest. A quantity that is positive by nature and taken away here – income tax, a sum of contributions – goes into `Minus`, so that it keeps its sign where it closes and wherever it is referenced.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Minus, Plus, Product, Ref, Sum } from "@umriss-ui/calculation";
+
+const CONTRIBUTIONS = [
+  { name: "Pension insurance", rate: 0.093 },
+  { name: "Health insurance", rate: 0.082 },
+];
+
+const CORRECTIONS = [
+  { id: "night", name: "Night work bonus, February", amount: 84 },
+  { id: "travel", name: "Overpaid travel, February", amount: -120 },
+];
+
+export default function PlusOrMinus() {
+  return (
+    <Calculation aria-label="Payslip, March">
+      <Chain>
+        <Given id="gross" label="Gross salary" value={4200} unit="€" decimals={2} />
+        <Minus label="Income tax" value={612.5} unit="€" decimals={2} />
+        <Minus>
+          <Sum label="Social security contributions" unit="€" decimals={2}>
+            {CONTRIBUTIONS.map((contribution) => (
+              <Product key={contribution.name} label={contribution.name} unit="€" decimals={2}>
+                <Given label={`Rate, ${contribution.name.toLowerCase()}`} value={contribution.rate} format="percent" />
+                <Ref to="gross" />
+              </Product>
+            ))}
+          </Sum>
+        </Minus>
+        <Plus>
+          <Sum label="Corrections" unit="€" decimals={2}>
+            {CORRECTIONS.map((correction) => (
+              <Given key={correction.id} label={correction.name} value={correction.amount} unit="€" decimals={2} />
+            ))}
+          </Sum>
+        </Plus>
+        <Interim label="Net salary" unit="€" decimals={2} />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+##### A deduction first
+
+The first operand of a sum stands without an operator – unless it lowers the sum: then it carries a minus like every other deduction. A folded line's formula starts with that minus too – "A sum from data in a tree" below shows one.
+
+```tsx
+import { Calculation, Given, Sum } from "@umriss-ui/calculation";
+
+const ROWS = [
+  { id: "refund", name: "Refund, order 1184", amount: -30 },
+  { id: "bonus", name: "Loyalty bonus", amount: 12 },
+  { id: "voucher", name: "Voucher", amount: 5 },
+];
+
+export default function ADeductionFirst() {
+  return (
+    <Calculation aria-label="Customer account, March">
+      <Sum label="Balance" unit="€" decimals={2}>
+        {ROWS.map((row) => (
+          <Given key={row.id} label={row.name} value={row.amount} unit="€" decimals={2} />
+        ))}
+      </Sum>
+    </Calculation>
+  );
+}
+```
+
+##### Zero and missing keep their sign
+
+A row worth zero has no direction, and a missing row has no number: both keep the operator they are written with. The missing row makes the group and everything after it absent, with the reason – never zero.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Minus, Plus, Sum } from "@umriss-ui/calculation";
+
+const CORRECTIONS: readonly { id: string; name: string; amount: number | null }[] = [
+  { id: "night", name: "Night work bonus, February", amount: 84 },
+  { id: "travel", name: "Travel, February", amount: 0 },
+  { id: "overtime", name: "Overtime, February", amount: null },
+];
+
+export default function ZeroAndMissingKeepTheirSign() {
+  return (
+    <Calculation aria-label="Payslip, March">
+      <Chain>
+        <Given label="Gross salary" value={4200} unit="€" decimals={2} />
+        <Minus label="Income tax" value={612.5} unit="€" decimals={2} />
+        <Plus>
+          <Sum label="Corrections" unit="€" decimals={2}>
+            {CORRECTIONS.map((correction) => (
+              <Given key={correction.id} label={correction.name} value={correction.amount} unit="€" decimals={2} />
+            ))}
+          </Sum>
+        </Plus>
+        <Interim label="Net salary" unit="€" decimals={2} />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+##### A sum from data in a tree
+
+Rows from data work in a tree as in a chain: here the stock movements of a day, whatever their count and sign, stand as one operand of a `Difference`. Taken away, a negative total turns into a plus – "+ Movements 7" – and the derivation closes with its own sign.
+
+```tsx
+import { Calculation, Difference, Given, Sum } from "@umriss-ui/calculation";
+
+const MOVEMENTS = [
+  { id: "m1", name: "Picked, order 5512", amount: -12 },
+  { id: "m2", name: "Received, delivery 881", amount: 40 },
+  { id: "m3", name: "Picked, order 5517", amount: -35 },
+];
+
+export default function ASumFromDataInATree() {
+  return (
+    <Calculation aria-label="Shelf B-14, 17 March">
+      <Difference label="Gap to plan" unit="pcs">
+        <Given label="Planned stock" value={150} unit="pcs" />
+        <Given label="Stock this morning" value={142} unit="pcs" />
+        <Sum label="Movements" unit="pcs">
+          {MOVEMENTS.map((movement) => (
+            <Given key={movement.id} label={movement.name} value={movement.amount} unit="pcs" />
+          ))}
+        </Sum>
+      </Difference>
+    </Calculation>
+  );
+}
+```
+
+##### Rows of both signs with metrics
+
+With metrics a line has one operator and a number per metric. Where they all point the same way, the line shows its contribution as everywhere else; a metric that is zero or missing does not count. Where they point in different directions – a part-timer joins: one more head, half a position less – the line keeps its written operator and every number its sign.
+
+```tsx
+import { Calculation, Chain, Given, Interim, Plus, Sum } from "@umriss-ui/calculation";
+import type { Metric } from "@umriss-ui/calculation";
+
+const STAFF: readonly Metric[] = [
+  { id: "heads", label: "Headcount", unit: "HC", decimals: 0 },
+  { id: "fte", label: "Full-time equivalents", unit: "FTE", decimals: 1 },
+];
+
+/* The quarter's movements from the HR system. */
+const MOVEMENTS = [
+  { id: "sales", name: "Transferred to sales", heads: -4, fte: -3.5 },
+  { id: "hours", name: "Hours reduced", heads: 0, fte: -1.5 },
+  { id: "part-time", name: "Full-timer replaced by two part-timers", heads: 1, fte: -0.5 },
+  { id: "joiners", name: "Joiners", heads: 6, fte: 5.8 },
+];
+
+export default function RowsOfBothSignsWithMetrics() {
+  return (
+    <Calculation aria-label="Staff movement, logistics, third quarter" metrics={STAFF}>
+      <Chain>
+        <Given label="Staff on 30 June" value={{ heads: 64, fte: 48.9 }} />
+        <Plus>
+          <Sum label="Movements">
+            {MOVEMENTS.map((movement) => (
+              <Given key={movement.id} label={movement.name} value={{ heads: movement.heads, fte: movement.fte }} />
+            ))}
+          </Sum>
+        </Plus>
+        <Interim label="Staff on 30 September" />
+      </Chain>
+    </Calculation>
+  );
+}
+```
+
+#### When to use something else
+
+- A fixed set of lines that is always in view → Chain
+
+#### Keyboard
+
+The keys of [Calculation](#/calculation/keyboard-calculation) apply here.
+
+#### Props on this page
+
+From `CalculationProps` — the full table stands on [Calculation](#/calculation/type-CalculationProps).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`children`](#/calculation/CalculationProps-children) *required* | `ReactNode` | — | The result: exactly one quantity - a tree (`<Sum>`, `<Difference>`, `<Product>`, `<Quotient>` with their operands, `<Given>` as leaves) or a `<Chain>`, the two mixing freely; `<Ref>` for a quantity defined elsewhere. |
+| [`metrics`](#/calculation/CalculationProps-metrics) | `readonly `[`Metric`](#/metrics/type-Metric)`[]` | — | Several numbers per quantity, side by side - headcount and full-time equivalents of the same teams ([ADR-0038](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0038-a-calculation-can-carry-several-metrics.md)). Every `value` is then an object with a number for each metric id; unit and places are the metric's. A calculation with metrics only adds and subtracts, and assesses no target or limits. |
+
+From `OperatorProps` — the full table stands on [Tree](#/tree/type-OperatorProps).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`children`](#/tree/OperatorProps-children) | `ReactNode` | — | The operands, in order: quantities, givens and references. |
+| [`label`](#/tree/OperatorProps-label) *required* | `string` | — | What the quantity is called. It stands on its line, wherever it is an operand, and in the accessible sentence. From `QuantityProps`. |
+| [`id`](#/tree/OperatorProps-id) | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once. From `QuantityProps`. |
+| [`unit`](#/tree/OperatorProps-unit) | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra. From `QuantityProps`. |
+| [`format`](#/tree/OperatorProps-format) | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation. From `QuantityProps`. |
+| [`decimals`](#/tree/OperatorProps-decimals) | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value. From `QuantityProps`. |
+
+From `RefProps` — the full table stands on [Tree](#/tree/type-RefProps).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`to`](#/tree/RefProps-to) *required* | `string` | — | The `id` of the quantity this reference stands for. |
+
+From `ChainProps` — the full table stands on [Chain](#/chain/type-ChainProps).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`children`](#/chain/ChainProps-children) | `ReactNode` | — | The operands, top to bottom: a first quantity with no operator, then `Plus`, `Minus`, `Times` and `DividedBy` with their operands and `Interim`s naming the value where they stand. The last line is an `Interim`; a `Times` or `DividedBy` stands alone between two named values. |
+
+From `ChainOperandProps` — the full table stands on [Chain](#/chain/type-ChainOperandProps).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`label`](#/chain/ChainOperandProps-label) | `string` | — | The operand's name, where the line is a given written in place. Left out where the line holds a quantity as its child. |
+| [`value`](#/chain/ChainOperandProps-value) | `number \| null \| `[`MetricValues`](#/chain/type-MetricValues) | — | The operand's number, where the line is a given written in place. Absent as for a `Given`: the line and every interim after it are absent, with the reason. With `metrics`, an object by metric id, as on a `Given`. |
+| [`children`](#/chain/ChainOperandProps-children) | `ReactNode` | — | Instead of `label` and `value`: exactly one quantity - a tree, a `<Ref>` or a `<Chain>`. |
+| [`id`](#/chain/ChainOperandProps-id) | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once. From `QuantityProps`. |
+| [`unit`](#/chain/ChainOperandProps-unit) | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra. From `QuantityProps`. |
+| [`format`](#/chain/ChainOperandProps-format) | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation. From `QuantityProps`. |
+| [`decimals`](#/chain/ChainOperandProps-decimals) | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value. From `QuantityProps`. |
+
+From `QuantityProps` — the full table stands on [Chain](#/chain/type-QuantityProps).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`label`](#/chain/QuantityProps-label) *required* | `string` | — | What the quantity is called. It stands on its line, wherever it is an operand, and in the accessible sentence. |
+| [`id`](#/chain/QuantityProps-id) | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once. |
+| [`unit`](#/chain/QuantityProps-unit) | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra. |
+| [`format`](#/chain/QuantityProps-format) | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation. |
+| [`decimals`](#/chain/QuantityProps-decimals) | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value. |
+
+From `GivenProps` — the full table stands on [Given](#/given/type-GivenProps).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`value`](#/given/GivenProps-value) *required* | `number \| null \| undefined \| `[`MetricValues`](#/given/type-MetricValues) | — | The number the calculation starts from. Absent (`null`, `undefined`, not finite) makes every quantity that depends on it absent, with the reason - never zero. Where the calculation has `metrics`, an object with a number for each metric id instead; absence then stays in its metric. |
+| [`label`](#/given/GivenProps-label) *required* | `string` | — | What the quantity is called. It stands on its line, wherever it is an operand, and in the accessible sentence. From `QuantityProps`. |
+| [`id`](#/given/GivenProps-id) | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once. From `QuantityProps`. |
+| [`unit`](#/given/GivenProps-unit) | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra. From `QuantityProps`. |
+| [`format`](#/given/GivenProps-format) | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation. From `QuantityProps`. |
+| [`decimals`](#/given/GivenProps-decimals) | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value. From `QuantityProps`. |
+
+From `Metric` — the full table stands on [Metrics](#/metrics/type-Metric).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`id`](#/metrics/Metric-id) *required* | `string` | — | The key of this metric's number in every `value` object. |
+| [`label`](#/metrics/Metric-label) *required* | `string` | — | The metric's name, in the head above its column and in each row's sentence. |
+| [`unit`](#/metrics/Metric-unit) | `string` | — | A label written after the number where a result closes, and beneath the metric's name in the head. Never converted and never checked. |
+| [`decimals`](#/metrics/Metric-decimals) | `number` | a given as it was given, at most two for a derived number | Fixed number of fraction digits as shown, for every quantity of this metric. |
+
+#### Known limits
+
+- Only a sum takes any count: an empty product, a difference of one and a quotient of anything but two still fail on the first render.
+
+What umriss deliberately does not build, and why: [ADR-0032](https://romanhaendler.github.io/umriss-ui/what-umriss-ui-is-not/).
+
 ### Given
 
 The numbers a calculation starts from (inputs, leaves): where they came from, when they were true, and whether they are still fresh.
@@ -2152,19 +2714,21 @@ The keys of [Calculation](#/calculation/keyboard-calculation) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `value` *required* | `number \| null \| undefined \| `[`MetricValues`](#type-MetricValues) | — | The number the calculation starts from. Absent (`null`, `undefined`, not finite) makes every quantity that depends on it absent, with the reason - never zero. Where the calculation has `metrics`, an object with a number for each metric id instead; absence then stays in its metric.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [State when a number was true](#/given/as-of), [Read in German](#/given/in-german) and 34 more |
+| `value` *required* | `number \| null \| undefined \| `[`MetricValues`](#type-MetricValues) | — | The number the calculation starts from. Absent (`null`, `undefined`, not finite) makes every quantity that depends on it absent, with the reason - never zero. Where the calculation has `metrics`, an object with a number for each metric id instead; absence then stays in its metric.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [State when a number was true](#/given/as-of), [Read in German](#/given/in-german) and 48 more |
 | `source` | `string` | — | Where the number came from: a system, a report, a person.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [State when a number was true](#/given/as-of), [Staff movement as a chain (Metrics)](#/metrics/staff-movement) and 7 more |
 | `asOf` | `Date \| number` | — | When the number was true - not when it was fetched.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [State when a number was true](#/given/as-of), [The cost per stop of a day's tours (Worked examples)](#/worked-examples/cost-per-tour) |
 | `ages` | [`FreshnessAges`](#type-FreshnessAges) | — | The ages at which `asOf` turns stale and lost. With both, the given carries a freshness through core; with `asOf` alone, only the time.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [The cost per stop of a day's tours (Worked examples)](#/worked-examples/cost-per-tour) |
-| `label` *required* | `string` | — | What the quantity is called. It stands on its line, wherever it is an operand, and in the accessible sentence. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [State when a number was true](#/given/as-of), [Read in German](#/given/in-german) and 34 more |
-| `id` | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once. From `QuantityProps`.<br>Shown in: [Read in German](#/given/in-german), [The availability of a service (Installation)](#/installation/availability), [Write a tree (Calculation)](#/calculation/oee) and 9 more |
-| `unit` | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [State when a number was true](#/given/as-of), [Read in German](#/given/in-german) and 28 more |
-| `format` | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [Read in German](#/given/in-german), [The availability of a service (Installation)](#/installation/availability) and 16 more |
-| `decimals` | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [State when a number was true](#/given/as-of), [Read in German](#/given/in-german) and 18 more |
+| `label` *required* | `string` | — | What the quantity is called. It stands on its line, wherever it is an operand, and in the accessible sentence. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [State when a number was true](#/given/as-of), [Read in German](#/given/in-german) and 48 more |
+| `id` | `string` | — | Makes the quantity referable: `<Ref to>` stands for it elsewhere. Needed only for a quantity used more than once. From `QuantityProps`.<br>Shown in: [Read in German](#/given/in-german), [The availability of a service (Installation)](#/installation/availability), [Write a tree (Calculation)](#/calculation/oee) and 10 more |
+| `unit` | `string` | — | A label written after the number - "min", "pcs", "€". Never converted and never checked; the calculation does no unit algebra. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [State when a number was true](#/given/as-of), [Read in German](#/given/in-german) and 41 more |
+| `format` | `"percent"` | — | `percent` presents a plain ratio as per cent: 0.916 is shown as 91.6 %. The quantity stays a ratio in every operation. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [Read in German](#/given/in-german), [The availability of a service (Installation)](#/installation/availability) and 17 more |
+| `decimals` | `number` | one digit for a percentage, at most two for a derived number, a given as it was given | Fixed number of fraction digits as shown. Rounding happens only in presentation; every operation uses the full value. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [State when a number was true](#/given/as-of), [Read in German](#/given/in-german) and 29 more |
 | `target` | `number` | — | The value this quantity is meant to reach - missed, never violated. From `QuantityProps`.<br>Shown in: [The availability of a service (Installation)](#/installation/availability), [Write a tree (Calculation)](#/calculation/oee), [Show a share against a target (Tree)](#/tree/share-with-target) and 5 more |
 | `limits` | `readonly `[`Limit`](#type-Limit)`[]` | — | Bounds the quantity is assessed against, through core's `assess()`. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [Hold a figure to its limits (Tree)](#/tree/limits), [Hold an interim to its limits (Chain)](#/chain/error-budget) and 4 more |
 | `explanation` | `string` | — | A sentence of plain text beside the line: why the quantity is here, or what it means. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from), [A number one metric does not have (Metrics)](#/metrics/not-recorded), [Staff movement as a chain (Metrics)](#/metrics/staff-movement) and 1 more |
 | `aside` | `ReactNode` | — | Content of the caller's own beside the line - a sparkline, a link. It never takes part in the calculation. From `QuantityProps`.<br>Shown in: [Say where a number came from](#/given/where-it-came-from) |
+| `emphasis` | `"strong" \| "muted"` | — | How much the line stands out among the others ([ADR-0049](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0049-a-sum-takes-rows-from-data.md)): `strong` to be read first, `muted` to recede - a muted line still counts in full. Not on the Result, which is already the heaviest line. From `QuantityProps`.<br>Shown in: [A stronger line (Calculation)](#/calculation/a-stronger-line), [A quieter line (Calculation)](#/calculation/a-quieter-line), [Emphasis inside a group (Calculation)](#/calculation/emphasis-inside-a-group) |
+| `rule` | `"above"` | — | `above` rules the line off from the ones before it, where a section starts that is not an interim. Not on the Result. From `QuantityProps`.<br>Shown in: [A rule above (Calculation)](#/calculation/a-rule-above), [Emphasis inside a group (Calculation)](#/calculation/emphasis-inside-a-group) |
 
 ##### Types on this page
 
@@ -2689,10 +3253,10 @@ The keys of [Calculation](#/calculation/keyboard-calculation) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `id` *required* | `string` | — | The key of this metric's number in every `value` object.<br>Shown in: [Headcount and full-time equivalents](#/metrics/two-teams), [A number one metric does not have](#/metrics/not-recorded), [Team, cost centre, business line](#/metrics/business-line) and 3 more |
-| `label` *required* | `string` | — | The metric's name, in the head above its column and in each row's sentence.<br>Shown in: [Headcount and full-time equivalents](#/metrics/two-teams), [A number one metric does not have](#/metrics/not-recorded), [Team, cost centre, business line](#/metrics/business-line) and 3 more |
-| `unit` | `string` | — | A label written after the number where a result closes, and beneath the metric's name in the head. Never converted and never checked.<br>Shown in: [Headcount and full-time equivalents](#/metrics/two-teams), [A number one metric does not have](#/metrics/not-recorded), [Team, cost centre, business line](#/metrics/business-line) and 3 more |
-| `decimals` | `number` | a given as it was given, at most two for a derived number | Fixed number of fraction digits as shown, for every quantity of this metric.<br>Shown in: [Headcount and full-time equivalents](#/metrics/two-teams), [A number one metric does not have](#/metrics/not-recorded), [Team, cost centre, business line](#/metrics/business-line) and 3 more |
+| `id` *required* | `string` | — | The key of this metric's number in every `value` object.<br>Shown in: [Headcount and full-time equivalents](#/metrics/two-teams), [A number one metric does not have](#/metrics/not-recorded), [Team, cost centre, business line](#/metrics/business-line) and 4 more |
+| `label` *required* | `string` | — | The metric's name, in the head above its column and in each row's sentence.<br>Shown in: [Headcount and full-time equivalents](#/metrics/two-teams), [A number one metric does not have](#/metrics/not-recorded), [Team, cost centre, business line](#/metrics/business-line) and 4 more |
+| `unit` | `string` | — | A label written after the number where a result closes, and beneath the metric's name in the head. Never converted and never checked.<br>Shown in: [Headcount and full-time equivalents](#/metrics/two-teams), [A number one metric does not have](#/metrics/not-recorded), [Team, cost centre, business line](#/metrics/business-line) and 4 more |
+| `decimals` | `number` | a given as it was given, at most two for a derived number | Fixed number of fraction digits as shown, for every quantity of this metric.<br>Shown in: [Headcount and full-time equivalents](#/metrics/two-teams), [A number one metric does not have](#/metrics/not-recorded), [Team, cost centre, business line](#/metrics/business-line) and 4 more |
 
 #### Known limits
 
@@ -3448,13 +4012,13 @@ Demo page: https://romanhaendler.github.io/umriss-ui/calculation/api/
 
 [Calculation](#/calculation) – Lets a reader follow and redo a figure (also called a KPI tree or calculation tree): each line a quantity with its operator, derived lines folded until opened beneath themselves. Reach for it where a number on the screen gets questioned: a cost, an availability, an invoice total.
 
-Used on [Scenarios](#/), [Installation](#/installation), [Calculation](#/calculation), [Tree](#/tree), [Chain](#/chain), [Given](#/given), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
+Used on [Scenarios](#/), [Installation](#/installation), [Calculation](#/calculation), [Tree](#/tree), [Chain](#/chain), [Rows from data](#/rows-from-data), [Given](#/given), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
 
 ##### `Chain`
 
 [Chain](#/chain) – A sheet read top to bottom (a running calculation): each line worked into the value before it, and interims naming the value where they stand. Reach for it for invoices, budgets and cost sheets.
 
-Used on [Calculation](#/calculation), [Chain](#/chain), [Given](#/given), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
+Used on [Calculation](#/calculation), [Chain](#/chain), [Rows from data](#/rows-from-data), [Given](#/given), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
 
 ##### `Difference`
 
@@ -3464,7 +4028,7 @@ The first operand minus every other: a − b − c.
 const Difference: (props: OperatorProps) => null;
 ```
 
-Used on [Scenarios](#/), [Installation](#/installation), [Calculation](#/calculation), [Tree](#/tree) and [Worked examples](#/worked-examples).
+Used on [Scenarios](#/), [Installation](#/installation), [Calculation](#/calculation), [Tree](#/tree), [Rows from data](#/rows-from-data) and [Worked examples](#/worked-examples).
 
 ##### `DividedBy`
 
@@ -3480,7 +4044,7 @@ Used on [Chain](#/chain), [Metrics](#/metrics) and [Worked examples](#/worked-ex
 
 [Given](#/given) – The numbers a calculation starts from (inputs, leaves): where they came from, when they were true, and whether they are still fresh.
 
-Used on [Scenarios](#/), [Installation](#/installation), [Calculation](#/calculation), [Tree](#/tree), [Chain](#/chain), [Given](#/given), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
+Used on [Scenarios](#/), [Installation](#/installation), [Calculation](#/calculation), [Tree](#/tree), [Chain](#/chain), [Rows from data](#/rows-from-data), [Given](#/given), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
 
 ##### `Interim`
 
@@ -3490,7 +4054,7 @@ Names the value of a chain where it stands.
 const Interim: (props: QuantityProps) => null;
 ```
 
-Used on [Calculation](#/calculation), [Chain](#/chain), [Given](#/given), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
+Used on [Calculation](#/calculation), [Chain](#/chain), [Rows from data](#/rows-from-data), [Given](#/given), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
 
 ##### `Minus`
 
@@ -3500,7 +4064,7 @@ Takes its operand from the value before it.
 const Minus: (props: ChainOperandProps) => null;
 ```
 
-Used on [Calculation](#/calculation), [Chain](#/chain), [Given](#/given) and [Metrics](#/metrics).
+Used on [Calculation](#/calculation), [Chain](#/chain), [Rows from data](#/rows-from-data), [Given](#/given) and [Metrics](#/metrics).
 
 ##### `Plus`
 
@@ -3510,7 +4074,7 @@ Adds its operand to the value before it.
 const Plus: (props: ChainOperandProps) => null;
 ```
 
-Used on [Calculation](#/calculation), [Chain](#/chain), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
+Used on [Calculation](#/calculation), [Chain](#/chain), [Rows from data](#/rows-from-data), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
 
 ##### `Product`
 
@@ -3520,7 +4084,7 @@ The product of two or more operands.
 const Product: (props: OperatorProps) => null;
 ```
 
-Used on [Scenarios](#/), [Calculation](#/calculation), [Tree](#/tree), [Chain](#/chain), [Given](#/given), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
+Used on [Scenarios](#/), [Calculation](#/calculation), [Tree](#/tree), [Chain](#/chain), [Rows from data](#/rows-from-data), [Given](#/given), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
 
 ##### `Quotient`
 
@@ -3536,17 +4100,18 @@ Used on [Scenarios](#/), [Installation](#/installation), [Calculation](#/calcula
 
 [Tree](#/tree) – A quantity defined elsewhere in the calculation, standing as an operand.
 
-Used on [Scenarios](#/), [Installation](#/installation), [Calculation](#/calculation), [Tree](#/tree), [Chain](#/chain), [Given](#/given) and [Worked examples](#/worked-examples).
+Used on [Scenarios](#/), [Installation](#/installation), [Calculation](#/calculation), [Tree](#/tree), [Chain](#/chain), [Rows from data](#/rows-from-data), [Given](#/given) and [Worked examples](#/worked-examples).
 
 ##### `Sum`
 
-The sum of two or more operands.
+The sum of its operands, however many: rows from data, one or none
+included. The sum of none is zero, and its line says it has no entries.
 
 ```ts
 const Sum: (props: OperatorProps) => null;
 ```
 
-Used on [Scenarios](#/), [Calculation](#/calculation), [Tree](#/tree), [Chain](#/chain), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
+Used on [Scenarios](#/), [Calculation](#/calculation), [Tree](#/tree), [Chain](#/chain), [Rows from data](#/rows-from-data), [Metrics](#/metrics), [What can go wrong](#/what-can-go-wrong) and [Worked examples](#/worked-examples).
 
 ##### `Times`
 
@@ -3556,7 +4121,7 @@ Multiplies the named value before it by its operand.
 const Times: (props: ChainOperandProps) => null;
 ```
 
-Used on [Chain](#/chain) and [Metrics](#/metrics).
+Used on [Calculation](#/calculation), [Chain](#/chain) and [Metrics](#/metrics).
 
 #### Types
 
@@ -3580,7 +4145,7 @@ Its table stands on [Given](#/given/type-GivenProps).
 
 Its table stands on [Metrics](#/metrics/type-Metric).
 
-Used on [Metrics](#/metrics).
+Used on [Rows from data](#/rows-from-data) and [Metrics](#/metrics).
 
 ##### `MetricValues`