@hearthsound/design 0.0.0-stage → 0.1.0

package/css/components/menu.css

@@ -0,0 +1,282 @@
+/*
+ * @hearthsound/design - menus
+ *
+ * k05 item anatomy, k18 A submenu (desktop cascade and phone replace-with-list),
+ * o01 account menu, k17-r3 song menu with like/dislike and stars. The k26 avatar
+ * and account row live in sidebar.css. Values from shared/approved/components.css
+ * (.popmenu, .songmenu, .stars, .amenu) and spec/components.md.
+ */
+
+/* ------------------------------------------------------------------ */
+/* Menu surface (k18, k05 item anatomy)                               */
+/* ------------------------------------------------------------------ */
+
+.hs-menu {
+  background: var(--hs-popover-bg);
+  border-radius: var(--hs-radius-popover);
+  box-shadow: var(--hs-elevation-2);
+  padding: 6px;
+  box-sizing: border-box;
+  min-width: 220px;
+}
+
+/* 1 px separators inset 6 px. */
+.hs-menu hr {
+  border: 0;
+  height: 1px;
+  background: var(--hs-separator);
+  margin: 2px 6px 4px;
+}
+
+.hs-menu__header {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 2px 2px 6px;
+  font-weight: 600;
+  white-space: nowrap;
+}
+
+.hs-menu__item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  height: 36px;
+  padding: 0 10px;
+  border: 0;
+  width: 100%;
+  background: none;
+  border-radius: var(--hs-radius-row);
+  position: relative;
+  font: 400 14px var(--hs-font-body);
+  color: var(--hs-fg);
+  text-align: left;
+  text-decoration: none;
+  box-sizing: border-box;
+}
+
+/* "No playlists yet" (c03 item 19): a muted, non-interactive line. */
+.hs-menu__empty {
+  padding: 0 10px;
+  color: var(--hs-fg-muted);
+  font-size: 13px;
+}
+
+.hs-menu__item > .hs-icon {
+  width: 16px;
+  height: 16px;
+  color: var(--hs-fg-muted);
+}
+
+/* A trailing icon on an item that opens a submenu is the 14 px chevron. */
+.hs-menu__item[aria-haspopup] > .hs-icon:last-child {
+  width: 14px;
+  height: 14px;
+}
+
+.hs-menu__label {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.hs-menu__sub {
+  margin-left: auto;
+  color: var(--hs-fg-muted);
+  font-size: 13px;
+}
+
+.hs-menu__cover {
+  width: 28px;
+  height: 28px;
+  border-radius: 5px;
+  overflow: hidden;
+  flex: none;
+  display: block;
+}
+
+.hs-menu__cover .hs-mosaic {
+  border-radius: inherit;
+}
+
+.hs-menu__check {
+  width: 16px;
+  height: 16px;
+  margin-left: auto;
+  color: var(--hs-accent-text);
+  visibility: hidden;
+  flex: none;
+}
+
+.hs-menu__item[aria-checked='true'] .hs-menu__check {
+  visibility: visible;
+}
+
+.hs-menu__item:hover {
+  background: var(--hs-control-tone);
+}
+
+.hs-menu__item:focus-visible {
+  outline: none;
+  background: var(--hs-accent-tint);
+  color: var(--hs-accent-text);
+  font-weight: 600;
+  box-shadow: var(--hs-focus-shadow);
+}
+
+/* ------------------------------------------------------------------ */
+/* k18 A - add-to-playlist submenu                                    */
+/* ------------------------------------------------------------------ */
+
+.hs-submenu {
+  position: absolute;
+  top: 0;
+  left: calc(100% + 6px);
+  width: 270px;
+  box-sizing: border-box;
+  background: var(--hs-popover-bg);
+  border-radius: var(--hs-radius-popover);
+  box-shadow: var(--hs-elevation-2);
+  padding: 6px;
+}
+
+.hs-submenu__header {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 2px 2px 6px;
+  font-weight: 600;
+  white-space: nowrap;
+}
+
+.hs-submenu__back {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  padding: 0;
+  border: 0;
+  border-radius: var(--hs-radius-control);
+  background: transparent;
+  color: var(--hs-fg-muted);
+  cursor: default;
+}
+
+.hs-submenu__back:hover {
+  background: var(--hs-control-tone);
+  color: var(--hs-fg);
+}
+
+.hs-submenu__back:focus-visible {
+  outline: none;
+  background: var(--hs-accent-tint);
+  color: var(--hs-accent-text);
+  box-shadow: var(--hs-focus-shadow);
+}
+
+/* Phones: the submenu content replaces the menu, so it stops floating. */
+@media (max-width: 720px) {
+  .hs-submenu {
+    position: static;
+  }
+}
+
+/* ------------------------------------------------------------------ */
+/* k17-r3 - song menu                                                 */
+/* ------------------------------------------------------------------ */
+
+.hs-song-menu {
+  width: 270px;
+}
+
+.hs-song-menu__feedback-line {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 2px 4px 6px;
+}
+
+.hs-song-menu__feedback-line .hs-button {
+  width: 40px;
+  height: 40px;
+}
+
+.hs-song-menu__feedback-line .hs-button--on {
+  background: transparent;
+  color: var(--hs-accent-text);
+}
+
+.hs-song-menu__rating-line {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  padding: 2px 4px 6px;
+}
+
+/* Rating stars: five 30 x 36 px targets, 18 px glyphs. */
+.hs-stars {
+  display: inline-flex;
+}
+
+.hs-star {
+  width: 30px;
+  height: 36px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+  border: 0;
+  background: transparent;
+  border-radius: var(--hs-radius-control);
+  color: var(--hs-fg-muted);
+  cursor: default;
+}
+
+.hs-star .hs-icon {
+  width: 18px;
+  height: 18px;
+}
+
+.hs-star--on {
+  color: var(--hs-accent-text);
+}
+
+.hs-star:focus-visible {
+  outline: none;
+  background: var(--hs-accent-tint);
+}
+
+/* ------------------------------------------------------------------ */
+/* o01 - account menu (avatar and account row live in sidebar.css)    */
+/* ------------------------------------------------------------------ */
+
+.hs-account-menu {
+  width: 250px;
+}
+
+.hs-account-menu__header {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 6px 8px 10px;
+}
+
+.hs-account-menu__who {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  min-width: 0;
+}
+
+.hs-account-menu__who > :first-child {
+  font-weight: 600;
+}
+
+.hs-account-menu__who > :last-child {
+  color: var(--hs-fg-muted);
+  font-size: 13px;
+}

package/css/components/page-header.css

@@ -0,0 +1,230 @@
+/*
+ * k25 A - page header: a 72 px sticky row on the view background (never a separate bar
+ * surface), the page title as h1, flat icon actions at the right, and the l03 back
+ * button. On phones the drawer menu button leads top-level pages (layouts.md 1.2) and the
+ * back button replaces it on drill-down pages. The hero below is the l09 detail hero
+ * (p15 album, p16-r1 artist, p17 playlist).
+ */
+
+.hs-page-header {
+  position: sticky;
+  top: 0;
+  z-index: 5;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  height: 72px;
+  padding: 0 24px;
+  box-sizing: border-box;
+  background: var(--hs-view-bg);
+  color: var(--hs-fg);
+}
+
+.hs-page-header__title {
+  flex: 1;
+  min-width: 0;
+  margin: 0;
+  font: 750 var(--hs-type-title-2-size)/1.1 var(--hs-font-display);
+  letter-spacing: -0.02em;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.hs-page-actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-left: auto;
+}
+
+/* k25 A: the hairline appears only once the page is scrolled. */
+.hs-page-header--scrolled,
+.hs-page-header[data-scrolled] {
+  box-shadow: 0 1px 0 var(--hs-separator);
+}
+
+/* l03: a flat 36 px icon button leading the header, pulled to the margin. */
+.hs-back {
+  margin-left: -8px;
+}
+
+/* l01-r1: the phone drawer trigger leads top-level pages only. */
+.hs-page-header__menu {
+  display: none;
+  margin-left: -8px;
+}
+
+/* ------------------------------------------------------------------ */
+/* Phone (l07): 14 px header padding; icon actions stay icon-only      */
+/* ------------------------------------------------------------------ */
+
+@media (max-width: 720px) {
+  .hs-page-header {
+    padding: 0 14px;
+  }
+
+  .hs-page-header__menu {
+    display: inline-flex;
+  }
+}
+
+/* ------------------------------------------------------------------ */
+/* l09, p15, p16-r1, p17 - detail hero                                 */
+/* ------------------------------------------------------------------ */
+
+.hs-hero {
+  display: flex;
+  align-items: flex-end;
+  gap: 28px;
+  padding: 8px 32px 26px;
+  box-sizing: border-box;
+}
+
+.hs-hero__art {
+  display: block;
+  flex: none;
+  width: 232px;
+  height: 232px;
+  border-radius: var(--hs-radius-art);
+  overflow: hidden;
+  background: var(--hs-art-placeholder-bg);
+  box-shadow: var(--hs-art-shadow);
+}
+
+.hs-hero__art > img {
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+
+/* f15c: artist portraits are round. */
+.hs-hero__art--round {
+  border-radius: var(--hs-radius-artist);
+}
+
+.hs-hero__text {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 6px;
+  min-width: 0;
+}
+
+.hs-hero__text > h1 {
+  margin: 0;
+  font: 750 var(--hs-type-title-1-size)/1.1 var(--hs-font-display);
+  letter-spacing: -0.02em;
+}
+
+.hs-hero__by {
+  margin: 0;
+  font-weight: 600;
+}
+
+.hs-hero__meta {
+  margin: 0;
+  color: var(--hs-fg-muted);
+  font-size: 13px;
+}
+
+/* p16-r1: the biography is muted, clamped to three lines, with Show more / Show less
+ * in place. A visually hidden checkbox carries the expanded state so the text stays
+ * visible while collapsed; the label is the disclosure control. */
+.hs-hero__bio {
+  position: relative;
+  max-width: 62ch;
+  margin: 4px 0 0;
+  color: var(--hs-fg-muted);
+}
+
+.hs-hero__bio > p {
+  margin: 0;
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 3;
+  overflow: hidden;
+}
+
+.hs-hero__bio-toggle {
+  position: absolute; /* markup also carries .hs-visually-hidden */
+}
+
+.hs-hero__bio-toggle:checked ~ p {
+  display: block;
+  overflow: visible;
+}
+
+.hs-hero__more {
+  display: inline-block;
+  width: max-content;
+  margin-top: 4px;
+  cursor: default;
+}
+
+.hs-hero__more-open {
+  display: none;
+}
+
+.hs-hero__bio-toggle:checked ~ .hs-hero__more .hs-hero__more-open {
+  display: inline;
+}
+
+.hs-hero__bio-toggle:checked ~ .hs-hero__more .hs-hero__more-closed {
+  display: none;
+}
+
+.hs-hero__bio-toggle:focus-visible ~ .hs-hero__more {
+  outline: none;
+  background: var(--hs-accent-tint);
+}
+
+.hs-hero__actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-top: 8px;
+  flex-wrap: wrap;
+}
+
+.hs-hero__actions .hs-button--icon {
+  width: 48px;
+  height: 48px;
+}
+
+.hs-hero__actions .hs-button--icon .hs-icon {
+  --hs-icon-size: 20px;
+}
+
+/* A pressed like toggle stays transparent with the accent glyph (k17-r3). */
+.hs-hero__actions .hs-button--flat.hs-button--on,
+.hs-hero__actions .hs-button--flat[aria-pressed='true'] {
+  background: transparent;
+  color: var(--hs-accent-text);
+}
+
+@media (max-width: 1280px) {
+  .hs-hero {
+    padding: 8px 24px 22px;
+  }
+}
+
+@media (max-width: 720px) {
+  .hs-hero {
+    flex-direction: column;
+    align-items: flex-start;
+    gap: 16px;
+    padding: 4px 18px 18px;
+  }
+
+  .hs-hero__art {
+    width: 200px;
+    height: 200px;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .hs-hero__art {
+    transition: none;
+  }
+}

package/css/components/pill.css

@@ -0,0 +1,101 @@
+/*
+ * k10 A - status pill (compact), count badge and row health indicator.
+ *
+ * Colour and glyph are the state colour on a --hs-status-tint background; in-progress
+ * states use --hs-accent-text on --hs-accent-tint, neutral states --hs-fg-muted. Every
+ * state carries a glyph and a label, never colour alone (f07). Pills are not focusable;
+ * glyphs are aria-hidden and the visible label is the accessible text.
+ */
+
+.hs-pill {
+  --c: var(--hs-fg-muted);
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  height: 22px;
+  padding: 0 9px 0 7px;
+  border-radius: var(--hs-radius-full);
+  white-space: nowrap;
+  font: 600 12px var(--hs-font-body);
+  font-variant-numeric: tabular-nums;
+  color: var(--c);
+  background: color-mix(in srgb, var(--c) var(--hs-status-tint), transparent);
+}
+
+.hs-pill__glyph {
+  --hs-icon-size: 12px;
+}
+
+.hs-pill--success {
+  --c: var(--hs-success);
+}
+
+.hs-pill--warning {
+  --c: var(--hs-warning);
+}
+
+.hs-pill--error {
+  --c: var(--hs-error);
+}
+
+.hs-pill--neutral {
+  --c: var(--hs-fg-muted);
+}
+
+/* In-progress states: Searching sources, Downloading N%, Prefetching N%, Uploading N%,
+ * Processing. */
+.hs-pill--accent {
+  color: var(--hs-accent-text);
+  background: var(--hs-accent-tint);
+}
+
+/* Count badge: "items" is added as visually hidden text in the markup. */
+.hs-count-badge {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 20px;
+  height: 20px;
+  padding: 0 6px;
+  box-sizing: border-box;
+  border-radius: 10px;
+  background: var(--hs-accent-bg);
+  color: var(--hs-accent-fg);
+  font: 600 12px var(--hs-font-body);
+  font-variant-numeric: tabular-nums;
+}
+
+/* Row health indicator: a 22 px tinted circle; role="img" with an aria-label, and the
+ * label repeated in a tooltip on hover and row focus. */
+.hs-health-indicator {
+  --c: var(--hs-fg-muted);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: none;
+  width: 22px;
+  height: 22px;
+  border-radius: 50%;
+  color: var(--c);
+  background: color-mix(in srgb, var(--c) var(--hs-status-tint), transparent);
+}
+
+.hs-health-indicator .hs-icon {
+  --hs-icon-size: 14px;
+}
+
+.hs-health-indicator--success {
+  --c: var(--hs-success);
+}
+
+.hs-health-indicator--warning {
+  --c: var(--hs-warning);
+}
+
+.hs-health-indicator--error {
+  --c: var(--hs-error);
+}
+
+.hs-health-indicator--neutral {
+  --c: var(--hs-fg-muted);
+}