@kerfjs/ui 4.5.0-beta.1 → 5.0.0-beta.100

package/dist/styles/list-item.css

@@ -1,32 +1,103 @@
 .kui-list-item {
-  --kui-list-item-color: var(--kui-color-neutral-on-normal);
-  --kui-list-item-border: transparent;
-  --kui-list-item-background: transparent;
-  --kui-list-item-hover-border: var(--kui-color-neutral-border-normal);
-  --kui-list-item-hover-background: var(--kui-color-neutral-fill-quiet);
-  --kui-list-item-selected-color: var(--kui-color-neutral-on-normal);
-  --kui-list-item-selected-border: var(--kui-color-brand-border-quiet);
-  --kui-list-item-selected-background: var(--kui-color-brand-fill-normal);
+  /* 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: 2.75rem;
+  min-height: var(--kui-list-item-min-height, 2.75rem);
+  overflow: hidden;
   margin-inline: var(--kui-layout-inline-margin, 0.5rem);
-  padding: var(--kui-layout-item-padding, 0.5rem);
+  padding-block: var(
+    --kui-list-item-padding-block,
+    var(--kui-layout-item-padding, 0.5rem)
+  );
+  padding-inline: var(
+    --kui-list-item-padding-inline,
+    var(
+      --kui-list-row-padding-inline,
+      var(--kui-layout-item-padding, 0.5rem)
+    )
+  );
   box-sizing: border-box;
-  border: 1px solid var(--kui-list-item-border);
-  border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
-  color: var(--kui-list-item-color);
-  background: var(--kui-list-item-background);
+  border: var(--kui-list-item-border-width, 1px) solid
+    var(--kui-list-item-border, transparent);
+  border-radius: var(
+    --kui-list-item-radius,
+    var(--kui-layout-rounded-radius, calc(1px + 0.6875rem))
+  );
+  color: var(--kui-list-item-color, var(--kui-color-neutral-on-normal));
+  background: var(--kui-list-item-background, transparent);
   cursor: pointer;
-  grid-template-columns: minmax(0, 1fr) auto;
-  align-items: center;
-  column-gap: var(--kui-layout-item-gap, 0.5rem);
+  grid-template-columns: var(--kui-list-item-columns, minmax(0, 1fr) auto);
+  align-items: var(--kui-list-item-align-items, center);
+  column-gap: var(--kui-list-item-gap, var(--kui-layout-item-gap, 0.5rem));
   font: inherit;
   text-align: start;
+  text-decoration: none;
+}
+
+.kui-list-item[data-density="compact"] {
+  min-height: var(--kui-list-item-min-height, 2.25rem);
+  padding-block: var(--kui-list-item-padding-block, 0.25rem);
+}
+
+.kui-list-item[data-density="spacious"] {
+  min-height: var(--kui-list-item-min-height, 3.25rem);
+  padding-block: var(--kui-list-item-padding-block, 0.75rem);
+}
+
+.kui-list-item[data-has-description="true"] {
+  min-height: var(--kui-list-item-min-height, 3.25rem);
+}
+
+.kui-list-item[data-density="compact"][data-has-description="true"] {
+  min-height: var(--kui-list-item-min-height, 2.75rem);
+}
+
+.kui-list-item[data-divider="before"],
+.kui-list-item[data-divider="both"] {
+  border-block-start-color: var(
+    --kui-list-group-divider-color,
+    var(--kui-color-neutral-border-quiet)
+  );
+  border-start-start-radius: 0;
+  border-start-end-radius: 0;
+}
+
+.kui-list-item[data-divider="after"],
+.kui-list-item[data-divider="both"] {
+  border-block-end-color: var(
+    --kui-list-group-divider-color,
+    var(--kui-color-neutral-border-quiet)
+  );
+  border-end-start-radius: 0;
+  border-end-end-radius: 0;
+}
+
+/* In a divided list, a corner is flat wherever its edge carries a divider
+   line, whichever row draws it: the previous row's after line squares this
+   row's top, and the next row's before line squares its bottom. So first,
+   middle, last, and only rows round just their outer corners. */
+:is([data-divider="after"], [data-divider="both"]) + .kui-list-item {
+  border-start-start-radius: 0;
+  border-start-end-radius: 0;
+}
+
+.kui-list-item:has(+ :is([data-divider="before"], [data-divider="both"])) {
+  border-end-start-radius: 0;
+  border-end-end-radius: 0;
 }
 
 .kui-list-item[data-has-icon="true"] {
-  grid-template-columns: 1.125rem minmax(0, 1fr) auto;
+  grid-template-columns: var(
+    --kui-list-item-columns,
+    var(--_kui-list-item-icon-size) minmax(0, 1fr) auto
+  );
 }
 
 .kui-list-item[data-has-icon="true"] .kui-list-item__icon {
@@ -49,22 +120,52 @@
   grid-column: 2;
 }
 
-.kui-list-item:hover {
-  border-color: var(--kui-list-item-hover-border);
-  background: var(--kui-list-item-hover-background);
+/* 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)
+  );
+  background: var(
+    --kui-list-item-hover-background,
+    var(--kui-color-neutral-fill-quiet)
+  );
 }
 
-.kui-list-item:disabled {
+/* A placeholder is disabled to stay inert, but it is loading, not unavailable:
+   it keeps the live row's tone (see the placeholder rule in skeleton.css). The
+   disabled tone follows the author's `disabled` prop (the data-kui-disabled
+   marker), so a disabled row's placeholder is dimmed like the loaded row; only
+   the `not-allowed` cursor is reserved for the live row. */
+.kui-list-item[data-kui-disabled="true"] {
   color: var(--kui-color-neutral-on-quiet);
-  cursor: not-allowed;
   opacity: 0.58;
 }
 
+.kui-list-item:is(:disabled, [aria-disabled="true"]):not(
+    [data-placeholder="true"]
+  ) {
+  cursor: not-allowed;
+}
+
 .kui-list-item[aria-current="page"],
 .kui-list-item[aria-pressed="true"] {
-  border-color: var(--kui-list-item-selected-border);
-  color: var(--kui-list-item-selected-color);
-  background: var(--kui-list-item-selected-background);
+  border-color: var(
+    --kui-list-item-selected-border,
+    var(--kui-color-brand-border-quiet)
+  );
+  color: var(
+    --kui-list-item-selected-color,
+    var(--kui-color-neutral-on-normal)
+  );
+  background: var(
+    --kui-list-item-selected-background,
+    var(--kui-color-brand-fill-normal)
+  );
   font-weight: 650;
 }
 
@@ -75,28 +176,53 @@
 
 .kui-list-item__icon {
   display: grid;
-  width: 1.125rem;
-  height: 1.125rem;
-  color: currentColor;
+  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: 1.125rem;
-  height: 1.125rem;
+  width: var(--_kui-list-item-icon-size);
+  height: var(--_kui-list-item-icon-size);
 }
 
 .kui-list-item__label {
+  display: grid;
   min-width: 0;
+  max-width: var(--kui-list-item-label-max-width, none);
   overflow: hidden;
-  text-overflow: ellipsis;
+  font-weight: var(--kui-list-item-label-weight, inherit);
   white-space: nowrap;
 }
 
+/* The label is a grid container, and `text-overflow` never reaches a grid
+   item's text, so each line of the stack clips and ellipsizes itself: a long
+   label ends in "…" before the trailing slot instead of being cut mid-glyph. */
+.kui-list-item__primary-label,
+.kui-list-item__description {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.kui-list-item__description {
+  color: var(--kui-color-neutral-on-quiet);
+  font-size: var(--kui-font-xs);
+  font-weight: 400;
+  line-height: 1.3;
+}
+
 .kui-list-item[data-multiline="true"] {
   height: fit-content;
   white-space: normal;
+  /* Size the single grid row to its content and center that track in the
+     44px minimum, instead of stretching it. The start-aligned icon then
+     measures its first-line offset from the same edge the centered label
+     starts at; a stretched track left a short label centered 1.4px below
+     the icon's first-line position. */
+  align-content: center;
 }
 
 .kui-list-item[data-multiline="true"] .kui-list-item__label {
@@ -104,20 +230,232 @@
   white-space: normal;
 }
 
+/* A multiline row shows its whole label, so a single word wider than the
+   column (a long component or file name) breaks onto the next line rather
+   than running under the trailing slot. */
+.kui-list-item[data-multiline="true"]
+  :is(.kui-list-item__primary-label, .kui-list-item__description) {
+  overflow: visible;
+  overflow-wrap: anywhere;
+}
+
 .kui-list-item[data-multiline="true"] .kui-list-item__icon {
   align-self: start;
-  margin-block-start: calc((1lh - 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"]
+  .kui-list-item__icon {
+  align-self: center;
+  margin-block-start: 0;
 }
 
 .kui-list-item__trailing {
   display: inline-flex;
   min-width: 0;
+  color: var(--kui-list-item-trailing-color, inherit);
   align-items: center;
   justify-content: flex-end;
   gap: var(--kui-layout-item-gap, 0.5rem);
 }
 
+.kui-list-item[data-state="drag-target"] {
+  outline: var(
+    --kui-list-item-drag-target-outline,
+    2px solid var(--kui-color-brand-border-normal)
+  );
+  outline-offset: var(--kui-list-item-drag-target-outline-offset, -2px);
+  background: var(
+    --kui-list-item-drag-target-background,
+    var(--kui-color-brand-fill-quiet)
+  );
+}
+
+/* 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-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);
+  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);
+  font-weight: 500;
+}
+
 .kui-list-item__trailing > svg {
   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;
+  }
+}