@kerfjs/ui 5.0.0-beta.6 → 5.0.0-beta.61

package/dist/styles/list-item.css

@@ -0,0 +1,245 @@
+.kui-list-item {
+  --kui-list-group-divider-color: var(--kui-color-neutral-border-quiet);
+  --kui-list-item-color: var(--kui-color-neutral-on-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-background: var(--kui-color-brand-fill-normal);
+  display: grid;
+  width: calc(100% - (2 * var(--kui-layout-inline-margin, 0.5rem)));
+  min-height: var(--kui-list-item-min-height, 2.75rem);
+  overflow: hidden;
+  margin-inline: var(--kui-layout-inline-margin, 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-layout-item-padding, 0.5rem)
+  );
+  box-sizing: border-box;
+  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);
+  background: var(--kui-list-item-background, transparent);
+  cursor: pointer;
+  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);
+  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);
+  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,
+    var(--kui-list-item-icon-size, 1.125rem) minmax(0, 1fr) auto
+  );
+}
+
+.kui-list-item[data-has-icon="true"] .kui-list-item__icon {
+  grid-column: 1;
+}
+
+.kui-list-item[data-has-icon="true"] .kui-list-item__label {
+  grid-column: 2;
+}
+
+.kui-list-item[data-has-icon="true"] .kui-list-item__trailing {
+  grid-column: 3;
+}
+
+.kui-list-item[data-has-icon="false"] .kui-list-item__label {
+  grid-column: 1;
+}
+
+.kui-list-item[data-has-icon="false"] .kui-list-item__trailing {
+  grid-column: 2;
+}
+
+.kui-list-item:hover:not([data-placeholder="true"]) {
+  border-color: var(
+    --kui-list-item-hover-border,
+    var(--kui-color-neutral-border-normal)
+  );
+  background: var(--kui-list-item-hover-background);
+}
+
+/* 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);
+  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,
+    var(--kui-color-brand-border-quiet)
+  );
+  color: var(--kui-list-item-selected-color);
+  background: var(--kui-list-item-selected-background);
+  font-weight: 650;
+}
+
+.kui-list-item:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: 1px;
+}
+
+.kui-list-item__icon {
+  display: grid;
+  width: var(--kui-list-item-icon-size, 1.125rem);
+  height: var(--kui-list-item-icon-size, 1.125rem);
+  color: var(--kui-list-item-icon-color, currentColor);
+  place-items: center;
+}
+
+.kui-list-item__icon svg {
+  display: block;
+  width: var(--kui-list-item-icon-size, 1.125rem);
+  height: var(--kui-list-item-icon-size, 1.125rem);
+}
+
+.kui-list-item__label {
+  display: grid;
+  min-width: 0;
+  max-width: var(--kui-list-item-label-max-width, none);
+  overflow: hidden;
+  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 {
+  overflow: visible;
+  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 - var(--kui-list-item-icon-size, 1.125rem)) / 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)
+  );
+}
+
+.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;
+}

package/dist/styles/list.css

@@ -0,0 +1,133 @@
+.kui-list {
+  --kui-list-divider-color: var(--kui-color-neutral-border-normal);
+  --kui-list-gap: var(--kui-layout-item-gap, 0.5rem);
+  /* Private per-instance values are reset on every List so a nested List that
+     omits `gap` or `flex` never inherits its ancestor's; the component's inline
+     style overrides these defaults for the props it does set. */
+  --_kui-list-gap: 0;
+  --_kui-list-flex: 0 1 auto;
+  --_kui-list-inset-top: 0;
+  --_kui-list-inset-right: 0;
+  --_kui-list-inset-bottom: 0;
+  --_kui-list-inset-left: 0;
+  --_kui-list-divider-top: transparent;
+  --_kui-list-divider-right: transparent;
+  --_kui-list-divider-bottom: transparent;
+  --_kui-list-divider-left: transparent;
+
+  display: flex;
+  min-width: 0;
+  min-height: 0;
+  box-sizing: border-box;
+  padding: var(--_kui-list-inset-top, 0) var(--_kui-list-inset-right, 0)
+    var(--_kui-list-inset-bottom, 0) var(--_kui-list-inset-left, 0);
+  flex: var(--_kui-list-flex, initial);
+  flex-direction: column;
+  align-items: stretch;
+  align-content: space-between;
+  justify-content: flex-start;
+  gap: var(--_kui-list-gap, 0);
+  box-shadow:
+    inset 0 1px var(--_kui-list-divider-top),
+    inset -1px 0 var(--_kui-list-divider-right),
+    inset 0 -1px var(--_kui-list-divider-bottom),
+    inset 1px 0 var(--_kui-list-divider-left);
+}
+
+.kui-list[data-control-insets*="t"] {
+  --_kui-list-inset-top: var(--kui-layout-inline-margin, 0.5rem);
+}
+
+.kui-list[data-control-insets*="r"] {
+  --_kui-list-inset-right: var(--kui-layout-inline-margin, 0.5rem);
+}
+
+.kui-list[data-control-insets*="b"] {
+  --_kui-list-inset-bottom: var(--kui-layout-inline-margin, 0.5rem);
+}
+
+.kui-list[data-control-insets*="l"] {
+  --_kui-list-inset-left: var(--kui-layout-inline-margin, 0.5rem);
+}
+
+.kui-list[data-text-insets*="t"] {
+  --_kui-list-inset-top: calc(
+    var(--kui-layout-inline-margin, 0.5rem) + 1px +
+      var(--kui-layout-item-padding, 0.5rem)
+  );
+}
+
+.kui-list[data-text-insets*="r"] {
+  --_kui-list-inset-right: calc(
+    var(--kui-layout-inline-margin, 0.5rem) + 1px +
+      var(--kui-layout-item-padding, 0.5rem)
+  );
+}
+
+.kui-list[data-text-insets*="b"] {
+  --_kui-list-inset-bottom: calc(
+    var(--kui-layout-inline-margin, 0.5rem) + 1px +
+      var(--kui-layout-item-padding, 0.5rem)
+  );
+}
+
+.kui-list[data-text-insets*="l"] {
+  --_kui-list-inset-left: calc(
+    var(--kui-layout-inline-margin, 0.5rem) + 1px +
+      var(--kui-layout-item-padding, 0.5rem)
+  );
+}
+
+.kui-list[data-h-align="left"] {
+  align-items: flex-start;
+  align-content: flex-start;
+}
+
+.kui-list[data-h-align="center"] {
+  align-items: center;
+  align-content: space-around;
+}
+
+.kui-list[data-h-align="right"] {
+  align-items: flex-end;
+  align-content: flex-end;
+}
+
+.kui-list[data-v-align="middle"] {
+  justify-content: space-around;
+}
+
+.kui-list[data-v-align="bottom"] {
+  justify-content: flex-end;
+}
+
+.kui-list[data-v-align="full"] {
+  justify-content: space-between;
+}
+
+.kui-list[data-scrollable="true"] {
+  overflow-y: auto;
+  overscroll-behavior-y: contain;
+}
+
+.kui-list:is([divider-sides*="t"], [data-scroll-divider*="t"]) {
+  --_kui-list-divider-top: var(--kui-list-divider-color);
+}
+
+.kui-list:is([divider-sides*="r"], [data-scroll-divider*="r"]) {
+  --_kui-list-divider-right: var(--kui-list-divider-color);
+}
+
+.kui-list:is([divider-sides*="b"], [data-scroll-divider*="b"]) {
+  --_kui-list-divider-bottom: var(--kui-list-divider-color);
+}
+
+.kui-list:is([divider-sides*="l"], [data-scroll-divider*="l"]) {
+  --_kui-list-divider-left: var(--kui-list-divider-color);
+}
+
+/* `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"] {
+  height: 100%;
+}

package/dist/styles/nav-stack.css

@@ -1,4 +1,5 @@
 .kui-nav-stack {
+  position: relative;
   display: flex;
   min-width: 0;
   min-height: 0;
@@ -6,82 +7,138 @@
   overflow: hidden;
   flex-direction: column;
   background: var(--kui-color-surface);
+  /* Safe areas: the stack's surfaces paint through unsafe areas; its chrome,
+     bottom toolbar, and each view compensate for the edges the stack still
+     touches (see pane.css for the `--kui-edge-inset-*` edge context). */
+  --_kui-nav-stack-safe-block-start: var(
+    --kui-edge-inset-block-start,
+    var(--kui-safe-area-block-start, env(safe-area-inset-top, 0px))
+  );
+  --_kui-nav-stack-safe-block-end: var(
+    --kui-edge-inset-block-end,
+    var(--kui-safe-area-block-end, env(safe-area-inset-bottom, 0px))
+  );
+  --_kui-nav-stack-safe-inline-start: var(
+    --kui-edge-inset-inline-start,
+    var(--kui-safe-area-inline-start, env(safe-area-inset-left, 0px))
+  );
+  --_kui-nav-stack-safe-inline-end: var(
+    --kui-edge-inset-inline-end,
+    var(--kui-safe-area-inline-end, env(safe-area-inset-right, 0px))
+  );
 }
 
