@adamarant/designsystem 0.11.2

package/src/components/tabs.css

@@ -0,0 +1,215 @@
+/* ==========================================================================
+   Component: Tabs
+   Horizontal/vertical tab navigation with pill, small, and full-width variants.
+
+   ARIA requirements (consumer responsibility):
+   - Tab list: role="tablist", aria-label="[description]"
+   - Tab: role="tab", aria-selected="true|false", aria-controls="[panel-id]"
+   - Tab panel: role="tabpanel", id matching aria-controls, aria-labelledby="[tab-id]"
+   - Keyboard: ArrowLeft/Right (horizontal) or ArrowUp/Down (vertical) to navigate
+   - Active tab: only the active tab should be in tab order (tabindex="0"), others tabindex="-1"
+   ========================================================================== */
+
+.ds-tabs {
+  display: flex;
+  flex-direction: row;
+  align-items: stretch;
+  border-block-end: 1px solid var(--ds-color-border);
+  gap: var(--ds-space-0);
+
+  /* --- Pill variant --- */
+
+  &--pills {
+    border-block-end: none;
+    gap: var(--ds-space-1);
+    background-color: var(--ds-color-surface-muted);
+    border-radius: var(--ds-radius-lg);
+    padding: var(--ds-space-1);
+
+    & .ds-tab {
+      border-block-end: none;
+      border-radius: var(--ds-radius-md);
+      padding: var(--ds-space-1-5) var(--ds-space-3);
+      margin-block-end: 0;
+
+      @media (hover: hover) {
+        &:hover {
+          background-color: var(--ds-color-surface-hover);
+        }
+      }
+
+      &--active,
+      &--active:hover {
+        background-color: var(--ds-color-surface-elevated);
+        color: var(--ds-color-text);
+        box-shadow: var(--ds-shadow-sm);
+        border-block-end: none;
+      }
+    }
+  }
+
+  /* --- Pills flat variant (pills without container background) --- */
+
+  &--pills-flat {
+    border-block-end: none;
+    align-items: center;
+    gap: var(--ds-space-1);
+    background: none;
+    padding: 0;
+
+    & .ds-tab {
+      border-block-end: none;
+      border-radius: var(--ds-radius-md);
+      padding: var(--ds-space-1-5) var(--ds-space-3);
+      margin-block-end: 0;
+
+      @media (hover: hover) {
+        &:hover {
+          background-color: var(--ds-color-surface-hover);
+        }
+      }
+
+      &--active,
+      &--active:hover {
+        background-color: var(--ds-color-surface);
+        color: var(--ds-color-text);
+        box-shadow: var(--ds-shadow-sm);
+        border-block-end: none;
+      }
+    }
+  }
+
+  /* --- Vertical variant --- */
+
+  &--vertical {
+    flex-direction: column;
+    border-block-end: none;
+    border-inline-end: 1px solid var(--ds-color-border);
+    gap: var(--ds-space-0-5);
+
+    & .ds-tab {
+      border-block-end: none;
+      border-inline-end: 2px solid transparent;
+      padding: var(--ds-space-2) var(--ds-space-4);
+      text-align: start;
+
+      &--active {
+        border-block-end: none;
+        border-inline-end-color: var(--ds-color-interactive);
+        color: var(--ds-color-text);
+      }
+    }
+  }
+
+  /* --- Small variant --- */
+
+  &--sm .ds-tab {
+    padding: var(--ds-space-1-5) var(--ds-space-3);
+    font-size: var(--ds-text-xs);
+  }
+
+  /* --- Large variant --- */
+
+  &--lg .ds-tab {
+    padding: var(--ds-space-3) var(--ds-space-5);
+    font-size: var(--ds-text-base);
+  }
+
+  /* --- Full width variant --- */
+
+  &--full {
+    width: 100%;
+
+    & .ds-tab {
+      flex: 1;
+      justify-content: center;
+    }
+  }
+}
+
+/* --- Individual Tab --- */
+
+.ds-tab {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--ds-space-2);
+  padding: var(--ds-space-2) var(--ds-space-4);
+  font-family: var(--ds-font-sans);
+  font-size: var(--ds-text-sm);
+  font-weight: var(--ds-weight-medium);
+  line-height: var(--ds-leading-snug);
+  color: var(--ds-color-text-secondary);
+  cursor: pointer;
+  border-block-end: 2px solid transparent;
+  background: none;
+  border-block-start: none;
+  border-inline-start: none;
+  border-inline-end: none;
+  white-space: nowrap;
+  transition: all var(--ds-duration-fast) var(--ds-ease-default);
+  margin-block-end: -1px;
+
+  @media (hover: hover) {
+    &:hover {
+      color: var(--ds-color-text);
+    }
+  }
+
+  &: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);
+  }
+
+  &--active {
+    color: var(--ds-color-text);
+    border-block-end-color: var(--ds-color-interactive);
+  }
+
+  &:disabled,
+  &[aria-disabled="true"] {
+    opacity: var(--ds-opacity-disabled);
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+
+  /* --- Tab Icon --- */
+
+  &__icon {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 1rem;
+    height: 1rem;
+    flex-shrink: 0;
+    color: currentColor;
+  }
+
+  /* --- Tab Count Badge --- */
+
+  &__count {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: var(--ds-space-0) var(--ds-space-1-5);
+    font-size: var(--ds-text-xs);
+    font-weight: var(--ds-weight-medium);
+    line-height: var(--ds-leading-snug);
+    color: var(--ds-color-text-tertiary);
+    background-color: var(--ds-color-surface-muted);
+    border-radius: var(--ds-radius-full);
+    min-width: 1.25rem;
+  }
+
+  &--active &__count {
+    color: var(--ds-color-text-secondary);
+    background-color: var(--ds-color-surface-elevated);
+  }
+}
+
+/* --- Tab Panel --- */
+
+.ds-tab-panel {
+  padding-block-start: var(--ds-space-5);
+}

