@adamarant/designsystem 0.11.2

package/src/components/spinner.css

@@ -0,0 +1,60 @@
+/* ==========================================================================
+   Component: Spinner
+   CSS-only loading spinner using border animation.
+
+   Usage:
+     <span class="ds-spinner"></span>
+     <span class="ds-spinner ds-spinner--sm"></span>
+     <span class="ds-spinner ds-spinner--muted"></span>
+
+   Sizes:
+     .ds-spinner--sm  — 1.25rem (20px)
+     (default)        — 1.5rem (24px)
+     .ds-spinner--lg  — 2rem (32px)
+
+   Variants:
+     (default)          — Border + interactive top
+     .ds-spinner--muted — Inverted colors (for dark backgrounds)
+     .ds-spinner--light — Light colors (for inverted/colored backgrounds)
+   ========================================================================== */
+
+.ds-spinner {
+  display: inline-block;
+  width: 1.5rem;
+  height: 1.5rem;
+  border: 2px solid var(--ds-color-border);
+  border-top-color: var(--ds-color-interactive);
+  border-radius: var(--ds-radius-full);
+  animation: ds-spin 0.8s linear infinite;
+
+  /* Sizes */
+  &--sm {
+    width: 1rem;
+    height: 1rem;
+  }
+
+  &--md {
+    width: 1.25rem;
+    height: 1.25rem;
+  }
+
+  &--lg {
+    width: 2rem;
+    height: 2rem;
+  }
+
+  /* Color variants */
+  &--muted {
+    border-color: var(--ds-color-inverted);
+    border-top-color: transparent;
+  }
+
+  &--light {
+    border-color: var(--ds-color-on-inverted);
+    border-top-color: transparent;
+  }
+}
+
+@keyframes ds-spin {
+  to { transform: rotate(360deg); }
+}

package/src/components/star-rating.css

@@ -0,0 +1,121 @@
+/* ==========================================================================
+   Component: Star Rating
+   Display or input star ratings. CSS-only styling with SVG/icon stars.
+
+   ARIA requirements (consumer responsibility):
+   - Display: aria-label="Rating: 4 out of 5"
+   - Input: role="radiogroup", aria-label="Rate this item"
+   - Each star input: role="radio", aria-checked="true|false", aria-label="[N] stars"
+   - Keyboard: ArrowLeft/Right to change rating
+
+   Usage (display):
+     <div class="ds-star-rating" aria-label="Rating: 4 out of 5">
+       <span class="ds-star-rating__star ds-star-rating__star--filled">★</span>
+       <span class="ds-star-rating__star ds-star-rating__star--filled">★</span>
+       <span class="ds-star-rating__star ds-star-rating__star--filled">★</span>
+       <span class="ds-star-rating__star ds-star-rating__star--filled">★</span>
+       <span class="ds-star-rating__star">★</span>
+     </div>
+
+   Usage (input):
+     <div class="ds-star-rating ds-star-rating--interactive" role="radiogroup">
+       <button class="ds-star-rating__star ds-star-rating__star--filled" role="radio">★</button>
+       ...
+     </div>
+
+   Modifiers:
+     .ds-star-rating--interactive   — Hoverable stars for input
+     .ds-star-rating--sm            — Smaller stars
+     .ds-star-rating--lg            — Larger stars
+   ========================================================================== */
+
+.ds-star-rating {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--ds-space-0-5);
+
+  &__star {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 1.5rem;
+    height: 1.5rem;
+    color: var(--ds-color-border);
+    font-size: var(--ds-text-lg);
+    line-height: 1;
+    border: none;
+    background: transparent;
+    padding: 0;
+    transition: color var(--ds-duration-fast) var(--ds-ease-default);
+
+    &--filled {
+      color: var(--ds-color-warning);
+    }
+
+    &--half {
+      position: relative;
+      color: var(--ds-color-border);
+
+      &::before {
+        content: "★";
+        position: absolute;
+        inset-inline-start: 0;
+        width: 50%;
+        overflow: hidden;
+        color: var(--ds-color-warning);
+      }
+    }
+  }
+
+  /* --- Interactive (input mode) --- */
+  &--interactive &__star {
+    cursor: pointer;
+
+    &:hover {
+      color: var(--ds-color-warning);
+      transform: scale(1.15);
+    }
+
+    &:focus-visible {
+      outline: none;
+      box-shadow: 0 0 0 var(--ds-ring-width) var(--ds-ring-color);
+      border-radius: var(--ds-radius-sm);
+      scroll-margin-block: var(--ds-space-16, 4rem);
+    }
+  }
+
+  /* --- Small --- */
+  &--sm &__star {
+    width: 1rem;
+    height: 1rem;
+    font-size: var(--ds-text-sm);
+  }
+
+  &--sm {
+    gap: 0;
+  }
+
+  /* --- Large --- */
+  &--lg &__star {
+    width: 2rem;
+    height: 2rem;
+    font-size: var(--ds-text-2xl);
+  }
+
+  &--lg {
+    gap: var(--ds-space-1);
+  }
+
+  /* --- Value text --- */
+  &__value {
+    margin-inline-start: var(--ds-space-1-5);
+    font-size: var(--ds-text-sm);
+    font-weight: var(--ds-weight-medium);
+    color: var(--ds-color-text);
+  }
+
+  &__count {
+    font-size: var(--ds-text-xs);
+    color: var(--ds-color-text-tertiary);
+  }
+}

