@kerfjs/ui 4.4.1 → 5.0.0-beta.10

package/dist/styles/app-tab.css

@@ -0,0 +1,152 @@
+.kui-app-tab {
+  --kui-app-tab-color: var(--kui-color-neutral-on-quiet);
+  --kui-app-tab-hover-background: color-mix(
+    in srgb,
+    var(--kui-color-surface) 72%,
+    transparent
+  );
+  --kui-app-tab-selected-color: var(--kui-color-brand-on-quiet);
+  --kui-app-tab-selected-background: var(--kui-color-surface);
+  --kui-app-tab-selected-border: color-mix(
+    in srgb,
+    var(--kui-color-neutral-border-normal) 80%,
+    transparent
+  );
+  --kui-app-tab-drop-indicator: var(--kui-color-brand-border-normal);
+  position: relative;
+  display: flex;
+  width: max-content;
+  min-width: max-content;
+  height: 2.5rem;
+  box-sizing: border-box;
+  border: 1px solid transparent;
+  border-radius: var(--kui-layout-pill-radius, calc(1px + 1.3125rem));
+  color: var(--kui-app-tab-color);
+  background: transparent;
+  align-items: center;
+  flex: none;
+}
+.kui-app-tab:hover {
+  border-color: var(--kui-color-neutral-border-normal);
+  background: var(--kui-app-tab-hover-background);
+}
+.kui-app-tab[data-selected="true"] {
+  border-color: var(--kui-app-tab-selected-border);
+  color: var(--kui-app-tab-selected-color);
+  background: var(--kui-app-tab-selected-background);
+  box-shadow: var(--kui-shadow-s);
+}
+.kui-app-tab[data-tab-dragging="true"] {
+  opacity: 0.55;
+}
+.kui-app-tab[data-tab-drop-position]::after {
+  position: absolute;
+  z-index: 2;
+  top: 0.2rem;
+  bottom: 0.2rem;
+  width: 2px;
+  border-radius: var(--kui-radius-pill);
+  background: var(--kui-app-tab-drop-indicator);
+  content: "";
+  pointer-events: none;
+}
+.kui-app-tab[data-tab-drop-position="before"]::after {
+  inset-inline-start: calc(var(--kui-space-2xs) * -1);
+}
+.kui-app-tab[data-tab-drop-position="after"]::after {
+  inset-inline-end: calc(var(--kui-space-2xs) * -1);
+}
+.kui-app-tab__select {
+  display: flex;
+  min-width: 0;
+  height: 100%;
+  padding: 0 var(--kui-layout-item-padding, 0.5rem);
+  border: 0;
+  appearance: none;
+  color: inherit;
+  background: transparent;
+  cursor: pointer;
+  font: inherit;
+  align-items: center;
+  gap: var(--kui-layout-item-gap, 0.5rem);
+  text-align: start;
+}
+.kui-app-tab:has(.kui-app-tab__close) .kui-app-tab__select {
+  padding-inline-start: var(--kui-layout-item-padding, 0.5rem);
+}
+.kui-app-tab:has(.kui-app-tab__select:focus-visible) {
+  outline: var(--kui-focus-ring);
+  outline-offset: -2px;
+}
+.kui-app-tab__select:focus-visible {
+  outline: none;
+}
+.kui-app-tab__close:focus-visible {
+  border-radius: var(--kui-radius-pill);
+  outline: var(--kui-focus-ring);
+  outline-offset: -2px;
+}
+.kui-app-tab__select > svg {
+  width: 1rem;
+  height: 1rem;
+  flex: none;
+}
+.kui-app-tab__name {
+  overflow: hidden;
+  font-size: var(--kui-font-xs);
+  font-weight: 650;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.kui-app-tab__trailing {
+  display: grid;
+  min-width: 1.275rem;
+  min-height: 1.275rem;
+  flex: none;
+  place-items: center;
+}
+.kui-app-tab__close {
+  display: grid;
+  width: 1.275rem;
+  height: 1.275rem;
+  margin-inline-start: var(--kui-space-xs);
+  padding: 0;
+  border: 0;
+  appearance: none;
+  color: var(--kui-color-neutral-on-quiet);
+  background: transparent;
+  cursor: pointer;
+  flex: none;
+  place-items: center;
+}
+.kui-app-tab__close:hover {
+  color: var(--kui-color-text);
+}
+.kui-app-tab__close-icon {
+  display: grid;
+  width: 0.6375rem;
+  height: 0.6375rem;
+  pointer-events: none;
+  place-items: center;
+}
+.kui-app-tab__close-icon > svg {
+  width: 100%;
+  height: 100%;
+}
+@media (hover: hover) and (pointer: fine) {
+  .kui-app-tab__close {
+    opacity: 0;
+    pointer-events: none;
+    transition: opacity 0.12s ease;
+  }
+  .kui-app-tab:hover .kui-app-tab__close,
+  .kui-app-tab:focus-within .kui-app-tab__close {
+    opacity: 1;
+    pointer-events: auto;
+  }
+}
+@media (prefers-reduced-motion: reduce) {
+  .kui-app-tab__close {
+    transition: none;
+  }
+}

package/dist/styles/catalog.css

@@ -0,0 +1,498 @@
+.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;
+  }
+}