@justin_evo/evo-ui 1.0.1

package/src/css/button.module.scss

@@ -0,0 +1,385 @@
+@use 'base/variables' as *;
+@use 'base/color' as *;
+
+// ==========================================================
+// EvoButton
+// ----------------------------------------------------------
+// Layout is built around three orthogonal axes:
+//   1. variant    — solid / outline / ghost / soft
+//   2. severity   — primary / secondary / danger / warning / success / info
+//   3. shape      — default / rounded / square
+// Plus modifiers: size (sm/md/lg), fullWidth, iconOnly, loading.
+//
+// All sizing uses `rem` + `min-height` so the component stays
+// usable on touch screens (44px target for `lg`) without needing
+// explicit mobile media queries.
+// ==========================================================
+
+// --- Base button ---
+.button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.4rem;
+  padding: $evo-btn-padding-y $evo-btn-padding-x;
+  min-height: 2.25rem;
+  max-width: 100%;
+  font-family: inherit;
+  font-size: $evo-btn-font-size;
+  font-weight: $evo-btn-font-weight;
+  line-height: $evo-btn-line-height;
+  white-space: nowrap;
+  vertical-align: middle;
+  border: 2px solid transparent;
+  border-radius: $evo-border-radius;
+  background-color: transparent;
+  color: inherit;
+  cursor: pointer;
+  user-select: none;
+  text-decoration: none;
+  appearance: none;
+  -webkit-tap-highlight-color: transparent;
+  touch-action: manipulation;
+  transition: background-color $evo-btn-transition,
+              border-color $evo-btn-transition,
+              box-shadow $evo-btn-transition,
+              color $evo-btn-transition;
+
+  &:focus-visible {
+    outline-width: $evo-btn-outline-width;
+    outline-style: solid;
+    outline-offset: $evo-btn-outline-offset;
+  }
+
+  &:disabled {
+    opacity: $evo-btn-disabled-opacity;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+}
+
+// --- Slots ---
+.label {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  line-height: 1;
+
+  // Normalize SVGs so consumers don't have to size them
+  > svg {
+    width: 1em;
+    height: 1em;
+  }
+}
+
+// --- Loading spinner (CSS-only, inherits currentColor) ---
+.spinner {
+  display: inline-block;
+  width: 1em;
+  height: 1em;
+  flex-shrink: 0;
+  border: 2px solid currentColor;
+  border-right-color: transparent;
+  border-radius: 50%;
+  animation: evo-btn-spin 0.6s linear infinite;
+}
+
+@keyframes evo-btn-spin {
+  to { transform: rotate(360deg); }
+}
+
+// --- Size modifiers ---
+.sm {
+  gap: 0.3rem;
+  padding: $evo-btn-padding-y-sm $evo-btn-padding-x-sm;
+  min-height: 1.75rem;
+  font-size: $evo-btn-font-size-sm;
+  border-radius: $evo-border-radius-sm;
+}
+
+.md { /* default */ }
+
+.lg {
+  gap: 0.5rem;
+  padding: $evo-btn-padding-y-lg $evo-btn-padding-x-lg;
+  min-height: 2.75rem;
+  font-size: $evo-btn-font-size-lg;
+  border-radius: $evo-border-radius-lg;
+}
+
+// --- Shape modifiers (orthogonal to variant) ---
+.rounded {
+  border-radius: $evo-border-radius-pill;
+}
+
+.square {
+  padding: 0;
+  aspect-ratio: 1 / 1;
+  min-width: 2.25rem;
+
+  &.sm { min-width: 1.75rem; }
+  &.lg { min-width: 2.75rem; }
+}
+
+// --- Icon-only (auto-applied when there's no label/children) ---
+.iconOnly {
+  padding-left: 0.5rem;
+  padding-right: 0.5rem;
+
+  &.sm { padding-left: 0.35rem; padding-right: 0.35rem; }
+  &.lg { padding-left: 0.65rem; padding-right: 0.65rem; }
+}
+
+// --- Layout modifiers ---
+.fullWidth {
+  display: flex;
+  width: 100%;
+}
+
+// --- Variant base looks ---
+.solid   { /* color set per-severity */ }
+.outline { background-color: transparent; }
+.ghost   { background-color: transparent; border-color: transparent; }
+.soft    { border-color: transparent; }
+
+// --- Severities ---
+.primary {
+  &.solid {
+    color: $evo-primary-fg;
+    background-color: $evo-primary-color;
+    border-color: $evo-primary-color;
+
+    &:hover:not(:disabled)  { background-color: $evo-primary-hover;  border-color: $evo-primary-hover; }
+    &:active:not(:disabled) { background-color: $evo-primary-active; border-color: $evo-primary-active; }
+    &:focus-visible         { outline-color: $evo-primary-focus; }
+  }
+
+  &.outline {
+    color: $evo-primary-color;
+    border-color: $evo-primary-color;
+
+    &:hover:not(:disabled)  { color: $evo-primary-fg; background-color: $evo-primary-color; }
+    &:active:not(:disabled) { color: $evo-primary-fg; background-color: $evo-primary-hover; border-color: $evo-primary-hover; }
+    &:focus-visible         { outline-color: $evo-primary-focus; }
+  }
+
+  &.ghost {
+    color: $evo-primary-color;
+
+    &:hover:not(:disabled)  { background-color: $evo-primary-soft; }
+    &:active:not(:disabled) { background-color: color-mix(in srgb, $evo-primary-color 22%, transparent); }
+    &:focus-visible         { outline-color: $evo-primary-focus; }
+  }
+
+  &.soft {
+    color: $evo-primary-color;
+    background-color: $evo-primary-soft;
+
+    &:hover:not(:disabled)  { background-color: color-mix(in srgb, $evo-primary-color 22%, transparent); }
+    &:active:not(:disabled) { background-color: color-mix(in srgb, $evo-primary-color 30%, transparent); }
+    &:focus-visible         { outline-color: $evo-primary-focus; }
+  }
+}
+
+.secondary {
+  &.solid {
+    color: $evo-secondary-text;
+    background-color: $evo-secondary-bg;
+    border-color: $evo-secondary-border;
+
+    &:hover:not(:disabled)  { background-color: $evo-secondary-hover;  border-color: $color-border-strong; color: $color-text-primary; }
+    &:active:not(:disabled) { background-color: $evo-secondary-active; border-color: $color-border-strong; }
+    &:focus-visible         { outline-color: $evo-secondary-focus; }
+  }
+
+  &.outline {
+    color: $evo-secondary-text;
+    border-color: $evo-secondary-border;
+
+    &:hover:not(:disabled)  { background-color: $evo-secondary-bg;    border-color: $color-border-strong; color: $color-text-primary; }
+    &:active:not(:disabled) { background-color: $evo-secondary-hover; border-color: $color-border-strong; }
+    &:focus-visible         { outline-color: $evo-secondary-focus; }
+  }
+
+  &.ghost {
+    color: $evo-secondary-text;
+
+    &:hover:not(:disabled)  { background-color: $evo-secondary-bg; color: $color-text-primary; }
+    &:active:not(:disabled) { background-color: $evo-secondary-hover; }
+    &:focus-visible         { outline-color: $evo-secondary-focus; }
+  }
+
+  &.soft {
+    color: $color-text-primary;
+    background-color: $evo-secondary-bg;
+
+    &:hover:not(:disabled)  { background-color: $evo-secondary-hover; }
+    &:active:not(:disabled) { background-color: $evo-secondary-active; }
+    &:focus-visible         { outline-color: $evo-secondary-focus; }
+  }
+}
+
+.danger {
+  &.solid {
+    color: $evo-danger-fg;
+    background-color: $evo-danger-color;
+    border-color: $evo-danger-color;
+
+    &:hover:not(:disabled)  { background-color: $evo-danger-hover;  border-color: $evo-danger-hover; }
+    &:active:not(:disabled) { background-color: $evo-danger-active; border-color: $evo-danger-active; }
+    &:focus-visible         { outline-color: $evo-danger-focus; }
+  }
+
+  &.outline {
+    color: $evo-danger-color;
+    border-color: $evo-danger-color;
+
+    &:hover:not(:disabled)  { color: $evo-danger-fg; background-color: $evo-danger-color; }
+    &:active:not(:disabled) { color: $evo-danger-fg; background-color: $evo-danger-hover; border-color: $evo-danger-hover; }
+    &:focus-visible         { outline-color: $evo-danger-focus; }
+  }
+
+  &.ghost {
+    color: $evo-danger-color;
+
+    &:hover:not(:disabled)  { background-color: $evo-danger-soft; }
+    &:active:not(:disabled) { background-color: color-mix(in srgb, $evo-danger-color 22%, transparent); }
+    &:focus-visible         { outline-color: $evo-danger-focus; }
+  }
+
+  &.soft {
+    color: $evo-danger-color;
+    background-color: $evo-danger-soft;
+
+    &:hover:not(:disabled)  { background-color: color-mix(in srgb, $evo-danger-color 22%, transparent); }
+    &:active:not(:disabled) { background-color: color-mix(in srgb, $evo-danger-color 30%, transparent); }
+    &:focus-visible         { outline-color: $evo-danger-focus; }
+  }
+}
+
+.warning {
+  &.solid {
+    color: $evo-warning-text;
+    background-color: $evo-warning-color;
+    border-color: $evo-warning-color;
+
+    &:hover:not(:disabled)  { background-color: $evo-warning-hover;  border-color: $evo-warning-hover; }
+    &:active:not(:disabled) { background-color: $evo-warning-active; border-color: $evo-warning-active; }
+    &:focus-visible         { outline-color: $evo-warning-focus; }
+  }
+
+  &.outline {
+    color: $evo-warning-text;
+    border-color: $evo-warning-color;
+
+    &:hover:not(:disabled)  { background-color: $evo-warning-color; }
+    &:active:not(:disabled) { background-color: $evo-warning-hover; border-color: $evo-warning-hover; }
+    &:focus-visible         { outline-color: $evo-warning-focus; }
+  }
+
+  &.ghost {
+    color: $evo-warning-text;
+
+    &:hover:not(:disabled)  { background-color: $evo-warning-soft; }
+    &:active:not(:disabled) { background-color: color-mix(in srgb, $evo-warning-color 22%, transparent); }
+    &:focus-visible         { outline-color: $evo-warning-focus; }
+  }
+
+  &.soft {
+    color: $evo-warning-text;
+    background-color: $evo-warning-soft;
+
+    &:hover:not(:disabled)  { background-color: color-mix(in srgb, $evo-warning-color 22%, transparent); }
+    &:active:not(:disabled) { background-color: color-mix(in srgb, $evo-warning-color 30%, transparent); }
+    &:focus-visible         { outline-color: $evo-warning-focus; }
+  }
+}
+
+.success {
+  &.solid {
+    color: $evo-success-fg;
+    background-color: $evo-success-color;
+    border-color: $evo-success-color;
+
+    &:hover:not(:disabled)  { background-color: $evo-success-hover;  border-color: $evo-success-hover; }
+    &:active:not(:disabled) { background-color: $evo-success-active; border-color: $evo-success-active; }
+    &:focus-visible         { outline-color: $evo-success-focus; }
+  }
+
+  &.outline {
+    color: $evo-success-color;
+    border-color: $evo-success-color;
+
+    &:hover:not(:disabled)  { color: $evo-success-fg; background-color: $evo-success-color; }
+    &:active:not(:disabled) { color: $evo-success-fg; background-color: $evo-success-hover; border-color: $evo-success-hover; }
+    &:focus-visible         { outline-color: $evo-success-focus; }
+  }
+
+  &.ghost {
+    color: $evo-success-color;
+
+    &:hover:not(:disabled)  { background-color: $evo-success-soft; }
+    &:active:not(:disabled) { background-color: color-mix(in srgb, $evo-success-color 22%, transparent); }
+    &:focus-visible         { outline-color: $evo-success-focus; }
+  }
+
+  &.soft {
+    color: $evo-success-color;
+    background-color: $evo-success-soft;
+
+    &:hover:not(:disabled)  { background-color: color-mix(in srgb, $evo-success-color 22%, transparent); }
+    &:active:not(:disabled) { background-color: color-mix(in srgb, $evo-success-color 30%, transparent); }
+    &:focus-visible         { outline-color: $evo-success-focus; }
+  }
+}
+
+.info {
+  &.solid {
+    color: $evo-info-fg;
+    background-color: $evo-info-color;
+    border-color: $evo-info-color;
+
+    &:hover:not(:disabled)  { background-color: $evo-info-hover;  border-color: $evo-info-hover; }
+    &:active:not(:disabled) { background-color: $evo-info-active; border-color: $evo-info-active; }
+    &:focus-visible         { outline-color: $evo-info-focus; }
+  }
+
+  &.outline {
+    color: $evo-info-color;
+    border-color: $evo-info-color;
+
+    &:hover:not(:disabled)  { color: $evo-info-fg; background-color: $evo-info-color; }
+    &:active:not(:disabled) { color: $evo-info-fg; background-color: $evo-info-hover; border-color: $evo-info-hover; }
+    &:focus-visible         { outline-color: $evo-info-focus; }
+  }
+
+  &.ghost {
+    color: $evo-info-color;
+
+    &:hover:not(:disabled)  { background-color: $evo-info-soft; }
+    &:active:not(:disabled) { background-color: color-mix(in srgb, $evo-info-color 22%, transparent); }
+    &:focus-visible         { outline-color: $evo-info-focus; }
+  }
+
+  &.soft {
+    color: $evo-info-color;
+    background-color: $evo-info-soft;
+
+    &:hover:not(:disabled)  { background-color: color-mix(in srgb, $evo-info-color 22%, transparent); }
+    &:active:not(:disabled) { background-color: color-mix(in srgb, $evo-info-color 30%, transparent); }
+    &:focus-visible         { outline-color: $evo-info-focus; }
+  }
+}
+
+// Respect users who prefer reduced motion
+@media (prefers-reduced-motion: reduce) {
+  .button { transition: none; }
+  .spinner { animation-duration: 1.6s; }
+}