package/src/components/tag.css

@@ -0,0 +1,188 @@
+/* ==========================================================================
+   Tag / Chip Component
+   ==========================================================================
+   Interactive, optionally removable tag for categorisation and filtering.
+
+   ARIA requirements (consumer responsibility):
+   - Remove button: add aria-label="Remove [tag name]"
+   - Selectable tags (as <button>): use aria-pressed="true|false"
+   - Tag list: wrap in role="list" with aria-label
+
+   Usage:
+     <span class="ds-tag">Default</span>
+     <span class="ds-tag ds-tag--success">Approved</span>
+     <span class="ds-tag ds-tag--removable">
+       Removable
+       <button class="ds-tag__remove" aria-label="Remove">&times;</button>
+     </span>
+   ========================================================================== */
+
+/* ---------------------------------------------------------------------------
+   Base
+   --------------------------------------------------------------------------- */
+
+.ds-tag {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--ds-space-1);
+  padding: var(--ds-space-1) var(--ds-space-2-5, 0.625rem);
+  font-size: var(--ds-text-xs);
+  font-weight: var(--ds-weight-medium);
+  font-family: var(--ds-font-sans);
+  line-height: var(--ds-leading-none);
+  border-radius: var(--ds-radius-full);
+  background-color: var(--ds-color-surface-muted);
+  border: 1px solid var(--ds-color-border);
+  color: var(--ds-color-text-secondary);
+  white-space: nowrap;
+  transition:
+    border-color var(--ds-duration-fast) var(--ds-ease-out),
+    background-color var(--ds-duration-fast) var(--ds-ease-out);
+
+  &:hover {
+    border-color: var(--ds-color-border-hover);
+  }
+
+  /* ---------------------------------------------------------------------------
+     Color variants — subtle background + vivid text + subtle border
+     --------------------------------------------------------------------------- */
+
+  &--primary {
+    background-color: var(--ds-color-interactive-subtle, var(--ds-color-surface-muted));
+    color: var(--ds-color-interactive);
+    border-color: var(--ds-color-interactive-border, var(--ds-color-interactive));
+  }
+
+  &--success {
+    background-color: var(--ds-color-success-subtle, var(--ds-color-surface-muted));
+    color: var(--ds-color-success);
+    border-color: var(--ds-color-success-border, var(--ds-color-success));
+  }
+
+  &--warning {
+    background-color: var(--ds-color-warning-subtle, var(--ds-color-surface-muted));
+    color: var(--ds-color-warning);
+    border-color: var(--ds-color-warning-border, var(--ds-color-warning));
+  }
+
+  &--error {
+    background-color: var(--ds-color-error-subtle, var(--ds-color-surface-muted));
+    color: var(--ds-color-error);
+    border-color: var(--ds-color-error-border, var(--ds-color-error));
+  }
+
+  &--info {
+    background-color: var(--ds-color-info-subtle, var(--ds-color-surface-muted));
+    color: var(--ds-color-info);
+    border-color: var(--ds-color-info-border, var(--ds-color-info));
+  }
+
+  &--purple {
+    background-color: var(--ds-color-accent-purple-subtle, var(--ds-color-surface-muted));
+    color: var(--ds-color-accent-purple, var(--ds-color-interactive));
+    border-color: var(--ds-color-accent-purple-border, var(--ds-color-accent-purple, var(--ds-color-interactive)));
+  }
+
+  /* ---------------------------------------------------------------------------
+     Removable — tighter right padding for the close button
+     --------------------------------------------------------------------------- */
+
+  &--removable {
+    padding-inline-end: var(--ds-space-1);
+  }
+
+  /* ---------------------------------------------------------------------------
+     Remove button
+     --------------------------------------------------------------------------- */
+
+  &__remove {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 1rem;
+    height: 1rem;
+    min-width: 1.5rem; /* WCAG 2.5.8: minimum 24px target */
+    min-height: 1.5rem;
+    padding: 0;
+    border: none;
+    border-radius: var(--ds-radius-full);
+    background: transparent;
+    color: currentColor;
+    font-size: inherit;
+    line-height: var(--ds-leading-none);
+    opacity: 0.6;
+    cursor: pointer;
+    transition:
+      opacity var(--ds-duration-fast) var(--ds-ease-out),
+      background-color var(--ds-duration-fast) var(--ds-ease-out);
+    -webkit-appearance: none;
+    appearance: none;
+
+    &:hover {
+      opacity: 1;
+      background-color: var(--ds-color-surface-hover);
+    }
+
+    &:focus-visible {
+      outline: none;
+      box-shadow: 0 0 0 var(--ds-ring-width) var(--ds-ring-color);
+      opacity: 1;
+    }
+  }
+
+  /* ---------------------------------------------------------------------------
+     Variant: Outline
+     --------------------------------------------------------------------------- */
+
+  &--outline {
+    background-color: transparent;
+  }
+
+  /* ---------------------------------------------------------------------------
+     Variant: Inverted — uses the theme-swapping inverted token pair so the
+     tag reads as dark-on-light in light mode and light-on-dark in dark mode.
+     --------------------------------------------------------------------------- */
+
+  &--inverted {
+    background-color: var(--ds-color-inverted);
+    color: var(--ds-color-on-inverted);
+    border-color: var(--ds-color-inverted);
+
+    &:hover {
+      border-color: var(--ds-color-inverted);
+    }
+  }
+
+  /* ---------------------------------------------------------------------------
+     Size: Small
+     --------------------------------------------------------------------------- */
+
+  &--sm {
+    padding: var(--ds-space-0-5, 0.125rem) var(--ds-space-2, 0.5rem);
+    font-size: var(--ds-text-2xs);
+
+    &.ds-tag--removable {
+      padding-inline-end: var(--ds-space-0-5, 0.125rem);
+    }
+  }
+
+  /* ---------------------------------------------------------------------------
+     Size: Large
+     --------------------------------------------------------------------------- */
+
+  &--lg {
+    padding: var(--ds-space-1-5, 0.375rem) var(--ds-space-3);
+    font-size: var(--ds-text-sm);
+
+    &.ds-tag--removable {
+      padding-inline-end: var(--ds-space-1-5, 0.375rem);
+    }
+  }
+}
+
+/* Tags used as <button> for selection — no focus ring on click */
+.ds-tag:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 var(--ds-ring-width) var(--ds-ring-color);
+  scroll-margin-block: var(--ds-space-16, 4rem);
+}

