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

package/dist/styles/components/actions/toolbar-control-group/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/components/actions/toolbar-text/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;

package/dist/styles/components/collections/framed-list/framed-list.css

@@ -0,0 +1,47 @@
+/* The same frame as ValueTable: content-item margin, a real 1px border, the
+   rounded radius, and a lowered (or base) fill. Rows clip to its corners. */
+.kui-framed-list {
+  --kui-framed-list-border: var(--kui-color-neutral-border-normal);
+  display: flex;
+  flex-direction: column;
+  margin-block: 0;
+  margin-inline: var(--kui-layout-inline-margin, 0.5rem);
+  padding: 0;
+  overflow: hidden;
+  border: 1px solid var(--kui-framed-list-border);
+  border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
+  background: var(--kui-color-surface-lowered);
+  list-style: none;
+}
+
+.kui-framed-list[data-surface="base"] {
+  background: var(--kui-color-surface);
+}
+
+/* Each row owns the content inset and the 1px divider above it, inset to the
+   row's padding like ValueTable's separators. Its margin is reset because a
+   document or Web Awesome native stylesheet indents list items. */
+.kui-framed-list__row {
+  --_kui-framed-list-row-padding: var(--kui-layout-item-padding, 0.5rem);
+  position: relative;
+  display: grid;
+  min-width: 0;
+  margin: 0;
+  min-height: 2.75rem;
+  padding: var(--_kui-framed-list-row-padding);
+  box-sizing: border-box;
+  align-items: center;
+}
+
+.kui-framed-list__row + .kui-framed-list__row::before {
+  position: absolute;
+  top: 0;
+  right: var(--_kui-framed-list-row-padding);
+  left: var(--_kui-framed-list-row-padding);
+  border-top: 1px solid var(--kui-framed-list-border);
+  content: "";
+}
+
+.kui-framed-list__row[data-highlighted="true"] {
+  background: var(--kui-color-brand-fill-quiet);
+}

package/dist/styles/components/collections/list/list.css

@@ -81,6 +81,22 @@
   );
 }
 
+/* `inset="document"`: a reading inset on all four sides that replaces any
+   side-selected text or control inset. */
+.kui-list[data-inset="document"] {
+  --_kui-list-inset-top: var(--kui-space-l);
+  --_kui-list-inset-right: var(--kui-space-xl);
+  --_kui-list-inset-bottom: var(--kui-space-l);
+  --_kui-list-inset-left: var(--kui-space-xl);
+}
+
+@media (max-width: 36rem) {
+  .kui-list[data-inset="document"] {
+    --_kui-list-inset-right: var(--kui-space-m);
+    --_kui-list-inset-left: var(--kui-space-m);
+  }
+}
+
 .kui-list[data-h-align="left"] {
   align-items: flex-start;
   align-content: flex-start;
@@ -113,6 +129,25 @@
   overscroll-behavior-y: contain;
 }
 
+/* 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
+   `flex-shrink: 1` compressed multiline rows into one another once the List
+   was bounded by a max-height ancestor. */
+.kui-list[data-scrollable="true"] > * {
+  flex-shrink: 0;
+}
+
+/* A scrollable List is a keyboard-focusable scroller: Chromium focuses it on
+   Tab when it holds no focusable rows, and a dialog may pick it as its first
+   focusable area. Its ring sits inside its box, so a rounded or clipping
+   parent cannot cut it off, and rounds with the standard control radius. */
+.kui-list[data-scrollable="true"]:focus-visible {
+  border-radius: var(--kui-radius-m);
+  outline: var(--kui-focus-ring);
+  outline-offset: -3px;
+}
+
 .kui-list:is([divider-sides*="t"], [data-scroll-divider*="t"]) {
   --_kui-list-divider-top: var(--kui-list-divider-color);
 }
@@ -129,6 +164,15 @@
   --_kui-list-divider-left: var(--kui-list-divider-color);
 }
 
+/* `surface`: a solid background behind the stack and its insets. */
+.kui-list[data-surface="base"] {
+  background: var(--kui-color-surface);
+}
+
+.kui-list[data-surface="raised"] {
+  background: var(--kui-color-surface-raised);
+}
+
 /* `fill`: the layout root of a definite-height parent (an app root or a
    fixed-height frame) takes its full height. Inside a flex layout use `flex`. */
 .kui-list[data-fill="true"] {

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

@@ -68,6 +68,40 @@
   outline-offset: 1px;
 }
 
+/* Reorder presentation. A dragged row dims; the row under the pointer draws
+   a brand insertion line along the block edge the dragged rows would land
+   beside, inset to the row's content padding so it ends clear of the
+   rounded corners. */
+.kui-list-action-row[data-dragging="true"] {
+  opacity: var(--kui-list-action-row-dragging-opacity, 0.55);
+}
+
+.kui-list-action-row[data-drop-position] {
+  position: relative;
+}
+
+.kui-list-action-row[data-drop-position]::after {
+  position: absolute;
+  z-index: 1;
+  inset-inline: var(--kui-layout-item-padding, 0.5rem);
+  height: var(--kui-list-action-row-drop-indicator-width, 2px);
+  border-radius: var(--kui-radius-pill);
+  background: var(
+    --kui-list-action-row-drop-indicator,
+    var(--kui-color-brand-border-loud)
+  );
+  content: "";
+  pointer-events: none;
+}
+
+.kui-list-action-row[data-drop-position="before"]::after {
+  inset-block-start: 0;
+}
+
+.kui-list-action-row[data-drop-position="after"]::after {
+  inset-block-end: 0;
+}
+
 .kui-list-action-row__primary,
 .kui-list-action-row__trailing-action {
   height: auto !important;
@@ -244,6 +278,11 @@
 }
 
 @media (forced-colors: active) {
+  .kui-list-action-row[data-drop-position]::after {
+    background: Highlight;
+    forced-color-adjust: none;
+  }
+
   .kui-list-action-row {
     --kui-list-action-row-border: ButtonText;
     outline: 1px solid ButtonText;

package/dist/styles/components/collections/list-item/list-item.css

@@ -243,6 +243,51 @@
   );
 }
 
+/* Reorder presentation. A dragged row dims; the row under the pointer draws
+   a brand insertion line along the block edge the dragged rows would land
+   beside. The line sits inside the row (the row clips its overflow to its
+   rounded boundary) and is inset to the row's content padding so it ends
+   clear of the rounded corners. */
+.kui-list-item[data-dragging="true"] {
+  opacity: var(--kui-list-item-dragging-opacity, 0.55);
+}
+
+.kui-list-item[data-drop-position] {
+  position: relative;
+}
+
+.kui-list-item[data-drop-position]::after {
+  position: absolute;
+  z-index: 1;
+  inset-inline: var(
+    --kui-list-item-padding-inline,
+    var(--kui-layout-item-padding, 0.5rem)
+  );
+  height: var(--kui-list-item-drop-indicator-width, 2px);
+  border-radius: var(--kui-radius-pill);
+  background: var(
+    --kui-list-item-drop-indicator,
+    var(--kui-color-brand-border-loud)
+  );
+  content: "";
+  pointer-events: none;
+}
+
+.kui-list-item[data-drop-position="before"]::after {
+  inset-block-start: 0;
+}
+
+.kui-list-item[data-drop-position="after"]::after {
+  inset-block-end: 0;
+}
+
+@media (forced-colors: active) {
+  .kui-list-item[data-drop-position]::after {
+    background: Highlight;
+    forced-color-adjust: none;
+  }
+}
+
 .kui-list-item__status {
   color: var(--kui-color-neutral-on-quiet);
   font-size: var(--kui-font-xs);