@kerfjs/ui 5.0.0-beta.104 → 5.0.0-beta.106

package/dist/styles/components/feedback/progress-bar/progress-bar.css

@@ -0,0 +1,168 @@
+/* A label row above a native <progress> track, on the shared block-content
+   inset and the full available width. The track resets the
+   platform's appearance in every engine and paints the fill in the tone; an
+   indeterminate bar (no value) sweeps a band across the track instead. */
+.kui-progress-bar {
+  --_kui-progress-bar-fill: var(--kui-color-brand-fill-loud);
+  --_kui-progress-bar-track: var(--kui-color-neutral-fill-normal);
+  --_kui-progress-bar-height: 0.375rem;
+
+  display: flex;
+  width: 100%;
+  min-width: 0;
+  box-sizing: border-box;
+  flex: 1 1 auto;
+  align-self: stretch;
+  flex-direction: column;
+  gap: var(--kui-space-2xs);
+  /* The shared block-content inset (a transparent 1px border and 8px
+     padding), so the label sits on the same text column as Text. */
+  padding: var(--kui-layout-item-padding, 0.5rem);
+  border: var(--kui-layout-item-border-width, 1px) solid transparent;
+}
+
+.kui-progress-bar[data-size="compact"] {
+  --_kui-progress-bar-height: 0.25rem;
+}
+
+.kui-progress-bar[data-tone="success"] {
+  --_kui-progress-bar-fill: var(--kui-color-success-fill-loud);
+}
+
+.kui-progress-bar[data-tone="warning"] {
+  --_kui-progress-bar-fill: var(--kui-color-warning-fill-loud);
+}
+
+.kui-progress-bar[data-tone="danger"] {
+  --_kui-progress-bar-fill: var(--kui-color-danger-fill-loud);
+}
+
+.kui-progress-bar__header {
+  display: flex;
+  min-width: 0;
+  align-items: baseline;
+  gap: var(--kui-space-xs);
+  font-size: var(--kui-font-s, 0.875rem);
+  line-height: 1.4;
+}
+
+.kui-progress-bar__label {
+  min-width: 0;
+  flex: 1;
+  overflow-wrap: anywhere;
+}
+
+.kui-progress-bar__value {
+  flex: none;
+  margin-inline-start: auto;
+  color: var(--kui-color-text-quiet);
+  font-variant-numeric: tabular-nums;
+}
+
+.kui-progress-bar__track {
+  display: block;
+  width: 100%;
+  height: var(--_kui-progress-bar-height);
+  margin: 0;
+  padding: 0;
+  overflow: hidden;
+  border: 0;
+  border-radius: var(--kui-radius-pill);
+  color: var(--_kui-progress-bar-fill);
+  background: var(--_kui-progress-bar-track);
+  appearance: none;
+}
+
+.kui-progress-bar__track::-webkit-progress-bar {
+  border-radius: inherit;
+  background: var(--_kui-progress-bar-track);
+}
+
+.kui-progress-bar__track::-webkit-progress-value {
+  border-radius: inherit;
+  background: var(--_kui-progress-bar-fill);
+  transition: inline-size 200ms ease;
+}
+
+.kui-progress-bar__track::-moz-progress-bar {
+  border-radius: inherit;
+  background: var(--_kui-progress-bar-fill);
+}
+
+/* Indeterminate: a band sweeps across the track. */
+.kui-progress-bar__track:indeterminate {
+  background:
+    linear-gradient(
+        90deg,
+        transparent 0%,
+        var(--_kui-progress-bar-fill) 35%,
+        var(--_kui-progress-bar-fill) 65%,
+        transparent 100%
+      )
+      no-repeat,
+    var(--_kui-progress-bar-track);
+  background-size:
+    40% 100%,
+    auto;
+  animation: kui-progress-bar-sweep 1.4s ease-in-out infinite;
+}
+
+.kui-progress-bar__track:indeterminate::-webkit-progress-bar {
+  background: transparent;
+}
+
+.kui-progress-bar__track:indeterminate::-moz-progress-bar {
+  background: transparent;
+}
+
+@keyframes kui-progress-bar-sweep {
+  from {
+    background-position:
+      -60% 0,
+      0 0;
+  }
+
+  to {
+    background-position:
+      160% 0,
+      0 0;
+  }
+}
+
+/* Without motion the indeterminate band holds still in the middle. */
+@media (prefers-reduced-motion: reduce) {
+  .kui-progress-bar__track:indeterminate {
+    background-position:
+      50% 0,
+      0 0;
+    animation: none;
+  }
+
+  .kui-progress-bar__track::-webkit-progress-value {
+    transition: none;
+  }
+}
+
+:root[data-kui-effects="static"] .kui-progress-bar__track:indeterminate {
+  background-position:
+    50% 0,
+    0 0;
+  animation: none;
+}
+
+@media (forced-colors: active) {
+  .kui-progress-bar__track {
+    border: 1px solid CanvasText;
+    background: Canvas;
+  }
+
+  .kui-progress-bar__track::-webkit-progress-value,
+  .kui-progress-bar__track::-moz-progress-bar {
+    background: Highlight;
+  }
+
+  .kui-progress-bar__track:indeterminate {
+    background: linear-gradient(90deg, Highlight, Highlight) no-repeat 50% 0 /
+      40% 100%;
+  }
+}

