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

package/dist/styles/icon-toggle-button.css

@@ -0,0 +1,83 @@
+/* The single contained ToolbarControlGroup's geometry, standalone: a 44px
+   filled, bordered control whose 2px-inset face lifts to the raised surface
+   on hover and stays raised, in the brand foreground, while pressed. */
+.kui-icon-toggle-button {
+  --_kui-icon-toggle-button-radius: var(
+    --kui-layout-pill-radius,
+    calc(1px + 1.3125rem)
+  );
+  --_kui-icon-toggle-button-inset: var(
+    --kui-layout-highlight-inset,
+    0.125rem
+  );
+  /* One full-size track for the face. The button sets its own track and
+     alignment because native or document button styles center content,
+     which would shrink the face to the icon. */
+  display: inline-grid;
+  grid-template: minmax(0, 1fr) / minmax(0, 1fr);
+  place-content: stretch;
+  place-items: stretch;
+  width: 2.75rem;
+  height: 2.75rem;
+  margin: 0;
+  padding: var(--_kui-icon-toggle-button-inset);
+  box-sizing: border-box;
+  border: 1px solid var(--kui-color-neutral-border-normal);
+  border-radius: var(--_kui-icon-toggle-button-radius);
+  color: var(--kui-color-neutral-on-quiet);
+  background: var(--kui-color-neutral-fill-normal);
+  cursor: pointer;
+  flex: none;
+  font: inherit;
+}
+
+.kui-icon-toggle-button[data-shape="rounded"] {
+  --_kui-icon-toggle-button-radius: var(
+    --kui-layout-rounded-radius,
+    calc(1px + 0.6875rem)
+  );
+}
+
+.kui-icon-toggle-button__face {
+  display: grid;
+  border-radius: max(
+    0px,
+    calc(
+      var(--_kui-icon-toggle-button-radius) -
+        var(--_kui-icon-toggle-button-inset) - 1px
+    )
+  );
+  place-items: center;
+  transition:
+    background-color 120ms ease,
+    box-shadow 120ms ease;
+}
+
+.kui-icon-toggle-button:hover:not(:disabled) > .kui-icon-toggle-button__face {
+  background: var(--kui-color-surface);
+}
+
+.kui-icon-toggle-button[aria-pressed="true"] {
+  color: var(--kui-color-brand-on-quiet);
+}
+
+.kui-icon-toggle-button[aria-pressed="true"] > .kui-icon-toggle-button__face {
+  background: var(--kui-color-surface);
+  box-shadow: var(--kui-shadow-s);
+}
+
+.kui-icon-toggle-button:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: 1px;
+}
+
+.kui-icon-toggle-button:disabled {
+  cursor: default;
+  opacity: 0.5;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .kui-icon-toggle-button__face {
+    transition: none;
+  }
+}

package/dist/styles/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/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);

package/dist/styles/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/pane.css

@@ -44,17 +44,11 @@
    Fixed chrome leaves the content slot scrolling; auto chrome lets the Pane
    root scroll in its short mode, while its content remains transparent. */
 .kui-pane[data-appearance="sunken"] > .kui-pane__content {
-  background: var(
-    --kui-sunken-panel-background,
-    var(--kui-color-surface-lowered)
-  );
+  background: var(--kui-sunken-panel-background, var(--kui-sunken-surface));
 }
 
 .kui-pane[data-appearance="sunken"][data-chrome-placement="auto"] {
-  background: var(
-    --kui-sunken-panel-background,
-    var(--kui-color-surface-lowered)
-  );
+  background: var(--kui-sunken-panel-background, var(--kui-sunken-surface));
 }
 
 .kui-pane[data-appearance="sunken"][data-chrome-placement="auto"]

package/dist/styles/popup-menu.css

@@ -104,8 +104,14 @@
   height: var(--_kui-popup-row-icon-size);
 }
 
+/* A context menu takes no space where it is rendered: out of flow, it adds no
+   line box in block layout and no gap slot in a flex or grid container. Its
+   fixed anchor opens the menu at the recorded viewport point. */
 .kui-popup-menu[data-trigger="context"] {
-  display: inline-block;
+  position: fixed;
+  top: 0;
+  left: 0;
+  display: block;
   width: 0;
   height: 0;
 }
@@ -283,3 +289,65 @@
   > wa-dropdown.kui-popup-menu::part(menu) {
   padding: 0;
 }
