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

package/dist/styles/catalog.css

@@ -1,498 +1,5 @@
-.kui-catalog {
-  /* Collapsing the sidebar changes its grid column, which reflows the detail
-     pane. Animating that width relayouts the whole shell per frame, so the column
-     snaps instantly (one reflow) and the fixed-width sidebar slides via transform
-     only (composited, clipped by this shell's overflow). */
-  --kui-catalog-sidebar-width: 18rem;
-  --kui-catalog-content-measure: 70rem;
-
-  display: grid;
-  height: 100vh;
-  grid-template-columns: var(--kui-catalog-sidebar-width) minmax(0, 1fr);
-  overflow: hidden;
-}
-
-.kui-catalog[data-sidebar-collapsed="true"] {
-  grid-template-columns: 0 minmax(0, 1fr);
-}
-
-.kui-catalog__sidebar {
-  width: var(--kui-catalog-sidebar-width);
-  min-width: var(--kui-catalog-sidebar-width);
-  height: 100%;
-  padding: 0;
-  overflow: hidden;
-  justify-self: start;
-  border-inline-end: 1px solid var(--kui-color-border);
-  background: var(--kui-color-surface);
-  transition:
-    transform 200ms ease,
-    visibility 0s linear 0s;
-}
-
-.kui-catalog[data-sidebar-collapsed="true"] .kui-catalog__sidebar {
-  border-inline-end: 0;
-  /* Slide out first, then hide, so the panel animates offscreen and only then
-     leaves the tab order rather than snapping invisible mid-slide. */
-  transform: translateX(-100%);
-  visibility: hidden;
-  transition:
-    transform 200ms ease,
-    visibility 0s linear 200ms;
-}
-
-.kui-catalog__brand .kui-toolbar {
-  padding: var(--kui-space-xs);
-}
-
-/* Scoped to the brand so it outranks the ToolbarControlGroup's own gap rule; a
-   single-class selector would lose that specificity and drop the logo→title gap,
-   which then misaligns the subtitle (whose padding assumes the gap is present). */
-.kui-catalog__brand .kui-catalog__identity {
-  min-width: 0;
-  gap: var(--kui-layout-control-gap, 0.5rem);
-}
-
-.kui-catalog__identity h1,
-.kui-catalog__subtitle {
-  margin: 0;
-}
-
-.kui-catalog__identity h1 {
-  overflow: hidden;
-  font-size: var(--kui-font-m);
-  letter-spacing: 0.07em;
-  line-height: 1.15;
-  text-overflow: ellipsis;
-  text-transform: uppercase;
-  white-space: nowrap;
-}
-
-.kui-catalog__subtitle {
-  overflow: hidden;
-  margin-block-start: calc(-1 * var(--kui-space-xs));
-  padding-block-end: var(--kui-space-xs);
-  padding-inline: calc(
-      var(--kui-space-xs) + 0.125rem + 2.125rem +
-        var(--kui-layout-control-gap, 0.5rem)
-    )
-    var(--kui-space-xs);
-  color: var(--kui-color-text-quiet);
-  font-size: var(--kui-font-xs);
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.kui-catalog__mark {
-  display: block;
-  width: 2.125rem;
-  height: 2.125rem;
-  flex: 0 0 auto;
-}
-
-.kui-catalog__group {
-  margin-block-start: var(--kui-space-m);
-}
-
-.kui-catalog__group:first-child {
-  margin-block-start: var(--kui-space-2xs);
-}
-
-.kui-catalog__items {
-  display: grid;
-  gap: var(--kui-space-2xs);
-}
-
-.kui-catalog__items .kui-list-item {
-  grid-template-columns: minmax(0, 1fr);
-}
-
-.kui-catalog__group--secondary {
-  padding-block-start: var(--kui-space-s);
-  border-block-start: 1px solid var(--kui-color-border-quiet);
-}
-
-.kui-catalog__secondary {
-  display: grid;
-  padding-block: var(--kui-space-xs);
-  gap: var(--kui-space-s);
-}
-
-.kui-catalog__secondary-group {
-  display: grid;
-  min-width: 0;
-  gap: var(--kui-space-2xs);
-}
-
-.kui-catalog__secondary-heading {
-  margin: 0;
-  padding: 0.1rem 0.55rem;
-  color: var(--kui-color-text-quiet);
-  font-size: var(--kui-font-2xs);
-  font-weight: 650;
-  letter-spacing: 0.04em;
-  text-transform: uppercase;
-}
-
-.kui-catalog__secondary-group .kui-list-item {
-  padding-inline-start: 1rem;
-}
-
-/* Labeled, aligned preview examples (CatalogExample / CatalogExampleStack). */
-.kui-catalog-example-stack {
-  display: flex;
-  flex-direction: column;
-  gap: 1rem;
-}
-
-.kui-catalog-example {
-  display: flex;
-  width: 100%;
-  min-width: 0;
-  max-width: 100%;
-  flex-direction: column;
-  align-items: flex-start;
-  gap: 0.5rem;
-}
-
-/* A ListHeader used as an example label shrinks to its title; one that is itself
-   the demoed specimen keeps its default full width. */
-.kui-catalog-example > .kui-list-header:first-child {
-  width: auto;
-}
-
-.kui-catalog-example__note {
-  /* Align the note text with the label above and a content-item specimen below:
-     all land at 8px margin + 1px border + 8px padding from the example's edge. */
-  margin: 0;
-  padding-inline: calc(
-    var(--kui-layout-inline-margin, 0.5rem) + 1px +
-      var(--kui-layout-item-padding, 0.5rem)
-  );
-  color: var(--kui-color-text-quiet);
-  font-size: var(--kui-font-s);
-}
-
-/* The inset is published as --kui-catalog-example-align and applied as the
-   specimen's leading margin, so a debug overlay can exclude it from the measured
-   margin and never paint the alignment device as intrinsic geometry. */
-.kui-catalog-example[data-align="glyph"]
-  > :not(.kui-list-header):not(.kui-catalog-example__note) {
-  --kui-catalog-example-align: 1rem;
-  margin-inline-start: var(--kui-catalog-example-align);
-}
-
-.kui-catalog-example[data-align="inline-control"]
-  > :not(.kui-list-header):not(.kui-catalog-example__note) {
-  --kui-catalog-example-align: 0.5rem;
-  margin-inline-start: var(--kui-catalog-example-align);
-}
-
-.kui-catalog__detail {
-  min-width: 0;
-  height: 100%;
-  grid-column: 2;
-}
-
-.kui-catalog__header {
-  border-block-end: 1px solid var(--kui-color-border);
-  background: var(--kui-color-surface);
-}
-
-.kui-catalog__header .kui-toolbar {
-  padding-block-end: 0;
-}
-
-.kui-catalog__title {
-  min-width: 0;
-}
-
-.kui-catalog__title h2,
-.kui-catalog__description {
-  margin: 0;
-}
-
-.kui-catalog__title h2 {
-  overflow: hidden;
-  font-size: var(--kui-font-l);
-  letter-spacing: -0.025em;
-  line-height: 1.2;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.kui-catalog__description {
-  max-width: var(--kui-catalog-content-measure, 70rem);
-  margin-block: 0 var(--kui-space-xs);
-  color: var(--kui-color-text-quiet);
-  background: transparent;
-  line-height: 1.45;
-}
-
-.kui-catalog__header-actions {
-  display: flex;
-  min-width: 0;
-  align-items: center;
-  gap: var(--kui-layout-control-gap);
-}
-
-.kui-catalog__settings {
-  box-shadow: none;
-}
-
-/* Scoped under the header-actions container so it outranks the toolbar group's
-   default `display: grid` icon-over-label button — these settings buttons carry a
-   text label and read as icon-beside-label. */
-.kui-catalog__header-actions .kui-catalog__settings > button {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.375rem;
-  white-space: nowrap;
-}
-
-.kui-catalog__settings > button:focus-visible {
-  outline: var(--kui-focus-ring);
-  outline-offset: 2px;
-}
-
-.kui-catalog__settings svg {
-  width: 1rem;
-  height: 1rem;
-}
-
-.kui-catalog__stage {
-  width: 100%;
-  background-color: var(--kui-color-surface-lowered);
-  background-image:
-    linear-gradient(
-      45deg,
-      color-mix(in srgb, var(--kui-color-border-quiet) 42%, transparent) 25%,
-      transparent 25%
-    ),
-    linear-gradient(
-      -45deg,
-      color-mix(in srgb, var(--kui-color-border-quiet) 42%, transparent) 25%,
-      transparent 25%
-    ),
-    linear-gradient(
-      45deg,
-      transparent 75%,
-      color-mix(in srgb, var(--kui-color-border-quiet) 42%, transparent) 75%
-    ),
-    linear-gradient(
-      -45deg,
-      transparent 75%,
-      color-mix(in srgb, var(--kui-color-border-quiet) 42%, transparent) 75%
-    );
-  background-position:
-    0 0,
-    0 0.75rem,
-    0.75rem -0.75rem,
-    -0.75rem 0;
-  background-size: 1.5rem 1.5rem;
-}
-
-.kui-catalog__canvas {
-  position: relative;
-  display: grid;
-  width: min(100%, var(--kui-catalog-content-measure, 70rem));
-  min-width: 0;
-  min-height: 100%;
-  margin-inline: auto;
-  padding: var(--kui-layout-content-gap);
-  box-sizing: border-box;
-  place-items: center;
-}
-
-.kui-catalog__footer {
-  --kui-toolbar-gap: 0.25rem;
-  --kui-toolbar-group-size: 2rem;
-
-  border-block-start: 1px solid var(--kui-color-border);
-  background: color-mix(
-    in srgb,
-    var(--kui-color-surface-lowered) 72%,
-    var(--kui-color-surface)
-  );
-}
-
-.kui-catalog__status {
-  display: flex;
-  min-height: 1.625rem;
-  padding: 0.375rem 0.75rem 0;
-  color: var(--kui-color-text-quiet);
-  align-items: center;
-  justify-content: space-between;
-  gap: var(--kui-layout-control-gap);
-  font-size: var(--kui-font-xs);
-}
-
-.kui-catalog__footer .kui-toolbar {
-  min-height: 2.5rem;
-  padding: 0.25rem 0.5rem 0.5rem;
-}
-
-.kui-catalog__footer .kui-toolbar-control-group {
-  height: 2rem;
-  min-width: 2rem;
-}
-
-.kui-catalog__resources {
-  min-width: 0;
-}
-
-.kui-catalog__resource-group {
-  max-width: 100%;
-  overflow-x: auto;
-}
-
-.kui-catalog__resource {
-  position: relative;
-  display: inline-flex;
-  flex: 0 0 auto;
-  min-width: 0;
-  height: 1.875rem;
-  padding: 0 var(--kui-space-xs);
-  border: 1px solid transparent;
-  border-radius: var(--kui-radius-pill);
-  color: var(--kui-color-text);
-  background: transparent;
-  text-decoration: none;
-  white-space: nowrap;
-  align-items: center;
-  gap: var(--kui-space-2xs);
-}
-
-.kui-catalog__resource:hover {
-  border-color: var(--kui-color-border);
-  background: var(--kui-color-surface);
-}
-
-.kui-catalog__resource:focus-visible {
-  outline: var(--kui-focus-ring);
-  outline-offset: 2px;
-}
-
-.kui-catalog__resource svg {
-  width: 0.875rem;
-  height: 0.875rem;
-}
-
-/* The optional monospace detail is a visually-hidden accessible affordance. */
-.kui-catalog__resource code {
-  position: absolute;
-  inset-block-start: 0;
-  inset-inline-start: 0;
-  width: 1px;
-  height: 1px;
-  padding: 0;
-  overflow: hidden;
-  border: 0;
-  clip-path: inset(50%);
-  white-space: nowrap;
-}
-
-.kui-catalog__related-group {
-  padding: 0;
-}
-
-/* The related-entries trigger is an icon + caret popup button. In the footer
-   toolbar the slotted glyph otherwise collapses to 0 width (a Web Awesome
-   slotted-flex quirk), so pin its box size explicitly. */
-.kui-catalog__related-menu wa-button[slot="trigger"] svg {
-  width: 1rem !important;
-  min-width: 1rem;
-  height: 1rem !important;
-}
-
-/* Group heading inside the related-entries popup menu (e.g. "Uses" / "Used by"). */
-.kui-catalog__related-heading {
-  display: block;
-  padding: 0.25rem 0.75rem 0;
-  color: var(--kui-color-text-quiet);
-  font-size: var(--kui-font-xs);
-  font-weight: 600;
-  text-transform: uppercase;
-  letter-spacing: 0.04em;
-}
-
-@media (max-width: 64rem) {
-  .kui-catalog__settings button span {
-    position: absolute;
-    width: 1px;
-    height: 1px;
-    overflow: hidden;
-    clip-path: inset(50%);
-    white-space: nowrap;
-  }
-}
-
-@media (max-width: 52rem) {
-  .kui-catalog {
-    height: auto;
-    min-height: 100vh;
-    grid-template-columns: 1fr;
-  }
-  .kui-catalog[data-sidebar-collapsed="true"] {
-    grid-template-columns: 1fr;
-  }
-  .kui-catalog[data-sidebar-collapsed="true"] .kui-catalog__sidebar {
-    display: none;
-  }
-  .kui-catalog__sidebar {
-    width: 100%;
-    min-width: 0;
-    height: auto;
-    justify-self: stretch;
-    /* Narrow layout collapses via display:none, not the desktop slide. */
-    transform: none;
-    border-inline-end: 0;
-    border-block-end: 1px solid var(--kui-color-border);
-  }
-  .kui-catalog__detail {
-    height: auto;
-    min-height: auto;
-    grid-column: 1;
-  }
-  .kui-catalog__sidebar nav {
-    display: grid;
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-    align-items: start;
-    gap: 0.5rem 1rem;
-  }
-  .kui-catalog__group,
-  .kui-catalog__group:first-child {
-    min-width: 0;
-    margin: 0;
-  }
-  .kui-catalog__stage {
-    min-height: 24rem;
-  }
-  .kui-catalog__canvas {
-    min-height: 16rem;
-  }
-  .kui-catalog__status {
-    align-items: flex-start;
-    flex-direction: column;
-    gap: 0.25rem;
-  }
-  /* Stack the footer's resource links above the related-entries menu at narrow widths
-     instead of keeping them in one row. */
-  .kui-catalog__footer .kui-toolbar[data-has-center="false"] {
-    grid-template-columns: minmax(0, 1fr);
-  }
-  .kui-catalog__footer .kui-toolbar__leading,
-  .kui-catalog__resource-group {
-    width: 100%;
-  }
-  .kui-catalog__footer .kui-toolbar__trailing {
-    width: 100%;
-    justify-content: flex-start;
-  }
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .kui-catalog__sidebar {
-    transition-duration: 0s;
-  }
-}
+/* Public compatibility entrypoint. Each catalog component owns its styles. */
+@import "./catalog/components/catalog.css";
+@import "./catalog/components/catalog-stage.css";
+@import "./catalog/components/catalog-example.css";
+@import "./catalog/components/catalog-example-stack.css";

package/dist/styles/chip.css

@@ -0,0 +1,208 @@
+.kui-chip {
+  --_kui-chip-fill-quiet: var(--kui-color-neutral-fill-quiet);
+  --_kui-chip-fill-solid: var(--kui-color-neutral-on-normal);
+  --_kui-chip-border: var(--kui-color-neutral-border-normal);
+  --_kui-chip-on-quiet: var(--kui-color-neutral-on-quiet);
+  --_kui-chip-on-solid: var(--kui-color-surface);
+
+  display: inline-flex;
+  min-width: 0;
+  min-height: 1.75rem;
+  padding-inline: 0.5rem;
+  box-sizing: border-box;
+  border: 1px solid transparent;
+  border-radius: var(--kui-layout-pill-radius, calc(1px + 1.3125rem));
+  color: var(--_kui-chip-on-quiet);
+  background: var(--_kui-chip-fill-quiet);
+  align-items: center;
+  gap: 0.25rem;
+  font-size: var(--kui-font-xs);
+  font-weight: 650;
+  line-height: 1;
+  white-space: nowrap;
+}
+
+/* A normal status chip stays readable beside a shrinkable toolbar title.
+   Only the explicit truncate variant gives up its label width. */
+.kui-chip:not([data-truncate]) {
+  flex-shrink: 0;
+}
+
+.kui-chip[data-tone="info"] {
+  --_kui-chip-fill-quiet: var(--kui-color-brand-fill-quiet);
+  --_kui-chip-fill-solid: var(--kui-color-brand-on-fill);
+  --_kui-chip-border: var(--kui-color-brand-border-normal);
+  --_kui-chip-on-quiet: var(--kui-color-brand-on-fill);
+}
+
+.kui-chip[data-tone="pop"] {
+  --_kui-chip-fill-quiet: var(--kui-color-pop-fill-quiet);
+  --_kui-chip-fill-solid: var(--kui-color-pop-on-fill);
+  --_kui-chip-border: var(--kui-color-pop-border-normal);
+  --_kui-chip-on-quiet: var(--kui-color-pop-on-fill);
+}
+
+.kui-chip[data-tone="success"] {
+  --_kui-chip-fill-quiet: var(--kui-color-success-fill-quiet);
+  --_kui-chip-fill-solid: var(--kui-color-success-on-fill);
+  --_kui-chip-border: var(--kui-color-success-border-normal);
+  --_kui-chip-on-quiet: var(--kui-color-success-on-fill);
+}
+
+.kui-chip[data-tone="warning"] {
+  --_kui-chip-fill-quiet: var(--kui-color-warning-fill-quiet);
+  --_kui-chip-fill-solid: var(--kui-color-warning-on-fill);
+  --_kui-chip-border: var(--kui-color-warning-border-normal);
+  --_kui-chip-on-quiet: var(--kui-color-warning-on-fill);
+}
+
+.kui-chip[data-tone="danger"] {
+  --_kui-chip-fill-quiet: var(--kui-color-danger-fill-quiet);
+  --_kui-chip-fill-solid: var(--kui-color-danger-on-fill);
+  --_kui-chip-border: var(--kui-color-danger-border-normal);
+  --_kui-chip-on-quiet: var(--kui-color-danger-on-fill);
+}
+
+.kui-chip[data-appearance="solid"] {
+  color: var(--_kui-chip-on-solid);
+  background: var(--_kui-chip-fill-solid);
+}
+
+.kui-chip[data-appearance="outline"] {
+  border-color: var(--_kui-chip-border);
+  background: transparent;
+}
+
+/* Follows the surrounding foreground, such as the on-loud text of a
+   brand-loud ContentItem bubble. It paints no fill: any currentColor wash
+   over a loud surface lowers the contrast the surface's own text was tuned
+   to, so the chip draws its shape with a currentColor border instead (soft
+   for quiet, full strength for outline and solid). */
+.kui-chip[data-tone="inherit"] {
+  --_kui-chip-border: color-mix(in srgb, currentColor 40%, transparent);
+
+  border-color: var(--_kui-chip-border);
+  color: inherit;
+  background: transparent;
+}
+
+.kui-chip[data-tone="inherit"]:is(
+    [data-appearance="outline"],
+    [data-appearance="solid"]
+  ) {
+  --_kui-chip-border: currentColor;
+}
+
+.kui-chip[data-shape="rounded"] {
+  border-radius: var(--kui-radius-s);
+}
+
+.kui-chip[data-size="compact"] {
+  min-height: 1.25rem;
+  padding-inline: 0.3125rem;
+  font-size: var(--kui-font-2xs);
+}
+
+.kui-chip[data-disabled] {
+  opacity: 0.5;
+  pointer-events: none;
+}
+
+.kui-chip[data-truncate] {
+  max-width: 100%;
+  overflow: hidden;
+}
+
+/* Link chip: a native anchor with the same geometry. Hover and press layer a
+   currentColor wash over whichever fill the appearance paints; an inherit
+   chip instead strengthens its border and underlines its label, so the
+   surrounding text contrast holds in every state. */
+.kui-chip[data-link] {
+  --_kui-chip-wash: transparent;
+
+  background-image: linear-gradient(
+    var(--_kui-chip-wash),
+    var(--_kui-chip-wash)
+  );
+  text-decoration: none;
+  cursor: pointer;
+}
+
+.kui-chip[data-link]:hover {
+  --_kui-chip-wash: color-mix(in srgb, currentColor 10%, transparent);
+}
+
+.kui-chip[data-link]:active {
+  --_kui-chip-wash: color-mix(in srgb, currentColor 18%, transparent);
+}
+
+.kui-chip[data-link][data-tone="inherit"]:is(:hover, :active) {
+  --_kui-chip-wash: transparent;
+  --_kui-chip-border: currentColor;
+}
+
+/* The label clips for its ellipsis; a little block room keeps the hover
+   underline inside that clip without changing the chip's height. */
+.kui-chip[data-link] .kui-chip__label {
+  padding-block: 0.2em;
+}
+
+.kui-chip[data-link][data-tone="inherit"]:is(:hover, :active) .kui-chip__label {
+  text-decoration: underline;
+  text-underline-offset: 0.12em;
+}
+
+.kui-chip[data-link]:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: 2px;
+}
+
+/* The brand focus color can match a brand-loud surface; an inherit chip's
+   ring follows the surrounding foreground instead. */
+.kui-chip[data-link][data-tone="inherit"]:focus-visible {
+  outline: 3px solid currentColor;
+}
+
+.kui-chip__icon {
+  display: inline-grid;
+  width: 1em;
+  height: 1em;
+  color: inherit;
+  place-items: center;
+  flex: none;
+}
+
+.kui-chip__label {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.kui-chip__remove {
+  display: inline-grid;
+  width: 1.25rem;
+  height: 1.25rem;
+  padding: 0;
+  border: 0;
+  border-radius: 50%;
+  color: inherit;
+  background: transparent;
+  align-items: center;
+  justify-items: center;
+  cursor: pointer;
+  flex: none;
+}
+
+.kui-chip[data-size="compact"] .kui-chip__remove {
+  width: 1rem;
+  height: 1rem;
+}
+
+.kui-chip__remove:hover {
+  background: color-mix(in srgb, currentColor 12%, transparent);
+}
+
+.kui-chip__remove:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: 1px;
+}