package/dist/styles/components/feedback/progress-ring/progress-ring.css

@@ -0,0 +1,91 @@
+/* An SVG track and arc. The arc starts at the top and fills clockwise; an
+   indeterminate ring spins a quarter arc. */
+.kui-progress-ring {
+  --_kui-progress-ring-fill: var(--kui-color-brand-fill-loud);
+
+  display: inline-flex;
+  width: var(--_kui-progress-ring-size, 1.5rem);
+  height: var(--_kui-progress-ring-size, 1.5rem);
+  flex: none;
+  vertical-align: middle;
+}
+
+.kui-progress-ring[data-tone="success"] {
+  --_kui-progress-ring-fill: var(--kui-color-success-fill-loud);
+}
+
+.kui-progress-ring[data-tone="warning"] {
+  --_kui-progress-ring-fill: var(--kui-color-warning-fill-loud);
+}
+
+.kui-progress-ring[data-tone="danger"] {
+  --_kui-progress-ring-fill: var(--kui-color-danger-fill-loud);
+}
+
+.kui-progress-ring svg {
+  display: block;
+  width: 100%;
+  height: 100%;
+  overflow: visible;
+  rotate: -90deg;
+}
+
+.kui-progress-ring__track,
+.kui-progress-ring__arc {
+  fill: none;
+  stroke-width: 3;
+}
+
+.kui-progress-ring__track {
+  stroke: var(--kui-color-neutral-fill-normal);
+}
+
+.kui-progress-ring__arc {
+  stroke: var(--_kui-progress-ring-fill);
+  stroke-linecap: round;
+  transition: stroke-dasharray 200ms ease;
+}
+
+/* A zero value draws no dot. */
+.kui-progress-ring[aria-valuenow="0"] .kui-progress-ring__arc {
+  stroke-linecap: butt;
+}
+
+.kui-progress-ring[data-indeterminate] svg {
+  animation: kui-progress-ring-spin 1s linear infinite;
+}
+
+@keyframes kui-progress-ring-spin {
+  from {
+    rotate: -90deg;
+  }
+
+  to {
+    rotate: 270deg;
+  }
+}
+
+/* Without motion an indeterminate ring holds a still quarter arc. */
+@media (prefers-reduced-motion: reduce) {
+  .kui-progress-ring[data-indeterminate] svg {
+    animation: none;
+  }
+
+  .kui-progress-ring__arc {
+    transition: none;
+  }
+}
+
+:root[data-kui-effects="static"] .kui-progress-ring[data-indeterminate] svg {
+  animation: none;
+}
+
+@media (forced-colors: active) {
+  .kui-progress-ring__track {
+    stroke: GrayText;
+  }
+
+  .kui-progress-ring__arc {
+    stroke: Highlight;
+  }
+}

package/dist/styles/components/feedback/state-banner/state-banner.css

@@ -181,6 +181,19 @@
     var(--kui-color-surface);
   box-shadow: var(--kui-shadow-l);
 }
