/*
 * ============================================================================
 * WORDPRESS PLUGIN DESIGN SYSTEM
 * Version: 1.0.0
 * Author: Daniel's Plugin Suite
 * ============================================================================
 * 
 * A unified design system for WordPress admin plugins featuring:
 * - Muted, modern color palette
 * - Clean, crisp interfaces
 * - Consistent component styling
 * - Accessible contrast ratios
 * 
 * USAGE INSTRUCTIONS FOR AI ASSISTANTS:
 * When implementing this design system, use the CSS custom properties (variables)
 * defined below. All components should use these variables rather than hard-coded
 * colors to maintain consistency across plugins.
 * 
 * ============================================================================
 */


/* ============================================================================
   1. CSS CUSTOM PROPERTIES (VARIABLES)
   ============================================================================ */

:root {
  /* 
   * PRIMARY COLORS
   * Main brand colors in muted tones
   */
  --ds-primary-50: #f0f7ff;
  --ds-primary-100: #e0efff;
  --ds-primary-200: #b8dbff;
  --ds-primary-300: #7ab8f5;
  --ds-primary-400: #4a9be8;
  --ds-primary-500: #2563eb;      /* Base primary */
  --ds-primary-600: #1d4ed8;
  --ds-primary-700: #1e40af;
  --ds-primary-800: #1e3a8a;
  --ds-primary-900: #172554;

  /* 
   * NEUTRAL COLORS
   * Grays for backgrounds, borders, and text
   */
  --ds-neutral-0: #ffffff;
  --ds-neutral-50: #f8fafc;
  --ds-neutral-100: #f1f5f9;
  --ds-neutral-200: #e2e8f0;
  --ds-neutral-300: #cbd5e1;
  --ds-neutral-400: #94a3b8;
  --ds-neutral-500: #64748b;
  --ds-neutral-600: #475569;
  --ds-neutral-700: #334155;
  --ds-neutral-800: #1e293b;
  --ds-neutral-900: #0f172a;

  /* 
   * SEMANTIC COLORS
   * Status and feedback colors (muted versions)
   */
  
  /* Success - Muted Green */
  --ds-success-50: #f0fdf4;
  --ds-success-100: #dcfce7;
  --ds-success-200: #bbf7d0;
  --ds-success-300: #86efac;
  --ds-success-400: #4ade80;
  --ds-success-500: #22c55e;
  --ds-success-600: #16a34a;
  --ds-success-700: #15803d;
  --ds-success-border: #86efac;
  --ds-success-bg: #f0fdf4;
  --ds-success-text: #15803d;

  /* Warning - Muted Amber */
  --ds-warning-50: #fffbeb;
  --ds-warning-100: #fef3c7;
  --ds-warning-200: #fde68a;
  --ds-warning-300: #fcd34d;
  --ds-warning-400: #fbbf24;
  --ds-warning-500: #f59e0b;
  --ds-warning-600: #d97706;
  --ds-warning-700: #b45309;
  --ds-warning-border: #fcd34d;
  --ds-warning-bg: #fffbeb;
  --ds-warning-text: #b45309;

  /* Error - Muted Red */
  --ds-error-50: #fef2f2;
  --ds-error-100: #fee2e2;
  --ds-error-200: #fecaca;
  --ds-error-300: #fca5a5;
  --ds-error-400: #f87171;
  --ds-error-500: #ef4444;
  --ds-error-600: #dc2626;
  --ds-error-700: #b91c1c;
  --ds-error-border: #fca5a5;
  --ds-error-bg: #fef2f2;
  --ds-error-text: #b91c1c;

  /* Info - Muted Cyan */
  --ds-info-50: #ecfeff;
  --ds-info-100: #cffafe;
  --ds-info-200: #a5f3fc;
  --ds-info-300: #67e8f9;
  --ds-info-400: #22d3ee;
  --ds-info-500: #06b6d4;
  --ds-info-600: #0891b2;
  --ds-info-700: #0e7490;
  --ds-info-border: #67e8f9;
  --ds-info-bg: #ecfeff;
  --ds-info-text: #0e7490;

  /* 
   * SPACING SCALE
   * Consistent spacing units
   */
  --ds-space-0: 0;
  --ds-space-1: 0.25rem;    /* 4px */
  --ds-space-2: 0.5rem;     /* 8px */
  --ds-space-3: 0.75rem;    /* 12px */
  --ds-space-4: 1rem;       /* 16px */
  --ds-space-5: 1.25rem;    /* 20px */
  --ds-space-6: 1.5rem;     /* 24px */
  --ds-space-8: 2rem;       /* 32px */
  --ds-space-10: 2.5rem;    /* 40px */
  --ds-space-12: 3rem;      /* 48px */
  --ds-space-16: 4rem;      /* 64px */

  /* 
   * TYPOGRAPHY
   */
  --ds-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen-Sans, Ubuntu, Cantarell, "Helvetica Neue", sans-serif;
  --ds-font-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;
  
  --ds-text-xs: 0.75rem;    /* 12px */
  --ds-text-sm: 0.875rem;   /* 14px */
  --ds-text-base: 1rem;     /* 16px */
  --ds-text-lg: 1.125rem;   /* 18px */
  --ds-text-xl: 1.25rem;    /* 20px */
  --ds-text-2xl: 1.5rem;    /* 24px */
  --ds-text-3xl: 1.875rem;  /* 30px */

  --ds-leading-tight: 1.25;
  --ds-leading-normal: 1.5;
  --ds-leading-relaxed: 1.625;

  --ds-font-normal: 400;
  --ds-font-medium: 500;
  --ds-font-semibold: 600;
  --ds-font-bold: 700;

  /* 
   * BORDERS & RADIUS
   */
  --ds-border-width: 1px;
  --ds-border-width-2: 2px;
  
  --ds-radius-sm: 0.25rem;  /* 4px */
  --ds-radius-md: 0.375rem; /* 6px */
  --ds-radius-lg: 0.5rem;   /* 8px */
  --ds-radius-xl: 0.75rem;  /* 12px */
  --ds-radius-full: 9999px;

  /* 
   * SHADOWS
   * Subtle, modern shadows
   */
  --ds-shadow-xs: 0 1px 2px 0 rgb(0 0 0 / 0.05);
  --ds-shadow-sm: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
  --ds-shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
  --ds-shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);

  /* 
   * TRANSITIONS
   */
  --ds-transition-fast: 150ms ease;
  --ds-transition-base: 200ms ease;
  --ds-transition-slow: 300ms ease;

  /* 
   * Z-INDEX SCALE
   */
  --ds-z-dropdown: 100;
  --ds-z-sticky: 200;
  --ds-z-modal-backdrop: 300;
  --ds-z-modal: 400;
  --ds-z-tooltip: 500;
}


