@umriss-ui/dashboard 0.45.0 → 0.47.0

package/CHANGELOG.md

@@ -4,7 +4,7 @@ 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. The six packages are released in step, and a rename
+when something is repaired. The seven 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
@@ -13,6 +13,30 @@ one section before an upgrade reads that one.
 
 The dashboard joins the other five packages' one number at its first version: they are released together, and a package without a change of its own still gets a heading for it.
 
+## 0.47.0 – Released in step with alarms (Oct. 2026)
+
+No change of its own; the number moves with the new package `@umriss-ui/alarms`.
+
+### Changed
+
+- **The peer ranges move to `^0.47.0`.**
+  - Migration: install the 0.47 version of `@umriss-ui/core` beside it.
+
+## 0.46.0 – A locked widget, a heading level, and stored options (Oct. 2026)
+
+### Added
+
+- **`DashboardWidget` takes `locked`**, set by the application: the reader can move a locked widget but not resize it, change its options or remove it, and the editing mode says so on its head and in its menu. The lock lives in the view; an example shows how an application brings it into arrangements kept before it.
+- **`headingLevel` on `Dashboard`** sets the level of its heading widgets (2 to 6, default 2); a dashboard that holds a heading widget has its widget titles one level below them.
+- **The demo:** a widget for one role that survives "Done" by another, an arrangement migrated from an older release, and a row of the widget's own controls above its chart. ADR-0032 and ADR-0064 name a mimic layer, uncertainty propagation and dragging from the catalogue as never.
+
+### Changed
+
+- **A kept arrangement's widgets are read with their options spread over the type's `defaultOptions`**, one level deep, so a key a later update adds is never `undefined`; absent, `null`, array or primitive options read as the defaults, and a widget of an undeclared type keeps its options as stored.
+  - Migration: an application that merged the defaults into stored options itself may drop that code.
+- **The peer range on core moves to `^0.46.0`.**
+  - Migration: install the 0.46 version of `@umriss-ui/core` beside it.
+
 ## 0.45.0 – Moves along (Oct. 2026)
 
 No change of its own; the dashboard is released with the other five under one number.

package/README.md

@@ -34,7 +34,9 @@ a test, without a layout engine.
 back `Dashboard` and `WidgetType`. A widget type is JSX: its name, a sentence,
 the sizes it offers with the columns (of twelve) and rows each takes, the size
 to start from, its default options, and its content as a function of the size
-and the options. The options type is inferred from the default options.
+and the options. The options type is inferred from the default options. The
+`headingLevel` prop (2 to 6, default 2) is the level of the heading widgets, and a
+widget's title stands one level below them when the dashboard holds one.
 
 ```tsx
 import { Stat } from "@umriss-ui/core";
@@ -85,8 +87,19 @@ const { Dashboard, WidgetType } = useDashboard({
 - **Every action without a drag.** One menu on every widget's head moves,
   sizes, sets the options and removes; the head is also the grip for a pointer
   and takes the arrow keys. Every change is announced.
-- **A kept arrangement is read leniently.** A widget of a type that is gone
-  falls out, a size a type no longer offers falls back to its starting size.
+- **A locked widget moves and nothing else changes it.** The application sets
+  `locked: true` on a widget of the view; the reader can move it, but not
+  resize it, change its options or remove it, and the editing mode says so on
+  its head and in its menu. The mark lives in the view, so it comes back through
+  `initialView` and "Reset" brings back the default's. Only the application sets
+  it; the reader never can. An arrangement a reader kept before the lock lacks
+  it: the application sets it before `initialView`, as the demo's "A widget every
+  reader keeps" shows.
+- **A kept arrangement is read leniently.** A widget of a type not declared is
+  not drawn and stays in the stored arrangement: "Done" keeps it after the
+  widgets that are drawn, so a widget behind a role, a flag or a plugin loaded
+  late is never lost. A size a type no longer offers falls back to its starting
+  size, and options a stored widget lacks come from its type's default options.
   A widget whose content throws keeps its frame and says so in a sentence.
 - **A failed widget is reported and may be retried.** React's `onCaughtError`,
   given to `createRoot` or to the application's root, receives the error of a