@kerfjs/ui 4.4.1 → 4.5.0-beta.1

package/dist/styles/catalog.css

@@ -0,0 +1,575 @@
+.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;
+  background: var(--kui-color-surface);
+  transition:
+    transform 200ms ease,
+    visibility 0s linear 0s;
+}
+
+.kui-catalog[data-sidebar-collapsed="true"] .kui-catalog__sidebar.kui-pane {
+  --kui-pane-separator-inline-end-width: 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) auto;
+}
+
+.kui-catalog__tags {
+  display: inline-flex;
+  min-width: 0;
+  flex-wrap: wrap;
+  justify-content: flex-end;
+  gap: var(--kui-space-2xs);
+}
+
+.kui-catalog__tag {
+  display: inline-flex;
+  padding: 0.125rem 0.375rem;
+  border: 1px solid var(--kui-color-warning-border-quiet);
+  border-radius: 999px;
+  color: var(--kui-color-warning-text);
+  background: var(--kui-color-warning);
+  font-size: var(--kui-font-2xs);
+  font-weight: 650;
+  line-height: 1.2;
+  white-space: nowrap;
+}
+
+.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 {
+  /* Match the content inset the list items and the group's ListHeader self-apply
+     (8px inline margin), so the subsection heading, its items, and the "Web
+     Awesome" group heading all share one left edge instead of the heading sitting
+     further left and its items further right. */
+  margin: 0 0.5rem;
+  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;
+}
+
+/* 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;
+}
+
+/* Optional devtools-style geometry overlay. `wireCatalogGeometryOverlay` draws
+   computed border edges, a quiet dashed bound for transparent borderless
+   specimens, and orange bands for non-zero margins. */
+.kui-catalog__geometry-overlay {
+  position: absolute;
+  z-index: 3;
+  pointer-events: none;
+  inset: 0;
+}
+
+.kui-catalog__geometry-bound,
+.kui-catalog__geometry-border,
+.kui-catalog__geometry-margin {
+  position: absolute;
+  top: 0;
+  left: 0;
+  box-sizing: border-box;
+}
+
+.kui-catalog__geometry-bound {
+  border: 1px dashed color-mix(in srgb, var(--kui-color-text) 40%, transparent);
+}
+
+.kui-catalog__geometry-border {
+  border: 0 solid
+    color-mix(in srgb, var(--kui-color-accent-text) 72%, transparent);
+}
+
+.kui-catalog__geometry-margin {
+  background: color-mix(in srgb, #f6a94c 55%, transparent);
+}
+
+.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;
+}
+
+/* The related trigger carries a text label ("Component") beside the glyph, so let
+   it grow to its content instead of the single-group's fixed 48px icon-button
+   width (from toolbar-control-group.css). */
+.kui-catalog__related-group[data-single="true"]
+  > .kui-catalog__related-menu
+  > wa-button,
+.kui-catalog__related-group[data-single="true"]
+  > .kui-catalog__related-menu
+  > wa-button::part(base) {
+  width: auto;
+}
+
+/* Keep the glyph beside the text label (the toolbar group paints the slotted svg
+   `display: block`, which would otherwise drop the label onto a second line). */
+.kui-catalog__related-trigger {
+  display: inline-flex;
+  align-items: center;
+}
+
+/* Text label beside the trigger glyph ("Component"). */
+.kui-catalog__related-label {
+  margin-inline-start: 0.375rem;
+}
+
+/* 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 .kui-catalog__sidebar.kui-pane {
+    --kui-pane-separator-block-end-width: var(--kui-pane-separator-width, 1px);
+    --kui-pane-separator-inline-end-width: 0;
+
+    width: 100%;
+    min-width: 0;
+    height: auto;
+    justify-self: stretch;
+    /* Narrow layout collapses via display:none, not the desktop slide. */
+    transform: none;
+  }
+  .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;
+  }
+}

package/dist/styles/collapsible-panel.css