/* ============================================================================
   2. BASE STYLES
   ============================================================================ */

/* 
 * Plugin wrapper - use this class on your main plugin container
 */
.ds-plugin-wrap {
  font-family: var(--ds-font-family);
  font-size: var(--ds-text-sm);
  line-height: var(--ds-leading-normal);
  color: var(--ds-neutral-700);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

.ds-plugin-wrap *,
.ds-plugin-wrap *::before,
.ds-plugin-wrap *::after {
  box-sizing: border-box;
}


/* ============================================================================
   3. TYPOGRAPHY
   ============================================================================ */

.ds-heading-1 {
  font-size: var(--ds-text-2xl);
  font-weight: var(--ds-font-semibold);
  line-height: var(--ds-leading-tight);
  color: var(--ds-neutral-900);
  margin: 0 0 var(--ds-space-4) 0;
}

.ds-heading-2 {
  font-size: var(--ds-text-xl);
  font-weight: var(--ds-font-semibold);
  line-height: var(--ds-leading-tight);
  color: var(--ds-neutral-900);
  margin: 0 0 var(--ds-space-3) 0;
}

.ds-heading-3 {
  font-size: var(--ds-text-lg);
  font-weight: var(--ds-font-medium);
  line-height: var(--ds-leading-tight);
  color: var(--ds-neutral-800);
  margin: 0 0 var(--ds-space-2) 0;
}

.ds-heading-4 {
  font-size: var(--ds-text-base);
  font-weight: var(--ds-font-medium);
  line-height: var(--ds-leading-tight);
  color: var(--ds-neutral-800);
  margin: 0 0 var(--ds-space-2) 0;
}

.ds-text {
  font-size: var(--ds-text-sm);
  line-height: var(--ds-leading-normal);
  color: var(--ds-neutral-600);
  margin: 0 0 var(--ds-space-4) 0;
}

.ds-text-small {
  font-size: var(--ds-text-xs);
  line-height: var(--ds-leading-normal);
  color: var(--ds-neutral-500);
}

.ds-text-muted {
  color: var(--ds-neutral-500);
}

.ds-link {
  color: var(--ds-primary-600);
  text-decoration: none;
  transition: color var(--ds-transition-fast);
}

.ds-link:hover {
  color: var(--ds-primary-700);
  text-decoration: underline;
}


/* ============================================================================
   4. BUTTONS
   ============================================================================
   
   Button style: Muted/lighter tint background with full color border
   This creates a subtle, modern appearance that's easy on the eyes.
*/

/* Base button styles */
.ds-btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  gap: var(--ds-space-2);
  padding: var(--ds-space-2) var(--ds-space-4);
  font-family: var(--ds-font-family);
  font-size: var(--ds-text-sm);
  font-weight: var(--ds-font-medium);
  line-height: var(--ds-leading-normal);
  text-decoration: none;
  border-radius: var(--ds-radius-md);
  border-width: var(--ds-border-width);
  border-style: solid;
  cursor: pointer;
  transition: all var(--ds-transition-fast);
  white-space: nowrap;
}

.ds-btn:focus {
  outline: 2px solid var(--ds-primary-300);
  outline-offset: 2px;
}

.ds-btn:disabled,
.ds-btn.is-disabled {
  opacity: 0.5;
  cursor: not-allowed;
  pointer-events: none;
}

/* Primary Button - Muted blue bg with solid blue border */
.ds-btn-primary {
  background-color: var(--ds-primary-50);
  border-color: var(--ds-primary-500);
  color: var(--ds-primary-700);
}

.ds-btn-primary:hover {
  background-color: var(--ds-primary-100);
  border-color: var(--ds-primary-600);
  color: var(--ds-primary-800);
}

.ds-btn-primary:active {
  background-color: var(--ds-primary-200);
}

/* Secondary Button - Neutral/gray */
.ds-btn-secondary {
  background-color: var(--ds-neutral-50);
  border-color: var(--ds-neutral-300);
  color: var(--ds-neutral-700);
}

.ds-btn-secondary:hover {
  background-color: var(--ds-neutral-100);
  border-color: var(--ds-neutral-400);
  color: var(--ds-neutral-800);
}

.ds-btn-secondary:active {
  background-color: var(--ds-neutral-200);
}

/* Success Button */
.ds-btn-success {
  background-color: var(--ds-success-bg);
  border-color: var(--ds-success-500);
  color: var(--ds-success-text);
}

