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

package/dist/styles/components/collections/list-item/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/components/feedback/anchored-surface/anchored-surface.css

@@ -1,9 +1,20 @@
 .kui-anchored-surface {
+  /* The room beside the anchor on the side the surface opened, which
+     kerfjs/overlay publishes and refreshes on every reposition. Read-only for
+     content that sizes an inner scroller to it. */
+  --kui-anchored-surface-available-height: var(
+    --kerf-anchor-available-height,
+    calc(100dvh - 2 * var(--kui-space-xs, 8px))
+  );
+
   box-sizing: border-box;
   inset: auto;
   width: max-content;
   max-width: calc(100vw - 2 * var(--kui-space-xs, 8px));
-  max-height: calc(100dvh - 2 * var(--kui-space-xs, 8px));
+  max-height: min(
+    calc(100dvh - 2 * var(--kui-space-xs, 8px)),
+    var(--kui-anchored-surface-available-height)
+  );
   overflow: auto;
   padding: var(--kui-anchored-surface-inset, var(--kui-space-xs, 8px));
   border: 1px solid var(--kui-color-neutral-border-normal);
@@ -13,3 +24,18 @@
   box-shadow: var(--kui-shadow-l);
   font: inherit;
 }
+
+/* Dark tone for a popup anchored to dark media chrome: the loud, inverse tone
+   of a dark ToolbarControlGroup, so the surface takes the opposite of its
+   anchor's color scheme (the script picks the class when it opens). It flips
+   only the color scheme: every semantic token is a light-dark() pair, so the
+   surface fill, border, shadow, and the content's text, borders, and focus
+   rings all resolve to the other side by inheritance. No child is styled from
+   here. */
+.kui-anchored-surface--scheme-dark {
+  color-scheme: dark;
+}
+
+.kui-anchored-surface--scheme-light {
+  color-scheme: light;
+}

package/dist/styles/components/feedback/chip/chip.css

@@ -73,6 +73,26 @@
   background: transparent;
 }
 
+/* Follows the surrounding foreground, such as the on-loud text of a
+   brand-loud ContentItem bubble. It paints no fill: any currentColor wash
+   over a loud surface lowers the contrast the surface's own text was tuned
+   to, so the chip draws its shape with a currentColor border instead (soft
+   for quiet, full strength for outline and solid). */
+.kui-chip[data-tone="inherit"] {
+  --_kui-chip-border: color-mix(in srgb, currentColor 40%, transparent);
+
+  border-color: var(--_kui-chip-border);
+  color: inherit;
+  background: transparent;
+}
+
+.kui-chip[data-tone="inherit"]:is(
+    [data-appearance="outline"],
+    [data-appearance="solid"]
+  ) {
+  --_kui-chip-border: currentColor;
+}
+
 .kui-chip[data-shape="rounded"] {
   border-radius: var(--kui-radius-s);
 }
@@ -93,6 +113,56 @@
   overflow: hidden;
 }
 
+/* Link chip: a native anchor with the same geometry. Hover and press layer a
+   currentColor wash over whichever fill the appearance paints; an inherit
+   chip instead strengthens its border and underlines its label, so the
+   surrounding text contrast holds in every state. */
+.kui-chip[data-link] {
+  --_kui-chip-wash: transparent;
+
+  background-image: linear-gradient(
+    var(--_kui-chip-wash),
+    var(--_kui-chip-wash)
+  );
+  text-decoration: none;
+  cursor: pointer;
+}
+
+.kui-chip[data-link]:hover {
+  --_kui-chip-wash: color-mix(in srgb, currentColor 10%, transparent);
+}
+
+.kui-chip[data-link]:active {
+  --_kui-chip-wash: color-mix(in srgb, currentColor 18%, transparent);
+}
+
+.kui-chip[data-link][data-tone="inherit"]:is(:hover, :active) {
+  --_kui-chip-wash: transparent;
+  --_kui-chip-border: currentColor;
+}
+
+/* The label clips for its ellipsis; a little block room keeps the hover
+   underline inside that clip without changing the chip's height. */
+.kui-chip[data-link] .kui-chip__label {
+  padding-block: 0.2em;
+}
+
+.kui-chip[data-link][data-tone="inherit"]:is(:hover, :active) .kui-chip__label {
+  text-decoration: underline;
+  text-underline-offset: 0.12em;
+}
+
+.kui-chip[data-link]:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: 2px;
+}
+
+/* The brand focus color can match a brand-loud surface; an inherit chip's
+   ring follows the surrounding foreground instead. */
+.kui-chip[data-link][data-tone="inherit"]:focus-visible {
+  outline: 3px solid currentColor;
+}
+
 .kui-chip__icon {
   display: inline-grid;
   width: 1em;

package/dist/styles/components/feedback/state-banner/state-banner.css

@@ -29,7 +29,16 @@
     --kui-state-banner-action-hover-background,
     var(--kui-color-surface)
   );