+
+/* As a ListActionRow's trailing menu, the PopupMenu styles its trigger in the
+   row's context like the row's trailing button: a full-height 44px pill (36px
+   in a compact row) on the row's trailing-hover fill, with a 16px icon. */
+.kui-list-action-row > .kui-popup-menu {
+  display: flex;
+  flex: none;
+}
+.kui-list-action-row > .kui-popup-menu > wa-button {
+  display: flex;
+  min-height: 2.75rem;
+  color: inherit;
+}
+.kui-list-action-row[data-density="compact"] > .kui-popup-menu > wa-button {
+  min-height: 2.25rem;
+}
+.kui-list-action-row > .kui-popup-menu > wa-button::part(base) {
+  width: 2.75rem;
+  min-width: 2.75rem;
+  height: 100%;
+  min-height: 0;
+  padding: 0;
+  border: 0;
+  border-radius: var(--kui-radius-pill);
+  color: inherit;
+  background: transparent;
+}
+.kui-list-action-row
+  > .kui-popup-menu
+  > wa-button:not([disabled]):hover::part(base) {
+  background: var(--kui-list-action-row-trailing-hover-background);
+}
+.kui-list-action-row > .kui-popup-menu > wa-button::part(base):focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: -2px;
+}
+.kui-list-action-row > .kui-popup-menu > wa-button > svg {
+  display: block;
+  width: 1rem;
+  height: 1rem;
+}
+/* The row's interaction visibility reveals the trigger on hover or focus, and
+   keeps it visible while its menu is open. A placeholder row reveals nothing. */
+.kui-list-action-row[data-trailing-visibility="interaction"]
+  > .kui-popup-menu:not([open])
+  > wa-button {
+  opacity: 0;
+}
+.kui-list-action-row[data-trailing-visibility="interaction"]:not(
+    [data-placeholder="true"]
+  ):is(:hover, :focus-within)
+  > .kui-popup-menu
+  > wa-button {
+  opacity: 1;
+}
+@media (hover: none) {
+  .kui-list-action-row[data-trailing-visibility="interaction"]
+    > .kui-popup-menu
+    > wa-button {
+    opacity: 1;
+  }
+}

package/dist/styles/split-button.css

@@ -0,0 +1,95 @@
+/* One loud semantic fill split into a primary half and a narrow options
+   trigger, with a hairline divider in the foreground color. Both halves are
+   native buttons on the shared fill; each brightens on its own hover. */
+.kui-split-button {
+  --_kui-split-button-fill: var(--kui-color-brand-fill-loud);
+  --_kui-split-button-on: var(--kui-color-brand-on-loud);
+  display: inline-grid;
+  min-width: 0;
+  min-height: 2.75rem;
+  overflow: hidden;
+  border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
+  color: var(--_kui-split-button-on);
+  background: var(--_kui-split-button-fill);
+  grid-template-columns: minmax(0, auto) 2.5rem;
+  font-weight: var(--kui-font-weight-semibold);
+}
+
+.kui-split-button[data-tone="neutral"] {
+  --_kui-split-button-fill: var(--kui-color-neutral-fill-loud);
+  --_kui-split-button-on: var(--kui-color-neutral-on-loud);
+}
+
+.kui-split-button[data-tone="success"] {
+  --_kui-split-button-fill: var(--kui-color-success-fill-loud);
+  --_kui-split-button-on: var(--kui-color-success-on-loud);
+}
+
+.kui-split-button[data-tone="warning"] {
+  --_kui-split-button-fill: var(--kui-color-warning-fill-loud);
+  --_kui-split-button-on: var(--kui-color-warning-on-loud);
+}
+
+.kui-split-button[data-tone="danger"] {
+  --_kui-split-button-fill: var(--kui-color-danger-fill-loud);
+  --_kui-split-button-on: var(--kui-color-danger-on-loud);
+}
+
+.kui-split-button[data-fill="true"] {
+  display: grid;
+  width: 100%;
+  grid-template-columns: minmax(0, 1fr) 2.5rem;
+}
+
+.kui-split-button > button {
+  display: flex;
+  min-width: 0;
+  min-height: 2.75rem;
+  margin: 0;
+  padding-block: var(--kui-space-xs);
+  padding-inline: var(--kui-space-s);
+  border: 0;
+  border-radius: 0;
+  color: inherit;
+  background: transparent;
+  cursor: pointer;
+  align-items: center;
+  justify-content: center;
+  gap: var(--kui-space-xs);
+  font: inherit;
+}
+
+.kui-split-button > .kui-split-button__options {
+  padding-inline: 0;
+  border-inline-start: 1px solid
+    color-mix(in srgb, currentColor 28%, transparent);
+}
+
+.kui-split-button > button:hover:not(:disabled) {
+  background: color-mix(in srgb, currentColor 12%, transparent);
+}
+
+/* The group clips outer outlines at its rounded corners, so the ring sits
+   inside each half. */
+.kui-split-button > button:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: -3px;
+}
+
+.kui-split-button > button:disabled {
+  cursor: not-allowed;
+  opacity: 0.6;
+}
+
+.kui-split-button__icon {
+  display: inline-grid;
+  flex: none;
+  place-items: center;
+}
+
+.kui-split-button__label {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}