package/src/components/stat-card.css

@@ -0,0 +1,44 @@
+/* ==========================================================================
+   Component: Stat Card
+   Compact metric display with label, value, detail, and optional icon.
+   ========================================================================== */
+
+.ds-stat-card {
+  display: flex;
+  flex-direction: column;
+  gap: var(--ds-space-1);
+  background-color: var(--ds-color-surface);
+  border: 1px solid var(--ds-color-border);
+  border-radius: var(--ds-radius-xl);
+  padding: var(--ds-space-5);
+
+  &__label {
+    font-size: var(--ds-text-sm);
+    color: var(--ds-color-text-tertiary);
+  }
+
+  &__value {
+    font-family: var(--ds-font-display);
+    font-weight: var(--ds-font-display-weight);
+    font-size: var(--ds-text-2xl);
+    color: var(--ds-color-text);
+    margin-block-start: var(--ds-space-1);
+  }
+
+  &__detail {
+    font-size: var(--ds-text-xs);
+    color: var(--ds-color-text-tertiary);
+    margin-block-start: var(--ds-space-0-5);
+  }
+
+  &__icon {
+    width: 2.5rem;
+    height: 2.5rem;
+    border-radius: var(--ds-radius-xl);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background-color: var(--ds-color-surface-muted);
+    color: var(--ds-color-text-secondary);
+  }
+}

package/src/components/table.css

