@umriss-ui/charts 0.41.1 → 0.42.0

package/CHANGELOG.md

@@ -4,11 +4,12 @@ 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 a rule stronger than the figure applies as
-well: **whatever changes existing behaviour stands under a heading "Changed" of
-its own**, no matter which digit rose. Whoever reads only one section before an
-upgrade reads that one.
+when something is repaired. The six packages are released in step, and a rename
+keeps its old name for one further minor, with a warning, before the minor after
+it removes the name ([the upgrade promise, ADR-0066](../../docs/adr/0066-one-number-peers-over-the-minor-a-rename-lives-one-minor.md)).
+**Whatever changes existing behaviour stands under a heading "Changed" of its
+own**, no matter which digit rose, with a `Migration:` line. Whoever reads only
+one section before an upgrade reads that one.
 
 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.
 
@@ -29,12 +30,22 @@ interface was still expected to move before `0.3.0`.
 
 ---
 
+## 0.42.0 – A chart under test in jsdom (Oct. 2026)
+
+### Added
+
+- **A chart is testable in jsdom.** The new "Testing" section gives the Vitest and Jest lines in full - a charts-only application installs no core - with a setup file whose ResizeObserver reports a fixed size and whose `getContext` stub keeps jsdom quiet; `.` and `./wording/de` carry a `default` condition for Jest's resolver. The release check runs a test of a legend and the data table from those blocks under both runners.
+- **The README names `--u-chart-1` to `--u-chart-6`** as the palette a brand changes, beside core's brand file.
+- **TypeScript 5.4 or newer**, stated in the Install section (the declarations use `NoInfer`); the release check compiles a strict consumer under 5.4 as well as the current TypeScript.
+
 ## 0.41.1 – The documentation runs where the code is (Oct. 2026)
 
 ### Changed
 
 - **The documentation is no longer hosted.** The site on GitHub Pages is gone, and the package's `homepage` now names its README on GitHub. The running documentation of this version opens from a checkout of the tag `charts-v0.41.1` with `pnpm install` and `pnpm start`, at `http://localhost:4170/umriss-ui/` - the repository README says how, under "See it running".
+  - Migration: nothing to change; a bookmark or link to the old hosted site no longer resolves - open the documentation from a checkout of the tag, as described above.
 - **`docs/llms-full.md` in the package stands on its own:** a link to another page points at that page's heading in the same file, a link to a place on the site that the file does not hold keeps only its text, and ADR-0032 is linked at this version's tag.
+  - Migration: nothing to change; look at any tool that read `docs/llms-full.md` and followed its links to the site, which now find the heading in the same file.
 
 ## 0.41.0 – Limits read as values, and Jest loads the charts (Oct. 2026)
 

package/README.md

