@kerfjs/ui 5.0.0-beta.24 → 5.0.0-beta.26

package/dist/select.d.ts

@@ -25,13 +25,24 @@ interface SelectBaseProps<Value extends string = string> {
     className?: string;
     /** Empty-value hint text shown in the closed control (the native select placeholder). */
     placeholderText?: string;
+    /** Supporting text shown below the control and associated with its combobox. */
+    hint?: string;
     disabled?: boolean;
     fitMenu?: boolean;
     renderSelected?: (choice: SelectChoice<Value>) => SafeHtml;
     /** Render as an unanimated loading skeleton: the label above a static, empty control box. */
     placeholder?: boolean;
+    /** Form (default), borderless toolbar, or intrinsic navigation chrome. */
+    presentation?: 'form' | 'toolbar-borderless' | 'navigation';
+    size?: 'default' | 'compact';
+    /** Show only the selected choice icon while retaining the Select's accessible name. */
+    selectedPresentation?: 'label' | 'icon-only';
+    /** Let an enclosing ToolbarControlGroup paint the composed focus ring. */
+    focusRingOwner?: 'select' | 'group';
+    /** Maximum closed-control label width in CSS pixels before ellipsis. */
+    labelMaxWidth?: number;
 }
 type SelectProps<Value extends string = string> = SelectBaseProps<Value> & SelectAccessibleName;
-declare function Select<Value extends string>({ name, value, label, ariaLabel, choices, className, placeholderText, disabled, fitMenu, renderSelected, placeholder, }: SelectProps<Value>): SafeHtml;
+declare function Select<Value extends string>({ name, value, label, ariaLabel, choices, className, placeholderText, hint, disabled, fitMenu, renderSelected, placeholder, presentation, size, selectedPresentation, focusRingOwner, labelMaxWidth, }: SelectProps<Value>): SafeHtml;
 
 export { Select, type SelectChoice, type SelectProps };

package/dist/select.js

@@ -1,4 +1,4 @@
-export { Select } from './chunk-NWSEP5RT.js';
+export { Select } from './chunk-FRVS5RFM.js';
 
 
 

package/dist/split-view.js

@@ -1,6 +1,6 @@
 import { NavStack } from './chunk-B3A3IVO5.js';
 
-import { ResizableRegion } from './chunk-NENBUYX5.js';
+import { ResizableRegion } from './chunk-HP2B2L26.js';
 
 import { jsx, jsxs } from 'kerfjs/jsx-runtime';
 

package/dist/styles/app-tab.css

@@ -26,6 +26,13 @@
   align-items: center;
   flex: none;
 }
