@gemboss/website-ui 0.5.0 → 0.7.0

package/css/forms.css

@@ -0,0 +1,154 @@
+/* forms (0.6.0, gap #28): a field (label, control, error, hint), the controls, a group of choices, the inline row and
+   the form stack. A public site asks as little as it can: one field beats a form, and a form keeps two or three fields
+   (AGENTS.md section 5). The look is the dashboard's field family (@gemboss/ui gemboss-field, ui-select, ui-textarea,
+   ui-check, ui-help, ui-error) at the website's sizes: as tall as a button (40px, 44px on touch), 16px words (a phone
+   does not zoom the page), the action radius of the site's profile, and a 1px border that reaches 3:1
+   (--gw-line-control). The page owns validation: it sets aria-invalid="true" and writes the message; the kit draws it. */
+
+/* a field: the label above the control, the error and then the hint under it, 8px apart */
+.gw-field { display: grid; gap: 8px; min-width: 0; }
+.gw-field__label { display: block; color: var(--gw-ink); font-size: 14px; font-weight: 600; line-height: 1.5; }
+/* two classes, so a context that styles its paragraphs (the footer's brand block) does not move or recolour them */
+:is(.gw-field, .gw-choices) > :is(.gw-field__hint, .gw-field__error) { margin: 0; font-size: 14px; font-weight: 400; line-height: 1.5; }
+:is(.gw-field, .gw-choices) > .gw-field__hint { color: var(--gw-muted); }
+/* the error: an icon and words, in the danger colour; never the colour alone. Empty, it takes no room, so a page can
+   keep it in the markup (named by aria-describedby) and fill it when the visitor sends the form. */
+:is(.gw-field, .gw-choices) > .gw-field__error { display: flex; gap: 6px; color: var(--gw-danger); font-weight: 500; }
+:is(.gw-field, .gw-choices) > .gw-field__error:empty { display: none; }
+.gw-field__error::before {
+  content: "";
+  flex: none;
+  width: 16px;
+  height: 16px;
+  margin-top: 2px;
+  margin-top: calc((1lh - 16px) / 2);
+  background: currentColor;
+  -webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M10 2a8 8 0 1 0 0 16 8 8 0 0 0 0-16Zm-.75 4h1.5v5.5h-1.5V6Zm.75 9a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z'/%3E%3C/svg%3E") center / 16px no-repeat;
+  mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M10 2a8 8 0 1 0 0 16 8 8 0 0 0 0-16Zm-.75 4h1.5v5.5h-1.5V6Zm.75 9a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z'/%3E%3C/svg%3E") center / 16px no-repeat;
+}
+
+/* the controls: one box for a line of text, a choice from a list and a few lines. Full width of their field. */
+.gw-input,
+.gw-select,
+.gw-textarea {
+  display: block;
+  width: 100%;
+  min-width: 0;
+  height: var(--gw-button-height);
+  margin: 0;
+  padding: 0 12px;
+  border: 1px solid var(--gw-line-control);
+  border-radius: var(--gw-radius-action);
+  background-color: var(--gw-surface);
+  color: var(--gw-ink);
+  font-size: 16px;
+  line-height: 1.5;
+  -webkit-appearance: none;
+  appearance: none;
+}
+:is(.gw-input, .gw-textarea)::placeholder { color: var(--gw-muted); opacity: 1; }
+/* a list: the caret is drawn with the muted ink (two gradients, so it follows dark mode), with room for it */
+.gw-select {
+  padding-right: 40px;
+  background-image: linear-gradient(45deg, transparent 50%, var(--gw-muted) 50%), linear-gradient(135deg, var(--gw-muted) 50%, transparent 50%);
+  background-position: calc(100% - 20px) 50%, calc(100% - 15px) 50%;
+  background-size: 5px 5px;
+  background-repeat: no-repeat;
+  cursor: pointer;
+}
+.gw-textarea { height: auto; min-height: 96px; padding-block: 8px; resize: vertical; }
+/* the states, in this order: hover, focus, read-only, invalid, disabled. Focus is the kit's accent ring. */
+:is(.gw-input, .gw-select, .gw-textarea):hover { border-color: var(--gw-muted); }
+:is(.gw-input, .gw-select, .gw-textarea):focus-visible { border-color: var(--gw-ink); outline: 2px solid var(--gw-accent); outline-offset: 1px; }
+/* read-only: still focusable and readable, visibly not editable (the dashboard's) */
+:is(.gw-input, .gw-textarea)[readonly] { border-color: var(--gw-line-strong); background-color: var(--gw-bg-soft); cursor: default; }
+:is(.gw-input, .gw-select, .gw-textarea)[aria-invalid="true"] { border-color: var(--gw-danger); background-color: var(--gw-danger-soft); }
+:is(.gw-input, .gw-select, .gw-textarea):disabled { opacity: 0.48; cursor: not-allowed; }
+
+/* a group of choices: a <fieldset> whose <legend> is the question, one choice per row */
+.gw-choices { min-width: 0; margin: 0; padding: 0; border: 0; }
+.gw-choices > legend { margin-bottom: 4px; padding: 0; }
+.gw-choices > :is(.gw-check, .gw-radio) { display: flex; }
+.gw-choices > :is(.gw-field__hint, .gw-field__error) { margin-top: 4px; }
+
+/* a checkbox or a radio: the <label> is the target (32px, 44px on touch), the box sits on the first line of words */
+.gw-check,
+.gw-radio {
+  display: inline-flex;
+  align-items: flex-start;
+  gap: 8px;
+  max-width: 100%;
+  padding-block: 4px;
+  color: var(--gw-ink);
+  font-size: 16px;
+  line-height: 1.5;
+  overflow-wrap: break-word;
+  cursor: pointer;
+}
+:is(.gw-check, .gw-radio) > :not(input) { min-width: 0; }
+:is(.gw-check, .gw-radio) > input {
+  display: inline-grid;
+  flex: none;
+  place-content: center;
+  width: 18px;
+  height: 18px;
+  margin: 3px 0 0;
+  border: 1px solid var(--gw-line-control);
+  border-radius: var(--gw-radius-4);
+  background: var(--gw-surface);
+  -webkit-appearance: none;
+  appearance: none;
+  cursor: inherit;
+}
+.gw-radio > input { border-radius: var(--gw-radius-chip); }
+:is(.gw-check, .gw-radio):hover > input { border-color: var(--gw-muted); }
+/* chosen: the accent, as every check mark of the kit; the mark in the words-on-accent colour */
+.gw-check > input:checked { border-color: var(--gw-accent); background: var(--gw-accent); }
+.gw-check > input:checked::before {
+  content: "";
+  width: 14px;
+  height: 14px;
+  background: var(--gw-on-accent);
+  -webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M3.5 8.4l2.9 2.8L12.5 5' fill='none' stroke='%23000' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") center / 14px no-repeat;
+  mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M3.5 8.4l2.9 2.8L12.5 5' fill='none' stroke='%23000' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") center / 14px no-repeat;
+}
+.gw-radio > input:checked { border: 5px solid var(--gw-accent); }
+:is(.gw-check, .gw-radio) > input[aria-invalid="true"]:not(:checked) { border-color: var(--gw-danger); }
+:is(.gw-check, .gw-radio):has(> input:disabled) { opacity: 0.48; cursor: not-allowed; }
+/* a filter's count: a small pill at the end of the row, the neutral badge's colours */
+.gw-check__count {
+  flex: none;
+  min-width: 24px;
+  margin: 1px 0 0 auto;
+  padding: 2px 8px;
+  border-radius: var(--gw-radius-chip);
+  background: color-mix(in srgb, var(--gw-ink) 8%, transparent);
+  color: var(--gw-ink-2);
+  font-size: 12px;
+  font-weight: 500;
+  text-align: center;
+  font-variant-numeric: tabular-nums;
+}
+
+/* the inline row: one field and its button (a newsletter, "get the guide"). One line from 480px, the field taking the
+   room; below 480px, and in a box too narrow for both, the field and the button each take a full line. */
+.gw-form-inline { display: flex; flex-wrap: wrap; gap: 8px; }
+.gw-form-inline > :not(.gw-btn) { flex: 999 1 160px; min-width: 0; }
+.gw-form-inline > .gw-btn { flex: 1 0 auto; }
+@media (max-width: 479px) {
+  .gw-form-inline > :not(.gw-btn) { flex-basis: 100%; }
+}
+
+/* the form stack: fields 24px apart, the actions 32px below the last one, 560px at most (a field's width hints at its
+   answer: no field runs across a wide screen) */
+.gw-form { display: grid; gap: 24px; max-width: 560px; }
+/* the gap is the rhythm, also when the form is the card itself (a card spaces its own children otherwise) */
+.gw-form > * { margin: 0; }
+.gw-form > :is(.gw-actions, .gw-btn) { margin-top: 8px; }
+.gw-form > .gw-btn { justify-self: start; }
+
+/* touch: every control is at least 44px tall, a choice's row too */
+@media (max-width: 768px), (pointer: coarse) {
+  .gw-input, .gw-select { height: var(--gw-tap-min); }
+  .gw-check, .gw-radio { padding-block: 10px; }
+}