@@ -16,7 +16,7 @@ lint rule over `packages/charts/src/**` holds that fast.
 pnpm add @umriss-ui/charts
 ```
 
-React 19 or newer as a peer, and nothing else. `@umriss-ui/core` is **not** a
+React 19 or newer as a peer, and nothing else. TypeScript 5.4 or newer (the declarations use `NoInfer`). `@umriss-ui/core` is **not** a
 dependency and not a peer dependency — if an application uses both packages, it
 does so because it chose to, not because this one required it (ADR-0020).
 
@@ -24,8 +24,11 @@ The package ships ES2022 syntax; an application that serves older browsers
 transpiles it itself.
 
 Every entry, `./wording/de` included, begins with `"use client"`, the directive a framework
-with Server Components reads to treat a module as client code. No test runs
-inside such a framework: the charts are rendered to a string in a test.
+with Server Components reads to treat a module as client code. A chart is declared by its hook,
+`useChart`, so the declaration lives in a Client Component file: a Server Component renders that
+file and hands it the rows. On a server a chart gives its labelled frame and an empty canvas; the
+drawing arrives after mount. No test runs inside such a framework: the charts are rendered to a
+string in a test.
 
 ## The smallest chart that runs
 
@@ -98,7 +101,8 @@ wins. `@umriss-ui/charts/styles.css` stays exported for setups that link
 stylesheets by hand.
 
 **Colours** come from `--uc-*` variables that fall back to the tokens of
-`@umriss-ui/core` where they exist and to literals where they do not. **Light and
+`@umriss-ui/core` where they exist and to literals where they do not. The palette is `--u-chart-1` to
+`--u-chart-6`; core's README holds a brand file that sets them, light and dark. **Light and
 dark** follow the application's `color-scheme`: the canvas colours are resolved
 anew when the root element's attributes or the system preference change;
 `invalidateTheme()` covers a switch made on another ancestor. **Fonts** are not
@@ -164,6 +168,80 @@ next kind to come (ADR-0059).
 * [`../../docs/design-language.md`](../../docs/design-language.md) — the design
   language all five packages share.
 
+## Testing
+
+Tested: Vitest 5 and Jest 30 (with babel-jest), both on jsdom. happy-dom and Jest 29 may work and are
+not promised. `check:dist` runs a test of the installed package in a Vitest project and a Jest project
+that hold exactly the files below. A chart-only application installs no core, so the lines are given in
+full here.
+
+**Vitest** needs one line, `server.deps.inline`: Vitest hands a dependency to Node, and Node cannot
+import the stylesheet that the package's JavaScript imports (`Unknown file extension ".css"`). Inlined,
+Vitest's own pipeline handles it.
+
+```ts vitest.config.ts
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "jsdom",
+    globals: true,
+    setupFiles: ["./umriss.setup.js"],
+    server: { deps: { inline: [/@umriss-ui/] } },
+  },
+});
+```
+
+**Jest** needs two settings: `moduleNameMapper` maps every stylesheet to an empty module, and
+`transformIgnorePatterns` lets babel-jest compile the package, which ships ES modules. Babel's config
+must apply to `node_modules`, so it is a root `babel.config.*`, not a `.babelrc`.
+
+```js jest.config.cjs
+module.exports = {
+  testEnvironment: "jsdom",
+  setupFilesAfterEnv: ["<rootDir>/umriss.setup.js"],
+  moduleNameMapper: { "\\.css$": "<rootDir>/css-stub.cjs" },
+  transformIgnorePatterns: ["/node_modules/(?!(@umriss-ui)/)"],
+};
+```
+
+```js css-stub.cjs
+module.exports = {};
+```
+
+```js babel.config.cjs
+module.exports = {
+  presets: [
+    ["@babel/preset-env", { targets: { node: "current" } }],
+    ["@babel/preset-react", { runtime: "automatic" }],
+  ],
+};
+```
+
+**Next.js** with `next/jest`: put the umriss packages in `transpilePackages`; the preset stubs the
+stylesheets and compiles the packages itself.
+
+**The setup file** gives jsdom what a chart needs to lay out. jsdom measures nothing, so the
+`ResizeObserver` reports a fixed size (600 x 280) for whatever it observes; without a size the chart
+stays empty, and neither the legend nor "Show data" appears. jsdom has no canvas, so `getContext`
+returns `null`, which a chart copes with. The file is the same for both runners:
+
+```js umriss.setup.js
+globalThis.ResizeObserver = class {
+  constructor(callback) {
+    this.callback = callback;
+  }
+  observe(target) {
+    const box = { inlineSize: 600, blockSize: 280 };
+    this.callback([{ target, contentRect: { width: 600, height: 280 }, contentBoxSize: [box] }], this);
+  }
+  unobserve() {}
+  disconnect() {}
+};
+
+HTMLCanvasElement.prototype.getContext = () => null;
+```
+
 ## Licence
 
 MIT — see [`LICENSE`](LICENSE).

package/docs/llms-full.md

@@ -1,4 +1,4 @@
-# @umriss-ui/charts 0.41.1
+# @umriss-ui/charts 0.42.0
 
 > React canvas chart library for data-dense dashboards - line, area, bar, box plot, scatter, control and Pareto charts. Few chart kinds, drawn well, fast.
 
@@ -2267,9 +2267,9 @@ Measurements of the instrumentation for the benchmark page.
 #### Known limits
 
 - No error state of its own: where the rows could not be loaded, show an `Alert` from @umriss-ui/core. Waiting for them is `loading`.
-- No pie, donut, radar or candlestick, no smoothing, animation or export, no WebGL ([ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.41.1/docs/adr/0032-what-umriss-is-not.md)).
+- No pie, donut, radar or candlestick, no smoothing, animation or export, no WebGL ([ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.42.0/docs/adr/0032-what-umriss-is-not.md)).
 
-What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.41.1/docs/adr/0032-what-umriss-is-not.md).
+What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.42.0/docs/adr/0032-what-umriss-is-not.md).
 
 ### Axis
 
@@ -3024,10 +3024,10 @@ schedule's shape.
 
 #### Known limits
 
-- No logarithmic and no band scale: compute the logarithm in `value`; a category is a place on the linear scale ([ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.41.1/docs/adr/0032-what-umriss-is-not.md), [ADR-0052](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0052-a-chart-reads-its-rows-as-they-come.md)).
+- No logarithmic and no band scale: compute the logarithm in `value`; a category is a place on the linear scale ([ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.42.0/docs/adr/0032-what-umriss-is-not.md), [ADR-0052](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0052-a-chart-reads-its-rows-as-they-come.md)).
 - umriss shows the reader's time ([ADR-0060](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0060-validation-and-a-layout-editor-are-never-time-zones-not-yet.md)).
 
-What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.41.1/docs/adr/0032-what-umriss-is-not.md).
+What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.42.0/docs/adr/0032-what-umriss-is-not.md).
 
 ### Zoom and pan
 
@@ -3697,7 +3697,7 @@ The optional numbers of a box by name.
 
 - No zoom along y, no rectangle zoom and no navigator: the x span is the one zoom there is.
 
-What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.41.1/docs/adr/0032-what-umriss-is-not.md).
+What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.42.0/docs/adr/0032-what-umriss-is-not.md).
 
 ### View
 
@@ -3966,7 +3966,7 @@ The optional numbers of a box by name.
 
 - The active point and the open data table are not part of the view: they are where the reader is, not how the chart is looked at.
 
-What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.41.1/docs/adr/0032-what-umriss-is-not.md).
+What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.42.0/docs/adr/0032-what-umriss-is-not.md).
 
 ## Series
 
@@ -4482,9 +4482,9 @@ type ValueFunction<T> = (d: T, index: number) => number | null | undefined;
 
 #### Known limits
 
-- No smoothing: a curve between two readings would invent values nobody measured ([ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.41.1/docs/adr/0032-what-umriss-is-not.md)).
+- No smoothing: a curve between two readings would invent values nobody measured ([ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.42.0/docs/adr/0032-what-umriss-is-not.md)).
 
-What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.41.1/docs/adr/0032-what-umriss-is-not.md).
+What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.42.0/docs/adr/0032-what-umriss-is-not.md).
 
 ### Area
 
@@ -5229,7 +5229,7 @@ type ValueFunction<T> = (d: T, index: number) => number | null | undefined;
 
 - Horizontal bars are the next kind to come ([ADR-0059](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0059-the-set-of-chart-kinds-is-open.md)); until then a `Matrix` or a `Table` ranks by name.
 
-What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.41.1/docs/adr/0032-what-umriss-is-not.md).
+What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.42.0/docs/adr/0032-what-umriss-is-not.md).
 
 ### Scatter
 
@@ -6100,7 +6100,7 @@ type ListFunction<T> = (d: T, index: number) => readonly number[] | null | undef
 
 - No horizontal boxes, no violin or jittered points, no box width by count: a density is smoothing, a jitter a picture that does not repeat.
 
-What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.41.1/docs/adr/0032-what-umriss-is-not.md).
+What umriss deliberately does not build, and why: [ADR-0032](https://github.com/romanhaendler/umriss-ui/blob/charts-v0.42.0/docs/adr/0032-what-umriss-is-not.md).
 
 ### StateBand
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umriss-ui/charts",
-  "version": "0.41.1",
+  "version": "0.42.0",
   "description": "React canvas chart library for data-dense dashboards - line, area, bar, box plot, scatter, control and Pareto charts. Few chart kinds, drawn well, fast.",
   "license": "MIT",
   "author": "Roman Händler",
@@ -56,11 +56,13 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/charts.js"
+      "import": "./dist/charts.js",
+      "default": "./dist/charts.js"
     },
     "./wording/de": {
       "types": "./dist/de.d.ts",
-      "import": "./dist/wording/de.js"
+      "import": "./dist/wording/de.js",
+      "default": "./dist/wording/de.js"
     },
     "./styles.css": {
       "types": "./dist/styles.d.ts",
@@ -84,7 +86,7 @@
     "vite": "^6.0.0",
     "vite-plugin-dts": "^4.3.0",
     "@umriss-ui/demo": "0.0.0",
-    "@umriss-ui/core": "0.41.1"
+    "@umriss-ui/core": "0.42.0"
   },
   "scripts": {
     "props": "node --disable-warning=ExperimentalWarning --experimental-strip-types demo/props.ts",