+.kui-app-tab[data-size="compact"] {
+  height: 2rem;
+}
+.kui-app-tab[data-presentation="segmented"] {
+  border-radius: var(--kui-radius-s);
+  box-shadow: none;
+}
 .kui-app-tab:hover {
   border-color: var(--kui-color-neutral-border-normal);
   background: var(--kui-app-tab-hover-background);
@@ -92,12 +99,31 @@
   flex: none;
 }
 .kui-app-tab__name {
+  max-width: var(--kui-app-tab-label-max-width, none);
   overflow: hidden;
   font-size: var(--kui-font-xs);
   font-weight: 650;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
+.kui-app-tab[data-presentation="icon-only"] .kui-app-tab__select {
+  width: 100%;
+  justify-content: center;
+}
+.kui-app-tab[data-presentation="icon-only"] .kui-app-tab__name {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  clip-path: inset(50%);
+}
+.kui-app-tab[data-presentation="icon-only"] {
+  width: 2rem;
+  min-width: 2rem;
+}
 .kui-app-tab__trailing {
   display: grid;
   min-width: 1.275rem;

package/dist/styles/collapsible-panel.css

@@ -33,6 +33,19 @@
   border: 0;
 }
 
+.kui-collapsible-panel[data-separator="hidden"] {
+  border-color: transparent;
+}
+
+.kui-collapsible-panel[data-content-overflow="auto"] {
+  overflow: auto;
+}
+
+.kui-collapsible-panel[data-content-overflow="visible"] {
+  z-index: var(--kui-collapsible-panel-popup-z, 5);
+  overflow: visible;
+}
+
 .kui-collapsible-panel--left[data-collapsed="true"],
 .kui-collapsible-panel--right[data-collapsed="true"] {
   width: 0;
@@ -59,6 +72,16 @@
   height: var(--kui-collapsible-panel-height, 13.75rem);
 }
 
+.kui-collapsible-panel[data-collapse-motion="none"]
+  .kui-collapsible-panel__content {
+  transition: none;
+}
+
+.kui-collapsible-panel[data-collapse-motion="fade-slide"][data-collapsed="true"]
+  .kui-collapsible-panel__content {
+  opacity: 0;
+}
+
 .kui-collapsible-panel--left[data-collapsed="true"]
   .kui-collapsible-panel__content {
   transform: translateX(-100%);
@@ -77,27 +100,66 @@
 /* Compact presentation: wireSidebar marks the host so the panel floats over the
    content as an overlay with a dismissable backdrop instead of taking layout
    space. The panel is fixed to its edge and slides in from off-screen. */
-[data-collapsible-overlay="true"] .kui-collapsible-panel {
+[data-collapsible-overlay="true"] .kui-collapsible-panel,
+.kui-collapsible-panel[data-presentation="overlay"] {
   position: fixed;
   z-index: var(--kui-collapsible-panel-overlay-z, 40);
   box-shadow: var(--kui-shadow-l, 0 8px 32px rgb(0 0 0 / 24%));
 }
 
-[data-collapsible-overlay="true"] .kui-collapsible-panel--left {
+[data-collapsible-overlay="true"] .kui-collapsible-panel--left,
+.kui-collapsible-panel--left[data-presentation="overlay"] {
   inset-block: 0;
   inset-inline-start: 0;
 }
 
-[data-collapsible-overlay="true"] .kui-collapsible-panel--right {
+[data-collapsible-overlay="true"] .kui-collapsible-panel--right,
+.kui-collapsible-panel--right[data-presentation="overlay"] {
   inset-block: 0;
   inset-inline-end: 0;
 }
 
-[data-collapsible-overlay="true"] .kui-collapsible-panel--bottom {
+[data-collapsible-overlay="true"] .kui-collapsible-panel--bottom,
+.kui-collapsible-panel--bottom[data-presentation="overlay"] {
   inset-inline: 0;
   inset-block-end: 0;
 }
 
+.kui-collapsible-panel[data-presentation="overlay"][data-collapsed="true"] {
+  pointer-events: none;
+}
+
+.kui-collapsible-panel[data-presentation="hidden"] {
+  display: none;
+}
+
+[data-collapsible-responsive="hidden"] .kui-collapsible-panel {
+  display: none;
+}
+
+.kui-collapsible-panel__restore {
+  position: fixed;
+  z-index: var(--kui-collapsible-panel-restore-z, 42);
+  inset-block-end: calc(
+    var(--kui-collapsible-panel-restore-inset, 1rem) +
+      var(--kui-safe-area-block-end, env(safe-area-inset-bottom, 0px))
+  );
+}
+
+.kui-collapsible-panel__restore[data-position="bottom-start"] {
+  inset-inline-start: calc(
+    var(--kui-collapsible-panel-restore-inset, 1rem) +
+      var(--kui-safe-area-inline-start, env(safe-area-inset-left, 0px))
+  );
+}
+
+.kui-collapsible-panel__restore[data-position="bottom-end"] {
+  inset-inline-end: calc(
+    var(--kui-collapsible-panel-restore-inset, 1rem) +
+      var(--kui-safe-area-inline-end, env(safe-area-inset-right, 0px))
+  );
+}
+
 .kui-collapsible-panel__backdrop {
   position: fixed;
   inset: 0;

package/dist/styles/list-action-row.css

@@ -1,4 +1,5 @@
 .kui-list-action-row {
+  --kui-list-group-divider-color: var(--kui-color-neutral-border-quiet);
   --kui-list-action-row-color: var(--kui-color-neutral-on-normal);
   --kui-list-action-row-border: transparent;
   --kui-list-action-row-background: transparent;
@@ -21,6 +22,29 @@
   align-items: stretch;
 }
 
+.kui-list-action-row[data-density="compact"] {
+  min-height: 2.25rem;
+}
+
+.kui-list-action-row[data-density="compact"]
+  :is(.kui-list-action-row__primary, .kui-list-action-row__trailing-action) {
+  min-height: 2.25rem;
+}
+
+.kui-list-action-row[data-divider="before"],
+.kui-list-action-row[data-divider="both"] {
+  border-block-start: 1px solid var(--kui-list-group-divider-color);
+  border-start-start-radius: 0;
+  border-start-end-radius: 0;
+}
+
+.kui-list-action-row[data-divider="after"],
+.kui-list-action-row[data-divider="both"] {
+  border-block-end: 1px solid var(--kui-list-group-divider-color);
+  border-end-start-radius: 0;
+  border-end-end-radius: 0;
+}
+
 .kui-list-action-row:has(.kui-list-action-row__primary:hover) {
   --kui-list-action-row-border: var(--kui-list-action-row-hover-border);
   --kui-list-action-row-background: var(--kui-list-action-row-hover-background);
@@ -104,6 +128,26 @@
   align-items: center;
 }
 
+.kui-list-action-row__primary-label,
+.kui-list-action-row__description,
+.kui-list-action-row__status {
+  min-width: 0;
+}
+
+.kui-list-action-row__description,
+.kui-list-action-row__status {
+  color: var(--kui-color-neutral-on-quiet);
+  font-size: var(--kui-font-xs);
+  font-weight: 400;
+  line-height: 1.3;
+}
+
+.kui-list-action-row__status {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+}
+
 .kui-list-action-row[data-has-icon="true"] .kui-list-action-row__label {
   margin-inline-start: calc(
     1.5rem + var(--kui-layout-item-gap, 0.5rem)
@@ -131,6 +175,26 @@
   place-items: center;
 }
 
+.kui-list-action-row[data-trailing-visibility="interaction"]
+  .kui-list-action-row__trailing-action {
+  opacity: 0;
+}
+
+.kui-list-action-row[data-trailing-visibility="interaction"]:is(
+    :hover,
+    :focus-within
+  )
+  .kui-list-action-row__trailing-action {
+  opacity: 1;
+}
+
+@media (hover: none) {
+  .kui-list-action-row[data-trailing-visibility="interaction"]
+    .kui-list-action-row__trailing-action {
+    opacity: 1;
+  }
+}
+
 .kui-list-action-row__trailing-action:hover:not(:disabled) {
   background: var(--kui-list-action-row-trailing-hover-background);
 }

package/dist/styles/list-header.css

@@ -1,4 +1,5 @@
 .kui-list-header {
+  --kui-list-group-divider-color: var(--kui-color-neutral-border-quiet);
   --kui-list-header-color: var(--kui-color-neutral-on-quiet);
   --kui-list-header-hover-background: var(--kui-color-neutral-border-quiet);
   --_kui-list-header-action-icon-size: var(
@@ -18,6 +19,25 @@
   gap: var(--kui-layout-item-gap, 0.5rem);
 }
 
+.kui-list-header[data-density="compact"],
+.kui-list-header[data-density="compact"] .kui-list-header__title {
+  min-height: 2.25rem;
+}
+
+.kui-list-header[data-density="compact"] .kui-list-header__title {
+  padding-block: 0.25rem;
+}
+
+.kui-list-header[data-divider="before"],
+.kui-list-header[data-divider="both"] {
+  border-block-start: 1px solid var(--kui-list-group-divider-color);
+}
+
+.kui-list-header[data-divider="after"],
+.kui-list-header[data-divider="both"] {
+  border-block-end: 1px solid var(--kui-list-group-divider-color);
+}
+
 .kui-list-header__title,
 .kui-list-header__action {
   box-sizing: border-box;
@@ -86,6 +106,18 @@
   line-height: 1;
 }
 
+.kui-list-header[data-indicator-tone="accent"]
+  :is(.kui-list-header__count, .kui-list-header__badge) {
+  color: var(--kui-color-brand-on-normal);
+  background: var(--kui-color-brand-fill-normal);
+}
+
+.kui-list-header[data-indicator-tone="danger"]
+  :is(.kui-list-header__count, .kui-list-header__badge) {
+  color: var(--kui-color-danger-on-normal);
+  background: var(--kui-color-danger-fill-normal);
+}
+
 .kui-list-header__action,
 .kui-list-header__action-layer {
   display: grid;

package/dist/styles/list-item.css

@@ -1,4 +1,5 @@
 .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-border: transparent;
   --kui-list-item-background: transparent;
@@ -25,6 +26,25 @@
   text-align: start;
 }
 
+.kui-list-item[data-density="compact"] {
+  min-height: 2.25rem;
+  padding-block: 0.25rem;
+}
+
+.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: 1.125rem minmax(0, 1fr) auto;
 }
@@ -88,12 +108,25 @@
 }
 
 .kui-list-item__label {
+  display: grid;
   min-width: 0;
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
 
+.kui-list-item__primary-label,
+.kui-list-item__description {
+  min-width: 0;
+}
+
+.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;
@@ -117,6 +150,12 @@
   gap: var(--kui-layout-item-gap, 0.5rem);
 }
 
+.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/resizable-region.css

@@ -27,6 +27,132 @@
   min-height: 0;
   overflow: hidden;
 }
+.kui-resizable-region[data-content-overflow="auto"]
+  > .kui-resizable-region__content {
+  overflow: auto;
+}
+.kui-resizable-region[data-content-overflow="visible"] {
+  z-index: var(--kui-resizable-region-popup-z, 5);
+  overflow: visible;
+}
+.kui-resizable-region[data-content-overflow="visible"]
+  > .kui-resizable-region__content {
+  overflow: visible;
+}
+.kui-resizable-region[data-separator="hidden"] {
+  --kui-resizable-region-separator-color: transparent;
+}
+.kui-resizable-region[data-collapsed="true"] > .kui-resizable-region__handle,
+.kui-resizable-region:not([data-presentation="inline"])
+  > .kui-resizable-region__handle {
+  display: none;
+}
+
+/* The track always snaps to its new size. Motion is isolated to the fixed-size
+   content so a large sibling workspace incurs one reflow, not one per frame. */
+.kui-resizable-region[data-collapse-motion="slide"]
+  > .kui-resizable-region__content,
+.kui-resizable-region[data-collapse-motion="fade-slide"]
+  > .kui-resizable-region__content {
+  transition:
+    opacity 160ms ease,
+    transform 200ms ease;
+}
+.kui-resizable-region[data-axis="horizontal"][data-collapse-motion]:not(
+    [data-collapse-motion="none"]
+  )
+  > .kui-resizable-region__content {
+  width: var(--kui-resizable-region-expanded-size);
+  min-width: var(--kui-resizable-region-expanded-size);
+}
+.kui-resizable-region[data-axis="vertical"][data-collapse-motion]:not(
+    [data-collapse-motion="none"]
+  )
+  > .kui-resizable-region__content {
+  height: var(--kui-resizable-region-expanded-size);
+  min-height: var(--kui-resizable-region-expanded-size);
+}
+.kui-resizable-region[data-axis="horizontal"][data-edge="end"][data-collapsed="true"]
+  > .kui-resizable-region__content {
+  transform: translateX(-100%);
+}
+.kui-resizable-region[data-axis="horizontal"][data-edge="start"][data-collapsed="true"]
+  > .kui-resizable-region__content {
+  transform: translateX(100%);
+}
+.kui-resizable-region[data-axis="vertical"][data-edge="end"][data-collapsed="true"]
+  > .kui-resizable-region__content {
+  transform: translateY(-100%);
+}
+.kui-resizable-region[data-axis="vertical"][data-edge="start"][data-collapsed="true"]
+  > .kui-resizable-region__content {
+  transform: translateY(100%);
+}
+.kui-resizable-region[data-collapse-motion="fade-slide"][data-collapsed="true"]
+  > .kui-resizable-region__content {
+  opacity: 0;
+}
+.kui-resizable-region[data-resizing="true"] > .kui-resizable-region__content {
+  transition: none;
+}
+
+/* Responsive replacement policies. Overlay regions stay on their logical edge
+   and stop participating in the parent's flex tracks; hidden regions are fully
+   replaced by application-owned compact UI. */
+.kui-resizable-region[data-presentation="overlay"] {
+  position: absolute;
+  z-index: var(--kui-resizable-region-overlay-z, 41);
+  max-width: var(--kui-resizable-region-overlay-max-width, 85vw);
+  max-height: var(--kui-resizable-region-overlay-max-height, 85vh);
+  box-shadow: var(--kui-shadow-l, 0 8px 32px rgb(0 0 0 / 24%));
+}
+.kui-resizable-region[data-presentation="overlay"][data-axis="horizontal"] {
+  inset-block: 0;
+}
+.kui-resizable-region[data-presentation="overlay"][data-axis="horizontal"][data-edge="end"] {
+  inset-inline-start: 0;
+}
+.kui-resizable-region[data-presentation="overlay"][data-axis="horizontal"][data-edge="start"] {
+  inset-inline-end: 0;
+}
+.kui-resizable-region[data-presentation="overlay"][data-axis="vertical"] {
+  inset-inline: 0;
+}
+.kui-resizable-region[data-presentation="overlay"][data-axis="vertical"][data-edge="end"] {
+  inset-block-start: 0;
+}
+.kui-resizable-region[data-presentation="overlay"][data-axis="vertical"][data-edge="start"] {
+  inset-block-end: 0;
+}
+.kui-resizable-region[data-presentation="overlay"][data-collapsed="true"] {
+  pointer-events: none;
+}
+.kui-resizable-region[data-presentation="hidden"] {
+  display: none;
+}
+
+/* A collapsed panel can supply its own affordance while Kerf owns consistent,
+   safe-area-aware viewport placement. */
+.kui-resizable-region__restore {
+  position: fixed;
+  z-index: var(--kui-resizable-region-restore-z, 42);
+  inset-block-end: calc(
+    var(--kui-resizable-region-restore-inset, 1rem) +
+      var(--kui-safe-area-block-end, env(safe-area-inset-bottom, 0px))
+  );
+}
+.kui-resizable-region__restore[data-position="bottom-start"] {
+  inset-inline-start: calc(
+    var(--kui-resizable-region-restore-inset, 1rem) +
+      var(--kui-safe-area-inline-start, env(safe-area-inset-left, 0px))
+  );
+}
+.kui-resizable-region__restore[data-position="bottom-end"] {
+  inset-inline-end: calc(
+    var(--kui-resizable-region-restore-inset, 1rem) +
+      var(--kui-safe-area-inline-end, env(safe-area-inset-right, 0px))
+  );
+}
 .kui-resizable-region__handle {
   position: absolute;
   z-index: 3;
@@ -109,3 +235,9 @@
 .kui-resizable-region__handle:focus-visible .kui-resizable-region__handle-icon {
   opacity: 1;
 }
+
+@media (prefers-reduced-motion: reduce) {
+  .kui-resizable-region > .kui-resizable-region__content {
+    transition: none;
+  }
+}

package/dist/styles/select.css

@@ -4,13 +4,61 @@
   border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
   gap: 0;
 }
+.kui-select--label-hidden::part(form-control-label) {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+  border: 0;
+}
 .kui-select::part(display-input) {
   min-width: 0;
+  max-width: var(--kui-select-label-max-width, none);
   overflow: hidden;
   padding: 0;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
+.kui-select[data-size="compact"]::part(combobox) {
+  min-height: 2rem;
+}
+.kui-select[data-presentation="toolbar-borderless"]::part(combobox) {
+  border-color: transparent;
+  background: transparent;
+  box-shadow: none;
+}
+.kui-select[data-presentation="navigation"] {
+  width: max-content;
+  max-width: 100%;
+}
+.kui-select[data-focus-ring-owner="group"]:focus-within::part(combobox) {
+  outline: none;
+  box-shadow: none;
+}
+.kui-select[data-selected-presentation="icon-only"] {
+  width: 2rem;
+}
+.kui-select[data-selected-presentation="icon-only"]::part(combobox) {
+  width: 2rem;
+  min-width: 2rem;
+  padding-inline: 0.4375rem;
+}
+.kui-select[data-selected-presentation="icon-only"]::part(display-input) {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  overflow: hidden;
+  clip-path: inset(50%);
+}
+.kui-select[data-selected-presentation="icon-only"]
+  .kui-select__icon[slot="start"] {
+  margin-inline-end: 0 !important;
+}
 .kui-select::part(start),
 .kui-select::part(end),
 .kui-select::part(expand-icon) {
@@ -122,9 +170,29 @@
   border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
   background: var(--kui-color-surface);
 }
+.kui-select--placeholder[data-size="compact"] .kui-select__placeholder-box {
+  min-height: 2rem;
+}
+.kui-select--placeholder[data-presentation="toolbar-borderless"]
+  .kui-select__placeholder-box {
+  border-color: transparent;
+  background: transparent;
+}
+.kui-select--placeholder[data-presentation="navigation"] {
+  width: max-content;
+  max-width: 100%;
+}
 .kui-select__placeholder-box .kui-skeleton {
   max-width: 10rem;
 }
+.kui-select__placeholder-hint {
+  display: block;
+  margin-block-start: 0.25rem;
+  padding-inline: calc(1px + var(--kui-layout-item-padding, 0.5rem));
+  color: var(--kui-color-text-quiet);
+  font-size: var(--kui-font-xs);
+  line-height: 1.4;
+}
 .kui-select__placeholder-chevron {
   display: inline-flex;
   width: 1rem;

package/dist/styles/styles.css

@@ -4,6 +4,7 @@
 @import "./disclosure-arrow.css";
 @import "./toolbar.css";
 @import "./toolbar-control-group.css";
+@import "./surface-scaffold.css";
 @import "./toolbar-text.css";
 @import "./list.css";
 @import "./list-action-row.css";
@@ -20,5 +21,4 @@
 @import "./token-search-field.css";
 @import "./state-banner.css";
 @import "./empty-state.css";
-@import "./panel-header.css";
 @import "./value-table.css";