/* ============================================================
   SCHOLARIA UTILITY CLASSES
   Small, single-purpose classes that replace inline styles.
   Use sparingly — prefer component classes for complex patterns.
   ============================================================ */

/* ---- Text Colors ---- */
.text-primary   { color: var(--color-primary) !important; }
.text-success   { color: var(--color-success) !important; }
.text-danger    { color: var(--color-danger) !important; }
.text-warning   { color: var(--color-warning-dark) !important; }
.text-info      { color: var(--color-info) !important; }
.text-muted     { color: var(--color-text-tertiary) !important; }
.text-secondary { color: var(--color-text-secondary) !important; }
.text-inverse   { color: var(--color-text-inverse) !important; }

/* ---- Background Colors ---- */
.bg-surface     { background-color: var(--color-surface) !important; }
.bg-muted       { background-color: var(--color-gray-100) !important; }
.bg-primary     { background-color: var(--color-primary) !important; }
.bg-success     { background-color: var(--color-success-bg) !important; }
.bg-danger      { background-color: var(--color-danger-bg) !important; }
.bg-warning     { background-color: var(--color-warning-bg) !important; }
.bg-info        { background-color: var(--color-info-bg) !important; }

/* ---- Text Alignment ---- */
.text-left   { text-align: left !important; }
.text-center { text-align: center !important; }
.text-right  { text-align: right !important; }

/* ---- Text Size ---- */
.text-xs   { font-size: var(--font-size-xs) !important; }
.text-sm   { font-size: var(--font-size-sm) !important; }
.text-base { font-size: var(--font-size-base) !important; }
.text-lg   { font-size: var(--font-size-lg) !important; }
.text-xl   { font-size: var(--font-size-xl) !important; }
.text-2xl  { font-size: var(--font-size-2xl) !important; }

/* ---- Font Weight ---- */
.font-normal   { font-weight: var(--font-weight-normal) !important; }
.font-medium   { font-weight: var(--font-weight-medium) !important; }
.font-semibold { font-weight: var(--font-weight-semibold) !important; }
.font-bold     { font-weight: var(--font-weight-bold) !important; }

/* ---- Text Utilities ---- */
.truncate {
  overflow: hidden !important;
  text-overflow: ellipsis !important;
  white-space: nowrap !important;
}

.line-clamp-2 {
  display: -webkit-box !important;
  -webkit-line-clamp: 2;
  -webkit-box-orient: vertical;
  overflow: hidden !important;
}

.line-clamp-3 {
  display: -webkit-box !important;
  -webkit-line-clamp: 3;
  -webkit-box-orient: vertical;
  overflow: hidden !important;
}

.uppercase { text-transform: uppercase !important; }
.capitalize { text-transform: capitalize !important; }
.no-wrap { white-space: nowrap !important; }

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

/* ---- Responsive Display ---- */
@media (min-width: 640px) {
  .sm\:d-none  { display: none !important; }
  .sm\:d-block { display: block !important; }
  .sm\:d-flex  { display: flex !important; }
}

@media (min-width: 768px) {
  .md\:d-none  { display: none !important; }
  .md\:d-block { display: block !important; }
  .md\:d-flex  { display: flex !important; }
}

@media (min-width: 1024px) {
  .lg\:d-none  { display: none !important; }
  .lg\:d-block { display: block !important; }
  .lg\:d-flex  { display: flex !important; }
}

/* ---- Flexbox Utilities ---- */
.flex-row    { flex-direction: row !important; }
.flex-col    { flex-direction: column !important; }
.flex-wrap   { flex-wrap: wrap !important; }
.flex-1      { flex: 1 1 0% !important; }
.flex-auto   { flex: 1 1 auto !important; }
.flex-none   { flex: none !important; }

.items-start   { align-items: flex-start !important; }
.items-center  { align-items: center !important; }
.items-end     { align-items: flex-end !important; }
.items-stretch { align-items: stretch !important; }

.justify-start   { justify-content: flex-start !important; }
.justify-center  { justify-content: center !important; }
.justify-end     { justify-content: flex-end !important; }
.justify-between { justify-content: space-between !important; }
.justify-around  { justify-content: space-around !important; }

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