package/src/components/timeline.css

@@ -0,0 +1,130 @@
+/* ==========================================================================
+   Timeline
+   ==========================================================================
+   Vertical timeline component for roadmaps, activity feeds, and step-based
+   flows. Each item has a dot indicator on a vertical line with support for
+   completed, current, and error states.
+
+   Usage:
+     <div class="ds-timeline">
+       <div class="ds-timeline__item ds-timeline__item--completed">
+         <div class="ds-timeline__dot"></div>
+         <div class="ds-timeline__content">
+           <div class="ds-timeline__title">Step one</div>
+           <div class="ds-timeline__description">Details here.</div>
+           <div class="ds-timeline__time">2 hours ago</div>
+         </div>
+       </div>
+     </div>
+
+   Modifiers:
+     .ds-timeline__item--completed  — Green dot (success)
+     .ds-timeline__item--current    — Inverted dot (active)
+     .ds-timeline__item--error      — Red dot (error)
+     .ds-timeline--compact          — Tighter spacing, smaller dots
+   ========================================================================== */
+
+.ds-timeline {
+  position: relative;
+  padding-inline-start: var(--ds-space-8);
+
+  /* Vertical line */
+  &::before {
+    content: "";
+    position: absolute;
+    inset-inline-start: 0.9rem;
+    inset-block-start: 0;
+    inset-block-end: 0;
+    width: 2px;
+    background-color: var(--ds-color-border);
+  }
+
+  /* Item */
+  &__item {
+    position: relative;
+    padding-block-end: var(--ds-space-6);
+
+    &:last-child {
+      padding-block-end: 0;
+    }
+
+    /* Dot state: completed */
+    &--completed .ds-timeline__dot {
+      background-color: var(--ds-color-success);
+      border-color: var(--ds-color-success);
+    }
+
+    /* Dot state: current */
+    &--current .ds-timeline__dot {
+      background-color: var(--ds-color-inverted);
+      border-color: var(--ds-color-inverted);
+    }
+
+    /* Dot state: error */
+    &--error .ds-timeline__dot {
+      background-color: var(--ds-color-error);
+      border-color: var(--ds-color-error);
+    }
+  }
+
+  /* Dot */
+  &__dot {
+    position: absolute;
+    inset-inline-start: calc(-1 * var(--ds-space-8) + 0.5rem);
+    width: 1rem;
+    height: 1rem;
+    border-radius: var(--ds-radius-full);
+    background-color: var(--ds-color-surface-muted);
+    border: 2px solid var(--ds-color-border);
+    z-index: 1;
+  }
+
+  /* Content area */
+  &__content {
+    /* no additional layout needed; flows naturally after the dot */
+  }
+
+  /* Title */
+  &__title {
+    font-size: var(--ds-text-sm);
+    font-weight: var(--ds-weight-medium);
+    color: var(--ds-color-text);
+  }
+
+  /* Description */
+  &__description {
+    font-size: var(--ds-text-sm);
+    color: var(--ds-color-text-secondary);
+    margin-block-start: var(--ds-space-1);
+  }
+
+  /* Timestamp */
+  &__time {
+    font-size: var(--ds-text-xs);
+    color: var(--ds-color-text-tertiary);
+    margin-block-start: var(--ds-space-0-5);
+  }
+
+  /* Compact variant */
+  &--compact {
+    padding-inline-start: var(--ds-space-6);
+
+    &::before {
+      inset-inline-start: 0.6rem;
+    }
+
+    & .ds-timeline__item {
+      padding-block-end: var(--ds-space-4);
+
+      &:last-child {
+        padding-block-end: 0;
+      }
+    }
+
+    & .ds-timeline__dot {
+      inset-inline-start: calc(-1 * var(--ds-space-6) + 0.25rem);
+      width: 0.75rem;
+      height: 0.75rem;
+    }
+  }
+}

