@kerfjs/ui 4.5.0-beta.1 → 5.0.0-beta.100

package/dist/styles/catalog.css

@@ -1,575 +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;
-  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;
-  }
-}
+/* 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";