/* ---- Margin ---- */
.m-0  { margin: 0 !important; }
.m-auto { margin: auto !important; }
.mx-auto { margin-left: auto !important; margin-right: auto !important; }
.mt-0 { margin-top: 0 !important; }
.mt-1 { margin-top: var(--space-1) !important; }
.mt-2 { margin-top: var(--space-2) !important; }
.mt-3 { margin-top: var(--space-3) !important; }
.mt-4 { margin-top: var(--space-4) !important; }
.mt-6 { margin-top: var(--space-6) !important; }
.mt-8 { margin-top: var(--space-8) !important; }
.mb-0 { margin-bottom: 0 !important; }
.mb-1 { margin-bottom: var(--space-1) !important; }
.mb-2 { margin-bottom: var(--space-2) !important; }
.mb-3 { margin-bottom: var(--space-3) !important; }
.mb-4 { margin-bottom: var(--space-4) !important; }
.mb-6 { margin-bottom: var(--space-6) !important; }
.mb-8 { margin-bottom: var(--space-8) !important; }
.ml-auto { margin-left: auto !important; }
.mr-2 { margin-right: var(--space-2) !important; }
.mr-3 { margin-right: var(--space-3) !important; }

/* ---- Padding ---- */
.p-0 { padding: 0 !important; }
.p-2 { padding: var(--space-2) !important; }
.p-3 { padding: var(--space-3) !important; }
.p-4 { padding: var(--space-4) !important; }
.p-5 { padding: var(--space-5) !important; }
.p-6 { padding: var(--space-6) !important; }
.p-8 { padding: var(--space-8) !important; }
.px-3 { padding-left: var(--space-3) !important; padding-right: var(--space-3) !important; }
.px-4 { padding-left: var(--space-4) !important; padding-right: var(--space-4) !important; }
.px-6 { padding-left: var(--space-6) !important; padding-right: var(--space-6) !important; }
.py-2 { padding-top: var(--space-2) !important; padding-bottom: var(--space-2) !important; }
.py-3 { padding-top: var(--space-3) !important; padding-bottom: var(--space-3) !important; }
.py-4 { padding-top: var(--space-4) !important; padding-bottom: var(--space-4) !important; }

/* ---- Width / Height ---- */
.w-full { width: 100% !important; }
.w-auto { width: auto !important; }
.h-full { height: 100% !important; }
.min-h-screen { min-height: 100vh !important; }

/* ---- Border ---- */
.border     { border: 1px solid var(--color-border) !important; }
.border-0   { border: 0 !important; }
.border-t   { border-top: 1px solid var(--color-border) !important; }
.border-b   { border-bottom: 1px solid var(--color-border) !important; }
.rounded-sm { border-radius: var(--radius-sm) !important; }
.rounded    { border-radius: var(--radius-md) !important; }
.rounded-lg { border-radius: var(--radius-lg) !important; }
.rounded-xl { border-radius: var(--radius-xl) !important; }
.rounded-full { border-radius: var(--radius-full) !important; }

/* ---- Shadow ---- */
.shadow-none { box-shadow: none !important; }
.shadow-sm   { box-shadow: var(--shadow-sm) !important; }
.shadow      { box-shadow: var(--shadow-md) !important; }
.shadow-lg   { box-shadow: var(--shadow-lg) !important; }

/* ---- Overflow ---- */
.overflow-hidden { overflow: hidden !important; }
.overflow-auto   { overflow: auto !important; }
.overflow-x-auto { overflow-x: auto !important; }

/* ---- Position ---- */
.relative { position: relative !important; }
.absolute { position: absolute !important; }
.fixed    { position: fixed !important; }
.sticky   { position: sticky !important; }

/* ---- Cursor ---- */
.cursor-pointer { cursor: pointer !important; }
.cursor-default { cursor: default !important; }

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

.visually-hidden {
  position: absolute !important;
  width: 1px !important;
  height: 1px !important;
  padding: 0 !important;
  margin: -1px !important;
  overflow: hidden !important;
  clip: rect(0, 0, 0, 0) !important;
  white-space: nowrap !important;
  border-width: 0 !important;
}

