@kerfjs/ui 5.0.0-beta.95 → 5.0.0-beta.96

package/dist/styles/surface-scaffold.css

@@ -62,6 +62,28 @@
     )
   );
 }
+.kui-dialog-surface[data-presentation="modal"][data-height]
+  > wa-dialog::part(dialog) {
+  --_kui-dialog-surface-resolved-height: max(
+    0px,
+    min(
+      var(--_kui-dialog-surface-height, 100dvh),
+      calc(
+        100dvh - var(--_kui-dialog-surface-resolved-gutter) -
+          var(--_kui-dialog-surface-resolved-gutter)
+      )
+    )
+  );
+  height: var(--_kui-dialog-surface-resolved-height);
+  max-height: var(--_kui-dialog-surface-resolved-height);
+}
+/* One child owns the body: it gets the body's whole height and its own
+   scrolling (the body itself no longer scrolls). */
+.kui-dialog-surface[data-body-layout="fill"] > wa-dialog::part(body) {
+  display: grid;
+  overflow: hidden;
+  grid-template-rows: minmax(0, 1fr);
+}
 .kui-dialog-surface[data-body-inset="none"] > wa-dialog::part(body),
 .kui-dialog-surface[data-footer-inset="none"] > wa-dialog::part(footer) {
   padding: 0;
@@ -92,6 +114,103 @@
   max-height: 100dvh;
   border-radius: 0;
 }
+/* PopoverDialogSurface: the dialog chrome and bounded geometry for a native
+   popover="auto" surface (non-modal, light dismiss) or the same surface in
+   flow. The UA popover rules supply the centered top-layer placement. */
+.kui-popover-dialog-surface {
+  --_kui-popover-dialog-surface-width: 35rem;
+  --_kui-popover-dialog-surface-resolved-gutter: max(
+    0px,
+    var(--_kui-popover-dialog-surface-gutter, 1rem)
+  );
+  --_kui-popover-dialog-surface-available-height: calc(
+    100dvh - var(--_kui-popover-dialog-surface-resolved-gutter) -
+      var(--_kui-popover-dialog-surface-resolved-gutter)
+  );
+  box-sizing: border-box;
+  width: min(
+    var(
+      --_kui-popover-dialog-surface-preferred-width,
+      var(--_kui-popover-dialog-surface-width)
+    ),
+    max(
+      0px,
+      calc(
+        100vw - var(--_kui-popover-dialog-surface-resolved-gutter) -
+          var(--_kui-popover-dialog-surface-resolved-gutter)
+      )
+    )
+  );
+  max-height: max(0px, var(--_kui-popover-dialog-surface-available-height));
+  padding: 0;
+  overflow: auto;
+  color: var(--kui-color-text);
+  border: 1px solid var(--kui-color-neutral-border-normal);
+  border-radius: var(--kui-radius-l);
+  background: var(--kui-color-surface-raised);
+  box-shadow: var(--kui-shadow-l);
+}
+.kui-popover-dialog-surface[data-size="small"] {
+  --_kui-popover-dialog-surface-width: 25rem;
+}
+.kui-popover-dialog-surface[data-size="large"] {
+  --_kui-popover-dialog-surface-width: 50rem;
+}
+.kui-popover-dialog-surface[data-max-height] {
+  max-height: max(
+    0px,
+    min(
+      var(--_kui-popover-dialog-surface-max-height, 100dvh),
+      var(--_kui-popover-dialog-surface-available-height)
+    )
+  );
+}
+.kui-popover-dialog-surface[data-height] {
+  height: max(
+    0px,
+    min(
+      var(--_kui-popover-dialog-surface-height, 100dvh),
+      var(--_kui-popover-dialog-surface-available-height)
+    )
+  );
+  max-height: none;
+}
+/* Centered in the top layer whatever margins or item alignment the host
+   sets: an absolutely positioned box's auto self-alignment otherwise
+   follows its parent's justify-items. */
+.kui-popover-dialog-surface[data-presentation="overlay"]:popover-open {
+  inset: 0;
+  margin: auto;
+  place-self: center;
+}
+.kui-popover-dialog-surface::backdrop {
+  background: var(
+    --wa-color-overlay-modal,
+    light-dark(rgb(29 29 31 / 0.34), rgb(0 0 0 / 0.6))
+  );
+}
+/* Only an open overlay lays out, so a closed one stays hidden. One filling
+   child takes the whole surface and owns its scrolling. */
+.kui-popover-dialog-surface[data-body-layout="fill"]:is(
+    :popover-open,
+    [data-presentation="embedded"]
+  ) {
+  display: grid;
+  overflow: hidden;
+  grid-template-rows: minmax(0, 1fr);
+}
+/* In flow for a catalog or inline use: the same surface without the top
+   layer, never wider than its container. */
+.kui-popover-dialog-surface[data-presentation="embedded"] {
+  position: relative;
+  inset: auto;
+  /* The available inline space, after any margin the container gives it. */
+  max-width: 100%;
+  max-width: -webkit-fill-available;
+  max-width: -moz-available;
+  max-width: stretch;
+  margin: 0;
+}
 .kui-popup-surface {
   display: inline-flex;
 }

