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

package/dist/styles/file-picker.css

@@ -0,0 +1,81 @@
+/* The native file input stays inside each label for activation, keyboard
+   focus, and form submission, visually hidden but accessible. */
+.kui-file-picker__input {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+}
+
+.kui-file-picker__icon {
+  display: inline-grid;
+  flex: none;
+  place-items: center;
+}
+
+/* A compact, link-toned browse trigger. */
+.kui-file-picker[data-presentation="trigger"] {
+  position: relative;
+  display: inline-flex;
+  min-height: 2rem;
+  padding: 0 var(--kui-space-xs);
+  border-radius: var(--kui-radius-pill);
+  color: var(--kui-color-text-link);
+  cursor: pointer;
+  align-items: center;
+  gap: var(--kui-space-2xs);
+  font-size: var(--kui-font-xs);
+  font-weight: var(--kui-font-weight-semibold);
+}
+
+.kui-file-picker[data-presentation="trigger"]:hover {
+  background: var(--kui-color-brand-fill-quiet);
+}
+
+/* A dashed drop target with content-item margins, highlighted on hover and
+   while files are dragged over it. */
+.kui-file-picker[data-presentation="drop-zone"] {
+  position: relative;
+  display: grid;
+  min-height: 5rem;
+  margin-inline: var(--kui-layout-inline-margin, 0.5rem);
+  padding: var(--kui-space-s);
+  box-sizing: border-box;
+  border: 1px dashed var(--kui-color-neutral-border-loud);
+  border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
+  color: var(--kui-color-neutral-on-quiet);
+  cursor: pointer;
+  place-items: center;
+  align-content: center;
+  gap: var(--kui-space-2xs);
+  font-size: var(--kui-font-xs);
+  text-align: center;
+}
+
+.kui-file-picker[data-presentation="drop-zone"]:hover,
+.kui-file-picker[data-presentation="drop-zone"][data-dragging="true"] {
+  border-color: var(--kui-color-text-link);
+  background: var(--kui-color-brand-fill-quiet);
+}
+
+.kui-file-picker__title {
+  color: var(--kui-color-text);
+}
+
+.kui-file-picker__detail {
+  font-size: var(--kui-font-2xs);
+}
+
+/* Keyboard focus lands on the hidden input; the visible control shows it. */
+.kui-file-picker:has(> .kui-file-picker__input:focus-visible) {
+  outline: var(--kui-focus-ring);
+  outline-offset: 2px;
+}
+
+.kui-file-picker[data-disabled="true"] {
+  cursor: default;
+  opacity: 0.5;
+  pointer-events: none;
+}

package/dist/styles/foundation.css

@@ -131,6 +131,14 @@
       rgb(228.157895 228.157895 255 / 0.07451)
     )
   );
+  /* The sunken surface: a fine monochrome grain over the lowered color. The
+     tile is generated once per page by the first sunken surface that renders
+     (ensureSunkenTexture); set --kui-sunken-texture to none at :root for a
+     flat lowered surface, or to another image. */
+  --kui-sunken-texture: var(--_kui-sunken-texture-generated, none);
+  --kui-sunken-surface:
+    var(--kui-sunken-texture) 0 0 / 100px 100px repeat,
+    var(--kui-color-surface-lowered);
   --kui-color-text: var(--wa-color-text-normal, light-dark(#1d1d1f, #f5f5f7));
   --kui-color-text-quiet: var(
     --wa-color-text-quiet,

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

@@ -0,0 +1,22 @@
+/* Web Awesome's own icon-button geometry, for a lone LucideIcon: a square one
+   form control height on each side with the glyph centered. Web Awesome
+   applies it only to a lone wa-icon. */
+.kui-icon-button::part(base) {
+  width: var(--wa-form-control-height);
+  min-width: var(--wa-form-control-height);
+  padding: 0;
+  aspect-ratio: 1;
+  justify-content: center;
+}
+
+.kui-icon-button::part(label) {
+  display: flex;
+  justify-content: center;
+}
+
+/* Beside a field in a ListInsetControl, the square keeps its size instead of
+   growing to share the row, and lines up with the field below its label. */
+.kui-list-inset-control > .kui-icon-button {
+  flex: none;
+  align-self: flex-end;
+}

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

@@ -46,6 +46,20 @@
   border-end-end-radius: 0;
 }
 
+/* In a divided list, a corner is flat wherever its edge carries a divider
+   line, whichever row draws it (see ListItem). */
+:is([data-divider="after"], [data-divider="both"]) + .kui-list-action-row {
+  border-start-start-radius: 0;
+  border-start-end-radius: 0;
+}
+
+.kui-list-action-row:has(
+  + :is([data-divider="before"], [data-divider="both"])
+) {
+  border-end-start-radius: 0;
+  border-end-end-radius: 0;
+}
+
 .kui-list-action-row:not([data-placeholder="true"]):has(
     .kui-list-action-row__primary:hover
   ) {
@@ -68,6 +82,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 +292,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

@@ -68,6 +68,20 @@
   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: var(
     --kui-list-item-columns,
@@ -243,6 +257,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;
+}