@@ -0,0 +1,359 @@
+/* ==========================================================================
+   Component: Table
+   Data table with sorting, selection, sticky headers, striping, and
+   responsive stacking. Composes with ds-pagination, ds-skeleton, ds-checkbox,
+   ds-icon-btn, and ds-empty-state for a full data-table experience.
+
+   ARIA requirements (consumer responsibility):
+   - Use <table> with role="grid" for interactive tables
+   - Sort headers: <th aria-sort="ascending|descending|none"> + <button> inside
+   - Select-all checkbox: aria-label="Select all rows"
+   - Row checkbox: aria-label="Select row [identifier]"
+   - Expandable rows: aria-expanded="true|false" on trigger
+
+   Usage:
+     <div class="ds-table-wrapper">
+       <table class="ds-table">
+         <thead>
+           <tr>
+             <th class="ds-table__cell--checkbox"><input class="ds-checkbox" /></th>
+             <th><button class="ds-table__sort ds-table__sort--asc">Name</button></th>
+             <th>Email</th>
+             <th class="ds-table__cell--truncate"><span>City</span></th>
+             <th class="ds-table__cell--shrink">Actions</th>
+           </tr>
+         </thead>
+         <tbody>
+           <tr class="ds-table__row--selected">
+             <td class="ds-table__cell--checkbox"><input class="ds-checkbox" /></td>
+             <td>John</td>
+             <td>john@example.com</td>
+             <td class="ds-table__cell--shrink">...</td>
+           </tr>
+         </tbody>
+       </table>
+     </div>
+
+   Modifiers:
+     .ds-table--compact     — Reduced padding
+     .ds-table--dense       — Even more compact (minimal padding)
+     .ds-table--striped     — Alternating row backgrounds
+     .ds-table--bordered    — Cell borders
+     .ds-table--sticky-header — Sticky thead with backdrop blur
+     .ds-table--hoverable   — Explicit hover class (hover is on by default)
+     .ds-table--no-hover    — Disable row hover
+   ========================================================================== */
+
+.ds-table {
+  width: 100%;
+  text-align: start;
+  font-size: var(--ds-text-sm);
+  border-collapse: collapse;
+}
+
+/* --- Header cells --- */
+.ds-table th {
+  padding: var(--ds-space-3) var(--ds-space-4);
+  font-weight: var(--ds-weight-medium);
+  font-size: var(--ds-text-sm);
+  color: var(--ds-color-text-tertiary);
+  text-transform: uppercase;
+  letter-spacing: var(--ds-tracking-wide);
+  border-block-end: 1px solid var(--ds-color-border);
+  text-align: start;
+  white-space: nowrap;
+}
+
+/* --- Body cells --- */
+.ds-table td {
+  padding: var(--ds-space-3) var(--ds-space-4);
+  color: var(--ds-color-text);
+  border-block-end: 1px solid var(--ds-color-border-subtle);
+  vertical-align: middle;
+}
+
+/* --- Row hover (default on) --- */
+.ds-table tbody tr {
+  transition: background-color var(--ds-duration-fast) var(--ds-ease-default);
+}
+
+.ds-table tbody tr:hover {
+  background-color: var(--ds-color-overlay-subtle);
+}
+
+.ds-table--no-hover tbody tr:hover {
+  background-color: transparent;
+}
+
+/* --- Selected row --- */
+.ds-table__row--selected {
+  background-color: var(--ds-color-overlay-subtle);
+}
+
+.ds-table__row--selected td {
+  border-block-end-color: var(--ds-color-border);
+}
+
+/* --- Sort header button --- */
+.ds-table__sort {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--ds-space-1);
+  padding: 0;
+  border: none;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  text-transform: inherit;
+  letter-spacing: inherit;
+  cursor: pointer;
+  white-space: nowrap;
+  transition: color var(--ds-duration-fast) var(--ds-ease-default);
+}
+
+.ds-table__sort:hover {
+  color: var(--ds-color-text-secondary);
+}
+
+.ds-table__sort:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 var(--ds-ring-width) var(--ds-ring-color);
+  border-radius: var(--ds-radius-sm);
+  scroll-margin-block: var(--ds-space-16, 4rem);
+}
+
+/* Sort indicator — neutral chevron via ::after */
+.ds-table__sort::after {
+  content: "";
+  display: inline-block;
+  width: 0;
+  height: 0;
+  border-inline-start: 4px solid transparent;
+  border-inline-end: 4px solid transparent;
+  border-block-start: 4px solid currentColor;
+  opacity: 0.3;
+  transition: opacity var(--ds-duration-fast) var(--ds-ease-default);
+}
+
+.ds-table__sort:hover::after {
+  opacity: 0.6;
+}
+
+/* Ascending */
+.ds-table__sort--asc {
+  color: var(--ds-color-text);
+}
+
+.ds-table__sort--asc::after {
+  border-block-start: none;
+  border-block-end: 4px solid currentColor;
+  opacity: 1;
+}
+
+/* Descending */
+.ds-table__sort--desc {
+  color: var(--ds-color-text);
+}
+
+.ds-table__sort--desc::after {
+  border-block-start: 4px solid currentColor;
+  border-block-end: none;
+  opacity: 1;
+}
+
+/* --- Special cell types --- */
+
+/* Truncate cell: long text with ellipsis (city names, categories, etc.)
+   Usage: <td class="ds-table__cell--truncate"><span>Long text here</span></td>
+   The child element (span, a, div) gets the truncation. This works with
+   table-layout: auto because max-width applies to the inner block, not the td.
+   Default max-width is 12rem. Override per cell via --_cell-max. */
+.ds-table__cell--truncate {
+  --_cell-max: 12rem;
+}
+
+.ds-table__cell--truncate > * {
+  display: block;
+  max-width: var(--_cell-max);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* Primary cell: the main identifier column (title, name). Gets min-width
+   so it never compresses when other columns claim space.
+   Default min-width is 16rem. Override per cell via --_cell-min. */
+.ds-table__cell--primary {
+  --_cell-min: 16rem;
+  min-width: var(--_cell-min);
+}
+
+/* Shrink cell: action buttons, icons, checkboxes */
+.ds-table__cell--shrink {
+  width: 1%;
+  white-space: nowrap;
+}
+
+/* Number cell: right-aligned with tabular numbers */
+.ds-table__cell--number {
+  text-align: end;
+  font-variant-numeric: tabular-nums;
+  font-feature-settings: "tnum" 1;
+}
+
+/* Checkbox cell: narrow centered */
+.ds-table__cell--checkbox {
+  width: 1%;
+  padding-inline-end: 0;
+  vertical-align: middle;
+}
+
+/* --- Empty state row --- */
+.ds-table__empty {
+  text-align: center;
+  padding: var(--ds-space-12) var(--ds-space-4);
+  color: var(--ds-color-text-tertiary);
+}
+
+.ds-table__empty td {
+  border-block-end: none;
+}
+
+/* --- Loading skeleton rows --- */
+.ds-table__loading td {
+  color: transparent;
+  position: relative;
+}
+
+.ds-table__loading td::after {
+  content: "";
+  position: absolute;
+  inset-block-start: 50%;
+  inset-inline-start: var(--ds-space-4);
+  inset-inline-end: var(--ds-space-4);
+  height: 0.75rem;
+  transform: translateY(-50%);
+  background: var(--ds-color-surface-muted);
+  border-radius: var(--ds-radius-sm);
+  animation: ds-table-skeleton-pulse 1.5s ease-in-out infinite;
+}
+
+@keyframes ds-table-skeleton-pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.4; }
+}
+
+/* --- Compact modifier --- */
+.ds-table--compact th,
+.ds-table--compact td {
+  padding: var(--ds-space-2) var(--ds-space-3);
+}
+
+/* --- Dense modifier --- */
+.ds-table--dense th,
+.ds-table--dense td {
+  padding: var(--ds-space-1-5) var(--ds-space-2);
+  font-size: var(--ds-text-xs);
+}
+
+/* --- Striped modifier --- */
+.ds-table--striped tbody tr:nth-child(even) {
+  background-color: var(--ds-color-overlay-subtle);
+}
+
+.ds-table--striped tbody tr:hover {
+  background-color: var(--ds-color-surface-hover);
+}
+
+/* --- Bordered modifier --- */
+.ds-table--bordered th,
+.ds-table--bordered td {
+  border: 1px solid var(--ds-color-border-subtle);
+}
+
+.ds-table--bordered th {
+  border-block-end-color: var(--ds-color-border);
+}
+
+/* --- Sticky header modifier --- */
+.ds-table--sticky-header thead {
+  position: sticky;
+  inset-block-start: 0;
+  z-index: var(--ds-z-sticky);
+}
+
+.ds-table--sticky-header th {
+  background-color: var(--ds-color-surface);
+  backdrop-filter: blur(var(--ds-blur-md));
+  -webkit-backdrop-filter: blur(var(--ds-blur-md));
+}
+
+/* --- Table wrapper --- */
+.ds-table-wrapper {
+  overflow-x: auto;
+  border: 1px solid var(--ds-color-border);
+  border-radius: var(--ds-radius-xl);
+  background-color: var(--ds-color-surface);
+}
+
+.ds-table-wrapper .ds-table {
+  margin: 0;
+}
+
+/* Remove outer borders when inside wrapper (wrapper provides them) */
+.ds-table-wrapper .ds-table tr:last-child td {
+  border-block-end: none;
+}
+
+/* --- Table footer (pagination area) --- */
+.ds-table-footer {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--ds-space-4);
+  padding: var(--ds-space-3) var(--ds-space-4);
+  border-block-start: 1px solid var(--ds-color-border);
+  font-size: var(--ds-text-sm);
+  color: var(--ds-color-text-tertiary);
+}
+
+/* --- Responsive: card-style stacking on mobile --- */
+@media (max-width: 767px) {
+  .ds-table--stack thead {
+    display: none;
+  }
+
+  .ds-table--stack tbody tr {
+    display: flex;
+    flex-direction: column;
+    gap: var(--ds-space-1);
+    padding: var(--ds-space-3) var(--ds-space-4);
+    border-block-end: 1px solid var(--ds-color-border);
+  }
+
+  .ds-table--stack td {
+    display: flex;
+    align-items: baseline;
+    gap: var(--ds-space-2);
+    padding: 0;
+    border: none;
+  }
+
+  .ds-table--stack td::before {
+    content: attr(data-label);
+    flex-shrink: 0;
+    min-width: 8rem;
+    font-size: var(--ds-text-xs);
+    font-weight: var(--ds-weight-medium);
+    color: var(--ds-color-text-tertiary);
+    text-transform: uppercase;
+    letter-spacing: var(--ds-tracking-wide);
+  }
+}
+
+/* --- Reduced motion --- */
+@media (prefers-reduced-motion: reduce) {
+  .ds-table__loading td::after {
+    animation: none;
+  }
+}