@kerfjs/ui 5.0.0-beta.10 → 5.0.0-beta.100

package/dist/styles/toolbar.css

@@ -1,27 +1,188 @@
 .kui-toolbar {
   display: grid;
   width: 100%;
-  min-height: calc(
-    var(--kui-toolbar-group-size, calc(2px + 2.625rem)) +
-      (2 * var(--kui-toolbar-gap, 0.5rem))
-  );
-  padding: var(--kui-toolbar-gap, 0.5rem);
+  /* min-height and padding: see the safe-area rules below. */
   box-sizing: border-box;
   color: var(--kui-color-text);
   background: transparent;
-  grid-template-columns: auto minmax(0, 1fr) auto;
-  align-items: center;
+  /* The center track's minimum is `auto`, not 0, so it resolves to the center
+     zone's own min-width (its content width, below): when the zones do not all
+     fit, the auto leading track is what shrinks and its title truncates, and
+     the center group never overflows its track onto the leading identity. */
+  grid-template-columns: auto 1fr auto;
+  align-items: start;
   gap: var(--kui-toolbar-gap, 0.5rem);
   container: kui-toolbar / inline-size;
   font-family: var(--kui-font-sans);
 }
 
+/* Safe areas: a toolbar compensates only for the inline edges its owner hands
+   it through `--kui-edge-inset-inline-*` (a Pane header or footer does), so its
+   box and dividers keep reaching the edge while its zones clear the unsafe
+   area. Unset means none: a toolbar embedded in content never pads for the
+   device. An app bar or bottom bar at a screen edge claims its sides with
+   `safeAreaEdges`; each claimed side pads by the routed edge context, or the
+   full device inset when nothing routes it (the Pane rule), so the top bar of
+   a shell clears the status area. A Pane header or footer clears the context
+   for its children, so a claimed side there never double-insets. Its zones
+   then see a cleared context. */
+.kui-toolbar {
+  --_kui-toolbar-safe-block-start: 0px;
+  --_kui-toolbar-safe-block-end: 0px;
+  --_kui-toolbar-safe-inline-start: var(--kui-edge-inset-inline-start, 0px);
+  --_kui-toolbar-safe-inline-end: var(--kui-edge-inset-inline-end, 0px);
+  /* The minimum height grows by any claimed block inset, so a toolbar a flex
+     column shrinks still keeps a whole control row clear of the unsafe area. */
+  min-height: calc(
+    var(--_kui-toolbar-band) + (2 * var(--_kui-toolbar-block-inset)) +
+      var(--_kui-toolbar-safe-block-start) + var(--_kui-toolbar-safe-block-end)
+  );
+  padding-block: calc(
+      var(--_kui-toolbar-block-inset) + var(--_kui-toolbar-safe-block-start)
+    )
+    calc(var(--_kui-toolbar-block-inset) + var(--_kui-toolbar-safe-block-end));
+  padding-inline: calc(
+      var(--kui-toolbar-inset, var(--kui-toolbar-gap, 0.5rem)) +
+        var(--_kui-toolbar-safe-inline-start)
+    )
+    calc(
+      var(--kui-toolbar-inset, var(--kui-toolbar-gap, 0.5rem)) +
+        var(--_kui-toolbar-safe-inline-end)
+    );
+}
+
+.kui-toolbar[data-safe-area-block-start="true"] {
+  --_kui-toolbar-safe-block-start: var(
+    --kui-edge-inset-block-start,
+    var(--kui-safe-area-block-start, env(safe-area-inset-top, 0px))
+  );
+}
+
+.kui-toolbar[data-safe-area-block-end="true"] {
+  --_kui-toolbar-safe-block-end: var(
+    --kui-edge-inset-block-end,
+    var(--kui-safe-area-block-end, env(safe-area-inset-bottom, 0px))
+  );
+}
+
+.kui-toolbar[data-safe-area-inline-start="true"] {
+  --_kui-toolbar-safe-inline-start: var(
+    --kui-edge-inset-inline-start,
+    var(--kui-safe-area-inline-start, env(safe-area-inset-left, 0px))
+  );
+}
+
+.kui-toolbar[data-safe-area-inline-end="true"] {
+  --_kui-toolbar-safe-inline-end: var(
+    --kui-edge-inset-inline-end,
+    var(--kui-safe-area-inline-end, env(safe-area-inset-right, 0px))
+  );
+}
+
+.kui-toolbar > * {
+  --kui-edge-inset-block-start: 0px;
+  --kui-edge-inset-block-end: 0px;
+  --kui-edge-inset-inline-start: 0px;
+  --kui-edge-inset-inline-end: 0px;
+}
+
 .kui-toolbar[data-has-center="false"] {
   grid-template-columns: minmax(0, 1fr) auto;
 }
 
