Changes to @umriss-ui/calculation

This document describes what changes for callers of the package: exports, props, behaviour.

The numbers. The middle digit rises when something is added; the last one when something is repaired. As long as the first digit is 0, no number promises compatibility — which is why whatever changes existing behaviour stands under a heading "Changed" of its own, no matter which digit rose.

From 0.34.0 the packages share one number - five, and six from 0.40.0, when the dashboard joined: they are released together, and a package without a change of its own still gets a heading for it.

0.40.0 – No change of its own (Oct. 2026)

Released with the other five packages under their one number. No change of its own.

0.39.0 – No change of its own (Oct. 2026)

Released with the other four packages under their one number. No change of its own.

0.38.0 – No change of its own (Oct. 2026)

Released with the other four packages under their one number. No change of its own.

0.37.0 – No change of its own (Oct. 2026)

Needs @umriss-ui/core 0.37; the peer range is ^0.37.0. No change of its own.

0.36.0 – No change of its own (Oct. 2026)

Needs @umriss-ui/core 0.36; the peer range is ^0.36.0. No change of its own.

0.35.0 – React 19 is the floor (Oct. 2026)

Needs @umriss-ui/core 0.35; the peer range is ^0.35.0.

Changed

• React 19 is required. The peers react and react-dom are >=19; 0.34.0 is the last version that serves React 18.

• The package ships ES2022 syntax. An application that serves older browsers transpiles it itself.

No other change of its own.

0.34.0 – One number for all five packages (Oct. 2026)

From this version all five packages carry one number and are released together. Needs @umriss-ui/core 0.34; the peer range is ^0.34.0. No change of its own.

0.7.3 – Core 0.33.0 (Oct. 2026)

Needs @umriss-ui/core 0.33; the peer range moves to ^0.33.0.

Added

• The unit tests run against React 18.3.1 and 19 in CI, and a calculation is rendered to a string with no window in a test (tests-unit/ssr.test.tsx).

Changed

• Every entry begins with "use client";. The built file dist/calculation.js starts with the directive, then the stylesheet import, so a bundler that splits server from client code takes each as client code. The directive is written to the built entries only; the sources are unchanged.

• Every export is a client component. A hook called in a Server Component now fails with React's message about a client reference, not one about useState.

0.7.2 – Core 0.32.0 (Oct. 2026)

Needs @umriss-ui/core 0.32; the peer range moves to ^0.32.0. Nothing else changes for a caller.

0.7.1 – Core 0.31.0 (Oct. 2026)

Needs @umriss-ui/core 0.31; the peer range moves to ^0.31.0. Nothing else changes for a caller.

0.7.0 – Density (Oct. 2026)

A calculation beside a compact table stood a third larger than it, on the same material. It follows the density now (ADR-0051).

Added

• density="regular" | "compact" on Calculation. Compact sets the lines at the compact table's measures: 11 px type and 27 px a line under a fine pointer, 35 px under a finger. A compact line that says one thing is exactly that tall - with a disclosure, with a verdict, the Result included. Columns, folding, emphasis and rule, the narrow and the two-line form, and what a screen reader hears stay as they are.

Changed

• A calculation takes the UmrissProvider's density as its default. Under a provider that says density="compact" every calculation becomes compact, without a change to your code; density="regular" on a calculation keeps that one as it was. Without a provider, or under one that is silent about density, nothing changes - a regular calculation does not move by a pixel.

0.6.1 – Core 0.30.0 (Oct. 2026)

Needs @umriss-ui/core 0.30; the peer range moves to ^0.30.0. Nothing else changes for a caller.

0.6.0 – Rows from data (Oct. 2026)

A payslip's corrections, an invoice's surcharges, a team's movements: rows that come from data, any number of them and of either sign, as one line that folds (ADR-0049). Needs @umriss-ui/core 0.29; the peer range moves to ^0.29.0.

Added

