/* ================================================================
   LEAST LMS — Base
   Normalisation, focus, layout utilities, typography utilities.
   No element selectors except :focus-visible and *, which are
   safe additive changes that do not break legacy layout.
   ================================================================ */

/* ── Box sizing (scoped) ─────────────────────────────────────────
   Scoped to .ui-scope containers only — legacy float/inline-block
   layouts outside .ui-scope are unaffected.

   PHP usage: wrap any new-UI section in a scope root:
     <div class="ui-scope">
       ... new UI content here ...
     </div>

   Do NOT add .ui-scope to elements that contain legacy layout
   (e.g. the outer page shell, existing form tables).
   ──────────────────────────────────────────────────────────────── */
.ui-scope,
.ui-scope *,
.ui-scope *::before,
.ui-scope *::after {
  box-sizing: border-box;
}

/* ── Scope root styles ───────────────────────────────────────────
   Base rendering quality for all .ui-scope sections.
   font-smoothing is cosmetic-only and additive — safe.
   ──────────────────────────────────────────────────────────────── */
.ui-scope {
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

/* ── Focus management ────────────────────────────────────────────
   Replaces the default browser outline with a consistent token-
   driven ring. :focus-visible only fires on keyboard navigation,
   so mouse users are not affected.
   ──────────────────────────────────────────────────────────────── */
:focus-visible {
  outline: none;
  box-shadow: var(--shadow-focus, 0 0 0 3px rgba(37, 99, 235, 0.25));
}

/* Ensure legacy elements also get the improved focus ring */
a:focus-visible,
button:focus-visible,
input:focus-visible,
select:focus-visible,
textarea:focus-visible {
  outline: none;
  box-shadow: var(--shadow-focus);
}

/* ── Container ───────────────────────────────────────────────────
   Centred, max-width wrapper. Safe to nest inside existing forms.
   ──────────────────────────────────────────────────────────────── */
.ui-container {
  width: 100%;
  max-width: var(--container-max);
  margin-left: auto;
  margin-right: auto;
  padding-left: var(--space-4);
  padding-right: var(--space-4);
}

.ui-container-narrow {
  max-width: var(--content-width);
}

/* ── Stack (vertical rhythm) ─────────────────────────────────────
   Adds consistent vertical gap between direct children.
   ──────────────────────────────────────────────────────────────── */
.ui-stack {
  display: flex;
  flex-direction: column;
  gap: var(--space-5);
}

.ui-stack-sm {
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
}

.ui-stack-lg {
  display: flex;
  flex-direction: column;
  gap: var(--space-7);
}

/* ── Cluster (horizontal wrap) ───────────────────────────────────
   Horizontal flex row that wraps. Use for button groups, tags, etc.
   ──────────────────────────────────────────────────────────────── */
.ui-cluster {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: var(--space-2);
}

.ui-cluster-end {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: flex-end;
  gap: var(--space-2);
}

/* ── Responsive grid ─────────────────────────────────────────────
   Auto-fills columns at minimum 240px. No breakpoints needed.
   ──────────────────────────────────────────────────────────────── */
.ui-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  gap: var(--space-5);
}

.ui-grid-2 {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
  gap: var(--space-5);
}

/* ── Divider ─────────────────────────────────────────────────────*/
.ui-divider {
  border: none;
  border-top: 1px solid var(--color-border);
  margin: var(--space-5) 0;
}

/* ── Page section ────────────────────────────────────────────────
   Adds top-level page padding when used inside existing forms.
   ──────────────────────────────────────────────────────────────── */
.ui-page {
  padding: var(--space-6) var(--space-5);
  background-color: var(--color-bg);
  min-height: 100%;
}

@media (max-width: 768px) {
  .ui-page {
    padding: var(--space-4) var(--space-3);
  }
}

/* ── Section header ──────────────────────────────────────────────*/
.ui-section-title {
  font-size: var(--font-size-lg);
  font-weight: var(--font-weight-semibold);
  color: var(--color-text);
  letter-spacing: var(--letter-spacing-tight);
  margin: 0 0 var(--space-4);
  line-height: var(--line-height-tight);
}

.ui-section-subtitle {
  font-size: var(--font-size-base);
  color: var(--color-text-muted);
  margin: calc(-1 * var(--space-3)) 0 var(--space-4);
}

/* ── Typography utilities ────────────────────────────────────────*/
.ui-text-xs     { font-size: var(--font-size-xs); }
.ui-text-sm     { font-size: var(--font-size-sm); }
.ui-text-base   { font-size: var(--font-size-base); }
.ui-text-lg     { font-size: var(--font-size-lg); }

.ui-text-muted  { color: var(--color-text-muted); }
.ui-text-subtle { color: var(--color-text-subtle); }
.ui-text-accent { color: var(--color-accent-text); }
.ui-text-danger { color: var(--color-danger); }
.ui-text-success{ color: var(--color-success); }

.ui-text-bold   { font-weight: var(--font-weight-semibold); }
.ui-text-upper  {
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-semibold);
  letter-spacing: var(--letter-spacing-wider);
  text-transform: uppercase;
}

/* ── Visibility utilities ────────────────────────────────────────*/
.ui-hidden   { display: none !important; }
.ui-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;
}

@media (prefers-reduced-motion: reduce) {
  * {
    transition: none !important;
    animation: none !important;
  }
}