package/src/components/toast.css

@@ -0,0 +1,90 @@
+/* ==========================================================================
+   Component: Toast
+
+   ARIA requirements (consumer responsibility):
+   - Container: role="status", aria-live="polite" (or role="alert" for errors)
+   - Close button: aria-label="Dismiss notification"
+   - Auto-dismiss: provide enough time (minimum 5s), or let user control
+   - Toast region: wrap container in aria-label="Notifications"
+   ========================================================================== */
+
+.ds-toast-container {
+  position: fixed;
+  z-index: var(--ds-z-toast);
+  display: flex;
+  flex-direction: column;
+  gap: var(--ds-space-2);
+  padding: var(--ds-space-4);
+  pointer-events: none;
+
+  &--top-right    { inset-block-start: 0; inset-inline-end: 0; }
+  &--bottom-right { inset-block-end: 0; inset-inline-end: 0; }
+  &--bottom-center {
+    inset-block-end: 0; inset-inline-start: 50%;
+    transform: translateX(-50%);
+    align-items: center;
+  }
+}
+
+.ds-toast {
+  display: flex;
+  align-items: center;
+  gap: var(--ds-space-3);
+  padding: var(--ds-space-3) var(--ds-space-4);
+  background-color: var(--ds-color-surface);
+  border: 1px solid var(--ds-color-border);
+  border-radius: var(--ds-radius-lg);
+  box-shadow: var(--ds-shadow-lg);
+  pointer-events: auto;
+  min-width: 18rem;
+  max-width: 28rem;
+  animation: ds-toast-in var(--ds-duration-slow) var(--ds-ease-out-expo) forwards;
+
+  &--info    { border-inline-start: var(--ds-accent-border-width) solid var(--ds-color-info); }
+  &--success { border-inline-start: var(--ds-accent-border-width) solid var(--ds-color-success); }
+  &--warning { border-inline-start: var(--ds-accent-border-width) solid var(--ds-color-warning); }
+  &--error   { border-inline-start: var(--ds-accent-border-width) solid var(--ds-color-error); }
+
+  &__message {
+    flex: 1;
+    font-size: var(--ds-text-sm);
+    color: var(--ds-color-text);
+  }
+
+  &__close {
+    color: var(--ds-color-text-tertiary);
+    padding: var(--ds-space-1);
+    border-radius: var(--ds-radius-sm);
+    transition: color var(--ds-duration-fast) var(--ds-ease-default);
+    min-width: 1.5rem; /* WCAG 2.5.8: minimum 24px target */
+    min-height: 1.5rem;
+
+    &:hover {
+      color: var(--ds-color-text);
+    }
+
+    &:focus-visible {
+      outline: none;
+      box-shadow: 0 0 0 var(--ds-ring-width) var(--ds-ring-color);
+      scroll-margin-block: var(--ds-space-16, 4rem);
+    }
+  }
+
+  &--exit {
+    animation: ds-toast-out var(--ds-duration-normal) var(--ds-ease-default) forwards;
+  }
+}
+
+@keyframes ds-toast-in {
+  from { opacity: 0; transform: translateY(-8px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+@keyframes ds-toast-out {
+  to { opacity: 0; transform: translateX(100%); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ds-toast { animation: none; }
+  .ds-toast--exit { animation: none; opacity: 0; }
+}