• Sum takes any number of operands, one or none included. With one it still folds and opens onto that one; with none it is worth zero, has no disclosure, and says "no entries" where its formula would stand (calculationNoOperands in core's wording). Difference, Product and Quotient keep their counts.
• emphasis="strong" | "muted" and rule="above" on every quantity: a line read first, a line that recedes and still counts in full, a section ruled off that is no interim - without CSS. On the Result either fails on the first render.
• A demo page "Rows from data", ten examples from none to many rows, both signs, a tree and metrics; four examples of emphasis and rule on the page Calculation.

Changed

• A line that adds or takes away shows its contribution: the direction as its operator, the number without a sign. A negative operand of a sum used to stand as "+ Corrections -18.00"; it now stands as "− Corrections 18.00", and so do the folded formula and the sentence. This holds for the operands of Sum and Difference, the first operand included (a negative one draws a leading "−"), and for a chain's Plus, Minus and first quantity. The quantity keeps its own sign where its derivation closes, as an interim, as the Result and where a reference names it. A factor keeps its sign; a line worth zero or missing, and a line whose metrics point in different directions, keep the operator as written.

0.5.3 – Core 0.28.0 (Oct. 2026)

Needs @umriss-ui/core 0.28; the peer range moves to ^0.28.0. Nothing else changes for a caller.

0.5.2 – Core 0.27.0 (Oct. 2026)

Needs @umriss-ui/core 0.27; the peer range moves to ^0.27.0. Nothing else changes for a caller.

0.5.1 – Core 0.26.0 (Oct. 2026)

Needs @umriss-ui/core 0.26; the peer range moves to ^0.26.0. Nothing else changes for a caller.

0.5.0 – Every export explained (Oct. 2026)

The package explains itself where it is used: every export carries a comment, every default a @default tag, and the demo lists all of it in an API index (ADR-0044). What a calculation shows and does is unchanged. Needs @umriss-ui/core 0.25; the peer range moves to ^0.25.0.

Added

• The Calculation page says what a screen reader meets: a section Accessibility after Keyboard gives the sentence each line is read as, in English and in German, the derivation button's name and state, the label to pass and what forced colours and reduced motion change. Every other page links the Calculation page's keys from a Keyboard section of its own. In the demo, the Markdown twins and docs/llms-full.md; the calculation is unchanged.
• Every export carries a comment: what a component or a type is for. The editor shows it on hover, from the package's .d.ts. Nothing else changes.
• A prop's default stands in a @default tag where its comment used to say it in words: the editor shows it on hover, and the props table in its Default column. Nothing else changes.
• docs/llms-full.md defines every type a props table names: a type without a table of its own (MetricValues, core's Limit) stands under "Types on this page" of each page that names it, with its comment and its members or its declaration.
• docs/llms-full.md ends with the API index: every export of the package, grouped as components and types, alphabetical, each with its comment and declaration or a link to the page and table where it stands, and the pages that use it. It replaces the appendix "The rest of the API". The same index is a page of the demo, at /calculation/api/.

Fixed

• docs/llms-full.md names the peer in its install line: npm install @umriss-ui/calculation @umriss-ui/core, read from the manifest. It had named the calculation alone, and an install after it lacked core.

0.4.8 – Core 0.24.0 (Oct. 2026)

Needs @umriss-ui/core 0.24; the peer range moves to ^0.24.0. Nothing else changes for a caller.

0.4.7 – Core 0.23.0 (Oct. 2026)

Needs @umriss-ui/core 0.23; the peer range moves to ^0.23.0. Nothing else changes for a caller.

0.4.6 – Core 0.22.0 (Oct. 2026)

Needs @umriss-ui/core 0.22; the peer range moves to ^0.22.0. Nothing else changes for a caller.

0.4.5 – Core 0.21.0 (Oct. 2026)

Needs @umriss-ui/core 0.21; the peer range moves to ^0.21.0. Its record picker in the scenarios is a Select at its natural width now, beside its line of text instead of before it. Nothing else changes for a caller.

0.4.4 – Core 0.20.0 (Oct. 2026)

Needs @umriss-ui/core 0.20; the peer range moves to ^0.20.0. Nothing else changes for a caller.

0.4.3 – Core 0.19.0 (Oct. 2026)

Needs @umriss-ui/core 0.19; the peer range moves to ^0.19.0. Nothing else changes for a caller.

0.4.2 – Core 0.18.0 (Sep. 2026)

Needs @umriss-ui/core 0.18; the peer range moves to ^0.18.0. Nothing else changes for a caller.

0.4.1 – Core 0.17.0 (Sep. 2026)

Needs @umriss-ui/core 0.17; the peer range moves to ^0.17.0. Nothing else changes for a caller.

0.4.0 – Metrics side by side (Sep. 2026)

Added

• Metrics: several numbers on every line, side by side (ADR-0038). <Calculation metrics={[{ id, label, unit?, decimals? }, …]}> names each metric once; every value on a Given or a chain's line is then an object with a number for each metric id - value={{ heads: 31, fte: 27.5 }}. The derivation is the same for every metric, and each is worked on its own. The type Metric (and MetricValues) is exported.
  • A head above the figures names each metric with its unit; the unit stands again only where a result closes - the Result, an interim, the line that closes an open derivation.
  • null for one metric makes absent only what depends on it in that metric; the badge says which metric ("FTE is missing"), the sentence the full reason.
  • Where the figures leave the labels less room than they need, and less than 10 rem, each line puts them on a line beneath its label, still in their columns. Measured, not a breakpoint.
  • Every line reads as one sentence: its formula in names once, then each metric's number - "Logistics equals Warehouse plus Dispatch: Headcount 58 HC; Full-time equivalents 45.7 FTE".
  • Fails on the first render, with a message saying which and where: a value that is not an object by metric, a metric's number left out or one for no metric, unit, format or decimals on a quantity, target or limits, Product, Quotient, Times, DividedBy, metrics empty or with an id twice, and a value by metric where the calculation has none.
• A demo page "Metrics", six examples from two teams to a whole company.

Changed

• A calculation wider than its place scrolls instead of being cut off. The frame clipped what did not fit; it now scrolls sideways, still clipped to its radius. A calculation that fits looks as before.
• Narrow, a verdict or a reason beneath the label no longer widens the statement past its frame: a long badge is cut at the frame's edge instead of pushing the numbers out of view.

0.3.7 – Core 0.16.0 (Sep. 2026)

Needs @umriss-ui/core 0.16; the peer range moves to ^0.16.0. Nothing else changes for a caller.

0.3.6 – Core 0.15.0 (Sep. 2026)

Needs @umriss-ui/core 0.15; the peer range moves to ^0.15.0. Nothing else changes for a caller.

0.3.5 – Found by search (Sep. 2026)

Fixed

• The package's description and keywords say what it is in the words a search uses, and the demo it links to addresses every page by a path (…/calculation/<page>/) instead of a hash, with the page's text readable before the demo starts. Old #/<page> links still land. Nothing in the package's code changed.

0.3.4 – Core 0.14.0 (Sep. 2026)

Needs @umriss-ui/core 0.14; the peer range moves to ^0.14.0. Nothing else changes for a caller.

0.3.3 – Core 0.13.0 (Sep. 2026)

Needs @umriss-ui/core 0.13; the peer range moves to ^0.13.0. Nothing else changes for a caller.

0.3.2 – Core 0.12.0 (Sep. 2026)

Needs @umriss-ui/core 0.12; the peer range moves to ^0.12.0. Nothing else changes for a caller.

0.3.1 – Core 0.11.0 (Sep. 2026)

Needs @umriss-ui/core 0.11; the peer range moves to ^0.11.0. Nothing else changes for a caller.

0.3.0 – Forced colours and agent-readable docs (Sep. 2026)

Needs @umriss-ui/core 0.10; the peer range moves to ^0.10.0.

Added

• The Windows contrast mode (forced-colors: active, forced-colors 03). The hover coupling keeps its band as an outline in the system's selection colour, the open derivation its spine, the frame and the disclosure's ring an outline where the box-shadow stood; the verdicts keep their words. Nothing changes outside forced colours.
• docs/llms-full.md, the package's documentation as one Markdown file for a coding agent, in the npm package and pinned to its version: every demo page with its import line, its examples' source, its props tables and why it is built as it is, and the declaration of every other export. The same text stands online as https://romanhaendler.github.io/umriss-ui/calculation/llms-full.txt, with an index of the pages beside it (llms.txt).

0.2.4 – Core 0.9.0 (Sep. 2026)

Admits @umriss-ui/core 0.9, which only adds a token; the peer range moves to ^0.9.0. Nothing else changes.

0.2.3 – Core 0.8.0: the canon of states (Sep. 2026)

Needs @umriss-ui/core 0.8: it reads core's pressed surfaces and motion tokens; the peer range moves to ^0.8.0.

Changed

• The disclosure sinks while pressed - on the key and on a foldable row - with core's --u-color-surface-pressed, like every quiet key of the library.

0.2.2 – Core 0.7.0 (Sep. 2026)

Changed

• The worst-verdict glyph and the lost freshness read core's --u-color-danger-text - lighter in the dark theme, 4.5:1 on every surface. The peer range moves to @umriss-ui/core ^0.7.0.

0.2.1 – Core 0.6.0 (Sep. 2026)

Changed

• The calculation takes @umriss-ui/core 0.6. Nothing in the calculation changed; the peer range moves to ^0.6.0, so that it installs beside @umriss-ui/table 0.3, which needs core's new wording.

0.2.0 – A chain stands open (Sep. 2026)

0.1.0 was committed in the repository but never published; this is the first version on npm.

Changed

• A chain in view no longer folds. Every line and every interim stands open, as on paper - gross salary, each deduction with its minus, the net salary beneath a rule once they all stand. What should show only on request is written as a tree in one line: a <Sum> held by a <Minus> folds like any tree and opens beneath its line. A chain that is an operand still folds, as a whole, and opens whole.
• No disclosure column where nothing can fold: a calculation of givens and chains alone starts its labels at the surface's edge.
• The hover band on operands is half the accent's surface instead of a grey, so coloured text in a marked row keeps its contrast.

0.1.0 – First release (Sep. 2026)

A calculation a reader can follow and redo: the package evaluates every operation it shows, so what stands on the screen cannot disagree with the number. Takes @umriss-ui/core ^0.5.0 as a peer, for its wording.

Added

• Calculation and the tree (ADR-0027): Given, Sum, Difference, Product, Quotient and Ref, written as nested elements the way the derivation reads. Full precision throughout, rounding only on the screen.
• The chain (ADR-0028): Chain, Plus, Minus, Times, DividedBy and Interim - a calculation read top to bottom, each operand worked into the value before it, ended by an interim. No precedence: a Times or DividedBy stands alone between two named values. Tree and chain mix both ways.
• Absence and approximation. A missing given or a division by zero makes every dependent quantity absent, with the reason - never zero. Where the rounded operands do not give the rounded result, the result is marked "≈".
• Assessment and freshness through core: target and limits on any quantity, source, asOf and ages on a given; the worst verdict inside a folded row stands beside it.
• The statement: a surface in the material of the library's tables and cards, rows of one height, fixed columns for label, names, operator, number, unit and assessment. The outermost statement stands as on paper and closes on the Result, underlined twice. Every other derivation is folded and opens beneath its row, joined to it by a falling line and closing with "= label"; the row never moves. A folded row shows the formula it hides in names, or how many operands there are above four. The verdict is core's Badge; "≈" explains itself in a Tooltip. Narrower than 34 rem the layout gives the numbers room.
• Accessibility: a nested list, one sentence per row - "Availability equals Run time divided by Planned production time, equals 412 min divided by 450 min, equals 91.6 percent" - and a disclosure button per derivation.
• Development errors on the first render, each saying which and where: a Ref to nothing (listing the ids that exist), a circle through references, a wrong operand count, a duplicate id, a component of the caller's own wrapping an element, and every rule of the chain.

Suggest an edit on GitHub