package/dist/styles/state-banner.css

@@ -135,6 +135,44 @@
     var(--kui-state-banner-danger-foreground, var(--kui-color-danger-on-fill))
   );
 }
+/* A strip is a full-width band at a layout edge rather than a card beside the
+   work: flush, square, and divided from its neighbor only on the edges it
+   names, in the tone's own border color. Its inline padding lands the copy on
+   the content-text column a card banner's copy uses (8px margin + 1px border
+   + 8px padding), so a strip above a pane lines up with the pane's text. */
+.kui-state-banner[data-presentation="strip"] {
+  margin-inline: 0;
+  padding-block: var(--kui-space-xs);
+  padding-inline: calc(1px + 1rem);
+  border-width: 0;
+  border-radius: 0;
+}
+.kui-state-banner[data-presentation="strip"][divider-sides*="t"] {
+  border-top-width: 1px;
+}
+.kui-state-banner[data-presentation="strip"][divider-sides*="r"] {
+  border-right-width: 1px;
+}
+.kui-state-banner[data-presentation="strip"][divider-sides*="b"] {
+  border-bottom-width: 1px;
+}
+.kui-state-banner[data-presentation="strip"][divider-sides*="l"] {
+  border-left-width: 1px;
+}
+/* Inside a CornerStatus the banner floats over the page at a viewport corner:
+   the corner's gutter replaces the inline margin, elevation separates it from
+   whatever content it covers, and the translucent tone fill composites over
+   the opaque surface so that content never shows through the copy. */
+.kui-corner-status > .kui-state-banner {
+  margin-inline: 0;
+  background:
+    linear-gradient(
+      var(--_kui-state-banner-background),
+      var(--_kui-state-banner-background)
+    ),
+    var(--kui-color-surface);
+  box-shadow: var(--kui-shadow-l);
+}
 .kui-state-banner__icon {
   display: grid;
   place-items: center;

package/dist/styles/styles.css

@@ -26,7 +26,19 @@
 @import "./popup-menu.css";
 @import "./anchored-surface.css";
 @import "./segmented-control.css";
+@import "./choice-chips.css";
 @import "./token-search-field.css";
 @import "./state-banner.css";
+@import "./corner-status.css";
+@import "./column-track.css";
+@import "./content-swap.css";
+@import "./file-picker.css";
+@import "./combobox.css";
+@import "./edge-activity-indicator.css";
+@import "./icon-button.css";
+@import "./icon-toggle-button.css";
+@import "./split-button.css";
+@import "./framed-list.css";
+@import "./summary-row.css";
 @import "./empty-state.css";
 @import "./value-table.css";

package/dist/styles/summary-row.css

@@ -0,0 +1,161 @@
+/* A selectable summary: a full-width option on the base surface, a container
+   for its own compaction, with a hairline divider below each list row. */
+.kui-summary-row {
+  --_kui-summary-row-rail: transparent;
+  --_kui-summary-row-radius: var(
+    --kui-layout-rounded-radius,
+    calc(1px + 0.6875rem)
+  );
+  --_kui-summary-row-title-lines: 2;
+  position: relative;
+  display: block;
+  width: 100%;
+  min-width: 0;
+  overflow: hidden;
+  box-sizing: border-box;
+  border: 1px solid transparent;
+  border-block-end-color: var(--kui-color-neutral-border-quiet);
+  border-radius: 0;
+  color: var(--kui-color-text);
+  background: var(--kui-color-surface);
+  cursor: pointer;
+  outline: none;
+  container-type: inline-size;
+  user-select: none;
+}
+
+.kui-summary-row[data-presentation="card"] {
+  --_kui-summary-row-title-lines: 4;
+  border-color: transparent;
+  border-radius: var(--_kui-summary-row-radius);
+}
+
+.kui-summary-row[data-list-edge="start"] {
+  border-start-start-radius: var(--_kui-summary-row-radius);
+  border-start-end-radius: var(--_kui-summary-row-radius);
+}
+.kui-summary-row[data-list-edge="end"] {
+  border-end-start-radius: var(--_kui-summary-row-radius);
+  border-end-end-radius: var(--_kui-summary-row-radius);
+}
+.kui-summary-row[data-list-edge="only"] {
+  border-radius: var(--_kui-summary-row-radius);
+}
+
+.kui-summary-row[data-defer="true"] {
+  content-visibility: auto;
+  contain-intrinsic-size: auto 4.5rem;
+}
+
+.kui-summary-row:hover {
+  border-color: var(--kui-color-brand-border-normal);
+}
+
+.kui-summary-row:focus-visible {
+  box-shadow: 0 0 0 3px
+    color-mix(in srgb, var(--kui-color-text-link) 24%, transparent);
+}
+
+.kui-summary-row[data-selected="true"] {
+  border-color: var(--kui-color-brand-border-normal);
+  background: var(--kui-color-brand-fill-quiet);
+}
+
+.kui-summary-row[data-dimmed="true"]:not(:hover, [data-selected="true"]) {
+  opacity: 0.55;
+}
+
+/* The leading state rail. */
+.kui-summary-row__rail {
+  position: absolute;
+  inset: 0 auto 0 0;
+  width: 0.25rem;
+  background: var(--_kui-summary-row-rail);
+}
+.kui-summary-row[data-rail="neutral"] {
+  --_kui-summary-row-rail: var(--kui-color-neutral-on-quiet);
+}
+.kui-summary-row[data-rail="info"] {
+  --_kui-summary-row-rail: var(--kui-color-brand-fill-loud);
+}
+.kui-summary-row[data-rail="pop"] {
+  --_kui-summary-row-rail: var(--kui-color-pop-fill-loud);
+}
+.kui-summary-row[data-rail="success"] {
+  --_kui-summary-row-rail: var(--kui-color-success-fill-loud);
+}
+.kui-summary-row[data-rail="warning"] {
+  --_kui-summary-row-rail: var(--kui-color-warning-fill-loud);
+}
+.kui-summary-row[data-rail="danger"] {
+  --_kui-summary-row-rail: var(--kui-color-danger-fill-loud);
+}
+
+/* Leading glyph, then the content column. */
+.kui-summary-row__body {
+  display: grid;
+  min-width: 0;
+  padding: var(--kui-space-xs) var(--kui-space-s);
+  grid-template-columns: auto minmax(0, 1fr);
+  align-items: start;
+  gap: var(--kui-space-xs);
+}
+
+.kui-summary-row__body:not(:has(> .kui-summary-row__leading)) {
+  grid-template-columns: minmax(0, 1fr);
+}
+
+.kui-summary-row__leading {
+  display: grid;
+  min-width: 1.5rem;
+  min-height: 1.5rem;
+  color: var(--kui-color-neutral-on-quiet);
+  place-items: center;
+}
+
+.kui-summary-row[data-presentation="card"] .kui-summary-row__leading {
+  min-width: 1.125rem;
+  min-height: 1.25rem;
+}
+
+.kui-summary-row__content {
+  display: grid;
+  min-width: 0;
+  gap: var(--kui-space-2xs);
+}
+
+/* The identity line clips at its line budget; the trailing meta floats to its
+   end so the title wraps around it. */
+.kui-summary-row__title {
+  min-width: 0;
+  max-height: calc(var(--_kui-summary-row-title-lines) * 1.3em);
+  overflow: hidden;
+  line-height: 1.3;
+  overflow-wrap: anywhere;
+}
+
+.kui-summary-row__trailing {
+  float: inline-end;
+  margin-inline-start: var(--kui-space-s);
+  color: var(--kui-color-text-quiet);
+  font-size: var(--kui-font-2xs);
+  line-height: calc(1.3em * 1.15);
+  white-space: nowrap;
+}
+
+.kui-summary-row__metadata {
+  display: flex;
+  min-width: 0;
+  color: var(--kui-color-neutral-on-quiet);
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--kui-space-2xs) var(--kui-space-xs);
+  font-size: var(--kui-font-xs);
+}
+
+/* A narrow row tightens its gaps. */
+@container (max-width: 24rem) {
+  .kui-summary-row__body {
+    padding: var(--kui-space-xs);
+  }
+}

package/dist/styles/sunken-panel.css

@@ -12,10 +12,7 @@
     var(--kui-layout-rounded-radius, calc(1px + 0.6875rem))
   );
   color: var(--kui-sunken-panel-foreground, var(--kui-color-text));
-  background: var(
-    --kui-sunken-panel-background,
-    var(--kui-color-surface-lowered)
-  );
+  background: var(--kui-sunken-panel-background, var(--kui-sunken-surface));
   flex-direction: column;
   gap: var(--kui-sunken-panel-gap, 0.5rem);
 }