@kerfjs/ui 5.0.0-beta.97 → 5.0.0-beta.99

package/dist/styles/list-action-row.css

@@ -10,9 +10,30 @@
   --kui-list-action-row-trailing-hover-background: var(
     --kui-color-neutral-fill-normal
   );
+  /* The leading (and trailing) content inset. An inherited
+     `--kui-list-row-padding-inline` on the containing List sets it for every
+     ListItem and ListActionRow at once; the +1px wherever it is used stands in
+     for the 1px border ListItem draws and this row paints as a box-shadow, so
+     both row kinds start their leading icons on one edge. */
+  --_kui-list-action-row-padding-inline: var(
+    --kui-list-row-padding-inline,
+    var(--kui-layout-item-padding, 0.5rem)
+  );
+  /* The leading icon size, shared with ListItem through an inherited
+     `--kui-list-row-icon-size` on the containing List, so a mixed list keeps
+     its labels on one edge. It defaults to ListItem's 18px row icon. */
+  --_kui-list-action-row-icon-size: var(--kui-list-row-icon-size, 1.125rem);
+  /* The row's minimum height and the primary button's block padding follow
+     density together, so a single-line label never holds a compact row
+     taller than its minimum (the label's own minimum is the difference). */
+  --_kui-list-action-row-min-height: 2.75rem;
+  --_kui-list-action-row-padding-block: var(
+    --kui-layout-item-padding,
+    0.5rem
+  );
   display: flex;
   width: calc(100% - (2 * var(--kui-layout-inline-margin, 0.5rem)));
-  min-height: 2.75rem;
+  min-height: var(--_kui-list-action-row-min-height);
   margin-inline: var(--kui-layout-inline-margin, 0.5rem);
   border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
   color: var(--kui-list-action-row-color);
@@ -22,12 +43,8 @@
 }
 
 .kui-list-action-row[data-density="compact"] {
-  min-height: 2.25rem;
-}
-
-.kui-list-action-row[data-density="compact"]
-  :is(.kui-list-action-row__primary, .kui-list-action-row__trailing-action) {
-  min-height: 2.25rem;
+  --_kui-list-action-row-min-height: 2.25rem;
+  --_kui-list-action-row-padding-block: 0.25rem;
 }
 
 .kui-list-action-row[data-divider="before"],
@@ -60,9 +77,12 @@
   border-end-end-radius: 0;
 }
 
