@nxgt/material 3.25.0 → 3.25.1

package/docs/guides/app-shell.md

@@ -508,7 +508,8 @@ The layout paints `bg-ground` (the `--ground` token, see [Page ground](./theming
 on its root, so the content, the gutters and the space between the chrome and
 the content are tinted, with or without a `backdrop`, in light and dark. The
 sidebar and the app bar stay on `--background`: flat rectangles with no radius
-and no shadow (translucent over a backdrop, about 90 % without one), so the edge
+and no shadow (translucent over a backdrop, about 90 % without one; the sidebar's
+fill runs the page's whole height, out to the frame's edges), so the edge
 between chrome and content is the change of colour. The cards, and the
 `ActivityContent` header card (`bg-card`), stand on the ground with their
 hairline and soft shadow. With `scroll="container"` the same ground stays behind

package/docs/troubleshooting.md

@@ -712,6 +712,20 @@ Vite and React Router apps use:
 
 ## Styles & assets
 
+### The backdrop shapes disappeared between the cards (3.22+)
+
+**When:** an `ActivityLayout` with `backdrop={<Background preset="shapes" ... />}`
+on a page whose cards sit close together. On 3.20 shapes showed in the gaps and
+around the cards; now only the open areas (below the last card, beside a short
+list) hold shapes.
+**Why:** not the page ground (`--ground` is painted by the layout root, under the
+backdrop layer). Since 3.22 a glyph whose box meets a surface, a text or a
+control, within 8px, is dropped whole (the keep-clear pass), so a gap narrower
+than a glyph shows none.
+**Fix:** none needed, it is the documented behaviour (see [the drop rule](./guides/backgrounds.md) in
+the backgrounds guide). To see more shapes, leave open space in the page, or draw
+the backdrop in a layout that has no content over it.
+
 ### The page and the cards look the same
 
 **When:** a screen under `ActivityLayout`, after the 3.24 upgrade or on an older

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nxgt/material",
-	"version": "3.25.0",
+	"version": "3.25.1",
 	"license": "MIT",
 	"bugs": {
 		"email": "stevegires@gmail.com"