@digiko-npm/designsystem 0.1.0

package/src/components/tag.css

@@ -0,0 +1,159 @@
+/* ==========================================================================
+   Tag / Chip Component
+   ==========================================================================
+   Interactive, optionally removable tag for categorisation and filtering.
+
+   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: 1;
+  border-radius: var(--ds-radius-full);
+  background-color: var(--ds-color-bg-elevated);
+  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);
+}
+
+.ds-tag:hover {
+  border-color: var(--ds-color-border-hover);
+}
+
+/* ---------------------------------------------------------------------------
+   Color variants — subtle background + vivid text + subtle border
+   --------------------------------------------------------------------------- */
+
+.ds-tag--primary {
+  background-color: var(--ds-color-interactive-subtle, var(--ds-color-bg-elevated));
+  color: var(--ds-color-interactive);
+  border-color: var(--ds-color-interactive-border, var(--ds-color-interactive));
+}
+
+.ds-tag--success {
+  background-color: var(--ds-color-success-subtle, var(--ds-color-bg-elevated));
+  color: var(--ds-color-success);
+  border-color: var(--ds-color-success-border, var(--ds-color-success));
+}
+
+.ds-tag--warning {
+  background-color: var(--ds-color-warning-subtle, var(--ds-color-bg-elevated));
+  color: var(--ds-color-warning);
+  border-color: var(--ds-color-warning-border, var(--ds-color-warning));
+}
+
+.ds-tag--error {
+  background-color: var(--ds-color-error-subtle, var(--ds-color-bg-elevated));
+  color: var(--ds-color-error);
+  border-color: var(--ds-color-error-border, var(--ds-color-error));
+}
+
+.ds-tag--info {
+  background-color: var(--ds-color-info-subtle, var(--ds-color-bg-elevated));
+  color: var(--ds-color-info);
+  border-color: var(--ds-color-info-border, var(--ds-color-info));
+}
+
+.ds-tag--purple {
+  background-color: var(--ds-color-purple-subtle, var(--ds-color-bg-elevated));
+  color: var(--ds-color-purple, var(--ds-color-interactive));
+  border-color: var(--ds-color-purple-border, var(--ds-color-purple, var(--ds-color-interactive)));
+}
+
+/* ---------------------------------------------------------------------------
+   Removable — tighter right padding for the close button
+   --------------------------------------------------------------------------- */
+
+.ds-tag--removable {
+  padding-right: var(--ds-space-1);
+}
+
+/* ---------------------------------------------------------------------------
+   Remove button
+   --------------------------------------------------------------------------- */
+
+.ds-tag__remove {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 1rem;
+  height: 1rem;
+  padding: 0;
+  border: none;
+  border-radius: var(--ds-radius-full);
+  background: transparent;
+  color: currentColor;
+  font-size: inherit;
+  line-height: 1;
+  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;
+}
+
+.ds-tag__remove:hover {
+  opacity: 1;
+  background-color: var(--ds-color-overlay-hover);
+}
+
+.ds-tag__remove:focus-visible {
+  outline: 2px solid var(--ds-color-interactive);
+  outline-offset: 1px;
+  opacity: 1;
+}
+
+/* ---------------------------------------------------------------------------
+   Variant: Outline
+   --------------------------------------------------------------------------- */
+
+.ds-tag--outline {
+  background-color: transparent;
+}
+
+/* ---------------------------------------------------------------------------
+   Size: Small
+   --------------------------------------------------------------------------- */
+
+.ds-tag--sm {
+  padding: var(--ds-space-0-5, 0.125rem) var(--ds-space-2, 0.5rem);
+  font-size: 0.625rem;
+}
+
+.ds-tag--sm.ds-tag--removable {
+  padding-right: var(--ds-space-0-5, 0.125rem);
+}
+
+/* ---------------------------------------------------------------------------
+   Size: Large
+   --------------------------------------------------------------------------- */
+
+.ds-tag--lg {
+  padding: var(--ds-space-1-5, 0.375rem) var(--ds-space-3);
+  font-size: var(--ds-text-sm);
+}
+
+.ds-tag--lg.ds-tag--removable {
+  padding-right: var(--ds-space-1-5, 0.375rem);
+}

package/src/components/timeline.css

