gridsmith-ui 0.28.0 → 0.29.0

package/CHANGELOG.md

@@ -1,6 +1,27 @@
 # gridsmith-ui changelog
 
-## Unreleased (0.28.0)
+## 0.29.0 — 6 October 2026
+
+The deprecated props are removed before beta (Sprint 28.2, B8). Each was an alias kept for one version after its replacement shipped, and code that still writes one fails the type-check, as any unknown prop does: a 0.x minor release, 0.29.0, says so, and an app pinned to `^0.28.0` doesn't reach it by itself. The upgrade note at the end says what to write instead.
+
+**Removed.**
+- **StackedList `flush` and `hover`.** Since Sprint 25.4 both mapped onto the articles variant, with a console note. The list takes its inset from what it sits on by itself, and an article list on the canvas writes `variant="articles"`.
+- **CheckboxGroupItem `groupValue` and `onGroupChange`.** The CheckboxGroup around the items hands them its `value` and `onChange`.
+- **`"default"` from the navbar family's `type`** (Navbar, NavItem, NavMenu, MobileHeaderMenu): it was tint's name before Sprint 20.8. A value that isn't a style still reads as tint at runtime.
+- **`"fill"` from ChartContainer's `height`**: since Sprint 25.9 it was the same as `"auto"`, the default.
+- **AvatarGroupItem's `status`**: a group has drawn no status since 30 September, so the field did nothing.
+
+### Upgrade note for agents (0.28.0 → 0.29.0)
+
+Upgrade `gridsmith-ui` to `^0.29.0` (an app pinned to `^0.28.0` never reaches it), then replace each removed prop; `check_compliance` names each one with its replacement:
+- **StackedList `flush`.** Delete it. The default list takes its inset from what it sits on: level with the heading on the canvas or under a SectionHeading, padded in a Card, at the pane's inset in a SplitView, with room for the selection rail when rows are selectable. Only an article list on the canvas (a knowledge base, a changelog, a help centre) takes `variant="articles"`, and never in a SplitView pane. `flush={false}`: delete it.
+- **StackedList `hover`.** `hover="title"` on an article list on the canvas becomes `variant="articles"`; anywhere else, and any other `hover`, delete it.
+- **CheckboxGroupItem `groupValue` and `onGroupChange`.** Delete them, and give the CheckboxGroup around the items `value` and `onChange`.
+- **`type="default"` on Navbar, NavItem, NavMenu or MobileHeaderMenu.** Write `type="tint"`, or delete it: an item inside a Navbar takes the Navbar's type, and a Navbar's comes from the theme.
+- **ChartContainer's `"fill"` height.** Delete the height: the chart sizes itself.
+- **AvatarGroupItem's `status`.** Delete it from the items; show someone's status with a single Avatar beside their name.
+
+## 0.28.0 — 5 October 2026
 
 One focus state and readable quiet colours (Sprint 30). Two looks replace the many each component drew: **keyboard focus**, where Tab has landed, is one outline, 2 px with a 2 px gap, in a colour derived to read on the theme's grounds, shown only from the keyboard; **active**, what was clicked or opened (a field clicked into, an open dropdown or picker, a file over a drop zone), is the accent border with a soft halo. Choices keep their selected look, never an outline or a halo. While an element shows the outline its own shadow steps aside. A field shows the outline when Tab reaches it and the active look when clicked into, by a small note of how focus arrived. The quiet colours read: muted and secondary text, the accent as text, the accent's tint's words and each status's words are derived to their WCAG minimum against what they sit on, the theme's own colour wherever it already reaches it. Two tokens are removed (`--ds-shadow-focus`, `--ds-input-focus-ring`), which breaks code that names them, and focus and the quiet colours change in most themes: a 0.x minor release, 0.28.0, says so, and an app pinned to `^0.27.0` doesn't reach it by itself. The upgrade note at the end says what an app on 0.27.0 does.
 

package/dist/charts.d.ts

@@ -382,10 +382,10 @@ interface ChartContainerProps {
     /**
      * "auto" (the default): the chart sizes itself from its type and its data (Sprint 25.9, A2) — a row per item for
      * sideways bars and funnels, two wide to one high for charts over dates or numbers, square for round charts — and in
-     * a row its frame matches the tallest block while the chart grows only to its bound. "fill" means the same as "auto".
+     * a row its frame matches the tallest block while the chart grows only to its bound.
      * A preset (sm, md, lg) or a number of px sets this chart's height instead, and beats the chart's own.
      */
-    height?: "auto" | "fill" | "sm" | "md" | "lg" | number;
+    height?: "auto" | "sm" | "md" | "lg" | number;
     /** The insight, as a heading (h3) in the card-title style, never cut. The chart's graphic is named by it. */
     title?: string;
     loading?: boolean;