-.kui-list-action-row:not([data-placeholder="true"]):has(
-    .kui-list-action-row__primary:hover
-  ) {
+/* A selected or pressed row keeps its selected tint while hovered. */
+.kui-list-action-row:not(
+    [data-placeholder="true"],
+    [data-selected="true"],
+    [data-pressed="true"]
+  ):has(.kui-list-action-row__primary:hover) {
   --kui-list-action-row-border: var(--kui-list-action-row-hover-border);
   --kui-list-action-row-background: var(--kui-list-action-row-hover-background);
 }
@@ -97,7 +117,7 @@
 .kui-list-action-row[data-drop-position]::after {
   position: absolute;
   z-index: 1;
-  inset-inline: var(--kui-layout-item-padding, 0.5rem);
+  inset-inline: var(--_kui-list-action-row-padding-inline);
   height: var(--kui-list-action-row-drop-indicator-width, 2px);
   border-radius: var(--kui-radius-pill);
   background: var(
@@ -119,7 +139,7 @@
 .kui-list-action-row__primary,
 .kui-list-action-row__trailing-action {
   height: auto !important;
-  min-height: 2.75rem;
+  min-height: var(--_kui-list-action-row-min-height);
   padding: 0;
   border: 0;
   appearance: none;
@@ -134,8 +154,9 @@
   display: block;
   flex: 1 1 auto;
   min-width: 2.75rem;
-  padding: var(--kui-layout-item-padding, 0.5rem);
-  padding-inline-start: calc(1px + var(--kui-layout-item-padding, 0.5rem));
+  padding-block: var(--_kui-list-action-row-padding-block);
+  padding-inline: calc(1px + var(--_kui-list-action-row-padding-inline))
+    var(--_kui-list-action-row-padding-inline);
   text-align: start;
 }
 
@@ -167,10 +188,10 @@
 .kui-list-action-row__icon {
   position: absolute;
   inset-block-start: 50%;
-  inset-inline-start: calc(1px + var(--kui-layout-item-padding, 0.5rem));
+  inset-inline-start: calc(1px + var(--_kui-list-action-row-padding-inline));
   display: grid;
-  width: 1.5rem;
-  height: 1.5rem;
+  width: var(--_kui-list-action-row-icon-size);
+  height: var(--_kui-list-action-row-icon-size);
   color: currentColor;
   transform: translateY(-50%);
   place-items: center;
@@ -178,15 +199,16 @@
 
 .kui-list-action-row__icon svg {
   display: block;
-  width: 1.5rem;
-  height: 1.5rem;
+  width: var(--_kui-list-action-row-icon-size);
+  height: var(--_kui-list-action-row-icon-size);
 }
 
 .kui-list-action-row__label {
   display: grid;
   min-width: 0;
   min-height: calc(
-    2.75rem - (2 * var(--kui-layout-item-padding, 0.5rem))
+    var(--_kui-list-action-row-min-height) -
+      (2 * var(--_kui-list-action-row-padding-block))
   );
   overflow: hidden;
   white-space: nowrap;
@@ -226,7 +248,8 @@
 
 .kui-list-action-row[data-has-icon="true"] .kui-list-action-row__label {
   margin-inline-start: calc(
-    1.5rem + var(--kui-layout-item-gap, 0.5rem)
+    var(--_kui-list-action-row-icon-size) +
+      var(--kui-layout-item-gap, 0.5rem)
   );
 }
 
@@ -244,7 +267,7 @@
 
 .kui-list-action-row[data-multiline="true"] .kui-list-action-row__icon {
   inset-block-start: calc(
-    var(--kui-layout-item-padding, 0.5rem) + (1lh / 2)
+    var(--_kui-list-action-row-padding-block) + (1lh / 2)
   );
 }
 
@@ -291,7 +314,139 @@
   height: 1rem;
 }
 
+/* A filled icon tile (`iconTile`): the leading icon sits in a 32px rounded
+   tile with an 18px glyph, 6px clear of a standard 44px row's edges (a
+   compact row is at least 42px tall) like a ListItem tile. The 6px radius
+   is concentric with the row's 12px corner at that clearance. */
+.kui-list-action-row[data-icon-tile] {
+  --_kui-list-action-row-icon-tile-size: 2rem;
+}
+
+.kui-list-action-row[data-icon-tile][data-density="compact"] {
+  --_kui-list-action-row-min-height: 2.625rem;
+}
+
+.kui-list-action-row[data-icon-tile] .kui-list-action-row__icon {
+  width: var(--_kui-list-action-row-icon-tile-size);
+  height: var(--_kui-list-action-row-icon-tile-size);
+  border-radius: var(--kui-radius-m, 0.375rem);
+  color: var(--_kui-list-action-row-icon-tile-foreground, currentColor);
+  background: var(--_kui-list-action-row-icon-tile-fill, transparent);
+  box-shadow: inset 0 0 0 1px
+    var(--_kui-list-action-row-icon-tile-border, transparent);
+}
+
+.kui-list-action-row[data-icon-tile] .kui-list-action-row__icon svg {
+  width: 1.125rem;
+  height: 1.125rem;
+}
+
+.kui-list-action-row[data-has-icon="true"][data-icon-tile]
+  .kui-list-action-row__label {
+  margin-inline-start: calc(
+    var(--_kui-list-action-row-icon-tile-size) +
+      var(--kui-layout-item-gap, 0.5rem)
+  );
+}
+
+/* An application fill defaults its glyph to black or white, whichever
+   contrasts with the fill's lightness. */
+.kui-list-action-row[data-icon-tile="color"] .kui-list-action-row__icon {
+  color: var(--_kui-list-action-row-icon-tile-foreground, #fff);
+}
+
+@supports (color: oklch(from red l c h)) {
+  .kui-list-action-row[data-icon-tile="color"] .kui-list-action-row__icon {
+    color: var(
+      --_kui-list-action-row-icon-tile-foreground,
+      oklch(
+        from var(--_kui-list-action-row-icon-tile-fill)
+          clamp(0, (0.68 - l) * 1000, 1) 0 0
+      )
+    );
+  }
+}
+
+.kui-list-action-row[data-icon-tile-tone="neutral"] .kui-list-action-row__icon {
+  --_kui-list-action-row-icon-tile-fill: var(--kui-color-neutral-fill-quiet);
+  --_kui-list-action-row-icon-tile-border: var(
+    --kui-color-neutral-border-quiet
+  );
+  --_kui-list-action-row-icon-tile-foreground: var(
+    --kui-color-neutral-on-quiet
+  );
+}
+
+.kui-list-action-row[data-icon-tile-tone="brand"] .kui-list-action-row__icon {
+  --_kui-list-action-row-icon-tile-fill: var(--kui-color-brand-fill-quiet);
+  --_kui-list-action-row-icon-tile-border: var(--kui-color-brand-border-quiet);
+  --_kui-list-action-row-icon-tile-foreground: var(--kui-color-brand-on-quiet);
+}
+
+.kui-list-action-row[data-icon-tile-tone="success"] .kui-list-action-row__icon {
+  --_kui-list-action-row-icon-tile-fill: var(--kui-color-success-fill-quiet);
+  --_kui-list-action-row-icon-tile-border: var(
+    --kui-color-success-border-quiet
+  );
+  --_kui-list-action-row-icon-tile-foreground: var(
+    --kui-color-success-on-quiet
+  );
+}
+
+.kui-list-action-row[data-icon-tile-tone="warning"] .kui-list-action-row__icon {
+  --_kui-list-action-row-icon-tile-fill: var(--kui-color-warning-fill-quiet);
+  --_kui-list-action-row-icon-tile-border: var(
+    --kui-color-warning-border-quiet
+  );
+  --_kui-list-action-row-icon-tile-foreground: var(
+    --kui-color-warning-on-quiet
+  );
+}
+
+.kui-list-action-row[data-icon-tile-tone="danger"] .kui-list-action-row__icon {
+  --_kui-list-action-row-icon-tile-fill: var(--kui-color-danger-fill-quiet);
+  --_kui-list-action-row-icon-tile-border: var(--kui-color-danger-border-quiet);
+  --_kui-list-action-row-icon-tile-foreground: var(--kui-color-danger-on-quiet);
+}
+
+/* A loading row shows a tile-sized skeleton in place of the fill. */
+.kui-list-action-row[data-icon-tile][data-placeholder="true"]
+  .kui-list-action-row__icon {
+  background: transparent;
+  box-shadow: none;
+}
+
+/* A wrapped label keeps its first line centered on the tile: the tile sits
+   6px below the row's top like a single-line row's, and the label starts
+   half the difference between the tile and its line box lower. */
+.kui-list-action-row[data-icon-tile][data-multiline="true"]
+  .kui-list-action-row__primary {
+  padding-block: 0.375rem;
+}
+
+.kui-list-action-row[data-icon-tile][data-multiline="true"]
+  .kui-list-action-row__icon {
+  inset-block-start: calc(
+    0.375rem + (var(--_kui-list-action-row-icon-tile-size) / 2)
+  );
+}
+
+.kui-list-action-row[data-icon-tile][data-multiline="true"]
+  .kui-list-action-row__label {
+  box-sizing: border-box;
+  min-height: var(--_kui-list-action-row-icon-tile-size);
+  padding-block-start: max(
+    0px,
+    (var(--_kui-list-action-row-icon-tile-size) - 1lh) / 2
+  );
+}
+
 @media (forced-colors: active) {
+  .kui-list-action-row[data-icon-tile] .kui-list-action-row__icon {
+    outline: 1px solid CanvasText;
+    outline-offset: -1px;
+  }
+
   .kui-list-action-row[data-drop-position]::after {
     background: Highlight;
     forced-color-adjust: none;

package/dist/styles/list-item.css

@@ -1,4 +1,12 @@
 .kui-list-item {
+  /* The leading icon size. An inherited `--kui-list-row-icon-size` on the
+     containing List sizes ListItem and ListActionRow icons together, so a
+     mixed list keeps its labels on one edge; `--kui-list-item-icon-size`
+     still wins for ListItem rows that set it. */
+  --_kui-list-item-icon-size: var(
+    --kui-list-item-icon-size,
+    var(--kui-list-row-icon-size, 1.125rem)
+  );
   display: grid;
   width: calc(100% - (2 * var(--kui-layout-inline-margin, 0.5rem)));
   min-height: var(--kui-list-item-min-height, 2.75rem);
@@ -10,7 +18,10 @@
   );
   padding-inline: var(
     --kui-list-item-padding-inline,
-    var(--kui-layout-item-padding, 0.5rem)
+    var(
+      --kui-list-row-padding-inline,
+      var(--kui-layout-item-padding, 0.5rem)
+    )
   );
   box-sizing: border-box;
   border: var(--kui-list-item-border-width, 1px) solid
@@ -85,7 +96,7 @@
 .kui-list-item[data-has-icon="true"] {
   grid-template-columns: var(
     --kui-list-item-columns,
-    var(--kui-list-item-icon-size, 1.125rem) minmax(0, 1fr) auto
+    var(--_kui-list-item-icon-size) minmax(0, 1fr) auto
   );
 }
 
@@ -109,7 +120,12 @@
   grid-column: 2;
 }
 
-.kui-list-item:hover:not([data-placeholder="true"]) {
+/* A selected or current row keeps its selected tint while hovered. */
+.kui-list-item:hover:not(
+    [data-placeholder="true"],
+    [aria-current="page"],
+    [aria-pressed="true"]
+  ) {
   border-color: var(
     --kui-list-item-hover-border,
     var(--kui-color-neutral-border-normal)
@@ -160,16 +176,16 @@
 
 .kui-list-item__icon {
   display: grid;
-  width: var(--kui-list-item-icon-size, 1.125rem);
-  height: var(--kui-list-item-icon-size, 1.125rem);
+  width: var(--_kui-list-item-icon-size);
+  height: var(--_kui-list-item-icon-size);
   color: var(--kui-list-item-icon-color, currentColor);
   place-items: center;
 }
 
 .kui-list-item__icon svg {
   display: block;
-  width: var(--kui-list-item-icon-size, 1.125rem);
-  height: var(--kui-list-item-icon-size, 1.125rem);
+  width: var(--_kui-list-item-icon-size);
+  height: var(--_kui-list-item-icon-size);
 }
 
 .kui-list-item__label {
@@ -225,9 +241,7 @@
 
 .kui-list-item[data-multiline="true"] .kui-list-item__icon {
   align-self: start;
-  margin-block-start: calc(
-    (1lh - var(--kui-list-item-icon-size, 1.125rem)) / 2
-  );
+  margin-block-start: calc((1lh - var(--_kui-list-item-icon-size)) / 2);
 }
 
 .kui-list-item[data-multiline="true"][data-icon-align="center"]
@@ -275,7 +289,10 @@
   z-index: 1;
   inset-inline: var(
     --kui-list-item-padding-inline,
-    var(--kui-layout-item-padding, 0.5rem)
+    var(
+      --kui-list-row-padding-inline,
+      var(--kui-layout-item-padding, 0.5rem)
+    )
   );
   height: var(--kui-list-item-drop-indicator-width, 2px);
   border-radius: var(--kui-radius-pill);
@@ -312,3 +329,133 @@
   width: 1rem;
   height: 1rem;
 }
+
+/* A filled icon tile (`iconTile`): the leading icon sits in a 32px rounded
+   tile with an 18px glyph. The tile overhangs the content box by up to 3px
+   into the block padding, so a single-line row keeps its density height
+   (44px standard, 52px spacious) and a compact row grows only to 42px; the
+   tile then sits 6px (5px compact) clear of the row edges, like a
+   ListActionRow tile, and rows with descriptions keep their height. The 6px
+   radius is concentric with the row's 12px corner at that clearance. */
+.kui-list-item[data-icon-tile] {
+  --_kui-list-item-icon-tile-size: 2rem;
+  --_kui-list-item-icon-tile-overhang: 0.1875rem;
+}
+
+.kui-list-item[data-icon-tile][data-density="compact"] {
+  --_kui-list-item-icon-tile-overhang: 0px;
+  /* Native buttons take a form-control height, so a compact tile row
+     declares its tile-sized minimum rather than relying on content height. */
+  min-height: var(--kui-list-item-min-height, 2.625rem);
+}
+
+.kui-list-item[data-has-icon="true"][data-icon-tile] {
+  grid-template-columns: var(
+    --kui-list-item-columns,
+    var(--_kui-list-item-icon-tile-size) minmax(0, 1fr) auto
+  );
+}
+
+.kui-list-item[data-icon-tile] .kui-list-item__icon {
+  width: var(--_kui-list-item-icon-tile-size);
+  height: var(--_kui-list-item-icon-tile-size);
+  margin-block: calc(-1 * var(--_kui-list-item-icon-tile-overhang));
+  border-radius: var(--kui-radius-m, 0.375rem);
+  color: var(--_kui-list-item-icon-tile-foreground, currentColor);
+  background: var(--_kui-list-item-icon-tile-fill, transparent);
+  box-shadow: inset 0 0 0 1px
+    var(--_kui-list-item-icon-tile-border, transparent);
+}
+
+.kui-list-item[data-icon-tile] .kui-list-item__icon svg {
+  width: 1.125rem;
+  height: 1.125rem;
+}
+
+/* An application fill defaults its glyph to black or white, whichever
+   contrasts with the fill's lightness. */
+.kui-list-item[data-icon-tile="color"] .kui-list-item__icon {
+  color: var(--_kui-list-item-icon-tile-foreground, #fff);
+}
+
+@supports (color: oklch(from red l c h)) {
+  .kui-list-item[data-icon-tile="color"] .kui-list-item__icon {
+    color: var(
+      --_kui-list-item-icon-tile-foreground,
+      oklch(
+        from var(--_kui-list-item-icon-tile-fill) clamp(0, (0.68 - l) * 1000, 1)
+          0 0
+      )
+    );
+  }
+}
+
+.kui-list-item[data-icon-tile-tone="neutral"] .kui-list-item__icon {
+  --_kui-list-item-icon-tile-fill: var(--kui-color-neutral-fill-quiet);
+  --_kui-list-item-icon-tile-border: var(--kui-color-neutral-border-quiet);
+  --_kui-list-item-icon-tile-foreground: var(--kui-color-neutral-on-quiet);
+}
+
+.kui-list-item[data-icon-tile-tone="brand"] .kui-list-item__icon {
+  --_kui-list-item-icon-tile-fill: var(--kui-color-brand-fill-quiet);
+  --_kui-list-item-icon-tile-border: var(--kui-color-brand-border-quiet);
+  --_kui-list-item-icon-tile-foreground: var(--kui-color-brand-on-quiet);
+}
+
+.kui-list-item[data-icon-tile-tone="success"] .kui-list-item__icon {
+  --_kui-list-item-icon-tile-fill: var(--kui-color-success-fill-quiet);
+  --_kui-list-item-icon-tile-border: var(--kui-color-success-border-quiet);
+  --_kui-list-item-icon-tile-foreground: var(--kui-color-success-on-quiet);
+}
+
+.kui-list-item[data-icon-tile-tone="warning"] .kui-list-item__icon {
+  --_kui-list-item-icon-tile-fill: var(--kui-color-warning-fill-quiet);
+  --_kui-list-item-icon-tile-border: var(--kui-color-warning-border-quiet);
+  --_kui-list-item-icon-tile-foreground: var(--kui-color-warning-on-quiet);
+}
+
+.kui-list-item[data-icon-tile-tone="danger"] .kui-list-item__icon {
+  --_kui-list-item-icon-tile-fill: var(--kui-color-danger-fill-quiet);
+  --_kui-list-item-icon-tile-border: var(--kui-color-danger-border-quiet);
+  --_kui-list-item-icon-tile-foreground: var(--kui-color-danger-on-quiet);
+}
+
+/* A loading row shows a tile-sized skeleton in place of the fill. */
+.kui-list-item[data-icon-tile][data-placeholder="true"] .kui-list-item__icon {
+  background: transparent;
+  box-shadow: none;
+}
+
+.kui-list-item[data-icon-tile][data-multiline="true"][data-icon-align="center"]
+  .kui-list-item__icon {
+  margin-block: calc(-1 * var(--_kui-list-item-icon-tile-overhang));
+}
+
+/* A wrapped label keeps its first line centered on the tile: the tile sits
+   at the top of the content box (less its overhang) and the label starts
+   the rest of the way down, instead of the tile overhanging the row edge. */
+.kui-list-item[data-icon-tile][data-multiline="true"]:not(
+    [data-icon-align="center"]
+  )
+  .kui-list-item__icon {
+  margin-block-start: calc(-1 * var(--_kui-list-item-icon-tile-overhang));
+}
+
+.kui-list-item[data-icon-tile][data-multiline="true"]:not(
+    [data-icon-align="center"]
+  )
+  .kui-list-item__label {
+  align-self: start;
+  padding-block-start: max(
+    0px,
+    (var(--_kui-list-item-icon-tile-size) - 1lh) / 2 -
+      var(--_kui-list-item-icon-tile-overhang)
+  );
+}
+
+@media (forced-colors: active) {
+  .kui-list-item[data-icon-tile] .kui-list-item__icon {
+    outline: 1px solid CanvasText;
+    outline-offset: -1px;
+  }
+}

package/dist/styles/list.css

@@ -8,10 +8,15 @@
   --_kui-list-column-gap: var(--_kui-list-gap);
   --_kui-list-row-gap: var(--_kui-list-gap);
   --_kui-list-flex: 0 1 auto;
-  --_kui-list-inset-top: 0;
-  --_kui-list-inset-right: 0;
-  --_kui-list-inset-bottom: 0;
-  --_kui-list-inset-left: 0;
+  --_kui-list-inset-top: 0px;
+  --_kui-list-inset-right: 0px;
+  --_kui-list-inset-bottom: 0px;
+  --_kui-list-inset-left: 0px;
+  --_kui-list-clearance-start: 0px;
+  --_kui-list-clearance-end: 0px;
+  --_kui-list-ring-room: 0px;
+  --_kui-list-max-height: none;
+  --_kui-list-min-height: 0px;
   --_kui-list-divider-top: transparent;
   --_kui-list-divider-right: transparent;
   --_kui-list-divider-bottom: transparent;
@@ -19,10 +24,15 @@
 
   display: flex;
   min-width: 0;
-  min-height: 0;
+  min-height: var(--_kui-list-min-height);
+  max-height: var(--_kui-list-max-height);
   box-sizing: border-box;
-  padding: var(--_kui-list-inset-top, 0) var(--_kui-list-inset-right, 0)
-    var(--_kui-list-inset-bottom, 0) var(--_kui-list-inset-left, 0);
+  padding: calc(
+      var(--_kui-list-inset-top, 0px) + var(--_kui-list-clearance-start)
+    )
+    var(--_kui-list-inset-right, 0)
+    calc(var(--_kui-list-inset-bottom, 0px) + var(--_kui-list-clearance-end))
+    var(--_kui-list-inset-left, 0);
   flex: var(--_kui-list-flex, initial);
   flex-direction: column;
   align-items: stretch;
@@ -97,6 +107,21 @@
   }
 }
 
+/* `frame`: a bordered, rounded stack (a result picker). Its 4px inset on
+   every side replaces any side-selected or document inset, and is exactly
+   the reach of a row's focus ring (3px ring, 1px offset), so the first and
+   last rows' rings stay inside a scrolling frame's clip at the scroll
+   extremes. (The ring-room scroll padding every scrollable List carries
+   handles a row stopped mid-scroll.) */
+.kui-list[data-frame="true"] {
+  --_kui-list-inset-top: var(--kui-space-2xs);
+  --_kui-list-inset-right: var(--kui-space-2xs);
+  --_kui-list-inset-bottom: var(--kui-space-2xs);
+  --_kui-list-inset-left: var(--kui-space-2xs);
+  border: 1px solid var(--kui-color-neutral-border-normal);
+  border-radius: var(--kui-radius-m);
+}
+
 .kui-list[data-h-align="left"] {
   align-items: flex-start;
   align-content: flex-start;
@@ -124,11 +149,56 @@
   justify-content: space-between;
 }
 
+/* A scrollable List's scroll padding is a row's focus-ring reach (3px ring,
+   1px offset) plus 2px of slack, so a row focused or scrolled into view stops
+   with its ring inside the clip rather than flush against it: Chromium's
+   focus scroll stops 1px short of the padded target, and a row's fractional
+   position can cost another 0.3px. Scroll padding moves nothing at rest; at
+   the scroll extremes an unframed List's first and last rows still meet the
+   clip, which is what `frame`'s 4px inset is for. */
 .kui-list[data-scrollable="true"] {
+  --_kui-list-ring-room: calc(var(--kui-space-2xs) + 2px);
   overflow-y: auto;
   overscroll-behavior-y: contain;
 }
 
+/* `scrollClearance`: chrome lying over the List's block edge (a dialog's
+   floating footer) publishes how far it covers that edge through the
+   inherited `--kui-scroll-clearance-block-*` context. The List adds it to its
+   own block padding and scroll padding, so rows scroll visibly beneath the
+   chrome while the first and last rows, and anything focused or scrolled into
+   view, still come to rest clear of it. */
+.kui-list:is(
+  [data-scroll-clearance="block-start"],
+  [data-scroll-clearance="both"]
+) {
+  --_kui-list-clearance-start: var(--kui-scroll-clearance-block-start, 0px);
+}
+
+.kui-list:is(
+  [data-scroll-clearance="block-end"],
+  [data-scroll-clearance="both"]
+) {
+  --_kui-list-clearance-end: var(--kui-scroll-clearance-block-end, 0px);
+}
+
+.kui-list:is([data-scroll-clearance], [data-scrollable="true"]) {
+  scroll-padding-block: calc(
+      var(--_kui-list-clearance-start) + var(--_kui-list-ring-room)
+    )
+    calc(var(--_kui-list-clearance-end) + var(--_kui-list-ring-room));
+}
+
+/* In a Pane's scrolling content, a List that does not scroll itself keeps
+   its full height rather than shrinking to the content box. A shrunken List
+   lets its rows overflow its own box, and the scroller's block-end padding
+   (a bottom safe area, an overlay NavStack bottom toolbar's clearance)
+   follows the List's box, not those rows, so the last row could never
+   scroll clear of the edge. A `flex` basis still grows the List to fill. */
+.kui-pane > .kui-pane__content > .kui-list:not([data-scrollable="true"]) {
+  flex-shrink: 0;
+}
+
 /* A scrollable List owns the overflow, so its rows keep their natural height
    and scroll rather than shrink. Items that clip their own overflow (a
    ListItem) have a zero automatic minimum height, so the default