-  display: grid;
+  /* A wrapping flex row, not a three-track grid: a trailing action stays
+     beside the copy only while the copy keeps its minimum readable width,
+     then wraps onto its own trailing row. The decision follows the banner's
+     own width and content, so it holds on a phone, in a narrow rail on a wide
+     screen, and in an intrinsically sized host such as CornerStatus, where a
+     container query's size containment would collapse the banner. A grid
+     gave the action an `auto` track at its full width and squeezed the copy
+     until its words ran under the action. */
+  display: flex;
+  flex-wrap: wrap;
   min-height: 2.75rem;
   margin-inline: var(--kui-layout-inline-margin, 0.5rem);
   padding: var(--kui-layout-item-padding, 0.5rem);
@@ -37,7 +46,6 @@
   border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
   color: var(--_kui-state-banner-foreground);
   background: var(--_kui-state-banner-background);
-  grid-template-columns: auto minmax(0, 1fr) auto;
   align-items: center;
   gap: var(--kui-layout-item-gap, 0.5rem);
 }
@@ -175,6 +183,7 @@
 }
 .kui-state-banner__icon {
   display: grid;
+  flex: none;
   place-items: center;
 }
 .kui-state-banner__icon svg {
@@ -190,6 +199,9 @@
    gap, so no margin lands at the start of a wrapped line. */
 .kui-state-banner__copy {
   min-width: 0;
+  /* The copy's minimum readable width before a trailing action wraps below
+     it; the copy grows to fill whatever its line leaves. */
+  flex: 1 1 12rem;
   /* The title's size, so a wrapped title's lines keep the title's own line
      height instead of the larger inherited strut. */
   font-size: var(--kui-font-xs);
@@ -219,17 +231,11 @@
   overflow: visible;
   text-overflow: clip;
 }
-.kui-state-banner[data-action-placement="below"] {
-  grid-template-columns: auto minmax(0, 1fr);
-}
-.kui-state-banner[data-action-placement="below"]:not(
-    :has(> .kui-state-banner__icon)
-  )
-  > .kui-state-banner__copy {
-  grid-column: 1 / -1;
-}
+/* `below` always gives the action its own end-aligned trailing row. */
 .kui-state-banner[data-action-placement="below"] > .kui-state-banner__action {
-  grid-column: 1 / -1;
+  display: flex;
+  flex-basis: 100%;
+  justify-content: flex-end;
 }
 .kui-state-banner__copy strong {
   margin-inline-end: var(--kui-layout-item-gap, 0.5rem);
@@ -254,8 +260,13 @@
   overflow: clip;
   text-overflow: ellipsis;
 }
+/* Content-sized and end-aligned on whichever line it lands; on its own line
+   it may shrink to the line so a wrapping action group (a `Row wrap`) wraps
+   its controls instead of overflowing the banner. */
 .kui-state-banner__action {
-  justify-self: end;
+  max-width: 100%;
+  margin-inline-start: auto;
+  flex: 0 1 auto;
 }
 .kui-state-banner__action button {
   min-height: 1.8rem;

package/dist/styles/components/forms/composer/composer.css

@@ -0,0 +1,100 @@
+/* A chat or prompt composer: a raised frame (surface-raised, the standard
+   neutral border, large radius, shadow-l) whose border turns brand while
+   focus is within. It holds a borderless message field that sizes to its
+   content between the min and max row counts, above an action row with a
+   quiet hint and trailing actions. The 8px padding puts the field's text on
+   the 17px text column when the composer sits 8px from a container edge. */
+
+.kui-composer {
+  --_kui-composer-min-rows: 1;
+  --_kui-composer-max-rows: 8;
+  display: flex;
+  flex-direction: column;
+  gap: var(--kui-layout-control-gap, 0.5rem);
+  /* Fill the container's inline size: a content-sized field would otherwise
+     shrink the frame to its text. */
+  width: 100%;
+  min-width: 0;
+  box-sizing: border-box;
+  padding: var(--kui-layout-item-padding, 0.5rem);
+  border: 1px solid var(--kui-color-neutral-border-normal);
+  border-radius: var(--kui-radius-l);
+  color: var(--kui-color-neutral-on-normal);
+  background: var(--kui-color-surface-raised);
+  box-shadow: var(--kui-shadow-l);
+}
+
+/* The frame is the field's boundary, so it carries the focus state. */
+.kui-composer:focus-within {
+  border-color: var(--kui-color-brand-border-loud);
+}
+
+.kui-composer__field {
+  display: block;
+  width: 100%;
+  min-width: 0;
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0.25rem 0;
+  border: 0;
+  outline: none;
+  color: inherit;
+  background: transparent;
+  font: inherit;
+  font-size: var(--kui-font-m, inherit);
+  line-height: var(--wa-line-height-normal, 1.6);
+  resize: none;
+  field-sizing: content;
+  min-height: calc(var(--_kui-composer-min-rows) * 1lh + 0.5rem);
+  max-height: calc(var(--_kui-composer-max-rows) * 1lh + 0.5rem);
+  overflow-y: auto;
+}
+
+/* Engines without content sizing keep a three-line field, clamped to the
+   row bounds, that scrolls once the message is longer. */
+@supports not (field-sizing: content) {
+  .kui-composer__field {
+    height: calc(
+      clamp(var(--_kui-composer-min-rows), 3, var(--_kui-composer-max-rows)) *
+        1lh + 0.5rem
+    );
+  }
+}
+
+.kui-composer__field::placeholder {
+  color: var(--kui-color-neutral-on-quiet);
+  opacity: 1;
+}
+
+.kui-composer__field:disabled {
+  color: var(--kui-color-neutral-on-quiet);
+  cursor: not-allowed;
+}
+
+.kui-composer__actions {
+  display: flex;
+  align-items: center;
+  gap: var(--kui-layout-control-gap, 0.5rem);
+  min-width: 0;
+}
+
+.kui-composer__hint {
+  flex: 1 1 auto;
+  min-width: 0;
+}
+
+.kui-composer__trailing {
+  display: flex;
+  flex: none;
+  align-items: center;
+  gap: var(--kui-layout-control-gap, 0.5rem);
+  margin-inline-start: auto;
+}
+
+@media (forced-colors: active) {
+  .kui-composer:focus-within {
+    border-color: Highlight;
+    outline: 2px solid Highlight;
+    outline-offset: 1px;
+  }
+}

package/dist/styles/components/forms/select/select.css

@@ -213,6 +213,7 @@
 }
 .kui-select::part(listbox) {
   padding: var(--_kui-popup-inset);
+  background: var(--_kui-popup-scroll-cue);
   width: max-content;
   min-width: 100%;
   max-width: min(20rem, calc(100vw - 1.25rem));

package/dist/styles/components/forms/token-search-field/token-search-field.css

@@ -172,10 +172,19 @@
 .kui-token-search__clear:hover,
 .kui-token-search__clear:focus-visible,
 .kui-token-search__trailing-action:hover,
-.kui-token-search__trailing-action:focus-visible {
+.kui-token-search__trailing-action:focus-visible,
+.kui-token-search__trailing-action[aria-expanded="true"],
+.kui-token-search__trailing-action[aria-pressed="true"] {
   background: color-mix(in srgb, currentColor 12%, transparent);
 }
 
+/* An open disclosure or an on toggle keeps the hover fill and reads at full
+   text strength, so its state stays visible after the pointer leaves. */
+.kui-token-search__trailing-action[aria-expanded="true"],
+.kui-token-search__trailing-action[aria-pressed="true"] {
+  color: var(--kui-color-text);
+}
+
 .kui-token-search__token button:focus-visible,
 .kui-token-search__clear:focus-visible,
 .kui-token-search__trailing-action:focus-visible {
@@ -386,7 +395,9 @@
   box-shadow: none;
 }
 
-.kui-token-search[data-presentation="toolbar-group"] .kui-token-search__clear {
+.kui-token-search[data-presentation="toolbar-group"] .kui-token-search__clear,
+.kui-token-search[data-presentation="toolbar-group"]
+  .kui-token-search__trailing-action {
   border-radius: var(--kui-control-highlight-radius);
 }
 

package/dist/styles/components/layout/pane/pane.css

@@ -159,14 +159,17 @@
   --kui-pane-content-inset-inline-start: var(--_kui-pane-safe-inline-start);
   --kui-pane-content-inset-inline-end: var(--_kui-pane-safe-inline-end);
   --_kui-pane-deep-block-inset: 0px;
+  --_kui-pane-clearance-block-start: 0px;
+  --_kui-pane-clearance-block-end: 0px;
   --_kui-pane-content-safe-block-start: var(--_kui-pane-safe-block-start);
   --_kui-pane-content-safe-block-end: var(--_kui-pane-safe-block-end);
   --_kui-pane-content-block-start: calc(
     var(--_kui-pane-content-safe-block-start) +
-      var(--_kui-pane-deep-block-inset)
+      var(--_kui-pane-deep-block-inset) + var(--_kui-pane-clearance-block-start)
   );
   --_kui-pane-content-block-end: calc(
-    var(--_kui-pane-content-safe-block-end) + var(--_kui-pane-deep-block-inset)
+    var(--_kui-pane-content-safe-block-end) +
+      var(--_kui-pane-deep-block-inset) + var(--_kui-pane-clearance-block-end)
   );
   min-width: 0;
   min-height: 0;
@@ -184,6 +187,82 @@
     var(--_kui-pane-content-block-end);
 }
 
+/* `scrollClearance`: chrome lying over the content's block edge (a dialog's
+   floating footer) publishes how far it covers that edge through the
+   inherited `--kui-scroll-clearance-block-*` context. The content scroller
+   adds it to the block padding and scroll padding above, so content scrolls
+   visibly beneath that chrome yet its first and last items can always rest
+   clear of it. */
+.kui-pane:is(
+    [data-scroll-clearance="block-start"],
+    [data-scroll-clearance="both"]
+  )
+  > .kui-pane__content {
+  --_kui-pane-clearance-block-start: var(
+    --kui-scroll-clearance-block-start,
+    0px
+  );
+}
+
+.kui-pane:is(
+    [data-scroll-clearance="block-end"],
+    [data-scroll-clearance="both"]
+  )
+  > .kui-pane__content {
+  --_kui-pane-clearance-block-end: var(--kui-scroll-clearance-block-end, 0px);
+}
+
+/* `headerPresentation="overlay"`: the header paints the translucent chrome
+   material (opaque under reduced transparency, without `backdrop-filter`, or
+   in forced colors). Once `wireScrollDividers` has measured it
+   (`data-header-overlay="measured"`, with its border-box height published as
+   `--kui-scroll-clearance-block-start` on this root), the header moves into
+   the content cell above the scroller, and the scroller clears it through
+   the same block padding and scroll padding `scrollClearance` uses, and the
+   header leaves a classic scrollbar uncovered. Unwired,
+   or with `chromePlacement="auto"`, the header stays docked in its own row,
+   so it never covers content it has not measured. */
+.kui-pane[data-header-presentation="overlay"] > .kui-pane__header {
+  -webkit-backdrop-filter: var(--kui-chrome-material-filter);
+  backdrop-filter: var(--kui-chrome-material-filter);
+  background: var(--kui-chrome-material);
+}
+
+.kui-pane[data-header-presentation="overlay"][data-header-overlay="measured"]:not(
+    [data-chrome-placement="auto"]
+  )
+  > .kui-pane__header {
+  position: relative;
+  z-index: 1;
+  align-self: start;
+  grid-area: content;
+  /* A classic (space-taking) vertical scrollbar stays uncovered: the wiring
+     publishes its inline size, so the header ends where the scrollbar's
+     track begins and its thumb and arrow buttons stay visible and usable.
+     An overlay scrollbar takes no space and leaves this unset, so it passes
+     beneath the material like the content. */
+  margin-inline-end: var(--kui-pane-scrollbar-inline-size, 0px);
+}
+
+.kui-pane[data-header-presentation="overlay"][data-header-overlay="measured"]:not(
+    [data-chrome-placement="auto"]
+  )
+  > .kui-pane__content {
+  --_kui-pane-clearance-block-start: var(
+    --kui-scroll-clearance-block-start,
+    0px
+  );
+}
+
+@media (forced-colors: active) {
+  .kui-pane[data-header-presentation="overlay"] > .kui-pane__header {
+    -webkit-backdrop-filter: none;
+    backdrop-filter: none;
+    background: Canvas;
+    border-block-end: 1px solid CanvasText;
+  }
+}
+
 /* Add one outer gutter without changing the inherited item-margin token.
    Nested Row, List, and Grid therefore keep their own default 8px insets. */
 .kui-pane[data-deep-inset="true"] > .kui-pane__content {