package/css/ratings.css

@@ -0,0 +1,78 @@
+/* ratings (0.6.0, gap #56): stars, the testimonial wall and the rating badge. Every rating and every testimonial
+   links to the page it comes from, and says only what that page says (AGENTS.md section 6); `check` warns about one
+   without its link (rating-source). */
+
+/* stars: a value from 0 to 5 (style="--gw-stars: 4.9") drawn as five 16px stars, the last one cut where the value
+   ends. A screen reader hears the value in words: role="img" and aria-label="4.9 out of 5" (the drawing itself is a
+   background, nothing to read). Ink on the strong hairline: a rating is proof, not a state or an action. */
+.gw-stars {
+  display: inline-block;
+  flex: none;
+  width: 80px;
+  height: 16px;
+  vertical-align: middle;
+  background: linear-gradient(90deg, var(--gw-ink) calc(clamp(0, var(--gw-stars, 0), 5) * 20%), var(--gw-line-strong) 0);
+  -webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M8 1.6L9.8 6.4L14.8 6.6L10.9 9.7L12.2 14.6L8 11.8L3.8 14.6L5.1 9.7L1.2 6.6L6.2 6.4Z' stroke='%23000' stroke-width='1' stroke-linejoin='round'/%3E%3C/svg%3E") 0 0 / 16px 16px repeat-x;
+  mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M8 1.6L9.8 6.4L14.8 6.6L10.9 9.7L12.2 14.6L8 11.8L3.8 14.6L5.1 9.7L1.2 6.6L6.2 6.4Z' stroke='%23000' stroke-width='1' stroke-linejoin='round'/%3E%3C/svg%3E") 0 0 / 16px 16px repeat-x;
+}
+/* a forced-colours screen drops backgrounds: draw the stars in its own text colours */
+@media (forced-colors: active) {
+  .gw-stars { forced-color-adjust: none; background: linear-gradient(90deg, CanvasText calc(clamp(0, var(--gw-stars, 0), 5) * 20%), GrayText 0); }
+}
+
+/* the wall: short quotes in cards, one column on phones, two from 768px, three from 1080px. No masonry: the cards of
+   a row share its height, and each card's byline sits at its foot. */
+.gw-testimonials {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  gap: 16px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+.gw-testimonials > li { display: flex; min-width: 0; }
+@media (min-width: 768px) { .gw-testimonials { grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 24px; } }
+@media (min-width: 1080px) { .gw-testimonials { grid-template-columns: repeat(3, minmax(0, 1fr)); } }
+/* a quote card (with .gw-card): stars, the reviewer's own words, who wrote them and where */
+.gw-testimonial { display: flex; flex-direction: column; gap: 16px; width: 100%; margin: 0; }
+.gw-testimonial > * { margin: 0; }
+.gw-testimonial__quote,
+.gw-testimonial__quote p { color: var(--gw-ink); font-size: 16px; line-height: 1.6; }
+.gw-testimonial__quote > * + * { margin-top: 8px; }
+.gw-testimonial > .gw-testimonial__by { display: flex; align-items: center; gap: 12px; margin-top: auto; color: var(--gw-muted); font-size: 14px; line-height: 1.5; }
+.gw-testimonial__by b { display: block; color: var(--gw-ink); font-weight: 600; }
+.gw-testimonial__by > :not(img) { min-width: 0; }
+.gw-testimonial__avatar { flex: none; width: 40px; height: 40px; border-radius: var(--gw-radius-chip); background: var(--gw-bg-soft); object-fit: cover; }
+
+/* the rating badge: one link to the store's review page, with the store's mark, the score, the stars and the count.
+   A small card that sits; the border darkens on hover, as a linked card's. */
+.gw-rating-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 12px;
+  max-width: 100%;
+  padding: 8px 16px 8px 8px;
+  border: 1px solid var(--gw-line);
+  border-radius: var(--gw-radius-card);
+  background: var(--gw-surface);
+  color: var(--gw-ink);
+  font-size: 13px;
+  line-height: 1.4;
+  vertical-align: middle;
+}
+a.gw-rating-badge:hover { border-color: var(--gw-line-strong); }
+.gw-rating-badge__icon {
+  display: inline-flex;
+  flex: none;
+  align-items: center;
+  justify-content: center;
+  width: 40px;
+  height: 40px;
+  border-radius: var(--gw-radius-action);
+  background: var(--gw-bg-soft);
+  color: var(--gw-ink);
+}
+.gw-rating-badge__icon :is(svg, img) { width: 24px; height: 24px; }
+.gw-rating-badge__body { display: grid; gap: 2px; min-width: 0; }
+.gw-rating-badge__score { display: flex; align-items: center; gap: 8px; color: var(--gw-ink); font-size: 16px; font-weight: 600; font-variant-numeric: tabular-nums; }
+.gw-rating-badge__count { color: var(--gw-muted); }