.ds-btn-success:hover {
  background-color: var(--ds-success-100);
  border-color: var(--ds-success-600);
  color: var(--ds-success-700);
}

/* Warning Button */
.ds-btn-warning {
  background-color: var(--ds-warning-bg);
  border-color: var(--ds-warning-500);
  color: var(--ds-warning-text);
}

.ds-btn-warning:hover {
  background-color: var(--ds-warning-100);
  border-color: var(--ds-warning-600);
  color: var(--ds-warning-700);
}

/* Danger/Error Button */
.ds-btn-danger {
  background-color: var(--ds-error-bg);
  border-color: var(--ds-error-500);
  color: var(--ds-error-text);
}

.ds-btn-danger:hover {
  background-color: var(--ds-error-100);
  border-color: var(--ds-error-600);
  color: var(--ds-error-700);
}

/* Ghost Button - No background, just border on hover */
.ds-btn-ghost {
  background-color: transparent;
  border-color: transparent;
  color: var(--ds-neutral-600);
}

.ds-btn-ghost:hover {
  background-color: var(--ds-neutral-100);
  border-color: var(--ds-neutral-200);
  color: var(--ds-neutral-700);
}

/* Button Sizes */
.ds-btn-sm {
  padding: var(--ds-space-1) var(--ds-space-3);
  font-size: var(--ds-text-xs);
}

.ds-btn-lg {
  padding: var(--ds-space-3) var(--ds-space-6);
  font-size: var(--ds-text-base);
}

/* Icon-only button */
.ds-btn-icon {
  padding: var(--ds-space-2);
  aspect-ratio: 1;
}

.ds-btn-icon.ds-btn-sm {
  padding: var(--ds-space-1);
}

.ds-btn-icon.ds-btn-lg {
  padding: var(--ds-space-3);
}

/* Button Group */
.ds-btn-group {
  display: inline-flex;
}

.ds-btn-group .ds-btn {
  border-radius: 0;
}

.ds-btn-group .ds-btn:first-child {
  border-radius: var(--ds-radius-md) 0 0 var(--ds-radius-md);
}

.ds-btn-group .ds-btn:last-child {
  border-radius: 0 var(--ds-radius-md) var(--ds-radius-md) 0;
}

.ds-btn-group .ds-btn:not(:last-child) {
  border-right-width: 0;
}


/* ============================================================================
   5. CARDS & BOXES
   ============================================================================ */

/* Standard Card */
.ds-card {
  background-color: var(--ds-neutral-0);
  border: var(--ds-border-width) solid var(--ds-neutral-200);
  border-radius: var(--ds-radius-lg);
  box-shadow: var(--ds-shadow-xs);
}

.ds-card-header {
  padding: var(--ds-space-4) var(--ds-space-5);
  border-bottom: var(--ds-border-width) solid var(--ds-neutral-200);
  background-color: var(--ds-neutral-50);
  border-radius: var(--ds-radius-lg) var(--ds-radius-lg) 0 0;
}

.ds-card-header-title {
  font-size: var(--ds-text-base);
  font-weight: var(--ds-font-semibold);
  color: var(--ds-neutral-800);
  margin: 0;
}

.ds-card-body {
  padding: var(--ds-space-5);
}

.ds-card-footer {
  padding: var(--ds-space-4) var(--ds-space-5);
  border-top: var(--ds-border-width) solid var(--ds-neutral-200);
  background-color: var(--ds-neutral-50);
  border-radius: 0 0 var(--ds-radius-lg) var(--ds-radius-lg);
}

/* Info Box - Colored background boxes for callouts */
.ds-infobox {
  padding: var(--ds-space-4);
  border-radius: var(--ds-radius-md);
  border-width: var(--ds-border-width);
  border-style: solid;
}

.ds-infobox-info {
  background-color: var(--ds-info-bg);
  border-color: var(--ds-info-border);
  color: var(--ds-info-text);
}

.ds-infobox-success {
  background-color: var(--ds-success-bg);
  border-color: var(--ds-success-border);
  color: var(--ds-success-text);
}

.ds-infobox-warning {
  background-color: var(--ds-warning-bg);
  border-color: var(--ds-warning-border);
  color: var(--ds-warning-text);
}

.ds-infobox-error {
  background-color: var(--ds-error-bg);
  border-color: var(--ds-error-border);
  color: var(--ds-error-text);
}

/* Stat Box - For displaying metrics/numbers */
.ds-stat-box {
  background-color: var(--ds-neutral-0);
  border: var(--ds-border-width) solid var(--ds-neutral-200);
  border-radius: var(--ds-radius-lg);
  padding: var(--ds-space-5);
  text-align: center;
}

.ds-stat-value {
  font-size: var(--ds-text-3xl);
  font-weight: var(--ds-font-bold);
  color: var(--ds-neutral-900);
  line-height: 1;
  margin-bottom: var(--ds-space-1);
}

.ds-stat-label {
  font-size: var(--ds-text-sm);
  color: var(--ds-neutral-500);
  font-weight: var(--ds-font-medium);
}

/* Section Box - For grouping content sections */
.ds-section {
  background-color: var(--ds-neutral-0);
  border: var(--ds-border-width) solid var(--ds-neutral-200);
  border-radius: var(--ds-radius-lg);
  margin-bottom: var(--ds-space-6);
}

.ds-section-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--ds-space-4) var(--ds-space-5);
  border-bottom: var(--ds-border-width) solid var(--ds-neutral-200);
  background-color: var(--ds-neutral-50);
  border-radius: var(--ds-radius-lg) var(--ds-radius-lg) 0 0;
}

