@iyulab/router 0.15.0 → 0.15.2

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [0.15.2] - 2026-09-23
+
+### Fixed
+
+- **A wide descendant no longer widens the route screen past the outlet.** 0.15.0 made
+  `<u-outlet>` a grid container without declaring a column track. The implicit column is `auto`,
+  and a grid item's default `min-width: auto` passes its content's minimum width up to the track,
+  so a wide table widened the whole screen — even inside an `overflow-x: auto` box — and anything
+  aligned to the screen's right edge, such as a toolbar's last button, was pushed off screen. The
+  track is now `minmax(0, 1fr)`: the screen is exactly as wide as the outlet, a narrow screen still
+  fills it, and wide content scrolls inside its own box. Print is unaffected (the outlet is a block
+  box there). The rule keeps zero specificity, so `u-outlet { grid-template-columns: auto; }`
+  restores the previous track.
+
+## [0.15.1] - 2026-09-17
+
+### Fixed
+
+- **Printing no longer adds a trailing blank page when a screen's last block has a bottom
+  margin.** 0.15.0 made `<u-outlet>` a grid container in every medium. A grid container keeps
+  its children's margins inside its own box, so the last block's bottom margin added to the
+  outlet's height; when the content ended within that margin of a page boundary, the outlet
+  spilled onto a page that held only the margin. In print media the outlet is now a block box,
+  which lets the margin collapse past it and be truncated at the page break:
+
+  ```css
+  @media print { :where(u-outlet) { display: block; } }
+  ```
+
+  Screen layout is unchanged. The grid only matters when the parent has a definite height, and
+  an application shell normally sets one for screen media only.
+
 ## [0.15.0] - 2026-09-16
 
 ### Changed

package/README.md

@@ -144,12 +144,13 @@ const routes = [
 ## Outlet Layout
 
 `<u-outlet>` declares its own box model. A custom element's UA default is `inline`, which
-would put a route's block-level screen inside an inline box — so the outlet adopts a single
-rule on whichever tree it is connected to (the document, or the shadow root if it lives in
+would put a route's block-level screen inside an inline box — so the outlet adopts its
+rules on whichever tree it is connected to (the document, or the shadow root if it lives in
 one):
 
 ```css
-:where(u-outlet) { display: grid; min-height: 100%; }
+:where(u-outlet) { display: grid; grid-template-columns: minmax(0, 1fr); min-height: 100%; }
+@media print { :where(u-outlet) { display: block; } }
 ```
 
 The outlet has to be two things at once, and no single declaration gives both:
@@ -178,19 +179,41 @@ The rule deliberately omits `align-content`; it relies on the initial `normal`.
 `align-content: start` stops the track from stretching and silently voids case 1.
 
 When the parent's own height is `auto`, `min-height: 100%` resolves to `auto` too, so ordinary
-document flow and printing are unaffected.
+document flow is unaffected.
+
+The column track is bound to the outlet's width with `minmax(0, 1fr)`. Without it the implicit
+column is `auto`, and a grid item's default `min-width: auto` passes its content's minimum width up
+to the track — so a wide table inside a screen widened the whole screen past the outlet, even when
+the table sat in an `overflow-x: auto` box, and anything aligned to the screen's right edge (a
+toolbar's last button) ended up off screen. With the track bound, the screen is exactly as wide as
+the outlet, a narrow screen still fills it, and wide content scrolls inside its own box.
+
+### Printing
+
+In print media the outlet is a plain block box instead of a grid container. A grid container is
+an independent formatting context, so the bottom margin of a screen's last block cannot collapse
+through it — the margin lands *inside* the outlet's box and adds to its height. On screen that is
+harmless. On paper it is not: when content ends within that margin of a page boundary, the box
+spills onto a new page that holds nothing but the margin. As a block box, the outlet lets the
+margin collapse past it to the end of the document, and a margin that meets a page break is
+truncated there, so no trailing blank page appears.
+
+Print loses nothing by this. The grid exists to pass a *sized* parent's height down, and an
+application shell normally sizes itself to the viewport only for screen media; in print the
+parent's height is `auto`, and `min-height: 100%` resolves to nothing.
 
 ### Overriding it
 
-The `:where()` wrapper makes the rule's specificity zero, so **any** `u-outlet { … }` rule your
+The `:where()` wrapper makes both rules' specificity zero, so **any** `u-outlet { … }` rule your
 application writes wins, regardless of sheet order and without `!important`:
 
 ```css
 u-outlet { display: flex; }                    /* wins */
+u-outlet { grid-template-columns: auto; }      /* restores the 0.15.1 column track */
 u-outlet { display: contents; }                /* remove the box entirely */
 u-outlet { display: block; height: 100%; }     /* restores the 0.14.0 behavior */
 u-outlet { display: inline; }                  /* restores the pre-0.14.0 behavior */
-@media print { u-outlet { … } }                /* wins */
+@media print { u-outlet { display: grid; } }  /* restores the 0.15.0 print behavior */
 ```
 
 > **Making the outlet *smaller* takes two declarations, not one.** `min-height` is a floor, so
@@ -198,7 +221,6 @@ u-outlet { display: inline; }                  /* restores the pre-0.14.0 behavi
 > `u-outlet { min-height: 0; height: 200px }`. Making it *larger*, or replacing `display`, needs
 > nothing extra. This is the only contract addition in 0.15.0.
 
-The rule is not media-scoped: the outlet is a block-level box on screen and in print alike.
 
 `<u-link>` supports `href`, `target`, `rel`, and `navigate`.