@adamarant/designsystem 0.11.2

package/src/components/bottom-nav.css

@@ -0,0 +1,125 @@
+/* ==========================================================================
+   Component: Bottom Nav
+   Mobile bottom navigation bar. Hidden on desktop, shown on mobile.
+   Fixed to bottom with safe-area insets for notched devices.
+
+   ARIA requirements (consumer responsibility):
+   - Container: <nav aria-label="Bottom navigation">
+   - Active item: aria-current="page" on the current tab
+   - Badge: aria-label on badge parent (e.g., "Home, 3 notifications")
+   - Create button: aria-label="Create new"
+
+   Usage:
+     <nav class="ds-bottom-nav" aria-label="Bottom navigation">
+       <a href="/" class="ds-bottom-nav__item ds-bottom-nav__item--active" aria-current="page">
+         <span class="ds-bottom-nav__icon">
+           <svg>...</svg>
+           <span class="ds-bottom-nav__badge">3</span>
+         </span>
+         <span class="ds-bottom-nav__label">Home</span>
+       </a>
+       <button class="ds-bottom-nav__item ds-bottom-nav__item--create" aria-label="Create new">
+         <span class="ds-bottom-nav__create-icon">+</span>
+         <span class="ds-bottom-nav__label">New</span>
+       </button>
+     </nav>
+
+   Modifiers:
+     .ds-bottom-nav__item--active  — Active/current tab
+     .ds-bottom-nav__item--create  — Elevated center action button
+   ========================================================================== */
+
+.ds-bottom-nav {
+  display: none;
+  position: fixed;
+  inset-block-end: 0;
+  inset-inline-start: 0;
+  inset-inline-end: 0;
+  z-index: var(--ds-z-dropdown);
+  background: var(--ds-color-surface);
+  border-block-start: 1px solid var(--ds-color-border);
+  padding-block-end: env(safe-area-inset-bottom, 0px);
+
+  /* Nav item */
+  &__item {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: var(--ds-space-1);
+    flex: 1;
+    padding: var(--ds-space-2) 0;
+    color: var(--ds-color-text-tertiary);
+    text-decoration: none;
+    border: none;
+    background: none;
+    cursor: pointer;
+    font: inherit;
+    transition: color var(--ds-duration-fast) var(--ds-ease-default);
+    -webkit-tap-highlight-color: transparent;
+
+    &--active {
+      color: var(--ds-color-text);
+    }
+
+    &--create {
+      color: var(--ds-color-text-tertiary);
+    }
+  }
+
+  /* Icon wrapper */
+  &__icon {
+    position: relative;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+
+  /* Notification badge */
+  &__badge {
+    position: absolute;
+    inset-block-start: calc(-1 * var(--ds-space-1));
+    inset-inline-end: calc(-1 * var(--ds-space-2));
+    min-width: var(--ds-space-4);
+    height: var(--ds-space-4);
+    padding: 0 var(--ds-space-1);
+    border-radius: var(--ds-radius-full);
+    background: var(--ds-color-error);
+    color: var(--ds-color-on-inverted);
+    font-size: var(--ds-text-2xs);
+    font-weight: var(--ds-weight-semibold);
+    line-height: var(--ds-space-4);
+    text-align: center;
+  }
+
+  /* Label */
+  &__label {
+    font-size: var(--ds-text-2xs);
+    font-weight: var(--ds-weight-medium);
+    letter-spacing: var(--ds-tracking-wide);
+  }
+
+  /* Create button — elevated center icon */
+  &__create-icon {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 2.25rem;
+    height: 2.25rem;
+    border-radius: var(--ds-radius-full);
+    background: var(--ds-color-text);
+    color: var(--ds-color-bg);
+  }
+}
+
+@media (max-width: 1023px) /* below --ds-breakpoint-lg */ {
+  .ds-bottom-nav {
+    display: flex;
+    justify-content: space-around;
+    align-items: stretch;
+  }
+}
+
+@media (min-width: 1024px) /* --ds-breakpoint-lg */ {
+  .ds-bottom-nav { display: none !important; }
+}

package/src/components/bottom-sheet.css

@@ -0,0 +1,146 @@
+/* ==========================================================================
+   Component: Bottom Sheet
+   Mobile overlay sliding up from the bottom. Alternative to dropdown on mobile.
+
+   ARIA requirements (consumer responsibility):
+   - Container: role="dialog", aria-label="[title]", aria-modal="true"
+   - Close button: aria-label="Close"
+   - Focus trap when open
+   - Keyboard: Escape to close
+
+   Usage:
+     <div class="ds-bottom-sheet ds-bottom-sheet--open">
+       <div class="ds-bottom-sheet__backdrop"></div>
+       <div class="ds-bottom-sheet__panel">
+         <div class="ds-bottom-sheet__handle"></div>
+         <div class="ds-bottom-sheet__header">
+           <h3 class="ds-bottom-sheet__title">Title</h3>
+           <button class="ds-bottom-sheet__close" aria-label="Close">&times;</button>
+         </div>
+         <div class="ds-bottom-sheet__body">
+           ...content...
+         </div>
+       </div>
+     </div>
+
+   Modifiers:
+     .ds-bottom-sheet--open    — Visible
+     .ds-bottom-sheet--full    — Full height (90dvh)
+   ========================================================================== */
+
+.ds-bottom-sheet {
+  position: fixed;
+  inset: 0;
+  z-index: var(--ds-z-modal);
+  display: none;
+
+  &--open {
+    display: block;
+  }
+
+  /* --- Backdrop --- */
+  &__backdrop {
+    position: fixed;
+    inset: 0;
+    background-color: var(--ds-color-overlay);
+    animation: ds-bottom-sheet-backdrop-in var(--ds-duration-normal) var(--ds-ease-default) forwards;
+  }
+
+  /* --- Panel --- */
+  &__panel {
+    position: fixed;
+    inset-inline-start: 0;
+    inset-inline-end: 0;
+    inset-block-end: 0;
+    max-height: 75dvh;
+    display: flex;
+    flex-direction: column;
+    background-color: var(--ds-color-surface);
+    border-radius: var(--ds-radius-xl) var(--ds-radius-xl) 0 0;
+    box-shadow: var(--ds-shadow-lg);
+    overflow: hidden;
+    animation: ds-bottom-sheet-slide-up var(--ds-duration-normal) var(--ds-ease-out-expo) forwards;
+  }
+
+  /* --- Drag handle --- */
+  &__handle {
+    width: 2.5rem;
+    height: 4px;
+    margin: var(--ds-space-2) auto;
+    border-radius: var(--ds-radius-full);
+    background-color: var(--ds-color-surface-muted);
+    flex-shrink: 0;
+  }
+
+  /* --- Header --- */
+  &__header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: var(--ds-space-2) var(--ds-space-4) var(--ds-space-3);
+    flex-shrink: 0;
+  }
+
+  &__title {
+    font-family: var(--ds-font-display);
+    font-weight: var(--ds-weight-semibold);
+    font-size: var(--ds-text-lg);
+    color: var(--ds-color-text);
+  }
+
+  &__close {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: var(--ds-size-2);
+    height: var(--ds-size-2);
+    border: none;
+    border-radius: var(--ds-radius-md);
+    background: transparent;
+    color: var(--ds-color-text-tertiary);
+    cursor: pointer;
+    transition: color var(--ds-duration-fast) var(--ds-ease-default);
+
+    &:hover {
+      color: var(--ds-color-text);
+    }
+
+    &:focus-visible {
+      outline: none;
+      box-shadow: 0 0 0 var(--ds-ring-width) var(--ds-ring-color);
+    }
+  }
+
+  /* --- Body --- */
+  &__body {
+    flex: 1;
+    overflow-y: auto;
+    overscroll-behavior: contain;
+    padding: 0 var(--ds-space-4) var(--ds-space-4);
+  }
+
+  /* --- Full height modifier --- */
+  &--full &__panel {
+    max-height: 90dvh;
+  }
+}
+
+@keyframes ds-bottom-sheet-backdrop-in {
+  from { opacity: 0; }
+  to { opacity: 1; }
+}
+
+@keyframes ds-bottom-sheet-slide-up {
+  from { transform: translateY(100%); }
+  to { transform: translateY(0); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ds-bottom-sheet__panel {
+    animation: none;
+  }
+  .ds-bottom-sheet__backdrop {
+    animation: none;
+    opacity: 1;
+  }
+}

package/src/components/breadcrumb.css

@@ -0,0 +1,102 @@
+/* ==========================================================================
+   Breadcrumb Navigation
+   ==========================================================================
+   A horizontal breadcrumb trail for hierarchical navigation.
+
+   ARIA requirements (consumer responsibility):
+   - Container: <nav aria-label="Breadcrumb">
+   - Current page: aria-current="page" on the last item
+   - Links: use <a> elements for navigation
+   - Separator: decorative (generated via CSS ::after, not in DOM)
+
+   Usage:
+     <nav class="ds-breadcrumb" aria-label="Breadcrumb">
+       <span class="ds-breadcrumb__item">
+         <a href="/" class="ds-breadcrumb__link">Home</a>
+       </span>
+       <span class="ds-breadcrumb__item">
+         <a href="/products" class="ds-breadcrumb__link">Products</a>
+       </span>
+       <span class="ds-breadcrumb__item">
+         <span class="ds-breadcrumb__current" aria-current="page">Widget</span>
+       </span>
+     </nav>
+   ========================================================================== */
+
+/* ---------------------------------------------------------------------------
+   Container
+   --------------------------------------------------------------------------- */
+
+.ds-breadcrumb {
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  gap: var(--ds-space-1);
+  font-size: var(--ds-text-sm);
+  font-family: var(--ds-font-sans);
+  list-style: none;
+  margin: 0;
+  padding: 0;
+
+  /* ---------------------------------------------------------------------------
+     Item
+     --------------------------------------------------------------------------- */
+
+  &__item {
+    display: flex;
+    align-items: center;
+    gap: var(--ds-space-1);
+
+    /* Separator — rendered via ::after on every item except the last */
+    &:not(:last-child)::after {
+      content: "/";
+      color: var(--ds-color-text-tertiary);
+      flex-shrink: 0;
+      user-select: none;
+      pointer-events: none;
+    }
+  }
+
+  /* ---------------------------------------------------------------------------
+     Link
+     --------------------------------------------------------------------------- */
+
+  &__link {
+    color: var(--ds-color-text-tertiary);
+    text-decoration: none;
+    transition: color var(--ds-duration-fast) var(--ds-ease-out);
+
+    &:hover {
+      color: var(--ds-color-text-secondary);
+    }
+
+    &: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);
+    }
+  }
+
+  /* ---------------------------------------------------------------------------
+     Current page (non-interactive)
+     --------------------------------------------------------------------------- */
+
+  &__current {
+    color: var(--ds-color-text);
+    font-weight: var(--ds-weight-medium);
+  }
+
+  /* ---------------------------------------------------------------------------
+     Modifier: Compact
+     --------------------------------------------------------------------------- */
+
+  &--compact {
+    gap: var(--ds-space-0-5, 0.125rem);
+    font-size: var(--ds-text-xs);
+
+    & .ds-breadcrumb__item {
+      gap: var(--ds-space-0-5, 0.125rem);
+    }
+  }
+}