.ds-section-title {
  font-size: var(--ds-text-base);
  font-weight: var(--ds-font-semibold);
  color: var(--ds-neutral-800);
  margin: 0;
}

.ds-section-body {
  padding: var(--ds-space-5);
}


/* ============================================================================
   6. FORM ELEMENTS
   ============================================================================ */

/* Form Group */
.ds-form-group {
  margin-bottom: var(--ds-space-4);
}

/* Labels */
.ds-label {
  display: block;
  font-size: var(--ds-text-sm);
  font-weight: var(--ds-font-medium);
  color: var(--ds-neutral-700);
  margin-bottom: var(--ds-space-1);
}

.ds-label-required::after {
  content: " *";
  color: var(--ds-error-500);
}

/* Help Text */
.ds-help-text {
  font-size: var(--ds-text-xs);
  color: var(--ds-neutral-500);
  margin-top: var(--ds-space-1);
}

/* Text Inputs */
.ds-input {
  display: block;
  width: 100%;
  padding: var(--ds-space-2) var(--ds-space-3);
  font-family: var(--ds-font-family);
  font-size: var(--ds-text-sm);
  line-height: var(--ds-leading-normal);
  color: var(--ds-neutral-800);
  background-color: var(--ds-neutral-0);
  border: var(--ds-border-width) solid var(--ds-neutral-300);
  border-radius: var(--ds-radius-md);
  transition: border-color var(--ds-transition-fast), box-shadow var(--ds-transition-fast);
}

.ds-input::placeholder {
  color: var(--ds-neutral-400);
}

.ds-input:hover {
  border-color: var(--ds-neutral-400);
}

.ds-input:focus {
  outline: none;
  border-color: var(--ds-primary-500);
  box-shadow: 0 0 0 3px var(--ds-primary-100);
}

.ds-input:disabled {
  background-color: var(--ds-neutral-100);
  cursor: not-allowed;
  opacity: 0.7;
}

/* Input States */
.ds-input.is-error {
  border-color: var(--ds-error-500);
}

.ds-input.is-error:focus {
  box-shadow: 0 0 0 3px var(--ds-error-100);
}

.ds-input.is-success {
  border-color: var(--ds-success-500);
}

.ds-input.is-success:focus {
  box-shadow: 0 0 0 3px var(--ds-success-100);
}

/* Error Message */
.ds-error-message {
  font-size: var(--ds-text-xs);
  color: var(--ds-error-600);
  margin-top: var(--ds-space-1);
}

/* Textarea */
.ds-textarea {
  min-height: 100px;
  resize: vertical;
}

/* Select */
.ds-select {
  appearance: none;
  background-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 20 20'%3e%3cpath stroke='%236b7280' stroke-linecap='round' stroke-linejoin='round' stroke-width='1.5' d='M6 8l4 4 4-4'/%3e%3c/svg%3e");
  background-position: right var(--ds-space-2) center;
  background-repeat: no-repeat;
  background-size: 1.5em 1.5em;
  padding-right: var(--ds-space-10);
}

/* Checkbox & Radio */
.ds-checkbox-group,
.ds-radio-group {
  display: flex;
  flex-direction: column;
  gap: var(--ds-space-2);
}

.ds-checkbox-label,
.ds-radio-label {
  display: flex;
  align-items: center;
  gap: var(--ds-space-2);
  font-size: var(--ds-text-sm);
  color: var(--ds-neutral-700);
  cursor: pointer;
}

.ds-checkbox,
.ds-radio {
  width: 1rem;
  height: 1rem;
  accent-color: var(--ds-primary-500);
  cursor: pointer;
}

/* Toggle Switch */
.ds-toggle {
  position: relative;
  display: inline-flex;
  align-items: center;
  cursor: pointer;
}

.ds-toggle-input {
  position: absolute;
  opacity: 0;
  width: 0;
  height: 0;
}

.ds-toggle-slider {
  position: relative;
  width: 44px;
  height: 24px;
  background-color: var(--ds-neutral-300);
  border-radius: var(--ds-radius-full);
  transition: background-color var(--ds-transition-fast);
}

.ds-toggle-slider::before {
  content: "";
  position: absolute;
  top: 2px;
  left: 2px;
  width: 20px;
  height: 20px;
  background-color: var(--ds-neutral-0);
  border-radius: var(--ds-radius-full);
  box-shadow: var(--ds-shadow-sm);
  transition: transform var(--ds-transition-fast);
}

.ds-toggle-input:checked + .ds-toggle-slider {
  background-color: var(--ds-primary-500);
}

.ds-toggle-input:checked + .ds-toggle-slider::before {
  transform: translateX(20px);
}

.ds-toggle-input:focus + .ds-toggle-slider {
  box-shadow: 0 0 0 3px var(--ds-primary-100);
}

.ds-toggle-label {
  margin-left: var(--ds-space-3);
  font-size: var(--ds-text-sm);
  color: var(--ds-neutral-700);
}


/* ============================================================================
   7. TABLES
   ============================================================================ */

.ds-table-wrap {
  overflow-x: auto;
  border: var(--ds-border-width) solid var(--ds-neutral-200);
  border-radius: var(--ds-radius-lg);
}

.ds-table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--ds-text-sm);
}

.ds-table th {
  background-color: var(--ds-neutral-50);
  font-weight: var(--ds-font-semibold);
  color: var(--ds-neutral-700);
  text-align: left;
  padding: var(--ds-space-3) var(--ds-space-4);
  border-bottom: var(--ds-border-width) solid var(--ds-neutral-200);
}

