/* ==========================================================================
   utils.css — Single-purpose utility classes
   Built on theme.css tokens and OpenProps.

   Load order: open-props → normalize → theme.css → global.css → utils.css → components.css
   ========================================================================== */

/* ==========================================================================
   LAYOUT PRIMITIVES
   ========================================================================== */

/* Container — centered max-width wrapper */
.container {
  width: 100%;
  max-width: var(--content-max-width);
  margin-inline: auto;
  padding-inline: var(--space-sm);
}

/* Stack — vertical flow with consistent spacing */
.stack {
  display: flex;
  flex-direction: column;
  gap: var(--space-md);
}

.stack--sm { gap: var(--space-sm); }
.stack--lg { gap: var(--space-lg); }
.stack--xl { gap: var(--space-xl); }

/* Cluster — horizontal wrapping layout */
.cluster {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-sm);
  align-items: center;
}

.cluster--sm { gap: var(--space-2xs); }
.cluster--lg { gap: var(--space-md); }

/* Auto Grid — responsive grid without breakpoints */
.auto-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(min(100%, 280px), 1fr));
  gap: var(--space-md);
}

.auto-grid--narrow {
  grid-template-columns: repeat(auto-fill, minmax(min(100%, 180px), 1fr));
}

.auto-grid--wide {
  grid-template-columns: repeat(auto-fill, minmax(min(100%, 380px), 1fr));
}

/* Sidebar — sidebar + main content split (first child = sidebar) */
.with-sidebar {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-md);
}

.with-sidebar > :first-child {
  flex-basis: 280px;
  flex-grow: 1;
}

.with-sidebar > :last-child {
  flex-basis: 0;
  flex-grow: 999;
  min-inline-size: 60%;
}

/* Flex atomic utilities */
.flex         { display: flex; }
.flex-col     { flex-direction: column; }
.flex-wrap    { flex-wrap: wrap; }
.items-center { align-items: center; }
.items-start  { align-items: flex-start; }
.items-end    { align-items: flex-end; }
.justify-center  { justify-content: center; }
.justify-between { justify-content: space-between; }
.justify-end     { justify-content: flex-end; }

/* Grid utility */
.grid { display: grid; }

/* ==========================================================================
   SPACING
   Scale: 3xs(4) · 2xs(8) · sm(16) · md(24) · lg(32) · xl(48) · 2xl(80) · 3xl(120)
   ========================================================================== */

/* ---- Margin-block-start (.mt-*) ---- */
.mt-3xs { margin-block-start: var(--space-3xs); }
.mt-2xs { margin-block-start: var(--space-2xs); }
.mt-sm  { margin-block-start: var(--space-sm); }
.mt-md  { margin-block-start: var(--space-md); }
.mt-lg  { margin-block-start: var(--space-lg); }
.mt-xl  { margin-block-start: var(--space-xl); }
.mt-2xl { margin-block-start: var(--space-2xl); }
.mt-3xl { margin-block-start: var(--space-3xl); }
.mt-0   { margin-block-start: 0; }

/* ---- Padding (.p-*) ---- */
.p-3xs { padding: var(--space-3xs); }
.p-2xs { padding: var(--space-2xs); }
.p-sm  { padding: var(--space-sm); }
.p-md  { padding: var(--space-md); }
.p-lg  { padding: var(--space-lg); }
.p-xl  { padding: var(--space-xl); }
.p-2xl { padding: var(--space-2xl); }
.p-3xl { padding: var(--space-3xl); }
.p-0   { padding: 0; }

/* ---- Padding-inline (.px-*) ---- */
.px-3xs { padding-inline: var(--space-3xs); }
.px-2xs { padding-inline: var(--space-2xs); }
.px-sm  { padding-inline: var(--space-sm); }
.px-md  { padding-inline: var(--space-md); }
.px-lg  { padding-inline: var(--space-lg); }
.px-xl  { padding-inline: var(--space-xl); }
.px-2xl { padding-inline: var(--space-2xl); }
.px-3xl { padding-inline: var(--space-3xl); }
.px-0   { padding-inline: 0; }

/* ---- Padding-block (.py-*) ---- */
.py-3xs { padding-block: var(--space-3xs); }
.py-2xs { padding-block: var(--space-2xs); }
.py-sm  { padding-block: var(--space-sm); }
.py-md  { padding-block: var(--space-md); }
.py-lg  { padding-block: var(--space-lg); }
.py-xl  { padding-block: var(--space-xl); }
.py-2xl { padding-block: var(--space-2xl); }
.py-3xl { padding-block: var(--space-3xl); }
.py-0   { padding-block: 0; }