-.kui-nav-stack__chrome {
-  display: flex;
-  min-width: 0;
-  min-height: calc(2px + 2.625rem);
-  padding-inline: var(--kui-space-xs);
-  border-block-end: 1px solid var(--kui-color-border);
-  align-items: center;
-  gap: var(--kui-space-xs);
-  background: var(--kui-color-surface);
-}
-
-.kui-nav-stack__lead {
-  display: flex;
-  flex: 1;
-  min-width: 0;
-  align-items: center;
-  gap: var(--kui-space-2xs);
-}
-
-.kui-nav-stack__back {
-  display: grid;
-  width: 2.5rem;
-  height: 2.5rem;
-  padding: 0;
-  border: 1px solid transparent;
-  border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
-  color: inherit;
-  background: transparent;
-  cursor: pointer;
-  place-items: center;
+.kui-nav-stack__chrome,
+.kui-nav-stack__bottom {
+  --kui-edge-inset-block-start: 0px;
+  --kui-edge-inset-block-end: 0px;
+  --kui-edge-inset-inline-start: 0px;
+  --kui-edge-inset-inline-end: 0px;
+  transition: opacity var(--kui-nav-stack-transition-duration, 200ms) ease;
 }
 
-.kui-nav-stack__back:hover {
-  border-color: var(--kui-color-border);
-  background: var(--kui-color-neutral-fill-normal);
+.kui-nav-stack__chrome--entering {
+  opacity: 0;
 }
 
-.kui-nav-stack__back:focus-visible {
-  outline: var(--kui-focus-ring);
-  outline-offset: 1px;
+.kui-nav-stack__chrome-copy {
+  position: absolute;
+  z-index: 2;
+  inset-block-start: 0;
+  inset-inline: 0;
+  pointer-events: none;
+  transition: opacity var(--kui-nav-stack-transition-duration, 200ms) ease;
 }
 
-.kui-nav-stack__back-icon {
-  display: block;
+.kui-nav-stack__chrome-copy--bottom {
+  inset-block: auto 0;
 }
 
-/* The title is ToolbarText (which owns its font, height, and ellipsis); it just
-   needs to flex to fill the lead zone beside the back control. */
-.kui-nav-stack__title {
-  flex: 1 1 auto;
-  min-width: 0;
+.kui-nav-stack__chrome-copy--exiting {
+  opacity: 0;
 }
 
-.kui-nav-stack__actions {
-  display: flex;
-  align-items: center;
-  gap: var(--kui-space-2xs);
+/* The chrome hosts the stack's real top Toolbar. It hands that toolbar the
+   edges the stack still touches through the edge context (never the bottom,
+   which the viewport owns); the toolbar pads for the sides it claims with
+   `safeAreaEdges` while its box paints through them. */
+.kui-nav-stack__chrome {
+  --kui-edge-inset-block-start: var(--_kui-nav-stack-safe-block-start);
+  --kui-edge-inset-inline-start: var(--_kui-nav-stack-safe-inline-start);
+  --kui-edge-inset-inline-end: var(--_kui-nav-stack-safe-inline-end);
+  background: var(--kui-color-surface);
 }
 
 .kui-nav-stack__viewport {
+  --kui-edge-inset-block-start: var(--_kui-nav-stack-safe-block-start);
+  --kui-edge-inset-block-end: var(--_kui-nav-stack-safe-block-end);
+  --kui-edge-inset-inline-start: var(--_kui-nav-stack-safe-inline-start);
+  --kui-edge-inset-inline-end: var(--_kui-nav-stack-safe-inline-end);
   position: relative;
   flex: 1;
   min-height: 0;
   overflow: hidden;
 }
 
+/* The top chrome and the bottom toolbar own their edges; transient chrome
+   copies from a transition do not. */
+.kui-nav-stack__chrome ~ .kui-nav-stack__viewport {
+  --kui-edge-inset-block-start: 0px;
+}
+
+.kui-nav-stack__viewport:has(
+  ~ .kui-nav-stack__bottom:not(.kui-nav-stack__chrome-copy)
+) {
+  --kui-edge-inset-block-end: 0px;
+}
+
 .kui-nav-stack__view {
   position: absolute;
   overflow: auto;
   background: var(--kui-color-surface);
-  transition: transform 200ms ease;
+  transition: transform var(--kui-nav-stack-transition-duration, 200ms) ease;
   inset: 0;
 }
 
+/* Each view is its region's scroll owner: block insets become padding inside
+   the scroller so content scrolls under an unsafe edge but can always be
+   scrolled clear. A view whose only child is a Pane or layout lets that child
+   own the insets instead. */
+.kui-nav-stack__view:not(
+  :has(
+    > :is(
+        [data-component="pane"],
+        [data-component="nav-stack"],
+        [data-component="split-view"],
+        [data-component="workbench"],
+        [data-component="tab-scaffold"]
+      ):only-child
+  )
+) {
+  padding-block: var(--kui-edge-inset-block-start)
+    var(--kui-edge-inset-block-end);
+  padding-inline: var(--kui-edge-inset-inline-start)
+    var(--kui-edge-inset-inline-end);
+  scroll-padding-block: var(--kui-edge-inset-block-start)
+    var(--kui-edge-inset-block-end);
+}
+
+.kui-nav-stack__view
+  > :not(
+    :is(
+      [data-component="pane"],
+      [data-component="nav-stack"],
+      [data-component="split-view"],
+      [data-component="workbench"],
+      [data-component="tab-scaffold"]
+    ):only-child
+  ) {
+  --kui-edge-inset-block-start: 0px;
+  --kui-edge-inset-block-end: 0px;
+  --kui-edge-inset-inline-start: 0px;
+  --kui-edge-inset-inline-end: 0px;
+}
+
 /* Only the active view (and any view mid-exit) is shown; lower entries stay
    mounted for state/focus but hidden behind it. */
 .kui-nav-stack__view[data-nav-active="false"] {
@@ -101,12 +158,63 @@
 }
 
 .kui-nav-stack__bottom {
-  border-block-start: 1px solid var(--kui-color-border);
+  padding-block-end: var(--_kui-nav-stack-safe-block-end);
+  padding-inline: var(--_kui-nav-stack-safe-inline-start)
+    var(--_kui-nav-stack-safe-inline-end);
+  border-block-start: 1px solid
+    var(--_kui-nav-stack-bottom-divider, transparent);
   background: var(--kui-color-surface);
 }
 
+/* The live chrome is the containing block of its scroll divider; a
+   cross-fading copy stays absolutely positioned. */
+.kui-nav-stack__chrome:not(.kui-nav-stack__chrome-copy) {
+  position: relative;
+}
+
+/* Chrome dividers: with `chromeDividers="scroll"` (the default, no
+   attribute) the top chrome draws a line along its bottom edge while the
+   active view's content is scrolled beneath it, and the bottom toolbar
+   colors its 1px top border while more content lies below it — never when
+   the content fits. `wireScrollDividers` reports that state through
+   `data-scroll-divider`; `always` draws both lines without it, and `none`
+   neither, whatever it reports. The chrome's line is an overlaid 1px pseudo-element
+   (whatever the chrome holds never covers it) and the bottom's border is
+   always there, so showing either never moves the chrome, the toolbar, or
+   the content. A cross-fading chrome copy keeps the line its snapshot had. */
+.kui-nav-stack:not([data-chrome-dividers])
+  > .kui-nav-stack__chrome[data-scroll-divider*="b"]::after,
+.kui-nav-stack[data-chrome-dividers="always"] > .kui-nav-stack__chrome::after {
+  position: absolute;
+  block-size: 1px;
+  background: var(--kui-color-neutral-border-normal);
+  content: "";
+  inset-block-end: 0;
+  inset-inline: 0;
+  pointer-events: none;
+}
+
+.kui-nav-stack:not([data-chrome-dividers])
+  > .kui-nav-stack__bottom[data-scroll-divider*="t"],
+.kui-nav-stack[data-chrome-dividers="always"] > .kui-nav-stack__bottom {
+  --_kui-nav-stack-bottom-divider: var(--kui-color-neutral-border-normal);
+}
+
 @media (prefers-reduced-motion: reduce) {
-  .kui-nav-stack__view {
+  .kui-nav-stack__view,
+  .kui-nav-stack__chrome,
+  .kui-nav-stack__bottom,
+  .kui-nav-stack__chrome-copy {
     transition: none;
   }
 }
+
+/* As the only child of a Workbench region (its main area or a panel's
+   content, which the Workbench marks with `data-workbench-main` /
+   `data-workbench-panel-content`), a NavStack fills the region, so a
+   composed toolbar's footer (or the app's own) sits at the region's bottom
+   edge rather than under short content. */
+:is([data-workbench-main], [data-workbench-panel-content])
+  > [data-component="nav-stack"]:only-child {
+  height: 100%;
+}