.ds-table td {
  padding: var(--ds-space-3) var(--ds-space-4);
  border-bottom: var(--ds-border-width) solid var(--ds-neutral-200);
  color: var(--ds-neutral-700);
}

.ds-table tbody tr:last-child td {
  border-bottom: none;
}

.ds-table tbody tr:hover {
  background-color: var(--ds-neutral-50);
}

/* Striped variant */
.ds-table-striped tbody tr:nth-child(even) {
  background-color: var(--ds-neutral-50);
}

.ds-table-striped tbody tr:hover {
  background-color: var(--ds-neutral-100);
}


/* ============================================================================
   8. BADGES & TAGS
   ============================================================================ */

.ds-badge {
  display: inline-flex;
  align-items: center;
  padding: var(--ds-space-1) var(--ds-space-2);
  font-size: var(--ds-text-xs);
  font-weight: var(--ds-font-medium);
  line-height: 1;
  border-radius: var(--ds-radius-full);
  border: var(--ds-border-width) solid;
}

.ds-badge-default {
  background-color: var(--ds-neutral-100);
  border-color: var(--ds-neutral-300);
  color: var(--ds-neutral-700);
}

.ds-badge-primary {
  background-color: var(--ds-primary-50);
  border-color: var(--ds-primary-300);
  color: var(--ds-primary-700);
}

.ds-badge-success {
  background-color: var(--ds-success-bg);
  border-color: var(--ds-success-border);
  color: var(--ds-success-text);
}

.ds-badge-warning {
  background-color: var(--ds-warning-bg);
  border-color: var(--ds-warning-border);
  color: var(--ds-warning-text);
}

.ds-badge-error {
  background-color: var(--ds-error-bg);
  border-color: var(--ds-error-border);
  color: var(--ds-error-text);
}

.ds-badge-info {
  background-color: var(--ds-info-bg);
  border-color: var(--ds-info-border);
  color: var(--ds-info-text);
}

/* Tag - Similar to badge but with remove button capability */
.ds-tag {
  display: inline-flex;
  align-items: center;
  gap: var(--ds-space-1);
  padding: var(--ds-space-1) var(--ds-space-2);
  font-size: var(--ds-text-xs);
  font-weight: var(--ds-font-medium);
  background-color: var(--ds-neutral-100);
  border: var(--ds-border-width) solid var(--ds-neutral-300);
  border-radius: var(--ds-radius-md);
  color: var(--ds-neutral-700);
}

.ds-tag-remove {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 14px;
  height: 14px;
  padding: 0;
  background: none;
  border: none;
  border-radius: var(--ds-radius-sm);
  color: var(--ds-neutral-500);
  cursor: pointer;
  transition: all var(--ds-transition-fast);
}

.ds-tag-remove:hover {
  background-color: var(--ds-neutral-200);
  color: var(--ds-neutral-700);
}


/* ============================================================================
   9. NAVIGATION & TABS
   ============================================================================ */

/* Tab Navigation */
.ds-tabs {
  display: flex;
  gap: var(--ds-space-1);
  border-bottom: var(--ds-border-width) solid var(--ds-neutral-200);
  margin-bottom: var(--ds-space-5);
}

.ds-tab {
  padding: var(--ds-space-3) var(--ds-space-4);
  font-size: var(--ds-text-sm);
  font-weight: var(--ds-font-medium);
  color: var(--ds-neutral-600);
  background: none;
  border: none;
  border-bottom: 2px solid transparent;
  margin-bottom: -1px;
  cursor: pointer;
  transition: all var(--ds-transition-fast);
}

.ds-tab:hover {
  color: var(--ds-neutral-800);
  background-color: var(--ds-neutral-50);
}

.ds-tab.is-active {
  color: var(--ds-primary-600);
  border-bottom-color: var(--ds-primary-500);
}

/* Pill Navigation */
.ds-pills {
  display: flex;
  gap: var(--ds-space-2);
  padding: var(--ds-space-1);
  background-color: var(--ds-neutral-100);
  border-radius: var(--ds-radius-lg);
}

.ds-pill {
  padding: var(--ds-space-2) var(--ds-space-4);
  font-size: var(--ds-text-sm);
  font-weight: var(--ds-font-medium);
  color: var(--ds-neutral-600);
  background: none;
  border: none;
  border-radius: var(--ds-radius-md);
  cursor: pointer;
  transition: all var(--ds-transition-fast);
}

.ds-pill:hover {
  color: var(--ds-neutral-800);
}

.ds-pill.is-active {
  background-color: var(--ds-neutral-0);
  color: var(--ds-neutral-800);
  box-shadow: var(--ds-shadow-sm);
}


/* ============================================================================
   10. MODALS & OVERLAYS
   ============================================================================ */

.ds-modal-backdrop {
  position: fixed;
  inset: 0;
  background-color: rgb(0 0 0 / 0.5);
  z-index: var(--ds-z-modal-backdrop);
  display: flex;
  align-items: center;
  justify-content: center;
  padding: var(--ds-space-4);
}

.ds-modal {
  background-color: var(--ds-neutral-0);
  border-radius: var(--ds-radius-xl);
  box-shadow: var(--ds-shadow-lg);
  max-width: 500px;
  width: 100%;
  max-height: calc(100vh - var(--ds-space-8));
  overflow: hidden;
  display: flex;
  flex-direction: column;
  z-index: var(--ds-z-modal);
}

.ds-modal-lg {
  max-width: 700px;
}