/* ---- Gap (.gap-*) ---- */
.gap-3xs { gap: var(--space-3xs); }
.gap-2xs { gap: var(--space-2xs); }
.gap-sm  { gap: var(--space-sm); }
.gap-md  { gap: var(--space-md); }
.gap-lg  { gap: var(--space-lg); }
.gap-xl  { gap: var(--space-xl); }
.gap-2xl { gap: var(--space-2xl); }
.gap-3xl { gap: var(--space-3xl); }
.gap-0   { gap: 0; }

/* ==========================================================================
   TEXT & TYPOGRAPHY
   ========================================================================== */

/* ---- Alignment ---- */
.text-center { text-align: center; }
.text-start  { text-align: start; }
.text-end    { text-align: end; }

/* ---- Weight ---- */
.font-normal { font-weight: var(--font-weight-4); }
.font-medium { font-weight: var(--font-weight-5); }
.font-bold   { font-weight: var(--font-weight-7); }

/* ---- Color ---- */
.text-muted     { color: var(--text-muted); }
.text-secondary { color: var(--text-secondary); }
.text-inverse   { color: var(--text-inverse); }
.text-brand     { color: var(--color-primary); }
.text-accent    { color: var(--color-accent); }
.text-success   { color: var(--color-success); }
.text-error     { color: var(--color-error); }

/* ---- Size overrides (mapped to OpenProps --font-size-*) ---- */
.text-xs   { font-size: var(--font-size-00); }  /* ~8px — fine print      */
.text-sm   { font-size: var(--font-size-0); }   /* 12px — captions        */
.text-base { font-size: var(--font-size-1); }   /* 16px — body default    */
.text-lg   { font-size: var(--font-size-2); }   /* ~18px                  */
.text-xl   { font-size: var(--font-size-3); }   /* 20px                   */
.text-2xl  { font-size: var(--font-size-4); }   /* 24px                   */
.text-3xl  { font-size: var(--font-size-5); }   /* 32px                   */

/* ==========================================================================
   VISIBILITY & DISPLAY
   ========================================================================== */

.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;
}

.hidden       { display: none; }
.block        { display: block; }
.inline-block { display: inline-block; }

/* ==========================================================================
   WIDTH, HEIGHT & ASPECT RATIO
   ========================================================================== */

.w-full      { width: 100%; }
.h-full      { height: 100%; }
.max-w-prose { max-inline-size: var(--size-content-3); }  /* 60ch */

.aspect-square     { aspect-ratio: var(--ratio-square); }
.aspect-landscape  { aspect-ratio: var(--ratio-landscape); }
.aspect-portrait   { aspect-ratio: var(--ratio-portrait); }
.aspect-widescreen { aspect-ratio: var(--ratio-widescreen); }

/* ==========================================================================
   DECORATIVE HELPERS
   ========================================================================== */

/* ---- Border radius (OpenProps --radius-*) ---- */
.rounded-sm   { border-radius: var(--radius-1); }
.rounded      { border-radius: var(--radius-2); }
.rounded-lg   { border-radius: var(--radius-3); }
.rounded-xl   { border-radius: var(--radius-4); }
.rounded-full { border-radius: var(--radius-round); }

/* ---- Shadows (OpenProps --shadow-*, tuned by theme.css) ---- */
.shadow-sm { box-shadow: var(--shadow-1); }
.shadow    { box-shadow: var(--shadow-2); }
.shadow-md { box-shadow: var(--shadow-3); }
.shadow-lg { box-shadow: var(--shadow-4); }
.shadow-xl { box-shadow: var(--shadow-5); }
.shadow-none { box-shadow: none; }

/* ---- Borders ---- */
.border        { border: 1px solid var(--border-default); }
.border-strong { border: 1px solid var(--border-strong); }
.border-none   { border: none; }

/* ---- Background surfaces ---- */
.bg-page     { background-color: var(--surface-page); }
.bg-card     { background-color: var(--surface-card); }
.bg-elevated { background-color: var(--surface-elevated); }
.bg-primary  { background-color: var(--color-primary); }
.bg-accent   { background-color: var(--color-accent); }

/* ---- Divide (vertical separator between children) ---- */
.divide-y > * + * {
  border-block-start: 1px solid var(--border-default);
}