package/dist/styles/tab-navigator.css

@@ -52,10 +52,7 @@
 }
 
 .kui-tab-scaffold__scene[data-appearance="sunken"] {
-  background: var(
-    --kui-sunken-panel-background,
-    var(--kui-color-surface-lowered)
-  );
+  background: var(--kui-sunken-panel-background, var(--kui-sunken-surface));
 }
 
 /* A scene is its region's scroll owner, so its top inset is padding inside

package/dist/styles/text.css

@@ -45,6 +45,42 @@ span.kui-text[data-wrap="truncate"] {
   max-width: 100%;
 }
 
+/* Tail-preserving truncation: the clip box runs right to left so its ellipsis
+   lands at the start, while the isolated left-to-right run keeps the text's
+   own order and punctuation. Short text that fits stays left-aligned. */
+.kui-text__truncate-start {
+  display: block;
+  overflow: hidden;
+  direction: rtl;
+  text-align: left;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* Middle truncation: the head shrinks to an ellipsis while the kept suffix
+   (the last path segment) stays whole. Pre keeps a space at the split. */
+.kui-text__truncate-middle {
+  display: flex;
+  min-width: 0;
+  overflow: hidden;
+}
+
+.kui-text__truncate-head,
+.kui-text__truncate-tail {
+  white-space: pre;
+}
+
+.kui-text__truncate-head {
+  flex: 0 1 auto;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.kui-text__truncate-tail {
+  flex: 0 0 auto;
+}
+
 .kui-text__clamp {
   display: -webkit-box;
   overflow: hidden;
@@ -89,6 +125,32 @@ span.kui-text[data-wrap="truncate"] {
   line-height: 1.2;
 }
 
+/* Inline alignment. The truncation boxes carry their own direction or flex
+   layout, so each aligns its single line explicitly. */
+.kui-text[data-align="center"] {
+  text-align: center;
+}
+
+.kui-text[data-align="end"] {
+  text-align: end;
+}
+
+.kui-text[data-align="center"] > .kui-text__truncate-start {
+  text-align: center;
+}
+
+.kui-text[data-align="end"] > .kui-text__truncate-start {
+  text-align: right;
+}
+
+.kui-text[data-align="center"] > .kui-text__truncate-middle {
+  justify-content: center;
+}
+
+.kui-text[data-align="end"] > .kui-text__truncate-middle {
+  justify-content: flex-end;
+}
+
 span.kui-text {
   margin: 0;
   border: 0;

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

@@ -284,12 +284,23 @@
      no-grow / may-shrink behavior a toolbar row wants without leaking the width
      into the cross axis. */
   flex: 0 1 auto;
+  /* A grow search group animates the open/close itself and sets this duration
+     to 0s: the field is the group's width on every frame instead of running a
+     second, lagging width transition that left an empty band beside a wrapped
+     query (KF-50K0JM). */
   transition:
-    width 0.25s ease,
+    width var(--_kui-toolbar-group-grow-search-width-duration, 0.25s) ease,
     background-color 0.2s ease,
     border-color 0.2s ease;
 }
 
+/* While a grow search group is still narrower than its basis, keep the
+   basis-wide layout it provides; the group clips the field and reveals the
+   query instead of re-wrapping it every frame. Elsewhere this is 0px. */
+.kui-token-search[data-collapsible="true"][data-expanded="true"] {
+  min-width: var(--_kui-toolbar-group-grow-search-min-width, 0px);
+}
+
 .kui-token-search[data-collapsible="true"][data-expanded="true"][data-fill="true"] {
   width: 100%;
   flex: 1 1 auto;

package/dist/styles/toolbar-control-group.css

@@ -215,10 +215,35 @@
 
 .kui-toolbar-control-group[data-sizing="grow"][data-expanded="true"] {
   --_kui-toolbar-group-grow-search-width: 100%;
+  /* The grown group's content-box width at its basis (basis minus the 1px
+     border and 1px padding on each side). A collapsible search lays its editor
+     out at least this wide while the group's flex size animates open, so the
+     clipped query is revealed rather than re-wrapped every frame (KF-50K0JM). */
+  --_kui-toolbar-group-grow-search-min-width: calc(
+    var(--kui-toolbar-group-grow-basis, 19rem) - 4px
+  );
   width: auto;
   min-width: var(--kui-toolbar-group-grow-basis, 19rem);
   flex: 1 1 var(--kui-toolbar-group-grow-basis, 19rem);
 }
+
+/* A grow search animates its flex size, not `width`: an expanded grow group's
+   `width: auto` cannot interpolate, so it used to snap open while the search
+   inside animated, leaving an empty band (KF-50K0JM). The collapsed state names
+   a definite basis and minimum so all three flex lengths interpolate. */
+.kui-toolbar-control-group[data-content="search"][data-sizing="grow"] {
+  /* The group owns this motion; a collapsible search inside follows it on
+     every frame rather than running its own width transition. */
+  --_kui-toolbar-group-grow-search-width-duration: 0s;
+  transition-property:
+    width, flex-basis, flex-grow, min-width, background-color, border-color;
+  transition-duration: 0.25s, 0.25s, 0.25s, 0.25s, 0.2s, 0.2s;
+  transition-timing-function: ease;
+}
+.kui-toolbar-control-group[data-content="search"][data-sizing="grow"][data-expanded="false"] {
+  min-width: var(--kui-toolbar-group-size, calc(2px + 2.625rem));
+  flex: 0 0 var(--kui-toolbar-group-size, calc(2px + 2.625rem));
+}
 .kui-toolbar-control-group[data-sizing="fill"] {
   width: 100%;
   min-width: 0;
@@ -256,15 +281,32 @@
 
 @container kui-toolbar (max-width: 30rem) {
   .kui-toolbar-control-group[data-sizing="grow"][data-expanded="true"] {
+    --_kui-toolbar-group-grow-search-min-width: 0px;
     width: 100%;
     min-width: 0;
     flex: 1 1 100%;
   }
+
+  /* Here the grown search takes its own line. Animating its basis would push
+     the trailing siblings and then jump the group to the next line mid-way, so
+     it opens and closes in one frame with the search filling it. */
+  .kui-toolbar-control-group[data-content="search"][data-sizing="grow"] {
+    transition-property: background-color, border-color;
+    transition-duration: 0.2s;
+  }
 }
 .kui-toolbar-control-group[data-content="text"]
-  > :is(button, wa-button, .kui-toolbar-action-link),
+  > :is(
+    button,
+    wa-button:not(:where(.kui-icon-button)),
+    .kui-toolbar-action-link
+  ),
 .kui-toolbar-control-group[data-content="mixed"]
-  > :is(button, wa-button, .kui-toolbar-action-link) {
+  > :is(
+    button,
+    wa-button:not(:where(.kui-icon-button)),
+    .kui-toolbar-action-link
+  ) {
   min-width: max-content;
 }
 .kui-toolbar-control-group[data-content="mixed"] > button {
@@ -272,14 +314,14 @@
   gap: var(--kui-space-xs);
 }
 .kui-toolbar-control-group[data-content="mixed"]
-  wa-button:not(:where(.kui-popup-menu > *)) {
+  wa-button:not(:where(.kui-popup-menu > *, .kui-icon-button)) {
   line-height: normal;
 }
 /* Toolbar controls never wrap. Web Awesome's label part is a plain block, so a
    slotted icon (a block SVG) and its text would otherwise stack vertically —
    lay them out on one row the way native mixed buttons already are. */
 .kui-toolbar-control-group
-  wa-button:not(:where(.kui-popup-menu > *))::part(label) {
+  wa-button:not(:where(.kui-popup-menu > *, .kui-icon-button))::part(label) {
   display: inline-flex;
   align-items: center;
   gap: var(--kui-space-xs);
@@ -335,11 +377,32 @@
   background: transparent;
 }
 
+/* `selectedChrome="none"`: a pressed control paints like its unpressed
+   neighbors, for an icon-state toggle whose glyph already shows the state.
+   One button opts out alone with `data-selected-chrome="none"`. After the
+   tone and appearance rules above, so it wins over their selected fills. */
+.kui-toolbar-control-group[data-selected-chrome="none"],
+.kui-toolbar-control-group
+  > :is(
+    button,
+    wa-button:not(:where(.kui-icon-button))
+  )[data-selected-chrome="none"] {
+  --kui-toolbar-control-selected-shadow: none;
+  --kui-toolbar-control-selected-border: transparent;
+  --kui-toolbar-control-selected-background: transparent;
+  --kui-toolbar-control-selected-color: var(--kui-toolbar-control-color);
+}
+
 /* The group lays out its own native and raw Web Awesome children. A composed
    PopupMenu (`wa-dropdown.kui-popup-menu`) or Select sizes itself in the
    group's context from its own stylesheet (popup-menu.css, select.css); the
    group names those children by class only to key its own state on them. */
-.kui-toolbar-control-group > :is(button, wa-button, .kui-toolbar-action-link),
+.kui-toolbar-control-group
+  > :is(
+    button,
+    wa-button:not(:where(.kui-icon-button)),
+    .kui-toolbar-action-link
+  ),
 .kui-toolbar-control-group > wa-dropdown:not(.kui-popup-menu) {
   flex: 0 0 auto;
 }
@@ -366,12 +429,15 @@
   place-items: center;
 }
 
-.kui-toolbar-control-group > button:disabled {
+/* A native button that is disabled, or kept focusable with aria-disabled,
+   dims and drops hover chrome. */
+.kui-toolbar-control-group > button:is(:disabled, [aria-disabled="true"]) {
   opacity: 0.5;
   cursor: not-allowed;
 }
 
-.kui-toolbar-control-group > button:not(:disabled):hover {
+.kui-toolbar-control-group
+  > button:not(:disabled, [aria-disabled="true"]):hover {
   border-color: var(--kui-toolbar-control-border);
   background: var(--kui-toolbar-control-hover-background);
 }
@@ -429,7 +495,9 @@
 }
 
 .kui-toolbar-control-group > button svg,
-.kui-toolbar-control-group wa-button:not(:where(.kui-popup-menu > *)) > svg,
+.kui-toolbar-control-group
+  wa-button:not(:where(.kui-popup-menu > *, .kui-icon-button))
+  > svg,
 .kui-toolbar-control-group > .kui-toolbar-action-link svg {
   display: block;
   width: 1rem;
@@ -441,40 +509,44 @@
    buttons: a composed PopupMenu's trigger (`.kui-popup-menu > wa-button`) is
    excluded inside a zero-specificity `:where()` and takes the same metrics
    from popup-menu.css. */
-.kui-toolbar-control-group wa-button:not(:where(.kui-popup-menu > *)) {
+.kui-toolbar-control-group
+  wa-button:not(:where(.kui-popup-menu > *, .kui-icon-button)) {
   --wa-form-control-height: 2.5rem;
 }
 .kui-toolbar-control-group[data-size="compact"]
-  wa-button:not(:where(.kui-popup-menu > *)) {
+  wa-button:not(:where(.kui-popup-menu > *, .kui-icon-button)) {
   --wa-form-control-height: 2rem;
 }
 
-.kui-toolbar-control-group > wa-button,
+.kui-toolbar-control-group > wa-button:not(:where(.kui-icon-button)),
 .kui-toolbar-control-group > wa-dropdown:not(.kui-popup-menu),
-.kui-toolbar-control-group > wa-dropdown:not(.kui-popup-menu) > wa-button,
 .kui-toolbar-control-group
   > wa-dropdown:not(.kui-popup-menu)
-  > wa-button::part(base) {
+  > wa-button:not(:where(.kui-icon-button)),
+.kui-toolbar-control-group
+  > wa-dropdown:not(.kui-popup-menu)
+  > wa-button:not(:where(.kui-icon-button))::part(base) {
   min-width: 2.5rem;
   height: 2.5rem;
 }
 .kui-toolbar-control-group[data-size="compact"] > button,
 .kui-toolbar-control-group[data-size="compact"] > .kui-toolbar-action-link,
-.kui-toolbar-control-group[data-size="compact"] > wa-button,
+.kui-toolbar-control-group[data-size="compact"]
+  > wa-button:not(:where(.kui-icon-button)),
 .kui-toolbar-control-group[data-size="compact"]
   > wa-dropdown:not(.kui-popup-menu),
 .kui-toolbar-control-group[data-size="compact"]
   > wa-dropdown:not(.kui-popup-menu)
-  > wa-button,
+  > wa-button:not(:where(.kui-icon-button)),
 .kui-toolbar-control-group[data-size="compact"]
   > wa-dropdown:not(.kui-popup-menu)
-  > wa-button::part(base),
+  > wa-button:not(:where(.kui-icon-button))::part(base),
 .kui-toolbar-control-group[data-size="compact"][data-nested-dropdown="true"]
   wa-dropdown:not(.kui-popup-menu)
-  wa-button,
+  wa-button:not(:where(.kui-icon-button)),
 .kui-toolbar-control-group[data-size="compact"][data-nested-dropdown="true"]
   wa-dropdown:not(.kui-popup-menu)
-  wa-button::part(base) {
+  wa-button:not(:where(.kui-icon-button))::part(base) {
   min-width: 2rem;
   height: 2rem;
   min-height: 2rem;
@@ -523,7 +595,7 @@
 .kui-toolbar-control-group[data-size="compact"][data-content="mixed"]
   > wa-dropdown:not(.kui-popup-menu),
 .kui-toolbar-control-group[data-size="compact"][data-content="mixed"]
-  > wa-button {
+  > wa-button:not(:where(.kui-icon-button)) {
   margin: -2px;
 }
 
@@ -533,25 +605,26 @@
    the separator and the caret beyond the group border. */
 .kui-toolbar-control-group[data-content="mixed"][data-nested-dropdown="true"]
   > wa-dropdown:not(.kui-popup-menu)
-  > wa-button,
+  > wa-button:not(:where(.kui-icon-button)),
 .kui-toolbar-control-group[data-content="mixed"][data-nested-dropdown="true"]
   > wa-dropdown:not(.kui-popup-menu)
-  > wa-button::part(base) {
+  > wa-button:not(:where(.kui-icon-button))::part(base) {
   min-width: max-content;
 }
 .kui-toolbar-control-group[data-content="mixed"][data-nested-dropdown="true"]
   > wa-dropdown:not(.kui-popup-menu)
-  > wa-button::part(base) {
+  > wa-button:not(:where(.kui-icon-button))::part(base) {
   width: max-content;
 }
 
 .kui-toolbar-control-group[data-single="true"]
   > wa-dropdown:not(.kui-popup-menu)
-  > wa-button::part(base) {
+  > wa-button:not(:where(.kui-icon-button))::part(base) {
   width: max-content;
 }
 
-.kui-toolbar-control-group wa-button:not(:where(.kui-popup-menu > *)) {
+.kui-toolbar-control-group
+  wa-button:not(:where(.kui-popup-menu > *, .kui-icon-button)) {
   display: inline-flex;
   line-height: 0;
   align-items: center;
@@ -560,7 +633,7 @@
 }
 
 .kui-toolbar-control-group
-  wa-button:not(:where(.kui-popup-menu > *))::part(base) {
+  wa-button:not(:where(.kui-popup-menu > *, .kui-icon-button))::part(base) {
   /* Match min-width to the 40px height so an icon-only button's highlight is at
      least a circle, not a vertical oval — the host is 40px wide but the base
      part was sizing to its ~32px content. Text/caret buttons grow past it. */
@@ -575,15 +648,18 @@
 }
 
 .kui-toolbar-control-group
-  wa-button:not(:where(.kui-popup-menu > *)):hover::part(base) {
+  wa-button:not(
+    :where(.kui-popup-menu > *, .kui-icon-button),
+    [disabled]
+  ):hover::part(base) {
   border-color: var(--kui-toolbar-control-border);
   background-color: var(--kui-toolbar-control-hover-background);
 }
 
 .kui-toolbar-control-group[data-single="true"]:has(
     > :is(
-      button:not(:disabled),
-      wa-button,
+      button:not(:disabled, [aria-disabled="true"]),
+      wa-button:not([disabled]),
       .kui-popup-menu,
       wa-dropdown:not(.kui-popup-menu),
       .kui-select,
@@ -594,9 +670,16 @@
 }
 
 .kui-toolbar-control-group[data-single="true"]
-  > :is(button, wa-button, .kui-toolbar-action-link):hover,
+  > :is(
+    button,
+    wa-button:not(:where(.kui-icon-button)),
+    .kui-toolbar-action-link
+  ):hover,
 .kui-toolbar-control-group[data-single="true"]
-  wa-button:not(:where(.kui-popup-menu > *)):hover::part(base) {
+  wa-button:not(
+    :where(.kui-popup-menu > *, .kui-icon-button),
+    [disabled]
+  ):hover::part(base) {
   border-color: transparent;
   background: transparent;
 }
@@ -607,8 +690,8 @@
    Done action). */
 .kui-toolbar-control-group:not([data-single="true"]):has(
     > :is(
-        button:not(:disabled),
-        wa-button,
+        button:not(:disabled, [aria-disabled="true"]),
+        wa-button:not([disabled]),
         .kui-select,
         .kui-toolbar-action-link
       ):nth-child(1 of :where(:not([data-toolbar-visibility-state]))):where(
@@ -619,17 +702,25 @@
 }
 
 .kui-toolbar-control-group:not([data-single="true"]):has(
-    > :is(button, wa-button, .kui-toolbar-action-link):nth-child(
-        1 of :where(:not([data-toolbar-visibility-state]))
-      ):where(:nth-last-child(1 of :not([data-toolbar-visibility-state])))
+    > :is(
+        button,
+        wa-button:not(:where(.kui-icon-button)),
+        .kui-toolbar-action-link
+      ):nth-child(1 of :where(:not([data-toolbar-visibility-state]))):where(
+        :nth-last-child(1 of :not([data-toolbar-visibility-state]))
+      )
   )
-  > :is(button, wa-button, .kui-toolbar-action-link):hover,
+  > :is(
+    button,
+    wa-button:not(:where(.kui-icon-button)),
+    .kui-toolbar-action-link
+  ):hover,
 .kui-toolbar-control-group:not([data-single="true"]):has(
-    > :is(button, wa-button):nth-child(
+    > :is(button, wa-button:not(:where(.kui-icon-button))):nth-child(
         1 of :where(:not([data-toolbar-visibility-state]))
       ):where(:nth-last-child(1 of :not([data-toolbar-visibility-state])))
   )
-  > wa-button:hover::part(base) {
+  > wa-button:not(:where(.kui-icon-button)):hover::part(base) {
   border-color: transparent;
   background: transparent;
 }
@@ -651,18 +742,22 @@
    and stays inside the group's border instead of overflowing it as an oversized
    square (KF-5BDDQ9). The selected text color rides on the host and inherits in. */
 .kui-toolbar-control-group[data-single="false"]
-  > wa-button[aria-pressed="true"] {
+  > wa-button:not(:where(.kui-icon-button))[aria-pressed="true"] {
   color: var(--kui-toolbar-control-selected-color);
 }
 .kui-toolbar-control-group[data-single="false"]
-  > wa-button[aria-pressed="true"]::part(base) {
+  > wa-button:not(:where(.kui-icon-button))[aria-pressed="true"]::part(base) {
   border-color: var(--kui-toolbar-control-selected-border);
   background: var(--kui-toolbar-control-selected-background);
   box-shadow: var(--kui-toolbar-control-selected-shadow);
 }
 
 .kui-toolbar-control-group
-  > :is(button, wa-button, .kui-toolbar-action-link):focus-visible {
+  > :is(
+    button,
+    wa-button:not(:where(.kui-icon-button)),
+    .kui-toolbar-action-link
+  ):focus-visible {
   outline: var(--kui-focus-ring);
   outline-offset: 1px;
 }
@@ -743,12 +838,13 @@
 }
 
 .kui-toolbar-control-group[data-button-appearance="push"][data-single="true"]
-  > :is(button, wa-button)[aria-pressed="true"] {
+  > :is(button, wa-button:not(:where(.kui-icon-button)))[aria-pressed="true"] {
   color: var(--kui-toolbar-control-pressed-color);
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .kui-toolbar-control-group[data-content="search"] {
+  .kui-toolbar-control-group[data-content="search"],
+  .kui-toolbar-control-group[data-content="search"][data-sizing="grow"] {
     transition-duration: 0s;
   }
 
@@ -785,18 +881,18 @@
 .kui-toolbar-control-group[data-content="avatar"]:is(
     [data-single="true"],
     :has(
-      > :is(button, wa-button):nth-child(
+      > :is(button, wa-button:not(:where(.kui-icon-button))):nth-child(
           1 of :where(:not([data-toolbar-visibility-state]))
         ):where(:nth-last-child(1 of :not([data-toolbar-visibility-state])))
     )
   )
-  > :is(button, wa-button) {
+  > :is(button, wa-button:not(:where(.kui-icon-button))) {
   color: transparent;
 }
 
 .kui-toolbar-control-group[data-content="avatar"][data-single="false"]:not(
     :has(
-      > :is(button, wa-button):nth-child(
+      > :is(button, wa-button:not(:where(.kui-icon-button))):nth-child(
           1 of :where(:not([data-toolbar-visibility-state]))
         ):where(:nth-last-child(1 of :not([data-toolbar-visibility-state])))
     )
@@ -804,12 +900,12 @@
   > button[aria-pressed="true"],
 .kui-toolbar-control-group[data-content="avatar"][data-single="false"]:not(
     :has(
-      > :is(button, wa-button):nth-child(
+      > :is(button, wa-button:not(:where(.kui-icon-button))):nth-child(
           1 of :where(:not([data-toolbar-visibility-state]))
         ):where(:nth-last-child(1 of :not([data-toolbar-visibility-state])))
     )
   )
-  > wa-button[aria-pressed="true"]::part(base) {
+  > wa-button:not(:where(.kui-icon-button))[aria-pressed="true"]::part(base) {
   color: transparent;
   background-image: var(--kui-toolbar-avatar-image);
   background-origin: border-box;

package/dist/styles/toolbar-text.css

@@ -49,6 +49,29 @@ button.kui-toolbar-text:focus-visible {
   padding-block: max(0px, calc((var(--_kui-toolbar-band) - 1.25em) / 2));
 }
 
+/* A title with supporting copy stacks the two lines and centers them together
+   in the control band (growing past it only when they do not fit), so
+   trailing groups stay on the band and both lines start at the same edge. */
+.kui-toolbar-text[data-has-description="true"] {
+  height: auto;
+  flex-direction: column;
+  align-items: stretch;
+  justify-content: center;
+  gap: 0.125rem;
+}
+
+.kui-toolbar-text__description {
+  min-width: 0;
+  overflow: hidden;
+  color: var(--kui-color-text-quiet);
+  font-size: var(--kui-font-xs);
+  font-weight: 400;
+  letter-spacing: normal;
+  line-height: 1.2;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
 /* A filling title grows into its row's free space and truncates there. */
 .kui-toolbar-text[data-fill="true"] {
   flex: 1 1 auto;