.ds-modal-xl {
  max-width: 900px;
}

.ds-modal-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--ds-space-4) var(--ds-space-5);
  border-bottom: var(--ds-border-width) solid var(--ds-neutral-200);
}

.ds-modal-title {
  font-size: var(--ds-text-lg);
  font-weight: var(--ds-font-semibold);
  color: var(--ds-neutral-900);
  margin: 0;
}

.ds-modal-close {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 32px;
  height: 32px;
  padding: 0;
  background: none;
  border: none;
  border-radius: var(--ds-radius-md);
  color: var(--ds-neutral-500);
  cursor: pointer;
  transition: all var(--ds-transition-fast);
}

.ds-modal-close:hover {
  background-color: var(--ds-neutral-100);
  color: var(--ds-neutral-700);
}

.ds-modal-body {
  padding: var(--ds-space-5);
  overflow-y: auto;
}

.ds-modal-footer {
  display: flex;
  align-items: center;
  justify-content: flex-end;
  gap: var(--ds-space-3);
  padding: var(--ds-space-4) var(--ds-space-5);
  border-top: var(--ds-border-width) solid var(--ds-neutral-200);
  background-color: var(--ds-neutral-50);
}


/* ============================================================================
   11. DROPDOWNS
   ============================================================================ */

.ds-dropdown {
  position: relative;
  display: inline-block;
}

.ds-dropdown-menu {
  position: absolute;
  top: 100%;
  left: 0;
  z-index: var(--ds-z-dropdown);
  min-width: 180px;
  margin-top: var(--ds-space-1);
  padding: var(--ds-space-1);
  background-color: var(--ds-neutral-0);
  border: var(--ds-border-width) solid var(--ds-neutral-200);
  border-radius: var(--ds-radius-lg);
  box-shadow: var(--ds-shadow-lg);
}

.ds-dropdown-item {
  display: flex;
  align-items: center;
  gap: var(--ds-space-2);
  width: 100%;
  padding: var(--ds-space-2) var(--ds-space-3);
  font-size: var(--ds-text-sm);
  color: var(--ds-neutral-700);
  background: none;
  border: none;
  border-radius: var(--ds-radius-md);
  text-align: left;
  cursor: pointer;
  transition: background-color var(--ds-transition-fast);
}

.ds-dropdown-item:hover {
  background-color: var(--ds-neutral-100);
}

.ds-dropdown-item.is-destructive {
  color: var(--ds-error-600);
}

.ds-dropdown-item.is-destructive:hover {
  background-color: var(--ds-error-50);
}

.ds-dropdown-divider {
  height: 1px;
  margin: var(--ds-space-1) 0;
  background-color: var(--ds-neutral-200);
}


/* ============================================================================
   12. PROGRESS & LOADING
   ============================================================================ */

/* Progress Bar */
.ds-progress {
  width: 100%;
  height: 8px;
  background-color: var(--ds-neutral-200);
  border-radius: var(--ds-radius-full);
  overflow: hidden;
}

.ds-progress-bar {
  height: 100%;
  background-color: var(--ds-primary-500);
  border-radius: var(--ds-radius-full);
  transition: width var(--ds-transition-slow);
}

.ds-progress-bar-success {
  background-color: var(--ds-success-500);
}

.ds-progress-bar-warning {
  background-color: var(--ds-warning-500);
}

.ds-progress-bar-error {
  background-color: var(--ds-error-500);
}

/* Spinner */
.ds-spinner {
  display: inline-block;
  width: 20px;
  height: 20px;
  border: 2px solid var(--ds-neutral-200);
  border-top-color: var(--ds-primary-500);
  border-radius: var(--ds-radius-full);
  animation: ds-spin 0.6s linear infinite;
}

.ds-spinner-sm {
  width: 14px;
  height: 14px;
  border-width: 2px;
}

.ds-spinner-lg {
  width: 32px;
  height: 32px;
  border-width: 3px;
}

@keyframes ds-spin {
  to {
    transform: rotate(360deg);
  }
}

/* Skeleton Loading */
.ds-skeleton {
  background: linear-gradient(
    90deg,
    var(--ds-neutral-200) 25%,
    var(--ds-neutral-100) 50%,
    var(--ds-neutral-200) 75%
  );
  background-size: 200% 100%;
  animation: ds-shimmer 1.5s infinite;
  border-radius: var(--ds-radius-md);
}

.ds-skeleton-text {
  height: 1em;
  margin-bottom: var(--ds-space-2);
}

.ds-skeleton-heading {
  height: 1.5em;
  width: 60%;
  margin-bottom: var(--ds-space-3);
}

.ds-skeleton-avatar {
  width: 40px;
  height: 40px;
  border-radius: var(--ds-radius-full);
}

@keyframes ds-shimmer {
  0% {
    background-position: 200% 0;
  }
  100% {
    background-position: -200% 0;
  }
}


/* ============================================================================
   13. TOOLTIPS
   ============================================================================ */

.ds-tooltip {
  position: relative;
  display: inline-block;
}

.ds-tooltip-content {
  position: absolute;
  bottom: 100%;
  left: 50%;
  transform: translateX(-50%);
  z-index: var(--ds-z-tooltip);
  padding: var(--ds-space-2) var(--ds-space-3);
  margin-bottom: var(--ds-space-1);
  font-size: var(--ds-text-xs);
  font-weight: var(--ds-font-medium);
  color: var(--ds-neutral-0);
  background-color: var(--ds-neutral-800);
  border-radius: var(--ds-radius-md);
  white-space: nowrap;
  opacity: 0;
  visibility: hidden;
  transition: opacity var(--ds-transition-fast), visibility var(--ds-transition-fast);
}