+/* As the only content of a kerfjs/overlay toast (styled by
+   @kerfjs/ui/overlay-toast.css) the banner is the toast: no inline margin, and
+   its tone fill composites over the opaque surface; the toast keeps the
+   elevation. */
+.kerf-toast > .kui-state-banner:only-child {
+  margin-inline: 0;
+  background:
+    linear-gradient(
+      var(--_kui-state-banner-background),
+      var(--_kui-state-banner-background)
+    ),
+    var(--kui-color-surface-raised);
+}
 .kui-state-banner__icon {
   display: grid;
   flex: none;
@@ -268,7 +281,9 @@
   margin-inline-start: auto;
   flex: 0 1 auto;
 }
-.kui-state-banner__action button {
+/* A plain action button takes the banner's own pill; a Button keeps its own
+   look. */
+.kui-state-banner__action button:not(.kui-button) {
   min-height: 1.8rem;
   padding: 0 0.7rem;
   border: 1px solid currentColor;
@@ -280,10 +295,10 @@
   font-size: var(--kui-font-2xs);
   font-weight: 650;
 }
-.kui-state-banner__action button:hover {
+.kui-state-banner__action button:not(.kui-button):hover {
   background: var(--_kui-state-banner-action-hover-background);
 }
-.kui-state-banner__action button:focus-visible {
+.kui-state-banner__action button:not(.kui-button):focus-visible {
   outline: 2px solid var(--kui-color-text-link);
   outline-offset: 2px;
 }

package/dist/styles/components/forms/checkbox/checkbox.css

@@ -0,0 +1,121 @@
+/* Checkbox: a drawn box beside its label, with hint and error text on the
+   label's column. The native input sits invisibly over the box, so pointer,
+   keyboard, touch exploration, and forms all reach the real control. */
+.kui-checkbox {
+  --_kui-checkbox-box: 1.25rem;
+  --_kui-checkbox-gap: 0.5rem;
+  display: flex;
+  min-width: 0;
+  flex-direction: column;
+  font-size: var(--kui-font-m, 1rem);
+  font-weight: 400;
+  line-height: 1.2;
+}
+.kui-checkbox[data-size="compact"] {
+  --_kui-checkbox-box: 1.125rem;
+  --_kui-checkbox-gap: 0.4375rem;
+  font-size: var(--kui-font-s, 0.875rem);
+}
+.kui-checkbox__row {
+  display: inline-flex;
+  width: fit-content;
+  align-items: flex-start;
+  gap: var(--_kui-checkbox-gap);
+  color: var(--kui-color-text);
+  cursor: pointer;
+}
+.kui-checkbox__control {
+  position: relative;
+  display: inline-flex;
+  flex: none;
+}
+/* A real input with every native and global form-control style reset. */
+.kui-checkbox__input {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  margin: 0;
+  padding: 0;
+  border: none;
+  opacity: 0;
+  cursor: inherit;
+  appearance: none;
+}
+.kui-checkbox__box {
+  display: inline-flex;
+  box-sizing: border-box;
+  width: var(--_kui-checkbox-box);
+  height: var(--_kui-checkbox-box);
+  align-items: center;
+  justify-content: center;
+  color: var(--kui-color-brand-on-loud);
+  border: 1px solid var(--kui-color-neutral-border-normal);
+  border-radius: 0.1875rem;
+  background-color: var(--kui-color-surface);
+}
+.kui-checkbox__box > [data-lucide] {
+  display: none;
+  width: calc(var(--_kui-checkbox-box) - 0.375rem);
+  height: calc(var(--_kui-checkbox-box) - 0.375rem);
+  stroke-width: 3;
+}
+.kui-checkbox__input:is(:checked, :indeterminate) + .kui-checkbox__box {
+  border-color: var(--kui-color-brand-fill-loud);
+  background-color: var(--kui-color-brand-fill-loud);
+}
+.kui-checkbox__input:checked:not(:indeterminate)
+  + .kui-checkbox__box
+  > [data-lucide="check"],
+.kui-checkbox__input:indeterminate
+  + .kui-checkbox__box
+  > [data-lucide="minus"] {
+  display: block;
+}
+.kui-checkbox__input:focus-visible + .kui-checkbox__box {
+  outline: var(--kui-focus-ring);
+  outline-offset: 1px;
+}
+.kui-checkbox[data-invalid] .kui-checkbox__box {
+  border-color: var(--kui-color-danger-border-loud);
+}
+.kui-checkbox__label {
+  min-width: 0;
+  padding-block-start: calc((var(--_kui-checkbox-box) - 1lh) / 2);
+  overflow-wrap: anywhere;
+}
+.kui-checkbox:has(.kui-checkbox__input:disabled) .kui-checkbox__row {
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+.kui-checkbox__hint,
+.kui-checkbox__error {
+  display: block;
+  margin-block-start: 0.4375rem;
+  padding-inline-start: calc(
+    var(--_kui-checkbox-box) + var(--_kui-checkbox-gap)
+  );
+  color: var(--kui-color-text-quiet);
+  font-size: var(--kui-font-s, 0.875rem);
+  line-height: 1.6;
+}
+.kui-checkbox[data-size="compact"]
+  :is(.kui-checkbox__hint, .kui-checkbox__error) {
+  font-size: var(--kui-font-xs, 0.75rem);
+}
+.kui-checkbox__error {
+  color: var(--kui-color-danger-on-quiet);
+}
+.kui-checkbox__hint + .kui-checkbox__error {
+  margin-block-start: 0;
+}
+@media (forced-colors: active) {
+  .kui-checkbox__box {
+    border-color: CanvasText;
+  }
+  .kui-checkbox__input:is(:checked, :indeterminate) + .kui-checkbox__box {
+    color: HighlightText;
+    border-color: Highlight;
+    background-color: Highlight;
+  }
+}

package/dist/styles/components/forms/choice-chips/choice-chips.css

@@ -1,6 +1,8 @@
-/* ChoiceChips: separated pills that wrap with the control gap. Each pill is a
-   <label> around a native radio, so the radio owns focus, arrow keys, and the
-   form value; the pill paints the radio's state through :has(). */
+/* ChoiceChips: separated pills that wrap with the control gap. In the radio
+   and toggle modes each pill is a <label> around a native input, which owns
+   focus, keys, and the form value; the pill paints its state through :has().
+   In the multiple mode each pill is itself a listbox option (aria-selected),
+   and hidden inputs carry the form value. */
 .kui-choice-chips {
   display: flex;
   min-width: 0;
@@ -57,12 +59,16 @@
 }
 
 .kui-choice-chips__chip:hover:not([data-disabled]):not(
-    :has(> .kui-choice-chips__input:checked)
+    :has(> .kui-choice-chips__input:checked),
+    [aria-selected="true"]
   ) {
   background: var(--kui-color-neutral-fill-quiet);
 }
 
-.kui-choice-chips__chip:has(> .kui-choice-chips__input:checked) {
+.kui-choice-chips__chip:is(
+  :has(> .kui-choice-chips__input:checked),
+  [aria-selected="true"]
+) {
   --_kui-choice-chips-border: var(--kui-color-brand-border-loud);
 
   color: var(--kui-color-brand-on-fill);
@@ -71,11 +77,18 @@
   box-shadow: inset 0 0 0 1px var(--_kui-choice-chips-border);
 }
 
-.kui-choice-chips__chip:has(> .kui-choice-chips__input:focus-visible) {
+.kui-choice-chips__chip:is(
+  :has(> .kui-choice-chips__input:focus-visible),
+  [role="option"]:focus-visible
+) {
   outline: var(--kui-focus-ring);
   outline-offset: 2px;
 }
 
+.kui-choice-chips__chip[role="option"]:focus:not(:focus-visible) {
+  outline: none;
+}
+
 .kui-choice-chips__chip[data-disabled] {
   opacity: 0.45;
   cursor: not-allowed;
@@ -136,7 +149,10 @@
     border-color: ButtonBorder;
   }
 
-  .kui-choice-chips__chip:has(> .kui-choice-chips__input:checked) {
+  .kui-choice-chips__chip:is(
+    :has(> .kui-choice-chips__input:checked),
+    [aria-selected="true"]
+  ) {
     border-color: Highlight;
     color: HighlightText;
     background: Highlight;
@@ -152,3 +168,38 @@
     transition: none;
   }
 }
+
+/* `icons`: square icon-only choices (an icon picker). The label stays as the
+   accessible name, visually hidden; the chip's title shows it on hover. */
+.kui-choice-chips[data-presentation="icons"] .kui-choice-chips__chip {
+  width: 2.25rem;
+  height: 2.25rem;
+  min-height: 0;
+  padding: 0;
+  justify-content: center;
+  border-radius: var(--kui-radius-m);
+}
+
+/* An unsized LucideIcon fills 1em, so the slot's font size sets it. */
+.kui-choice-chips[data-presentation="icons"] .kui-choice-chips__icon {
+  font-size: 1.25rem;
+}
+
+.kui-choice-chips[data-presentation="icons"] .kui-choice-chips__label {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+}
+
+/* `maxHeight`: past it the group scrolls, with room for a chip's focus ring
+   (3px ring, 2px offset) inside the clip. */
+.kui-choice-chips[data-scrollable] {
+  max-height: var(--_kui-choice-chips-max-height);
+  padding: 0.3125rem;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  align-content: flex-start;
+}

package/dist/styles/components/forms/color-field/color-field.css

@@ -0,0 +1,125 @@
+/* ColorField: a label above a trigger box (a swatch, the hex value, and a
+   chevron) that matches TextField's box, then supporting or error text. */
+.kui-color-field {
+  --_kui-color-field-height: round(2.75em, 1px);
+
+  display: flex;
+  min-width: 0;
+  flex-direction: column;
+  font-size: var(--kui-font-m, 1rem);
+  font-weight: 400;
+}
+
+.kui-color-field[data-size="compact"] {
+  --_kui-color-field-height: round(calc(1rem + 1.2em), 1px);
+
+  font-size: var(--kui-font-s, 0.875rem);
+}
+
+/* The label matches every Kerf form control's label. */
+.kui-color-field__label {
+  display: block;
+  margin-block-end: 0.375rem;
+  padding-inline: calc(1px + var(--kui-layout-item-padding, 0.5rem));
+  color: var(--kui-color-neutral-on-quiet);
+  font-size: var(--kui-font-xs);
+  font-weight: 650;
+  letter-spacing: 0.04em;
+  line-height: 1.2;
+  text-transform: uppercase;
+}
+
+.kui-color-field__required {
+  margin-inline-start: 0.1em;
+}
+
+.kui-color-field__trigger {
+  display: flex;
+  min-height: var(--_kui-color-field-height);
+  box-sizing: border-box;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0 0.5rem;
+  border: 1px solid var(--kui-color-neutral-border-normal);
+  border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
+  color: var(--kui-color-text);
+  background-color: var(--kui-color-surface);
+  font: inherit;
+  text-align: start;
+  cursor: pointer;
+  appearance: none;
+}
+
+.kui-color-field__trigger:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: 1px;
+}
+
+.kui-color-field__trigger:disabled {
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+
+.kui-color-field[data-invalid] > .kui-color-field__trigger {
+  border-color: var(--kui-color-danger-border-loud);
+}
+
+/* The swatch shows the color over a checkerboard, so transparency reads. */
+.kui-color-field__swatch {
+  width: 1.25em;
+  height: 1.25em;
+  box-sizing: border-box;
+  flex: none;
+  border-radius: var(--kui-radius-m);
+  background:
+    linear-gradient(
+      var(--_kui-color-field-color),
+      var(--_kui-color-field-color)
+    ),
+    repeating-conic-gradient(
+        var(--kui-color-neutral-fill-normal) 0% 25%,
+        var(--kui-color-surface) 0% 50%
+      )
+      0 0 / 0.5em 0.5em;
+  box-shadow: inset 0 0 0 1px
+    color-mix(in srgb, var(--kui-color-text) 20%, transparent);
+}
+
+.kui-color-field__hex {
+  min-width: 0;
+  flex: 1;
+  font-family: var(--kui-font-mono, ui-monospace, monospace);
+  font-variant-numeric: tabular-nums;
+}
+
+.kui-color-field__chevron {
+  display: inline-flex;
+  flex: none;
+  color: var(--kui-color-neutral-on-quiet);
+}
+
+.kui-color-field__hint,
+.kui-color-field__error {
+  margin-block-start: 0.375rem;
+  padding-inline: calc(1px + var(--kui-layout-item-padding, 0.5rem));
+  font-size: var(--kui-font-s, 0.875rem);
+  line-height: 1.4;
+}
+
+.kui-color-field__hint {
+  color: var(--kui-color-text-quiet);
+}
+
+.kui-color-field__error {
+  color: var(--kui-color-danger-on-quiet);
+}
+
+@media (forced-colors: active) {
+  .kui-color-field__trigger {
+    border-color: CanvasText;
+  }
+
+  .kui-color-field__swatch {
+    forced-color-adjust: none;
+  }
+}