@kerfjs/ui 5.0.0-beta.103 → 5.0.0-beta.105

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

package/dist/styles/color-picker.css

@@ -0,0 +1,331 @@
+/* ColorPicker: a saturation and brightness area, hue and opacity sliders, a
+   color-model menu with its tools, channel fields, a hex and opacity row,
+   then preset and sample swatches. The surface's custom properties
+   (--_kui-color-picker-h/s/v/a and the opaque color) place the thumbs and
+   paint the tracks; the wiring updates them while a person drags. */
+.kui-color-picker {
+  display: grid;
+  width: 100%;
+  min-width: 0;
+  max-width: 20rem;
+  box-sizing: border-box;
+  gap: var(--kui-space-s, 0.75rem);
+  /* The shared block-content inset, so the panel's edges line up with the
+     text column beside it. */
+  padding: var(--kui-layout-item-padding, 0.5rem);
+  border: var(--kui-layout-item-border-width, 1px) solid transparent;
+  color: var(--kui-color-text);
+  font-size: var(--kui-font-m, 1rem);
+}
+
+.kui-color-picker__surface {
+  --_kui-color-picker-checker: repeating-conic-gradient(
+      var(--kui-color-neutral-fill-normal) 0% 25%,
+      var(--kui-color-surface) 0% 50%
+    )
+    0 0 / 0.75rem 0.75rem;
+
+  display: grid;
+  min-width: 0;
+  gap: var(--kui-space-s, 0.75rem);
+}
+
+/* The area: white to the hue left to right, darkening to black downward. */
+.kui-color-picker__area {
+  position: relative;
+  aspect-ratio: 4 / 3;
+  border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
+  background:
+    linear-gradient(to top, #000, transparent),
+    linear-gradient(to right, #fff, hsl(var(--_kui-color-picker-h) 100% 50%));
+  cursor: crosshair;
+  touch-action: none;
+}
+
+.kui-color-picker__area:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: 2px;
+}
+
+.kui-color-picker__area-thumb {
+  position: absolute;
+  top: calc(100% - var(--_kui-color-picker-v));
+  left: var(--_kui-color-picker-s);
+  width: 1rem;
+  height: 1rem;
+  box-sizing: border-box;
+  border: 2px solid #fff;
+  border-radius: 50%;
+  background: var(--_kui-color-picker-color);
+  box-shadow:
+    0 0 0 1px rgb(0 0 0 / 0.3),
+    var(--kui-shadow-s);
+  pointer-events: none;
+  translate: -50% -50%;
+}
+
+/* The hue and opacity sliders: native ranges drawn as 12px tracks with a
+   round thumb that shows the color at that point. */
+.kui-color-picker__hue,
+.kui-color-picker__opacity {
+  --_kui-color-picker-thumb: 1.25rem;
+
+  display: block;
+  width: 100%;
+  height: var(--_kui-color-picker-thumb);
+  margin: 0;
+  padding: 0;
+  border: 0;
+  background: transparent;
+  cursor: pointer;
+  appearance: none;
+}
+
+.kui-color-picker__hue {
+  --_kui-color-picker-track: linear-gradient(
+    to right,
+    #f00,
+    #ff0,
+    #0f0,
+    #0ff,
+    #00f,
+    #f0f,
+    #f00
+  );
+  --_kui-color-picker-thumb-color: hsl(var(--_kui-color-picker-h) 100% 50%);
+}
+
+.kui-color-picker__opacity {
+  --_kui-color-picker-track:
+    linear-gradient(to right, transparent, var(--_kui-color-picker-color)),
+    var(--_kui-color-picker-checker);
+  --_kui-color-picker-thumb-color: color-mix(
+    in srgb,
+    var(--_kui-color-picker-color) var(--_kui-color-picker-a),
+    #fff
+  );
+}
+
+.kui-color-picker__hue::-webkit-slider-runnable-track,
+.kui-color-picker__opacity::-webkit-slider-runnable-track {
+  height: 0.75rem;
+  border-radius: var(--kui-radius-pill);
+  background: var(--_kui-color-picker-track);
+  box-shadow: inset 0 0 0 1px rgb(0 0 0 / 0.1);
+}
+
+.kui-color-picker__hue::-moz-range-track,
+.kui-color-picker__opacity::-moz-range-track {
+  height: 0.75rem;
+  border-radius: var(--kui-radius-pill);
+  background: var(--_kui-color-picker-track);
+  box-shadow: inset 0 0 0 1px rgb(0 0 0 / 0.1);
+}
+
+.kui-color-picker__hue::-webkit-slider-thumb,
+.kui-color-picker__opacity::-webkit-slider-thumb {
+  width: var(--_kui-color-picker-thumb);
+  height: var(--_kui-color-picker-thumb);
+  box-sizing: border-box;
+  margin-block-start: calc((0.75rem - var(--_kui-color-picker-thumb)) / 2);
+  border: 3px solid #fff;
+  border-radius: 50%;
+  background: var(--_kui-color-picker-thumb-color);
+  box-shadow:
+    0 0 0 1px rgb(0 0 0 / 0.2),
+    var(--kui-shadow-s);
+  appearance: none;
+}
+
+.kui-color-picker__hue::-moz-range-thumb,
+.kui-color-picker__opacity::-moz-range-thumb {
+  width: var(--_kui-color-picker-thumb);
+  height: var(--_kui-color-picker-thumb);
+  box-sizing: border-box;
+  border: 3px solid #fff;
+  border-radius: 50%;
+  background: var(--_kui-color-picker-thumb-color);
+  box-shadow:
+    0 0 0 1px rgb(0 0 0 / 0.2),
+    var(--kui-shadow-s);
+}
+
+.kui-color-picker__hue:focus-visible,
+.kui-color-picker__opacity:focus-visible {
+  outline: none;
+}
+
+.kui-color-picker__hue:focus-visible::-webkit-slider-thumb,
+.kui-color-picker__opacity:focus-visible::-webkit-slider-thumb {
+  outline: var(--kui-focus-ring);
+  outline-offset: 1px;
+}
+
+.kui-color-picker__hue:focus-visible::-moz-range-thumb,
+.kui-color-picker__opacity:focus-visible::-moz-range-thumb {
+  outline: var(--kui-focus-ring);
+  outline-offset: 1px;
+}
+
+/* The model menu leads; the tools trail. */
+.kui-color-picker__controls {
+  display: flex;
+  min-height: 2rem;
+  align-items: center;
+  gap: var(--kui-space-2xs, 0.25rem);
+}
+
+.kui-color-picker__mode-wrap {
+  position: relative;
+  display: inline-flex;
+  min-width: 0;
+  margin-inline-end: auto;
+  align-items: center;
+}
+
+/* The menu's chevrons sit over the select's end; presses pass through. */
+.kui-color-picker__mode-icon {
+  display: inline-flex;
+  position: absolute;
+  inset-inline-end: 0.25rem;
+  pointer-events: none;
+}
+
+.kui-color-picker__mode {
+  min-width: 0;
+  margin: 0;
+  padding-block: 0.25rem;
+  padding-inline: 0.25rem 1.5rem;
+  appearance: none;
+  border: 0;
+  border-radius: var(--kui-radius-m);
+  color: inherit;
+  background: transparent;
+  font: inherit;
+  font-weight: var(--kui-font-weight-semibold, 500);
+  cursor: pointer;
+}
+
+.kui-color-picker__mode:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: 0;
+}
+
+.kui-color-picker__tool {
+  display: inline-grid;
+  width: 2rem;
+  height: 2rem;
+  place-items: center;
+  padding: 0;
+  border: 0;
+  border-radius: var(--kui-radius-m);
+  color: var(--kui-color-text-quiet);
+  background: transparent;
+  cursor: pointer;
+}
+
+.kui-color-picker__tool[hidden] {
+  display: none;
+}
+
+.kui-color-picker__tool:hover:not(:disabled) {
+  color: var(--kui-color-text);
+  background: var(--kui-color-neutral-fill-quiet);
+}
+
+.kui-color-picker__tool:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: 0;
+}
+
+/* Channel fields: a quiet letter and a right-aligned number in a filled
+   box; one column for grayscale. */
+.kui-color-picker__channels {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: var(--kui-space-xs, 0.5rem);
+}
+
+.kui-color-picker__channels[data-count="1"] {
+  grid-template-columns: minmax(0, 1fr);
+}
+
+.kui-color-picker__hex-row {
+  display: grid;
+  grid-template-columns: minmax(0, 2fr) minmax(0, 1fr);
+  gap: var(--kui-space-xs, 0.5rem);
+}
+
+.kui-color-picker:not([data-alpha]) .kui-color-picker__hex-row {
+  grid-template-columns: minmax(0, 1fr);
+}
+
+.kui-color-picker__field {
+  display: flex;
+  min-width: 0;
+  height: 2.25rem;
+  box-sizing: border-box;
+  align-items: center;
+  gap: var(--kui-space-xs, 0.5rem);
+  padding-inline: 0.625rem;
+  border: 1px solid transparent;
+  border-radius: var(--kui-radius-m);
+  background: var(--kui-color-neutral-fill-quiet);
+  cursor: text;
+}
+
+.kui-color-picker__field[hidden] {
+  display: none;
+}
+
+.kui-color-picker__field:focus-within {
+  border-color: var(--kui-color-brand-fill-loud);
+  background: var(--kui-color-surface);
+  box-shadow: 0 0 0 1px var(--kui-color-brand-fill-loud);
+}
+
+.kui-color-picker__field-label {
+  flex: none;
+  color: var(--kui-color-text-quiet);
+}
+
+.kui-color-picker__field input {
+  width: 100%;
+  min-width: 0;
+  margin: 0;
+  padding: 0;
+  border: 0;
+  color: inherit;
+  background: transparent;
+  font: inherit;
+  font-variant-numeric: tabular-nums;
+  text-align: end;
+  outline: none;
+}
+
+.kui-color-picker__field--hex input {
+  text-align: start;
+  text-transform: uppercase;
+  font-family: var(--kui-font-mono, ui-monospace, monospace);
+}
+
+.kui-color-picker[data-disabled] .kui-color-picker__surface {
+  opacity: 0.5;
+}
+
+.kui-color-picker[data-disabled] .kui-color-picker__area {
+  cursor: not-allowed;
+}
+
+@media (forced-colors: active) {
+  .kui-color-picker__area,
+  .kui-color-picker__area-thumb,
+  .kui-color-picker__hue,
+  .kui-color-picker__opacity {
+    forced-color-adjust: none;
+  }
+
+  .kui-color-picker__field {
+    border-color: CanvasText;
+  }
+}

