@umriss-ui/charts 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -29,6 +29,20 @@ interface was still expected to move before `0.3.0`.
 
 ---
 
+## 0.13.0 – A chart fills its frame, never below its floor (Oct. 2026)
+
+### Changed
+
+- **A `Chart` without `height` fills its frame** and never goes below 300 px
+  (ADR-0050). Standing alone in a block it is 300 px tall, as before. In a
+  frame taller than that - a stretched grid cell, a card the grid stretches, a
+  container of definite height - it now takes that height, and follows the
+  frame both ways as it grows and shrinks. A number still means a fixed height;
+  a different floor goes through `style={{ minHeight }}`. The descriptions of
+  `height` and `style` say so.
+
+---
+
 ## 0.12.0 – A chart that is loading says so (Oct. 2026)
 
 A chart takes `loading`, as the table does (ADR-0042). Over a course already

package/dist/charts.js

@@ -4647,7 +4647,7 @@ function $o(i) {
     data: t,
     scene: e,
     width: n = "100%",
-    height: s = 300,
+    height: s,
     padding: o = 8,
     ariaLabel: r,
     className: l,
@@ -4723,7 +4723,9 @@ function $o(i) {
     () => !1
   ), R = Eo(e), L = (R == null ? void 0 : R.leaving) === !0, V = {
     width: n === "100%" ? "100%" : `${n}px`,
-    height: `${s}px`,
+    // Without a number: 100% where the frame has a definite height, auto where
+    // it has none, and the floor either way (ADR-0050).
+    ...s === void 0 ? { height: "100%", minHeight: 300 } : { height: `${s}px` },
     ...a
   }, W = (D) => {
     e.drag(D.nativeEvent), e.pointerMove(D.nativeEvent.offsetX, D.nativeEvent.offsetY);

package/dist/index.d.ts

@@ -394,9 +394,12 @@ export declare interface ChartProps {
      host and follows it through a ResizeObserver.
      @default "100%" */
     width?: number | "100%";
-    /** Height in CSS pixels. Unlike the width, the chart does not take its
-     host's.
-     @default 300 */
+    /** Height in CSS pixels, fixed. Left out, the chart fills its frame - a
+     stretched grid cell, a card the grid stretches, a container of definite
+     height - and never goes below 300 px, which is also its height in a
+     frame without one. A different floor goes through `style`'s `minHeight`
+     (ADR-0050).
+     @default fills the frame, at least 300 px */
     height?: number;
     /** Outer spacing of the plot area in CSS pixels. */
     padding?: number | Partial<Padding>;
@@ -405,9 +408,9 @@ export declare interface ChartProps {
     ariaLabel?: string;
     /** Goes to the root element, as it does everywhere in this workspace. */
     className?: string;
-    /** Goes to the root element. The plot area is measured, never styled from
-     here: a height set past the component is a height the scene does not know
-     about. */
+    /** Goes to the root element, after the chart's own styles: a `height` or
+     `minHeight` set here wins. The plot area is observed in both directions
+     and the scene follows it. */
     style?: CSSProperties;
     /** Shown in the middle of the plot area when no visible series has a point
      to show - no data, only gaps, or every series hidden. Axes and frame

package/docs/llms-full.md

@@ -1,4 +1,4 @@
-# @umriss-ui/charts 0.12.0
+# @umriss-ui/charts 0.13.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.
 
@@ -1324,7 +1324,7 @@ From `ChartProps` — the full table stands on [Chart](#/chart/type-ChartProps).
 | Prop | Type | Default | Description |
 |---|---|---|---|
 | [`width`](#/chart/ChartProps-width) | `number \| "100%"` | `"100%"` | Width in CSS pixels, or `"100%"` for the host's: the chart measures its host and follows it through a ResizeObserver. |
-| [`height`](#/chart/ChartProps-height) | `number` | `300` | Height in CSS pixels. Unlike the width, the chart does not take its host's. |
+| [`height`](#/chart/ChartProps-height) | `number` | fills the frame, at least 300 px | Height in CSS pixels, fixed. Left out, the chart fills its frame - a stretched grid cell, a card the grid stretches, a container of definite height - and never goes below 300 px, which is also its height in a frame without one. A different floor goes through `style`'s `minHeight` ([ADR-0050](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0050-a-chart-fills-its-frame-never-below-its-floor.md)). |
 | [`children`](#/chart/ChartProps-children) | `ReactNode` | — | The axes, series and companions of this chart. They draw nothing themselves: each registers its configuration and the scene draws it, and the order in the JSX is the drawing order. |
 
 ###### Accessibility
@@ -2209,7 +2209,7 @@ Under forced colours the chart draws in the system colours and tells its series
 | Prop | Type | Default | Description |
 |---|---|---|---|
 | `width` | `number \| "100%"` | `"100%"` | Width in CSS pixels, or `"100%"` for the host's: the chart measures its host and follows it through a ResizeObserver.<br>Shown in: [Size a chart by its container (Installation)](#/installation/in-its-container) |
-| `height` | `number` | `300` | Height in CSS pixels. Unlike the width, the chart does not take its host's.<br>Shown in: [Mix series kinds](#/chart/mixed), [Say there is nothing to show](#/chart/empty), [Read it by keyboard and screen reader](#/chart/keyboard-and-screen-reader) and 68 more |
+| `height` | `number` | fills the frame, at least 300 px | Height in CSS pixels, fixed. Left out, the chart fills its frame - a stretched grid cell, a card the grid stretches, a container of definite height - and never goes below 300 px, which is also its height in a frame without one. A different floor goes through `style`'s `minHeight` ([ADR-0050](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0050-a-chart-fills-its-frame-never-below-its-floor.md)).<br>Shown in: [Mix series kinds](#/chart/mixed), [Say there is nothing to show](#/chart/empty), [Read it by keyboard and screen reader](#/chart/keyboard-and-screen-reader) and 68 more |
 | `padding` | `number \| Partial<`[`Padding`](#type-Padding)`>` | — | Outer spacing of the plot area in CSS pixels.<br>Shown in: [Fix the domain and name the ticks (Axis)](#/axis/configuration) |
 | `empty` | `ReactNode` | the wording's `empty` | Shown in the middle of the plot area when no visible series has a point to show - no data, only gaps, or every series hidden. Axes and frame stay. Not while `loading`.<br>Shown in: [Say there is nothing to show](#/chart/empty) |
 | `loading` | `boolean` | `false` | The rows are on their way, as the table's `loading` says ([ADR-0042](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0042-a-rows-height-never-follows-what-it-shows.md)). A course already drawn stays: it dims after a moment and takes no pointer until the answer is in. Where there is nothing to show, the empty message waits. The plot is `aria-busy` meanwhile.<br>Shown in: [Show that rows are on their way](#/chart/loading) |
@@ -2235,7 +2235,7 @@ Under forced colours the chart draws in the system colours and tells its series
 | Prop | Type | Default | Description |
 |---|---|---|---|
 | `className` | `string` | — | Goes to the root element, as it does everywhere in this workspace. |
-| `style` | `CSSProperties` | — | Goes to the root element. The plot area is measured, never styled from here: a height set past the component is a height the scene does not know about. |
+| `style` | `CSSProperties` | — | Goes to the root element, after the chart's own styles: a `height` or `minHeight` set here wins. The plot area is observed in both directions and the scene follows it. |
 
 ##### Types on this page
 
@@ -8981,7 +8981,7 @@ From `ChartProps` — the full table stands on [Chart](#/chart/type-ChartProps).
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| [`height`](#/chart/ChartProps-height) | `number` | `300` | Height in CSS pixels. Unlike the width, the chart does not take its host's. |
+| [`height`](#/chart/ChartProps-height) | `number` | fills the frame, at least 300 px | Height in CSS pixels, fixed. Left out, the chart fills its frame - a stretched grid cell, a card the grid stretches, a container of definite height - and never goes below 300 px, which is also its height in a frame without one. A different floor goes through `style`'s `minHeight` ([ADR-0050](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0050-a-chart-fills-its-frame-never-below-its-floor.md)). |
 | [`children`](#/chart/ChartProps-children) | `ReactNode` | — | The axes, series and companions of this chart. They draw nothing themselves: each registers its configuration and the scene draws it, and the order in the JSX is the drawing order. |
 
 ###### Accessibility
@@ -10324,7 +10324,7 @@ From `ChartProps` — the full table stands on [Chart](#/chart/type-ChartProps).
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| [`height`](#/chart/ChartProps-height) | `number` | `300` | Height in CSS pixels. Unlike the width, the chart does not take its host's. |
+| [`height`](#/chart/ChartProps-height) | `number` | fills the frame, at least 300 px | Height in CSS pixels, fixed. Left out, the chart fills its frame - a stretched grid cell, a card the grid stretches, a container of definite height - and never goes below 300 px, which is also its height in a frame without one. A different floor goes through `style`'s `minHeight` ([ADR-0050](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0050-a-chart-fills-its-frame-never-below-its-floor.md)). |
 | [`children`](#/chart/ChartProps-children) | `ReactNode` | — | The axes, series and companions of this chart. They draw nothing themselves: each registers its configuration and the scene draws it, and the order in the JSX is the drawing order. |
 
 ###### Events

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umriss-ui/charts",
-  "version": "0.12.0",
+  "version": "0.13.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",
@@ -71,7 +71,7 @@
     "vite": "^6.0.0",
     "vite-plugin-dts": "^4.3.0",
     "@umriss-ui/demo": "0.0.0",
-    "@umriss-ui/core": "0.25.0"
+    "@umriss-ui/core": "0.30.0"
   },
   "scripts": {
     "props": "node --disable-warning=ExperimentalWarning --experimental-strip-types demo/props.ts",