package/src/css/card.module.scss

@@ -0,0 +1,217 @@
+@use './base/variables' as *;
+
+// ============================================================
+// EvoCard
+// ------------------------------------------------------------
+// Three orthogonal axes:
+//   1. variant     — elevated / outlined / ghost
+//   2. orientation — vertical / horizontal / responsive
+//   3. interactive — adds hover / focus / press states for
+//                    when the root is a <button> or <a>
+//
+// All colours / shadows come from semantic tokens so the same
+// rules render correctly under data-theme="light" and "dark".
+// ============================================================
+
+.root {
+  display: flex;
+  flex-direction: column;
+  background-color: $color-surface-elevated;
+  color: $color-text-primary;
+  border: 1px solid transparent;
+  border-radius: $evo-border-radius-lg;
+  overflow: hidden;
+  text-align: left;
+  text-decoration: none;
+  font-family: inherit;
+  transition:
+    box-shadow $transition-fast,
+    transform $transition-fast,
+    border-color $transition-fast,
+    background-color $transition-fast;
+}
+
+// ----- Variants ---------------------------------------------
+
+.elevated {
+  background-color: $color-surface-elevated;
+  box-shadow: $shadow-md;
+}
+
+.outlined {
+  background-color: $color-surface;
+  border-color: $color-border;
+  box-shadow: none;
+}
+
+.ghost {
+  background-color: transparent;
+  border-color: transparent;
+  box-shadow: none;
+}
+
+// ----- Orientation ------------------------------------------
+//
+// Horizontal layouts use CSS grid: a fixed-ish media column on
+// the left and content stacked on the right. `:has(> .media)`
+// gates the two-column grid so cards without a media slot stay
+// single-column even in horizontal/responsive mode.
+
+.orient-vertical {
+  flex-direction: column;
+}
+
+.orient-horizontal {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+
+  &:has(> .media) {
+    grid-template-columns: minmax(0, 40%) minmax(0, 1fr);
+  }
+
+  > .media {
+    grid-row: 1 / -1;
+    grid-column: 1;
+  }
+
+  > :not(.media) {
+    grid-column: -2;
+  }
+}
+
+.orient-responsive {
+  flex-direction: column;
+
+  @media (min-width: 768px) {
+    display: grid;
+    flex-direction: initial;
+    grid-template-columns: minmax(0, 1fr);
+
+    &:has(> .media) {
+      grid-template-columns: minmax(0, 40%) minmax(0, 1fr);
+    }
+
+    > .media {
+      grid-row: 1 / -1;
+      grid-column: 1;
+    }
+
+    > :not(.media) {
+      grid-column: -2;
+    }
+  }
+}
+
+// ----- Interactive (real <button> / <a>) --------------------
+
+.interactive {
+  cursor: pointer;
+  user-select: none;
+  appearance: none;
+  width: 100%;
+  font: inherit;
+  -webkit-tap-highlight-color: transparent;
+  touch-action: manipulation;
+  // a11y: cards used as buttons can be short — guarantee a 44px
+  // touch target so they stay tappable on mobile.
+  min-height: 2.75rem;
+
+  &:hover:not(:disabled) {
+    transform: translateY(-2px);
+    box-shadow: $shadow-lg;
+  }
+
+  &.outlined:hover:not(:disabled) {
+    border-color: $color-border-strong;
+  }
+
+  &.ghost:hover:not(:disabled) {
+    background-color: $color-surface-hover;
+  }
+
+  &:active:not(:disabled) {
+    transform: translateY(0);
+    box-shadow: $shadow-sm;
+  }
+
+  &:focus-visible {
+    outline: 2px solid $evo-primary-focus;
+    outline-offset: 2px;
+  }
+
+  &:disabled,
+  &[aria-disabled='true'] {
+    opacity: 0.5;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+}
+
+// ----- Slots ------------------------------------------------
+
+.media {
+  display: block;
+  overflow: hidden;
+  background-color: $color-surface-sunken;
+}
+
+.mediaImg {
+  display: block;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.header {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  padding: 1rem 1.25rem 0.5rem;
+}
+
+.body {
+  flex: 1 1 auto;
+  min-width: 0;
+  padding: 0.5rem 1.25rem 1rem;
+}
+
+.footer {
+  padding: 0.75rem 1.25rem;
+  border-top: 1px solid $color-border-subtle;
+}
+
+// When the card has only a body (no header/footer), pad the body
+// like a full block so content doesn't look cramped.
+.root > .body:only-child {
+  padding: 1.25rem;
+}
+
+// ----- Typography -------------------------------------------
+
+.title {
+  margin: 0;
+  font-size: $text-lg;
+  font-weight: 700;
+  line-height: 1.3;
+  color: $color-text-primary;
+}
+
+.description {
+  margin: 0;
+  font-size: $text-sm;
+  line-height: 1.55;
+  color: $color-text-secondary;
+}
+
+// ----- Motion preferences -----------------------------------
+
+@media (prefers-reduced-motion: reduce) {
+  .root,
+  .interactive {
+    transition: none;
+
+    &:hover:not(:disabled) {
+      transform: none;
+    }
+  }
+}

package/src/css/checkbox.module.scss

@@ -0,0 +1,120 @@
+@use 'base/variables' as *;
+@use 'base/color' as *;
+
+.group {
+  border: none;
+  padding: 0;
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.groupLabel {
+  font-size: $text-sm;
+  font-weight: 600;
+  color: $color-text-primary;
+  margin-bottom: 0.125rem;
+  font-family: $font-sans;
+}
+
+.checkbox {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+
+  &.disabled {
+    opacity: 0.5;
+    pointer-events: none;
+  }
+}
+
+.input {
+  position: absolute;
+  opacity: 0;
+  width: 0;
+  height: 0;
+  pointer-events: none;
+
+  &:checked + .label .checkmark {
+    background-color: $evo-primary-color;
+    border-color: $evo-primary-color;
+
+    &::after {
+      opacity: 1;
+      transform: rotate(45deg) scale(1);
+    }
+  }
+
+  &:indeterminate + .label .checkmark {
+    background-color: $evo-primary-color;
+    border-color: $evo-primary-color;
+
+    &::after {
+      content: '';
+      position: absolute;
+      top: 50%;
+      left: 50%;
+      transform: translate(-50%, -50%) !important;
+      width: 8px;
+      height: 2px;
+      background: $evo-primary-fg;
+      border: none;
+      opacity: 1;
+    }
+  }
+
+  &:focus-visible + .label .checkmark {
+    outline: 2px solid $evo-primary-focus;
+    outline-offset: 2px;
+  }
+}
+
+.label {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  cursor: pointer;
+  font-family: $font-sans;
+}
+
+.checkmark {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 1rem;
+  height: 1rem;
+  border: 2px solid $color-border;
+  border-radius: $radius-sm;
+  background: $color-surface;
+  transition: background-color $transition-fast, border-color $transition-fast;
+  flex-shrink: 0;
+
+  &::after {
+    content: '';
+    position: absolute;
+    top: 0px;
+    left: 3px;
+    width: 5px;
+    height: 8px;
+    border: 2px solid $evo-primary-fg;
+    border-top: none;
+    border-left: none;
+    opacity: 0;
+    transform: rotate(45deg) scale(0.5);
+    transition: opacity $transition-fast, transform $transition-fast;
+  }
+}
+
+.labelText {
+  font-size: $text-sm;
+  color: $color-text-primary;
+}
+
+.helperText {
+  font-size: $text-xs;
+  color: $color-text-muted;
+  padding-left: 1.5rem;
+  margin: 0;
+}