.ds-tooltip-content::after {
  content: "";
  position: absolute;
  top: 100%;
  left: 50%;
  transform: translateX(-50%);
  border: 4px solid transparent;
  border-top-color: var(--ds-neutral-800);
}

.ds-tooltip:hover .ds-tooltip-content {
  opacity: 1;
  visibility: visible;
}


/* ============================================================================
   14. EMPTY STATES
   ============================================================================ */

.ds-empty-state {
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  padding: var(--ds-space-12) var(--ds-space-6);
  text-align: center;
}

.ds-empty-state-icon {
  width: 64px;
  height: 64px;
  margin-bottom: var(--ds-space-4);
  color: var(--ds-neutral-400);
}

.ds-empty-state-title {
  font-size: var(--ds-text-lg);
  font-weight: var(--ds-font-semibold);
  color: var(--ds-neutral-800);
  margin: 0 0 var(--ds-space-2) 0;
}

.ds-empty-state-description {
  font-size: var(--ds-text-sm);
  color: var(--ds-neutral-500);
  margin: 0 0 var(--ds-space-6) 0;
  max-width: 400px;
}


/* ============================================================================
   15. AVATARS
   ============================================================================ */

.ds-avatar {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 40px;
  height: 40px;
  background-color: var(--ds-primary-100);
  border-radius: var(--ds-radius-full);
  font-size: var(--ds-text-sm);
  font-weight: var(--ds-font-semibold);
  color: var(--ds-primary-700);
  overflow: hidden;
}

.ds-avatar img {
  width: 100%;
  height: 100%;
  object-fit: cover;
}

.ds-avatar-sm {
  width: 32px;
  height: 32px;
  font-size: var(--ds-text-xs);
}

.ds-avatar-lg {
  width: 56px;
  height: 56px;
  font-size: var(--ds-text-lg);
}

.ds-avatar-xl {
  width: 80px;
  height: 80px;
  font-size: var(--ds-text-2xl);
}

/* Avatar Group */
.ds-avatar-group {
  display: flex;
}

.ds-avatar-group .ds-avatar {
  border: 2px solid var(--ds-neutral-0);
  margin-left: -8px;
}

.ds-avatar-group .ds-avatar:first-child {
  margin-left: 0;
}


/* ============================================================================
   16. DIVIDERS
   ============================================================================ */

.ds-divider {
  height: 1px;
  background-color: var(--ds-neutral-200);
  border: none;
  margin: var(--ds-space-4) 0;
}

.ds-divider-lg {
  margin: var(--ds-space-6) 0;
}

.ds-divider-with-text {
  display: flex;
  align-items: center;
  gap: var(--ds-space-4);
  color: var(--ds-neutral-500);
  font-size: var(--ds-text-sm);
}

.ds-divider-with-text::before,
.ds-divider-with-text::after {
  content: "";
  flex: 1;
  height: 1px;
  background-color: var(--ds-neutral-200);
}


/* ============================================================================
   17. UTILITY CLASSES
   ============================================================================ */

/* Display */
.ds-hidden { display: none !important; }
.ds-block { display: block; }
.ds-inline-block { display: inline-block; }
.ds-flex { display: flex; }
.ds-inline-flex { display: inline-flex; }
.ds-grid { display: grid; }

/* Flex utilities */
.ds-flex-row { flex-direction: row; }
.ds-flex-col { flex-direction: column; }
.ds-flex-wrap { flex-wrap: wrap; }
.ds-flex-1 { flex: 1 1 0%; }
.ds-flex-auto { flex: 1 1 auto; }
.ds-flex-none { flex: none; }

/* Alignment */
.ds-items-start { align-items: flex-start; }
.ds-items-center { align-items: center; }
.ds-items-end { align-items: flex-end; }
.ds-justify-start { justify-content: flex-start; }
.ds-justify-center { justify-content: center; }
.ds-justify-end { justify-content: flex-end; }
.ds-justify-between { justify-content: space-between; }

/* Gap */
.ds-gap-1 { gap: var(--ds-space-1); }
.ds-gap-2 { gap: var(--ds-space-2); }
.ds-gap-3 { gap: var(--ds-space-3); }
.ds-gap-4 { gap: var(--ds-space-4); }
.ds-gap-6 { gap: var(--ds-space-6); }
.ds-gap-8 { gap: var(--ds-space-8); }

/* Margin */
.ds-m-0 { margin: 0; }
.ds-m-auto { margin: auto; }
.ds-mt-0 { margin-top: 0; }
.ds-mt-2 { margin-top: var(--ds-space-2); }
.ds-mt-4 { margin-top: var(--ds-space-4); }
.ds-mt-6 { margin-top: var(--ds-space-6); }
.ds-mb-0 { margin-bottom: 0; }
.ds-mb-2 { margin-bottom: var(--ds-space-2); }
.ds-mb-4 { margin-bottom: var(--ds-space-4); }
.ds-mb-6 { margin-bottom: var(--ds-space-6); }

/* Padding */
.ds-p-0 { padding: 0; }
.ds-p-2 { padding: var(--ds-space-2); }
.ds-p-4 { padding: var(--ds-space-4); }
.ds-p-6 { padding: var(--ds-space-6); }

/* Text alignment */
.ds-text-left { text-align: left; }
.ds-text-center { text-align: center; }
.ds-text-right { text-align: right; }