.visually-hidden:focus,
.visually-hidden:active {
  position: static !important;
  width: auto !important;
  height: auto !important;
  padding: inherit !important;
  margin: inherit !important;
  overflow: visible !important;
  clip: auto !important;
  white-space: inherit !important;
}

/* ---- Opacity ---- */
.opacity-0   { opacity: 0 !important; }
.opacity-50  { opacity: 0.5 !important; }
.opacity-75  { opacity: 0.75 !important; }
.opacity-100 { opacity: 1 !important; }

/* ---- Badges (inline status indicators) ---- */
.badge {
  display: inline-flex;
  align-items: center;
  padding: var(--space-0-5) var(--space-2);
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-medium);
  line-height: 1;
  border-radius: var(--radius-full);
  white-space: nowrap;
}

.badge--primary {
  background-color: var(--color-primary-light);
  color: var(--color-primary-dark);
}

.badge--success {
  background-color: var(--color-success-light);
  color: var(--color-success-dark);
}

.badge--danger {
  background-color: var(--color-danger-light);
  color: var(--color-danger-dark);
}

.badge--warning {
  background-color: var(--color-warning-light);
  color: var(--color-warning-dark);
}

.badge--info {
  background-color: var(--color-info-light);
  color: var(--color-info-dark);
}

.badge--neutral {
  background-color: var(--color-gray-200);
  color: var(--color-gray-700);
}

/* ---- Avatar ---- */
.avatar {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  border-radius: var(--radius-full);
  background-color: var(--color-primary-light);
  color: var(--color-primary);
  font-weight: var(--font-weight-semibold);
  overflow: hidden;
  flex-shrink: 0;
}

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

.avatar--md {
  width: 40px;
  height: 40px;
  font-size: var(--font-size-sm);
}

.avatar--lg {
  width: 48px;
  height: 48px;
  font-size: var(--font-size-base);
}

.avatar--xl {
  width: 64px;
  height: 64px;
  font-size: var(--font-size-lg);
}

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

/* ---- Container ---- */
.container {
  width: 100%;
  max-width: var(--container-max);
  margin-left: auto;
  margin-right: auto;
  padding-left: var(--space-4);
  padding-right: var(--space-4);
}

@media (min-width: 640px) {
  .container {
    padding-left: var(--space-6);
    padding-right: var(--space-6);
  }
}

/* ---- Page Content Wrapper (works with sidebar layout) ---- */
.page-content {
  padding: var(--space-4);
  padding-bottom: calc(var(--bottombar-height) + var(--space-4));
}

@media (min-width: 1024px) {
  .page-content {
    margin-left: var(--sidebar-width);
    padding: var(--space-6) var(--space-8);
    padding-bottom: var(--space-6);
  }

  .sidebar-collapsed .page-content {
    margin-left: var(--sidebar-collapsed);
  }
}

/* ---- Page Header (title + actions area) ---- */
.page-header {
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
  margin-bottom: var(--space-6);
}

.page-header__title {
  font-size: var(--font-size-2xl);
  font-weight: var(--font-weight-bold);
  color: var(--color-text);
}

.page-header__subtitle {
  font-size: var(--font-size-sm);
  color: var(--color-text-secondary);
}

.page-header__actions {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-2);
}

@media (min-width: 640px) {
  .page-header {
    flex-direction: row;
    align-items: center;
    justify-content: space-between;
  }
}

/* ---- Empty State ---- */
.empty-state {
  text-align: center;
  padding: var(--space-12) var(--space-4);
  color: var(--color-text-secondary);
}

.empty-state__icon {
  font-size: 3rem;
  margin-bottom: var(--space-4);
  opacity: 0.4;
}

.empty-state__title {
  font-size: var(--font-size-lg);
  font-weight: var(--font-weight-semibold);
  color: var(--color-text);
  margin-bottom: var(--space-2);
}

.empty-state__description {
  font-size: var(--font-size-sm);
  max-width: 400px;
  margin: 0 auto var(--space-6);
}

/* ---- Divider ---- */
.divider {
  height: 1px;
  background-color: var(--color-border);
  margin: var(--space-4) 0;
}