@@ -0,0 +1,146 @@
+/* A standalone collapsible rail / drawer. Collapsing snaps the panel's own size
+   to zero (one reflow, no per-frame width/height animation) while the fixed-size
+   content slides out via transform (composited, clipped by overflow). The same
+   technique as Workbench and the catalog sidebar (docs/18). */
+.kui-collapsible-panel {
+  overflow: hidden;
+  background: var(--kui-color-surface);
+}
+
+.kui-collapsible-panel--left,
+.kui-collapsible-panel--right {
+  width: var(--kui-collapsible-panel-width, 17.5rem);
+  min-width: 0;
+  height: 100%;
+}
+
+.kui-collapsible-panel--left {
+  border-inline-end: 1px solid var(--kui-color-border);
+}
+
+.kui-collapsible-panel--right {
+  border-inline-start: 1px solid var(--kui-color-border);
+}
+
+.kui-collapsible-panel--bottom {
+  width: 100%;
+  height: var(--kui-collapsible-panel-height, 13.75rem);
+  min-height: 0;
+  border-block-start: 1px solid var(--kui-color-border);
+}
+
+.kui-collapsible-panel[data-collapsed="true"] {
+  border: 0;
+}
+
+.kui-collapsible-panel--left[data-collapsed="true"],
+.kui-collapsible-panel--right[data-collapsed="true"] {
+  width: 0;
+}
+
+.kui-collapsible-panel--bottom[data-collapsed="true"] {
+  height: 0;
+}
+
+/* The fixed-size sliding content: it keeps a definite size so the transform
+   reads as a slide, not a squeeze. */
+.kui-collapsible-panel__content {
+  height: 100%;
+  transition: transform 200ms ease;
+}
+
+.kui-collapsible-panel--left .kui-collapsible-panel__content,
+.kui-collapsible-panel--right .kui-collapsible-panel__content {
+  width: var(--kui-collapsible-panel-width, 17.5rem);
+}
+
+.kui-collapsible-panel--bottom .kui-collapsible-panel__content {
+  width: 100%;
+  height: var(--kui-collapsible-panel-height, 13.75rem);
+}
+
+.kui-collapsible-panel--left[data-collapsed="true"]
+  .kui-collapsible-panel__content {
+  transform: translateX(-100%);
+}
+
+.kui-collapsible-panel--right[data-collapsed="true"]
+  .kui-collapsible-panel__content {
+  transform: translateX(100%);
+}
+
+.kui-collapsible-panel--bottom[data-collapsed="true"]
+  .kui-collapsible-panel__content {
+  transform: translateY(100%);
+}
+
+/* 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 {
+  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 {
+  inset-block: 0;
+  inset-inline-start: 0;
+}
+
+[data-collapsible-overlay="true"] .kui-collapsible-panel--right {
+  inset-block: 0;
+  inset-inline-end: 0;
+}
+
+[data-collapsible-overlay="true"] .kui-collapsible-panel--bottom {
+  inset-inline: 0;
+  inset-block-end: 0;
+}
+
+.kui-collapsible-panel__backdrop {
+  position: fixed;
+  inset: 0;
+  z-index: var(--kui-collapsible-panel-backdrop-z, 39);
+  border: 0;
+  padding: 0;
+  background: var(--kui-color-scrim, rgb(0 0 0 / 32%));
+  cursor: pointer;
+}
+
+/* The standard toggle affordance: a plain icon button carrying the per-side
+   collapse/expand glyph. */
+.kui-collapsible-panel__toggle {
+  display: grid;
+  width: 2.5rem;
+  height: 2.5rem;
+  padding: 0;
+  border: 1px solid transparent;
+  border-radius: var(--kui-layout-rounded-radius, calc(1px + 0.6875rem));
+  color: inherit;
+  background: transparent;
+  cursor: pointer;
+  place-items: center;
+}
+
+.kui-collapsible-panel__toggle:hover {
+  border-color: var(--kui-color-border);
+  background: var(--kui-color-neutral-fill-normal);
+}
+
+.kui-collapsible-panel__toggle:focus-visible {
+  outline: var(--kui-focus-ring);
+  outline-offset: 1px;
+}
+
+.kui-collapsible-panel__toggle svg {
+  display: block;
+  width: 1.125rem;
+  height: 1.125rem;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .kui-collapsible-panel__content {
+    transition: none;
+  }
+}