package/src/components/button.css

@@ -0,0 +1,250 @@
+/* ==========================================================================
+   Component: Button
+   Inverted primary, rounded-full CTAs, refined sizing.
+
+   ARIA requirements (consumer responsibility):
+   - Use <button> or <a role="button"> elements
+   - Disabled: add aria-disabled="true" (supported by DS styles)
+   - Loading: add aria-busy="true" when --loading is applied
+   - Icon-only: add aria-label="[action]" for screen readers
+   - Button groups: wrap in role="group" with aria-label
+   ========================================================================== */
+
+.ds-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  height: var(--ds-size-3);
+  gap: var(--ds-space-2);
+  padding: 0 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-none);
+  white-space: nowrap;
+  border-radius: var(--ds-radius-lg);
+  border: 1px solid transparent;
+  cursor: pointer;
+  transition: all var(--ds-duration-fast) var(--ds-ease-default);
+
+  /* Default: inverted (dark bg in light mode, light bg in dark mode) */
+  background-color: var(--ds-color-inverted);
+  color: var(--ds-color-on-inverted);
+
+  &:hover {
+    opacity: 0.9;
+  }
+
+  &: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);
+  }
+
+  &:disabled,
+  &[aria-disabled="true"] {
+    opacity: var(--ds-opacity-disabled);
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+
+  /* --- Variants --- */
+
+  &--secondary {
+    background-color: var(--ds-color-surface-muted);
+    color: var(--ds-color-text);
+    border-color: var(--ds-color-border);
+
+    &:hover {
+      border-color: var(--ds-color-border-hover);
+      background-color: var(--ds-color-surface-muted-hover);
+      opacity: 1;
+    }
+  }
+
+  &--outline {
+    background-color: transparent;
+    color: var(--ds-color-text-secondary);
+    border-color: var(--ds-color-border);
+
+    &:hover {
+      color: var(--ds-color-text);
+      border-color: var(--ds-color-border-hover);
+      opacity: 1;
+    }
+  }
+
+  &--ghost {
+    background-color: transparent;
+    color: var(--ds-color-text-secondary);
+
+    &:hover {
+      color: var(--ds-color-text);
+      background-color: var(--ds-color-surface-hover);
+      opacity: 1;
+    }
+  }
+
+  &--danger {
+    background-color: var(--ds-color-error-subtle);
+    color: var(--ds-color-error);
+    border-color: var(--ds-color-error-border);
+
+    &:hover {
+      background-color: var(--ds-color-error);
+      color: var(--ds-color-on-inverted);
+      opacity: 1;
+    }
+  }
+
+  &--success {
+    background-color: var(--ds-color-success-subtle);
+    color: var(--ds-color-success);
+    border-color: var(--ds-color-success-border);
+
+    &:hover {
+      background-color: var(--ds-color-success);
+      color: var(--ds-color-on-inverted);
+      opacity: 1;
+    }
+  }
+
+  &--success-solid {
+    background-color: var(--ds-color-success);
+    color: var(--ds-color-on-inverted);
+    border-color: transparent;
+
+    &:hover {
+      opacity: 0.85;
+    }
+  }
+
+  /* --- Sizes --- */
+
+  &--xs {
+    height: var(--ds-size-1);
+    padding: 0 var(--ds-space-2);
+    font-size: var(--ds-text-xs);
+    gap: var(--ds-space-1);
+    border-radius: var(--ds-radius-md);
+  }
+
+  &--sm {
+    height: var(--ds-size-2);
+    padding: 0 var(--ds-space-3);
+    font-size: var(--ds-text-sm);
+    gap: var(--ds-space-1-5);
+    border-radius: var(--ds-radius-md);
+  }
+
+  &--lg {
+    height: var(--ds-size-4);
+    padding: 0 var(--ds-space-6);
+    font-size: var(--ds-text-base);
+    border-radius: var(--ds-radius-lg);
+  }
+
+  &--xl {
+    height: var(--ds-size-5);
+    padding: 0 var(--ds-space-8);
+    font-size: var(--ds-text-base);
+    border-radius: var(--ds-radius-lg);
+  }
+
+  &--2xl {
+    height: var(--ds-size-6);
+    padding: 0 var(--ds-space-8);
+    font-size: var(--ds-text-lg);
+    border-radius: var(--ds-radius-xl);
+  }
+
+  /* --- Pill (rounded-full, like hero CTAs) --- */
+  &--pill {
+    border-radius: var(--ds-radius-full);
+    padding: 0 var(--ds-space-6);
+
+    &.ds-btn--xs {
+      padding: 0 var(--ds-space-3);
+    }
+
+    &.ds-btn--sm {
+      padding: 0 var(--ds-space-5);
+    }
+
+    &.ds-btn--xl {
+      padding: 0 var(--ds-space-8);
+    }
+
+    &.ds-btn--2xl {
+      padding: 0 var(--ds-space-10);
+    }
+  }
+
+  /* --- Full Width --- */
+  &--full { width: 100%; }
+
+  /* --- Icon Only --- */
+  &--icon {
+    padding: 0;
+    width: var(--ds-size-3);
+    height: var(--ds-size-3);
+    border-radius: var(--ds-radius-md);
+
+    &.ds-btn--xs {
+      width: var(--ds-size-1);
+      height: var(--ds-size-1);
+    }
+
+    &.ds-btn--sm {
+      width: var(--ds-size-2);
+      height: var(--ds-size-2);
+    }
+
+    &.ds-btn--xl {
+      width: var(--ds-size-5);
+      height: var(--ds-size-5);
+    }
+
+    &.ds-btn--2xl {
+      width: var(--ds-size-6);
+      height: var(--ds-size-6);
+    }
+  }
+
+  /* --- Loading spinner --- */
+  &--loading {
+    position: relative;
+    color: transparent !important;
+    pointer-events: none;
+
+    &::after {
+      content: '';
+      position: absolute;
+      width: 1em;
+      height: 1em;
+      border: 2px solid currentColor;
+      border-inline-end-color: transparent;
+      border-radius: var(--ds-radius-full);
+      animation: ds-btn-spin 0.6s linear infinite;
+      color: var(--ds-color-on-inverted);
+    }
+  }
+}
+
+/* --- Button Group --- */
+.ds-btn-group {
+  display: inline-flex;
+
+  & .ds-btn { border-radius: 0; }
+  & .ds-btn:first-child { border-radius: var(--ds-radius-lg) 0 0 var(--ds-radius-lg); }
+  & .ds-btn:last-child { border-radius: 0 var(--ds-radius-lg) var(--ds-radius-lg) 0; }
+  & .ds-btn + .ds-btn { margin-inline-start: -1px; }
+}
+
+@keyframes ds-btn-spin {
+  to { transform: rotate(360deg); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ds-btn--loading::after { animation: none; opacity: 0.6; }
+}