@@ -0,0 +1,131 @@
+/* ==========================================================================
+ * 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-left: var(--ds-space-8);
+}
+
+/* Vertical line */
+.ds-timeline::before {
+  content: "";
+  position: absolute;
+  left: 0.9rem;
+  top: 0;
+  bottom: 0;
+  width: 2px;
+  background-color: var(--ds-color-border);
+}
+
+/* Item */
+.ds-timeline__item {
+  position: relative;
+  padding-bottom: var(--ds-space-6);
+}
+
+.ds-timeline__item:last-child {
+  padding-bottom: 0;
+}
+
+/* Dot */
+.ds-timeline__dot {
+  position: absolute;
+  left: calc(-1 * var(--ds-space-8) + 0.5rem);
+  width: 1rem;
+  height: 1rem;
+  border-radius: var(--ds-radius-full);
+  background-color: var(--ds-color-bg-elevated);
+  border: 2px solid var(--ds-color-border);
+  z-index: 1;
+}
+
+/* Dot state: completed */
+.ds-timeline__item--completed .ds-timeline__dot {
+  background-color: var(--ds-color-success);
+  border-color: var(--ds-color-success);
+}
+
+/* Dot state: current */
+.ds-timeline__item--current .ds-timeline__dot {
+  background-color: var(--ds-color-inverted);
+  border-color: var(--ds-color-inverted);
+}
+
+/* Dot state: error */
+.ds-timeline__item--error .ds-timeline__dot {
+  background-color: var(--ds-color-error);
+  border-color: var(--ds-color-error);
+}
+
+/* Content area */
+.ds-timeline__content {
+  /* no additional layout needed; flows naturally after the dot */
+}
+
+/* Title */
+.ds-timeline__title {
+  font-size: var(--ds-text-sm);
+  font-weight: var(--ds-weight-medium);
+  color: var(--ds-color-text);
+}
+
+/* Description */
+.ds-timeline__description {
+  font-size: var(--ds-text-sm);
+  color: var(--ds-color-text-secondary);
+  margin-top: var(--ds-space-1);
+}
+
+/* Timestamp */
+.ds-timeline__time {
+  font-size: var(--ds-text-xs);
+  color: var(--ds-color-text-tertiary);
+  margin-top: var(--ds-space-0-5);
+}
+
+/* Compact variant */
+.ds-timeline--compact {
+  padding-left: var(--ds-space-6);
+}
+
+.ds-timeline--compact::before {
+  left: 0.6rem;
+}
+
+.ds-timeline--compact .ds-timeline__item {
+  padding-bottom: var(--ds-space-4);
+}
+
+.ds-timeline--compact .ds-timeline__item:last-child {
+  padding-bottom: 0;
+}
+
+.ds-timeline--compact .ds-timeline__dot {
+  left: calc(-1 * var(--ds-space-6) + 0.25rem);
+  width: 0.75rem;
+  height: 0.75rem;
+}

package/src/components/toast.css