-.kui-toolbar[data-divider="true"] {
-  box-shadow: inset 0 -1px var(--kui-color-border);
+/* Equal side tracks center the middle zone on the toolbar's content box even
+   when one side has no controls. Side content still shrinks or wraps within
+   its own track, and responsive policies below may move a zone to a new row. */
+.kui-toolbar[data-center-align="balanced"][data-has-center="true"] {
+  grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
+}
+
+/* A lone title in a balanced center (a navigation bar's title beside a back
+   control) centers on the toolbar while the side zones leave room, moves away
+   from a wider side when they do not, and truncates before it reaches a side
+   control: the side tracks keep their content width and the title's track
+   may shrink to nothing, so the title, unlike center controls, gives way
+   first. */
+.kui-toolbar[data-center-align="balanced"][data-has-center="true"]:has(
+    > .kui-toolbar__center > .kui-toolbar-text:only-child
+  ) {
+  grid-template-columns:
+    minmax(max-content, 1fr) minmax(0, max-content)
+    minmax(max-content, 1fr);
+}
+
+.kui-toolbar[data-center-align="balanced"]
+  > .kui-toolbar__center:has(> .kui-toolbar-text:only-child) {
+  min-width: 0;
+}
+
+.kui-toolbar[data-responsive="trailing-priority"][data-has-center="false"]:has(
+    > .kui-toolbar__trailing [data-expanded="true"]
+  ) {
+  grid-template-columns:
+    minmax(0, 1fr)
+    minmax(0, var(--kui-token-search-expanded-width, 30rem));
+}
+
+.kui-toolbar {
+  --_kui-toolbar-divider-top: transparent;
+  --_kui-toolbar-divider-right: transparent;
+  --_kui-toolbar-divider-bottom: transparent;
+  --_kui-toolbar-divider-left: transparent;
+  box-shadow:
+    inset 0 1px var(--_kui-toolbar-divider-top),
+    inset -1px 0 var(--_kui-toolbar-divider-right),
+    inset 0 -1px var(--_kui-toolbar-divider-bottom),
+    inset 1px 0 var(--_kui-toolbar-divider-left);
+}
+
+.kui-toolbar:is([divider-sides*="t"], [data-scroll-divider*="t"]) {
+  --_kui-toolbar-divider-top: var(
+    --kui-toolbar-divider-color,
+    var(--kui-color-neutral-border-normal)
+  );
+}
+
+.kui-toolbar:is([divider-sides*="r"], [data-scroll-divider*="r"]) {
+  --_kui-toolbar-divider-right: var(
+    --kui-toolbar-divider-color,
+    var(--kui-color-neutral-border-normal)
+  );
+}
+
+.kui-toolbar:is([divider-sides*="b"], [data-scroll-divider*="b"]) {
+  --_kui-toolbar-divider-bottom: var(
+    --kui-toolbar-divider-color,
+    var(--kui-color-neutral-border-normal)
+  );
+}
+
+.kui-toolbar:is([divider-sides*="l"], [data-scroll-divider*="l"]) {
+  --_kui-toolbar-divider-left: var(
+    --kui-toolbar-divider-color,
+    var(--kui-color-neutral-border-normal)
+  );
+}
+
+/* Every zone reserves a group-height control band. Direct custom content
+   centers against its zone's height by default. ToolbarText,
+   ToolbarControlGroup, and standalone wa-button keep their own first-band
+   placement, so taller siblings do not move their controls off that axis.
+   `--_kui-toolbar-band` is context those components use for that placement. */
+.kui-toolbar {
+  --_kui-toolbar-band: var(--kui-toolbar-group-size, calc(2px + 2.625rem));
+  --_kui-toolbar-block-inset: var(
+    --kui-toolbar-inset,
+    var(--kui-toolbar-gap, 0.5rem)
+  );
+}
+
+/* Compact density: a 34px band (the compact ToolbarControlGroup's size) with
+   3px block insets makes a 40px header for an embedded panel or card. The
+   inline insets and zone gap keep the standard 8px. */
+.kui-toolbar[data-density="compact"] {
+  --_kui-toolbar-band: 2.125rem;
+  --_kui-toolbar-block-inset: var(--kui-toolbar-inset, 0.1875rem);
 }
 
 .kui-toolbar__leading,
@@ -29,6 +190,9 @@
 .kui-toolbar__trailing {
   display: flex;
   min-width: 0;
+  min-height: var(--_kui-toolbar-band);
+  padding-inline: var(--kui-toolbar-zone-padding-inline, 0px);
+  box-sizing: border-box;
   align-items: center;
   gap: var(--kui-toolbar-gap, 0.5rem);
 }
@@ -40,18 +204,146 @@
    the 3- and 2-column layouts, and still stacks under the leading zone when a
    consumer collapses the toolbar to a single column. */
 .kui-toolbar__leading {
+  min-width: var(--kui-toolbar-leading-min-width, 0px);
+  padding-inline: var(
+    --kui-toolbar-leading-padding-inline,
+    var(--kui-toolbar-zone-padding-inline, 0px)
+  );
   grid-column: 1;
-  overflow: hidden;
+  /* Keep a shrinking title clipped while letting the 3px focus outline plus
+     its 1px offset paint past the zone edge. `hidden` cropped the ring of the
+     first control in this zone. */
+  overflow: clip;
+  overflow-clip-margin: 4px;
 }
 
 .kui-toolbar__center {
+  /* The center content never compresses below its own width (a group cannot
+     shrink or clip its controls). The track above takes this as its minimum, so
+     the leading identity gives way first, the way a platform toolbar truncates
+     its title before it overlaps the centered controls. */
+  min-width: min-content;
+  padding-inline: var(
+    --kui-toolbar-center-padding-inline,
+    var(--kui-toolbar-zone-padding-inline, 0px)
+  );
   justify-content: center;
   grid-column: 2;
 }
 
+.kui-toolbar[data-center-align="stretch"] > .kui-toolbar__center {
+  justify-content: flex-start;
+}
+
+.kui-toolbar[data-center-align="stretch"] > .kui-toolbar__center > * {
+  width: 100%;
+  flex-basis: 100%;
+}
+
 .kui-toolbar__trailing {
-  justify-content: flex-end;
+  padding-inline: var(
+    --kui-toolbar-trailing-padding-inline,
+    var(--kui-toolbar-zone-padding-inline, 0px)
+  );
+  justify-content: var(--kui-toolbar-trailing-justify, flex-end);
+  justify-self: var(--kui-toolbar-trailing-justify-self, stretch);
   grid-column: -2 / -1;
+  gap: var(--kui-toolbar-trailing-gap, var(--kui-toolbar-gap, 0.5rem));
+  /* Trailing actions never clip (KF-4EYES0): the zone wraps its groups, so its
+     track can shrink only to the widest single group. When one row cannot hold
+     every group, the next group moves to a new trailing-aligned row instead of
+     overflowing the toolbar. */
+  flex-wrap: wrap;
+}
+
+.kui-toolbar__trailing > wa-button:not(:where(.kui-icon-button)) {
+  margin-block-start: max(
+    0px,
+    calc((var(--_kui-toolbar-band) - var(--wa-form-control-height)) / 2)
+  );
+  align-self: flex-start;
+  flex: 0 0 auto;
+}
+
+/* An expanded trailing search gets a complete second row while the leading
+   identity and optional center controls remain in the first. The query styles
+   descendants because a toolbar cannot query its own container width. */
+@container kui-toolbar (max-width: 52rem) {
+  .kui-toolbar[data-responsive="trailing-priority"][data-responsive-at="narrow"][data-has-center="false"]:has(
+      > .kui-toolbar__trailing [data-expanded="true"]
+    )
+    > .kui-toolbar__leading {
+    grid-column: 1 / -1;
+    grid-row: 1;
+  }
+
+  .kui-toolbar[data-responsive="trailing-priority"][data-responsive-at="narrow"]:has(
+      > .kui-toolbar__trailing [data-expanded="true"]
+    )
+    > .kui-toolbar__trailing {
+    width: 100%;
+    grid-column: 1 / -1;
+    grid-row: 2;
+    justify-self: stretch;
+  }
+
+  .kui-toolbar[data-responsive="trailing-priority"][data-responsive-at="narrow"]
+    > .kui-toolbar__trailing
+    > [data-expanded="true"] {
+    width: 100%;
+    flex: 1 1 100%;
+  }
+}
+
+@container kui-toolbar (max-width: 44rem) {
+  .kui-toolbar[data-responsive="trailing-priority"][data-responsive-at="compact"][data-has-center="false"]:has(
+      > .kui-toolbar__trailing [data-expanded="true"]
+    )
+    > .kui-toolbar__leading {
+    grid-column: 1 / -1;
+    grid-row: 1;
+  }
+
+  .kui-toolbar[data-responsive="trailing-priority"][data-responsive-at="compact"]:has(
+      > .kui-toolbar__trailing [data-expanded="true"]
+    )
+    > .kui-toolbar__trailing {
+    width: 100%;
+    grid-column: 1 / -1;
+    grid-row: 2;
+    justify-self: stretch;
+  }
+
+  .kui-toolbar[data-responsive="trailing-priority"][data-responsive-at="compact"]
+    > .kui-toolbar__trailing
+    > [data-expanded="true"] {
+    width: 100%;
+    flex: 1 1 100%;
+  }
+}
+
+/* Content-driven wrap: one row while every zone fits at its natural width;
+   otherwise the trailing zone moves below the identity, still trailing-aligned,
+   instead of truncating the leading title or clipping an action. For panel,
+   inspector, and dialog headings whose identity must stay whole. */
+.kui-toolbar[data-responsive="wrap"] {
+  display: flex;
+  flex-wrap: wrap;
+}
+
+.kui-toolbar[data-responsive="wrap"] > .kui-toolbar__leading {
+  max-width: 100%;
+  flex: 1 1 auto;
+}
+
+.kui-toolbar[data-responsive="wrap"] > .kui-toolbar__center {
+  flex: 1 1 auto;
+}
+
+.kui-toolbar[data-responsive="wrap"] > .kui-toolbar__trailing {
+  max-width: 100%;
+  flex: 0 1 auto;
+  margin-inline-start: auto;
 }
 
 .kui-toolbar[data-has-center="false"] .kui-toolbar__center,
@@ -59,3 +351,93 @@
 .kui-toolbar__trailing:empty {
   display: none;
 }
+
+/* Stacked topology. A container query only matches an ancestor container, so
+   these rules style the zones (whose query container is this toolbar) rather
+   than the toolbar's own grid template, which a self query can never reach.
+   Each zone spans every column track, one zone per row, so no empty track or
+   column gap narrows a stacked zone. Stacked control zones wrap at group
+   granularity (KF-4EYES0: a stacked trailing zone clipped its last action at
+   phone widths), so every group stays whole, reachable, and full size; the
+   leading identity keeps its single-line truncation. */
+@container kui-toolbar (max-width: 52rem) {
+  .kui-toolbar[data-responsive="stack"][data-responsive-at="narrow"]
+    > :is(.kui-toolbar__leading, .kui-toolbar__center, .kui-toolbar__trailing) {
+    width: 100%;
+    grid-column: 1 / -1;
+    justify-content: flex-start;
+  }
+
+  .kui-toolbar[data-responsive="stack"][data-responsive-at="narrow"]
+    > :is(.kui-toolbar__center, .kui-toolbar__trailing) {
+    flex-wrap: wrap;
+  }
+}
+
+@container kui-toolbar (max-width: 44rem) {
+  .kui-toolbar[data-responsive="stack"][data-responsive-at="compact"]
+    > :is(.kui-toolbar__leading, .kui-toolbar__center, .kui-toolbar__trailing) {
+    width: 100%;
+    grid-column: 1 / -1;
+    justify-content: flex-start;
+  }
+
+  .kui-toolbar[data-responsive="stack"][data-responsive-at="compact"]
+    > :is(.kui-toolbar__center, .kui-toolbar__trailing) {
+    flex-wrap: wrap;
+  }
+}
+
+/* Center priority. As with the stacked topology, the toolbar cannot query its
+   own width, so these rules style the zones: while the center holds an expanded
+   control, the leading and trailing zones leave and the center spans every
+   column track (including the gaps the vacated tracks still own), taking the
+   whole row. */
+@container kui-toolbar (max-width: 42rem) {
+  .kui-toolbar[data-responsive="center-priority"]:has(
+      > .kui-toolbar__center [data-expanded="true"]
+    )
+    > .kui-toolbar__center {
+    width: 100%;
+    grid-column: 1 / -1;
+  }
+
+  .kui-toolbar[data-responsive="center-priority"]:has(
+      > .kui-toolbar__center [data-expanded="true"]
+    )
+    > :is(.kui-toolbar__leading, .kui-toolbar__trailing) {
+    display: none;
+  }
+}
+.kui-toolbar > [data-toolbar-visibility-probe] {
+  position: fixed;
+  left: 0;
+  top: 0;
+  height: 0;
+  overflow: hidden;
+  visibility: hidden;
+  pointer-events: none;
+  contain: layout paint;
+}
+
+.kui-toolbar > [data-toolbar-visibility-probe] > div {
+  position: absolute;
+  top: 0;
+  height: 0;
+  min-width: 0;
+  max-width: none;
+  padding: 0;
+  border: 0;
+  margin: 0;
+}
+
+/* A typed sentinel distinguishes invalid/unresolved input from a valid zero. */
+@property --kui-toolbar-visibility-length {
+  syntax: "<length-percentage>";
+  inherits: false;
+  initial-value: -1px;
+}
+.kui-toolbar > [data-toolbar-visibility-probe] > div {
+  left: var(--kui-toolbar-visibility-length);
+  width: var(--kui-toolbar-visibility-length);
+}

package/dist/styles/value-table.css

@@ -1,6 +1,5 @@
 .kui-value-table {
-  --kui-value-table-background: var(--kui-color-surface-lowered);
-  --kui-value-table-border: var(--kui-color-border);
+  --kui-value-table-border: var(--kui-color-neutral-border-normal);
   --_kui-value-table-icon-size: var(--kui-value-table-icon-size, 1.5rem);
   display: grid;
   margin-block: 0;
@@ -8,7 +7,10 @@
   overflow: hidden;
   border: 1px solid var(--kui-value-table-border);
   border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
-  background: var(--kui-value-table-background);
+  background: var(
+    --kui-value-table-background,
+    var(--kui-color-surface-lowered)
+  );
 }
 .kui-value-table__row {
   --_kui-value-table-inline-padding: var(
@@ -19,12 +21,32 @@
   position: relative;
   display: grid;
   min-height: 2.55rem;
-  padding-block: 0.5rem;
+  padding-block: var(
+    --kui-value-table-row-padding-block,
+    var(--_kui-value-table-density-padding-block, 0.5rem)
+  );
   padding-inline: var(--_kui-value-table-inline-padding);
   box-sizing: border-box;
-  grid-template-columns: minmax(6rem, auto) minmax(0, 1fr);
+  /* Two content-sized tracks share the free space equally, and each stops
+     growing once its content fits. A short value keeps its whole width and a
+     long label takes the rest (ending a word that still does not fit in an
+     ellipsis); a short label keeps its width beside a long, wrapping value;
+     when both are long they split the row. A `1fr` value track would get
+     nothing until the label reached its full width, starving the value to 0px
+     beside a long single-word label. */
+  grid-template-columns: var(
+    --kui-value-table-row-columns,
+    minmax(0, auto) minmax(0, auto)
+  );
   align-items: center;
-  gap: var(--kui-layout-item-gap, 0.5rem);
+  gap: var(
+    --kui-value-table-row-gap,
+    var(--_kui-value-table-density-gap, var(--kui-layout-item-gap, 0.5rem))
+  );
+}
+.kui-value-table[data-density="compact"] .kui-value-table__row {
+  --_kui-value-table-density-padding-block: 0.25rem;
+  --_kui-value-table-density-gap: 0.25rem;
 }
 .kui-value-table__row[data-has-icon="true"] {
   --_kui-value-table-separator-start: calc(
@@ -42,8 +64,13 @@
 }
 .kui-value-table__row dt {
   display: flex;
+  /* The label hugs its content (up to its column) rather than stretching, so
+     its box does not change with the value's width — a placeholder row keeps
+     the live row's label geometry beside its skeleton value. */
+  max-width: 100%;
   min-width: 0;
-  color: var(--kui-color-text-quiet);
+  justify-self: start;
+  color: var(--kui-color-text);
   align-items: center;
   gap: var(--kui-layout-item-gap, 0.5rem);
 }
@@ -60,6 +87,11 @@
 }
 .kui-value-table__label {
   min-width: 0;
+  overflow: hidden;
+  /* A multi-word label wraps at spaces; a single word wider than the label
+     column (a long component or file name) ends in an ellipsis instead of
+     running under the value. */
+  text-overflow: ellipsis;
 }
 .kui-value-table__row dd {
   display: flex;
@@ -73,3 +105,79 @@
   font-weight: var(--kui-font-weight-semibold);
   text-align: end;
 }
+
+/* `labelWidth`: a minimum label column; the value takes the rest of the row
+   (never wider than the row, so a narrow table still fits). */
+.kui-value-table[data-label-width] .kui-value-table__row {
+  grid-template-columns: var(
+    --kui-value-table-row-columns,
+    minmax(min(var(--_kui-value-table-label-min), 100%), auto) minmax(0, 1fr)
+  );
+}
+
+/* Only a table that stacks below a width becomes a size container. Size
+   containment drops its content-based width, so it fills its container's
+   width (inside its own inline margins) instead; a table without
+   `stackBelow` keeps sizing to content in shrink-to-fit contexts. */
+.kui-value-table[data-stack-below] {
+  box-sizing: border-box;
+  width: calc(100% - 2 * var(--kui-layout-inline-margin, 0.5rem));
+  container: kui-value-table / inline-size;
+}
+
+/* Stacked rows: each value sits under its label and starts at the label's
+   text edge (after a leading icon). */
+.kui-value-table[data-presentation="stacked"] .kui-value-table__row {
+  grid-template-columns: minmax(0, 1fr);
+  row-gap: var(--kui-space-2xs);
+}
+.kui-value-table[data-presentation="stacked"] .kui-value-table__row dd {
+  justify-content: flex-start;
+  text-align: start;
+}
+.kui-value-table[data-presentation="stacked"]
+  .kui-value-table__row[data-has-icon="true"]
+  dd {
+  padding-inline-start: calc(
+    var(--_kui-value-table-separator-start) -
+      var(--_kui-value-table-inline-padding)
+  );
+}
+
+@container kui-value-table (max-width: 36rem) {
+  .kui-value-table[data-stack-below="narrow"] .kui-value-table__row {
+    grid-template-columns: minmax(0, 1fr);
+    row-gap: var(--kui-space-2xs);
+  }
+  .kui-value-table[data-stack-below="narrow"] .kui-value-table__row dd {
+    justify-content: flex-start;
+    text-align: start;
+  }
+  .kui-value-table[data-stack-below="narrow"]
+    .kui-value-table__row[data-has-icon="true"]
+    dd {
+    padding-inline-start: calc(
+      var(--_kui-value-table-separator-start) -
+        var(--_kui-value-table-inline-padding)
+    );
+  }
+}
+
+@container kui-value-table (max-width: 32rem) {
+  .kui-value-table[data-stack-below="compact"] .kui-value-table__row {
+    grid-template-columns: minmax(0, 1fr);
+    row-gap: var(--kui-space-2xs);
+  }
+  .kui-value-table[data-stack-below="compact"] .kui-value-table__row dd {
+    justify-content: flex-start;
+    text-align: start;
+  }
+  .kui-value-table[data-stack-below="compact"]
+    .kui-value-table__row[data-has-icon="true"]
+    dd {
+    padding-inline-start: calc(
+      var(--_kui-value-table-separator-start) -
+        var(--_kui-value-table-inline-padding)
+    );
+  }
+}