package/css/tokens.css

@@ -15,6 +15,7 @@
   --gw-text-30: 30px;
   --gw-display-h1: clamp(40px, 4.6vw, 68px);
   --gw-display-h2: clamp(32px, 3.4vw, 52px);
+  --gw-display-wordmark: clamp(40px, 9vw, 128px);
   --gw-display-weight: 600;
   --gw-display-tracking: -0.03em;
   --gw-heading-weight: 650;
@@ -89,6 +90,7 @@
   --gw-muted: #686b71;
   --gw-line: #e5e7ea;
   --gw-line-strong: #d5d8dd;
+  --gw-line-control: #85888e;
   --gw-action: #1b1c1e;
   --gw-action-hover: #000000;
   --gw-on-action: #ffffff;
@@ -100,6 +102,9 @@
   --gw-success-soft: #e3f1df;
   --gw-warning: #9a6700;
   --gw-warning-soft: #fbf1dc;
+  --gw-danger: #b42318;
+  --gw-danger-soft: #fff0e9;
+  --gw-on-danger: #ffffff;
   --gw-night: #0c0e14;
   --gw-night-2: #141722;
   --gw-on-night: #e3e4e8;
@@ -116,6 +121,7 @@
     --gw-muted: #9a9ca6;
     --gw-line: #2a2b33;
     --gw-line-strong: #383944;