@@ -0,0 +1,70 @@
+/* ==========================================================================
+   Component: Toast
+   ========================================================================== */
+
+.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;
+}
+
+.ds-toast-container--top-right    { top: 0; right: 0; }
+.ds-toast-container--bottom-right { bottom: 0; right: 0; }
+.ds-toast-container--bottom-center {
+  bottom: 0; left: 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;
+}
+
+.ds-toast--info    { border-left: 3px solid var(--ds-color-info); }
+.ds-toast--success { border-left: 3px solid var(--ds-color-success); }
+.ds-toast--warning { border-left: 3px solid var(--ds-color-warning); }
+.ds-toast--error   { border-left: 3px solid var(--ds-color-error); }
+
+.ds-toast__message {
+  flex: 1;
+  font-size: var(--ds-text-sm);
+  color: var(--ds-color-text);
+}
+
+.ds-toast__close {
+  color: var(--ds-color-text-tertiary);
+  padding: var(--ds-space-1);
+  border-radius: var(--ds-radius-sm);
+  transition: color var(--ds-duration-fast) ease;
+}
+.ds-toast__close:hover {
+  color: var(--ds-color-text);
+}
+
+@keyframes ds-toast-in {
+  from { opacity: 0; transform: translateY(-8px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+.ds-toast--exit {
+  animation: ds-toast-out var(--ds-duration-normal) var(--ds-ease-default) forwards;
+}
+
+@keyframes ds-toast-out {
+  to { opacity: 0; transform: translateX(100%); }
+}

package/src/components/toggle.css

@@ -0,0 +1,135 @@
+/* ==========================================================================
+   Toggle / Switch Component
+   ==========================================================================
+   A toggle (switch) control for binary on/off states.
+   Supports aria-checked attribute and modifier-class driven states.
+
+   Usage:
+     <button class="ds-toggle" role="switch" aria-checked="false"></button>
+
+     <label class="ds-toggle-label">
+       <button class="ds-toggle" role="switch" aria-checked="true"></button>
+       <span class="ds-toggle-label__text">Dark mode</span>
+     </label>
+   ========================================================================== */
+
+/* ---------------------------------------------------------------------------
+   Track
+   --------------------------------------------------------------------------- */
+
+.ds-toggle {
+  display: inline-flex;
+  position: relative;
+  width: 2.75rem;
+  height: 1.5rem;
+  padding: 2px;
+  border: none;
+  border-radius: var(--ds-radius-full);
+  background-color: var(--ds-color-bg-muted);
+  cursor: pointer;
+  transition: background-color var(--ds-duration-normal) var(--ds-ease-out);
+  -webkit-appearance: none;
+  appearance: none;
+  flex-shrink: 0;
+}
+
+/* ---------------------------------------------------------------------------
+   Thumb (pseudo-element)
+   --------------------------------------------------------------------------- */
+
+.ds-toggle::after {
+  content: "";
+  position: absolute;
+  left: 2px;
+  top: 50%;
+  width: 1.25rem;
+  height: 1.25rem;
+  border-radius: var(--ds-radius-full);
+  background-color: #fff;
+  box-shadow: var(--ds-shadow-sm);
+  transform: translateY(-50%);
+  transition: transform var(--ds-duration-normal) var(--ds-ease-out);
+}
+
+/* ---------------------------------------------------------------------------
+   Checked state
+   --------------------------------------------------------------------------- */
+
+.ds-toggle[aria-checked="true"],
+.ds-toggle--checked {
+  background-color: var(--ds-color-interactive);
+}
+
+.ds-toggle[aria-checked="true"]::after,
+.ds-toggle--checked::after {
+  transform: translateX(1.25rem) translateY(-50%);
+}
+
+/* ---------------------------------------------------------------------------
+   Hover
+   --------------------------------------------------------------------------- */
+
+.ds-toggle:hover {
+  background-color: var(--ds-color-border-hover);
+}
+
+.ds-toggle[aria-checked="true"]:hover,
+.ds-toggle--checked:hover {
+  background-color: var(--ds-color-interactive-hover);
+}
+
+/* ---------------------------------------------------------------------------
+   Focus
+   --------------------------------------------------------------------------- */
+
+.ds-toggle:focus-visible {
+  outline: 2px solid var(--ds-color-interactive);
+  outline-offset: 2px;
+}
+
+/* ---------------------------------------------------------------------------
+   Disabled
+   --------------------------------------------------------------------------- */
+
+.ds-toggle:disabled,
+.ds-toggle--disabled {
+  opacity: var(--ds-opacity-disabled);
+  cursor: not-allowed;
+  pointer-events: none;
+}
+
+/* ---------------------------------------------------------------------------
+   Size: Small
+   --------------------------------------------------------------------------- */
+
+.ds-toggle--sm {
+  width: 2rem;
+  height: 1.125rem;
+}
+
+.ds-toggle--sm::after {
+  width: 0.875rem;
+  height: 0.875rem;
+}
+
+.ds-toggle--sm[aria-checked="true"]::after,
+.ds-toggle--sm.ds-toggle--checked::after {
+  transform: translateX(0.875rem) translateY(-50%);
+}
+
+/* ---------------------------------------------------------------------------
+   Label wrapper
+   --------------------------------------------------------------------------- */
+
+.ds-toggle-label {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--ds-space-2);
+  cursor: pointer;
+  font-size: var(--ds-text-sm);
+  font-family: var(--ds-font-sans);
+}
+
+.ds-toggle-label__text {
+  color: var(--ds-color-text-secondary);
+}

package/src/components/tooltip.css

@@ -0,0 +1,161 @@
+/* ==========================================================================
+   Component: Tooltip
+   Inverted bubble with arrow, positioned via modifier classes.
+   Default placement: top.
+   ========================================================================== */
+
+.ds-tooltip {
+  position: relative;
+  display: inline-flex;
+}
+
+/* --- Tooltip bubble --- */
+
+.ds-tooltip__content {
+  position: absolute;
+  z-index: var(--ds-z-tooltip);
+  background-color: var(--ds-color-inverted);
+  color: var(--ds-color-on-inverted);
+  font-size: var(--ds-text-xs);
+  font-weight: var(--ds-weight-medium);
+  line-height: var(--ds-leading-snug);
+  padding: var(--ds-space-1) var(--ds-space-2);
+  border-radius: var(--ds-radius-md);
+  white-space: nowrap;
+  pointer-events: none;
+  opacity: 0;
+  visibility: hidden;
+  transition:
+    opacity var(--ds-duration-fast) var(--ds-ease-default),
+    visibility var(--ds-duration-fast) var(--ds-ease-default),
+    transform var(--ds-duration-fast) var(--ds-ease-out);
+}
+
+/* --- Arrow (shared base) --- */
+
+.ds-tooltip__content::after {
+  content: '';
+  position: absolute;
+  border: 4px solid transparent;
+}
+
+/* --- Show on hover --- */
+
+.ds-tooltip:hover .ds-tooltip__content {
+  opacity: 1;
+  visibility: visible;
+}
+
+/* --- Delay modifier --- */
+
+.ds-tooltip--delay .ds-tooltip__content {
+  transition-delay: 0ms;
+}
+
+.ds-tooltip--delay:hover .ds-tooltip__content {
+  transition-delay: 200ms;
+}
+
+/* =============================================
+   Placement: Top (default)
+   ============================================= */
+
+.ds-tooltip .ds-tooltip__content,
+.ds-tooltip--top .ds-tooltip__content {
+  bottom: calc(100% + 8px);
+  left: 50%;
+  transform: translateX(-50%) translateY(4px);
+}
+
+.ds-tooltip:hover .ds-tooltip__content,
+.ds-tooltip--top:hover .ds-tooltip__content {
+  transform: translateX(-50%) translateY(0);
+}
+
+/* Arrow — points down */
+.ds-tooltip .ds-tooltip__content::after,
+.ds-tooltip--top .ds-tooltip__content::after {
+  top: 100%;
+  left: 50%;
+  transform: translateX(-50%);
+  border-top-color: var(--ds-color-inverted);
+}
+
+/* =============================================
+   Placement: Bottom
+   ============================================= */
+
+.ds-tooltip--bottom .ds-tooltip__content {
+  top: calc(100% + 8px);
+  bottom: auto;
+  left: 50%;
+  transform: translateX(-50%) translateY(-4px);
+}
+
+.ds-tooltip--bottom:hover .ds-tooltip__content {
+  transform: translateX(-50%) translateY(0);
+}
+
+/* Arrow — points up */
+.ds-tooltip--bottom .ds-tooltip__content::after {
+  bottom: 100%;
+  top: auto;
+  left: 50%;
+  transform: translateX(-50%);
+  border-top-color: transparent;
+  border-bottom-color: var(--ds-color-inverted);
+}
+
+/* =============================================
+   Placement: Left
+   ============================================= */
+
+.ds-tooltip--left .ds-tooltip__content {
+  right: calc(100% + 8px);
+  left: auto;
+  bottom: auto;
+  top: 50%;
+  transform: translateY(-50%) translateX(4px);
+}
+
+.ds-tooltip--left:hover .ds-tooltip__content {
+  transform: translateY(-50%) translateX(0);
+}
+
+/* Arrow — points right */
+.ds-tooltip--left .ds-tooltip__content::after {
+  left: 100%;
+  top: 50%;
+  bottom: auto;
+  right: auto;
+  transform: translateY(-50%);
+  border-top-color: transparent;
+  border-left-color: var(--ds-color-inverted);
+}
+
+/* =============================================
+   Placement: Right
+   ============================================= */
+
+.ds-tooltip--right .ds-tooltip__content {
+  left: calc(100% + 8px);
+  right: auto;
+  bottom: auto;
+  top: 50%;
+  transform: translateY(-50%) translateX(-4px);
+}
+
+.ds-tooltip--right:hover .ds-tooltip__content {
+  transform: translateY(-50%) translateX(0);
+}
+
+/* Arrow — points left */
+.ds-tooltip--right .ds-tooltip__content::after {
+  right: 100%;
+  left: auto;
+  top: 50%;
+  bottom: auto;
+  transform: translateY(-50%);
+  border-top-color: transparent;
+  border-right-color: var(--ds-color-inverted);
+}

package/src/index.css

@@ -0,0 +1,19 @@
+/* ==========================================================================
+   @ds/designsystem
+
+   Import this one file to get everything.
+   Or import individual layers for fine-grained control:
+
+     import '@ds/designsystem/tokens'
+     import '@ds/designsystem/base'
+     import '@ds/designsystem/components'
+     import '@ds/designsystem/utilities'
+
+   To customize: override any --ds-* variable in your project CSS.
+   Your values always win. Nothing breaks.
+   ========================================================================== */
+
+@import './tokens/index.css';
+@import './base/index.css';
+@import './components/index.css';
+@import './utilities/index.css';