package/dist/styles/color-swatches.css

@@ -0,0 +1,122 @@
+/* A wrapping row of round swatches over native radios. The radio covers its
+   swatch invisibly; the chosen swatch wears a ring in the text color, set off
+   by a gap in the surface color, so the choice never depends on hue. */
+.kui-color-swatches {
+  --_kui-color-swatches-size: 1.5rem;
+
+  min-width: 0;
+  margin: 0;
+  /* The shared block-content inset (a transparent 1px border and 8px
+     padding), so the label sits on the text column. The swatches' own 4px
+     ring room is pulled back out so the first dot's ring aligns with it. */
+  padding: var(--kui-layout-item-padding, 0.5rem);
+  border: var(--kui-layout-item-border-width, 1px) solid transparent;
+}
+
+.kui-color-swatches[data-size="compact"] {
+  --_kui-color-swatches-size: 1.25rem;
+}
+
+.kui-color-swatches__label {
+  margin-block-end: var(--kui-space-xs);
+  padding: 0;
+  color: var(--kui-color-text);
+  font-size: var(--kui-font-m, 1rem);
+}
+
+.kui-color-swatches__list {
+  display: flex;
+  margin-inline: -0.25rem;
+  flex-wrap: wrap;
+  gap: var(--kui-space-xs);
+}
+
+.kui-color-swatches__swatch {
+  position: relative;
+  display: inline-grid;
+  /* Room for the 2px ring and its 2px gap around the dot. */
+  padding: 0.25rem;
+  flex: none;
+  border-radius: 50%;
+  cursor: pointer;
+}
+
+.kui-color-swatches__input {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  margin: 0;
+  border-radius: 50%;
+  opacity: 0;
+  cursor: inherit;
+  appearance: none;
+}
+
+.kui-color-swatches__dot {
+  width: var(--_kui-color-swatches-size);
+  height: var(--_kui-color-swatches-size);
+  box-sizing: border-box;
+  border-radius: 50%;
+  background: var(--_kui-color-swatches-color, transparent);
+  /* An inner edge keeps a pale swatch visible against the surface. */
+  box-shadow: inset 0 0 0 1px
+    color-mix(in srgb, var(--kui-color-text) 20%, transparent);
+}
+
+/* The no-color swatch: an outlined dot struck through from corner to corner. */
+.kui-color-swatches__dot[data-swatch="transparent"] {
+  position: relative;
+  box-shadow: inset 0 0 0 1px var(--kui-color-neutral-border-loud);
+}
+
+.kui-color-swatches__dot[data-swatch="transparent"]::after {
+  position: absolute;
+  top: 0;
+  left: calc(50% - 0.75px);
+  width: 1.5px;
+  height: 100%;
+  border-radius: 1px;
+  background: var(--kui-color-danger-on-quiet);
+  content: "";
+  transform: rotate(45deg);
+}
+
+/* The chosen swatch's ring. */
+.kui-color-swatches__swatch:has(> .kui-color-swatches__input:checked)
+  > .kui-color-swatches__dot {
+  outline: 2px solid var(--kui-color-text);
+  outline-offset: 2px;
+}
+
+.kui-color-swatches__swatch:has(> .kui-color-swatches__input:focus-visible) {
+  outline: var(--kui-focus-ring);
+  outline-offset: 0;
+}
+
+.kui-color-swatches:disabled .kui-color-swatches__list {
+  opacity: 0.45;
+}
+
+.kui-color-swatches:disabled .kui-color-swatches__swatch {
+  cursor: not-allowed;
+}
+
+@media (forced-colors: active) {
+  .kui-color-swatches__dot {
+    forced-color-adjust: none;
+    box-shadow: inset 0 0 0 1px CanvasText;
+  }
+
+  .kui-color-swatches__swatch:has(> .kui-color-swatches__input:checked)
+    > .kui-color-swatches__dot {
+    outline-color: Highlight;
+  }
+}
+
+/* As a ColorPicker's preset or sample row the picker already insets its
+   content, so the row drops its own inline inset. */
+[data-component="color-picker"] > .kui-color-swatches {
+  padding-inline: 0;
+  border-inline-width: 0;
+}

package/dist/styles/combobox.css

@@ -69,12 +69,14 @@
   }
 }
 
-/* The suggestion list drops below the field over the content that follows. */
+/* The suggestion list drops below the field in the top layer (a manual
+   popover the wiring places), so no clipping ancestor cuts it off. */
 .kui-combobox__listbox {
-  position: absolute;
-  z-index: var(--kui-combobox-z-index, 20);
-  inset: calc(100% + var(--kui-space-2xs)) 0 auto;
-  max-height: 15rem;
+  --_kui-combobox-max-height: 15rem;
+
+  position: fixed;
+  inset: auto;
+  max-height: var(--_kui-combobox-max-height);
   margin: 0;
   padding: var(--kui-space-2xs);
   overflow-y: auto;