+    --gw-line-control: #6a6d78;
     --gw-action: #f2f3f5;
     --gw-action-hover: #ffffff;
     --gw-on-action: #0d0d12;
@@ -127,6 +133,9 @@
     --gw-success-soft: #132a22;
     --gw-warning: #e0b341;
     --gw-warning-soft: #2b2410;
+    --gw-danger: #ff6b5a;
+    --gw-danger-soft: #2e1714;
+    --gw-on-danger: #0d0d12;
     --gw-night: #0a0b10;
     --gw-night-2: #12141c;
     --gw-on-night: #e3e4e8;
@@ -143,6 +152,7 @@
   --gw-muted: #9a9ca6;
   --gw-line: #2a2b33;
   --gw-line-strong: #383944;
+  --gw-line-control: #6a6d78;
   --gw-action: #f2f3f5;
   --gw-action-hover: #ffffff;
   --gw-on-action: #0d0d12;
@@ -154,6 +164,9 @@
   --gw-success-soft: #132a22;
   --gw-warning: #e0b341;
   --gw-warning-soft: #2b2410;
+  --gw-danger: #ff6b5a;
+  --gw-danger-soft: #2e1714;
+  --gw-on-danger: #0d0d12;
   --gw-night: #0a0b10;
   --gw-night-2: #12141c;
   --gw-on-night: #e3e4e8;
@@ -169,6 +182,7 @@
   --gw-muted: #686b71;
   --gw-line: #e5e7ea;
   --gw-line-strong: #d5d8dd;
+  --gw-line-control: #85888e;
   --gw-action: #1b1c1e;
   --gw-action-hover: #000000;
   --gw-on-action: #ffffff;
@@ -180,6 +194,9 @@
   --gw-success-soft: #e3f1df;
   --gw-warning: #9a6700;
   --gw-warning-soft: #fbf1dc;
+  --gw-danger: #b42318;
+  --gw-danger-soft: #fff0e9;
+  --gw-on-danger: #ffffff;
   --gw-night: #0c0e14;
   --gw-night-2: #141722;
   --gw-on-night: #e3e4e8;
@@ -196,6 +213,7 @@
   --gw-muted: #9a9ca6;
   --gw-line: #2a2b33;
   --gw-line-strong: #383944;
+  --gw-line-control: #6a6d78;
   --gw-action: #f2f3f5;
   --gw-action-hover: #ffffff;
   --gw-on-action: #0d0d12;
@@ -207,6 +225,9 @@
   --gw-success-soft: #132a22;
   --gw-warning: #e0b341;
   --gw-warning-soft: #2b2410;
+  --gw-danger: #ff6b5a;
+  --gw-danger-soft: #2e1714;
+  --gw-on-danger: #0d0d12;
 }
 /* action profile "accent": data-gw-action="accent" on <html>. In night bands too, where the dark palette applies. */
 :root[data-gw-action="accent"],

package/demo/assets/avatar-sample.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" width="48" height="48"><rect width="48" height="48" fill="#e5e7ea"/><circle cx="24" cy="19" r="8" fill="#9a9ca6"/><path d="M9 44c1.6-8.4 7.8-13 15-13s13.4 4.6 15 13z" fill="#9a9ca6"/></svg>