/* Width */
.ds-w-full { width: 100%; }
.ds-w-auto { width: auto; }
.ds-max-w-sm { max-width: 24rem; }
.ds-max-w-md { max-width: 28rem; }
.ds-max-w-lg { max-width: 32rem; }
.ds-max-w-xl { max-width: 36rem; }

/* Visibility */
.ds-sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}


/* ============================================================================
   18. RESPONSIVE GRID
   ============================================================================ */

.ds-row {
  display: flex;
  flex-wrap: wrap;
  margin-left: calc(var(--ds-space-4) * -0.5);
  margin-right: calc(var(--ds-space-4) * -0.5);
}

.ds-col {
  flex: 1 0 0%;
  padding-left: calc(var(--ds-space-4) * 0.5);
  padding-right: calc(var(--ds-space-4) * 0.5);
}

.ds-col-auto { flex: 0 0 auto; width: auto; }
.ds-col-1 { flex: 0 0 auto; width: 8.333333%; }
.ds-col-2 { flex: 0 0 auto; width: 16.666667%; }
.ds-col-3 { flex: 0 0 auto; width: 25%; }
.ds-col-4 { flex: 0 0 auto; width: 33.333333%; }
.ds-col-5 { flex: 0 0 auto; width: 41.666667%; }
.ds-col-6 { flex: 0 0 auto; width: 50%; }
.ds-col-7 { flex: 0 0 auto; width: 58.333333%; }
.ds-col-8 { flex: 0 0 auto; width: 66.666667%; }
.ds-col-9 { flex: 0 0 auto; width: 75%; }
.ds-col-10 { flex: 0 0 auto; width: 83.333333%; }
.ds-col-11 { flex: 0 0 auto; width: 91.666667%; }
.ds-col-12 { flex: 0 0 auto; width: 100%; }

@media (min-width: 768px) {
  .ds-col-md-1 { flex: 0 0 auto; width: 8.333333%; }
  .ds-col-md-2 { flex: 0 0 auto; width: 16.666667%; }
  .ds-col-md-3 { flex: 0 0 auto; width: 25%; }
  .ds-col-md-4 { flex: 0 0 auto; width: 33.333333%; }
  .ds-col-md-5 { flex: 0 0 auto; width: 41.666667%; }
  .ds-col-md-6 { flex: 0 0 auto; width: 50%; }
  .ds-col-md-7 { flex: 0 0 auto; width: 58.333333%; }
  .ds-col-md-8 { flex: 0 0 auto; width: 66.666667%; }
  .ds-col-md-9 { flex: 0 0 auto; width: 75%; }
  .ds-col-md-10 { flex: 0 0 auto; width: 83.333333%; }
  .ds-col-md-11 { flex: 0 0 auto; width: 91.666667%; }
  .ds-col-md-12 { flex: 0 0 auto; width: 100%; }
}

@media (min-width: 1024px) {
  .ds-col-lg-1 { flex: 0 0 auto; width: 8.333333%; }
  .ds-col-lg-2 { flex: 0 0 auto; width: 16.666667%; }
  .ds-col-lg-3 { flex: 0 0 auto; width: 25%; }
  .ds-col-lg-4 { flex: 0 0 auto; width: 33.333333%; }
  .ds-col-lg-5 { flex: 0 0 auto; width: 41.666667%; }
  .ds-col-lg-6 { flex: 0 0 auto; width: 50%; }
  .ds-col-lg-7 { flex: 0 0 auto; width: 58.333333%; }
  .ds-col-lg-8 { flex: 0 0 auto; width: 66.666667%; }
  .ds-col-lg-9 { flex: 0 0 auto; width: 75%; }
  .ds-col-lg-10 { flex: 0 0 auto; width: 83.333333%; }
  .ds-col-lg-11 { flex: 0 0 auto; width: 91.666667%; }
  .ds-col-lg-12 { flex: 0 0 auto; width: 100%; }
}


/* ============================================================================
   19. WORDPRESS ADMIN OVERRIDES
   ============================================================================
   
   These styles help ensure consistency within the WordPress admin context
   by resetting some WP defaults within the plugin wrapper.
*/

.ds-plugin-wrap input[type="text"],
.ds-plugin-wrap input[type="email"],
.ds-plugin-wrap input[type="url"],
.ds-plugin-wrap input[type="password"],
.ds-plugin-wrap input[type="number"],
.ds-plugin-wrap input[type="search"],
.ds-plugin-wrap input[type="tel"],
.ds-plugin-wrap textarea,
.ds-plugin-wrap select {
  /* Override WP admin styles to use our design system */
  border-color: var(--ds-neutral-300);
  border-radius: var(--ds-radius-md);
  box-shadow: none;
  padding: var(--ds-space-2) var(--ds-space-3);
  font-size: var(--ds-text-sm);
  line-height: var(--ds-leading-normal);
}

.ds-plugin-wrap input[type="text"]:focus,
.ds-plugin-wrap input[type="email"]:focus,
.ds-plugin-wrap input[type="url"]:focus,
.ds-plugin-wrap input[type="password"]:focus,
.ds-plugin-wrap input[type="number"]:focus,
.ds-plugin-wrap input[type="search"]:focus,
.ds-plugin-wrap input[type="tel"]:focus,
.ds-plugin-wrap textarea:focus,
.ds-plugin-wrap select:focus {
  border-color: var(--ds-primary-500);
  box-shadow: 0 0 0 3px var(--ds-primary-100);
  outline: none;
}

/* Reset WP button styles within plugin */
.ds-plugin-wrap .button,
.ds-plugin-wrap .button-primary,
.ds-plugin-wrap .button-secondary {
  /* Let our button classes take over */
  all: unset;
}