/* ==========================================================================
   07-UTILITIES.CSS — NEOMETIS Design System
   Clases de utilidad de uso frecuente. Atomic/functional helpers.
   Depende de 01-tokens.css.
   ========================================================================== */

/* -------------------------------------------------------------------------
   DISPLAY
   ------------------------------------------------------------------------- */

.nm-block         { display: block; }
.nm-inline        { display: inline; }
.nm-inline-block  { display: inline-block; }
.nm-inline-flex   { display: inline-flex; }
.nm-hidden        { display: none !important; }
.nm-sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border-width: 0;
}

/* -------------------------------------------------------------------------
   VISIBILITY RESPONSIVE
   ------------------------------------------------------------------------- */

@media (max-width: 767px)  { .nm-hide-mobile  { display: none !important; } }
@media (min-width: 768px)  { .nm-hide-tablet  { display: none !important; } }
@media (min-width: 1024px) { .nm-hide-desktop { display: none !important; } }
@media (max-width: 1023px) { .nm-show-desktop { display: none !important; } }
@media (min-width: 1024px) { .nm-show-mobile  { display: none !important; } }

/* -------------------------------------------------------------------------
   POSICIÓN
   ------------------------------------------------------------------------- */

.nm-relative { position: relative; }
.nm-absolute { position: absolute; }
.nm-fixed    { position: fixed; }
.nm-sticky   { position: sticky; }
.nm-inset-0  { inset: 0; }

/* -------------------------------------------------------------------------
   OVERFLOW
   ------------------------------------------------------------------------- */

.nm-overflow-hidden   { overflow: hidden; }
.nm-overflow-x-hidden { overflow-x: hidden; }
.nm-overflow-auto     { overflow: auto; }
.nm-overflow-scroll   { overflow: scroll; }

/* -------------------------------------------------------------------------
   CURSOR
   ------------------------------------------------------------------------- */

.nm-pointer    { cursor: pointer; }
.nm-default    { cursor: default; }
.nm-not-allowed { cursor: not-allowed; }

/* -------------------------------------------------------------------------
   POINTER EVENTS
   ------------------------------------------------------------------------- */

.nm-pe-none { pointer-events: none; }
.nm-pe-auto { pointer-events: auto; }

/* -------------------------------------------------------------------------
   USER SELECT
   ------------------------------------------------------------------------- */

.nm-select-none { user-select: none; }
.nm-select-text { user-select: text; }
.nm-select-all  { user-select: all; }

/* -------------------------------------------------------------------------
   SPACING — Margin y Padding helpers
   Patrón: nm-m{side}-{scale} / nm-p{side}-{scale}
   Sides: (vacío=all) t=top r=right b=bottom l=left x=horizontal y=vertical
   ------------------------------------------------------------------------- */

/* Margin auto */
.nm-mx-auto { margin-left: auto; margin-right: auto; }
.nm-ml-auto { margin-left: auto; }
.nm-mr-auto { margin-right: auto; }
.nm-mt-auto { margin-top: auto; }
.nm-mb-auto { margin-bottom: auto; }

/* Margin 0 */
.nm-m-0  { margin: 0; }
.nm-mt-0 { margin-top: 0; }
.nm-mb-0 { margin-bottom: 0; }
.nm-ml-0 { margin-left: 0; }
.nm-mr-0 { margin-right: 0; }

/* Margin escala */
.nm-mt-2  { margin-top: var(--space-2); }
.nm-mt-4  { margin-top: var(--space-4); }
.nm-mt-6  { margin-top: var(--space-6); }
.nm-mt-8  { margin-top: var(--space-8); }
.nm-mt-10 { margin-top: var(--space-10); }
.nm-mt-12 { margin-top: var(--space-12); }
.nm-mt-16 { margin-top: var(--space-16); }

.nm-mb-2  { margin-bottom: var(--space-2); }
.nm-mb-4  { margin-bottom: var(--space-4); }
.nm-mb-6  { margin-bottom: var(--space-6); }
.nm-mb-8  { margin-bottom: var(--space-8); }
.nm-mb-10 { margin-bottom: var(--space-10); }
.nm-mb-12 { margin-bottom: var(--space-12); }
.nm-mb-16 { margin-bottom: var(--space-16); }

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

/* -------------------------------------------------------------------------
   COLORES DE FONDO
   ------------------------------------------------------------------------- */

.nm-bg-base     { background-color: var(--color-bg); }
.nm-bg-surface  { background-color: var(--color-bg-surface); }
.nm-bg-elevated { background-color: var(--color-bg-elevated); }
.nm-bg-deep     { background-color: var(--color-bg-deep); }
.nm-bg-brand    { background-color: var(--color-brand); }

/* -------------------------------------------------------------------------
   COLORES DE TEXTO
   ------------------------------------------------------------------------- */

.nm-text-primary   { color: var(--color-text); }
.nm-text-secondary { color: var(--color-text-secondary); }
.nm-text-muted     { color: var(--color-text-muted); }
.nm-text-subtle    { color: var(--color-text-subtle); }
.nm-text-brand     { color: var(--color-brand); }
.nm-text-accent    { color: var(--color-accent); }
.nm-text-inverse   { color: var(--color-text-inverse); }
.nm-text-success   { color: var(--color-success); }
.nm-text-error     { color: var(--color-error); }
.nm-text-warning   { color: var(--color-warning); }

/* -------------------------------------------------------------------------
   BORDES
   ------------------------------------------------------------------------- */

.nm-border        { border: 1px solid var(--color-border); }
.nm-border-medium { border: 1px solid var(--color-border-medium); }
.nm-border-t      { border-top: 1px solid var(--color-border); }
.nm-border-b      { border-bottom: 1px solid var(--color-border); }
.nm-border-none   { border: none; }

/* -------------------------------------------------------------------------
   BORDER RADIUS
   ------------------------------------------------------------------------- */

.nm-rounded-none { border-radius: var(--radius-none); }
.nm-rounded-sm   { border-radius: var(--radius-sm); }
.nm-rounded      { border-radius: var(--radius-base); }
.nm-rounded-lg   { border-radius: var(--radius-lg); }
.nm-rounded-xl   { border-radius: var(--radius-xl); }
.nm-rounded-full { border-radius: var(--radius-full); }

/* -------------------------------------------------------------------------
   SOMBRAS
   ------------------------------------------------------------------------- */

.nm-shadow-sm    { box-shadow: var(--shadow-sm); }
.nm-shadow       { box-shadow: var(--shadow-md); }
.nm-shadow-lg    { box-shadow: var(--shadow-lg); }
.nm-shadow-xl    { box-shadow: var(--shadow-xl); }
.nm-shadow-brand { box-shadow: var(--shadow-brand-md); }
.nm-shadow-none  { box-shadow: none; }

/* -------------------------------------------------------------------------
   ANCHO / ALTO
   ------------------------------------------------------------------------- */

.nm-w-full   { width: 100%; }
.nm-w-auto   { width: auto; }
.nm-h-full   { height: 100%; }
.nm-h-screen { height: 100vh; }
.nm-min-h-screen { min-height: 100vh; }
.nm-max-w-prose  { max-width: 68ch; }
.nm-max-w-sm     { max-width: 480px; }
.nm-max-w-md     { max-width: 640px; }
.nm-max-w-lg     { max-width: 860px; }
.nm-max-w-xl     { max-width: var(--shell-max); }

/* -------------------------------------------------------------------------
   ASPECT RATIO
   ------------------------------------------------------------------------- */

.nm-aspect-square { aspect-ratio: 1; }
.nm-aspect-video  { aspect-ratio: 16 / 9; }
.nm-aspect-4-3    { aspect-ratio: 4 / 3; }
.nm-aspect-3-2    { aspect-ratio: 3 / 2; }

/* -------------------------------------------------------------------------
   OBJECT FIT
   ------------------------------------------------------------------------- */

.nm-object-cover   { object-fit: cover; }
.nm-object-contain { object-fit: contain; }
.nm-object-fill    { object-fit: fill; }

/* -------------------------------------------------------------------------
   OPACITY
   ------------------------------------------------------------------------- */

.nm-opacity-0  { opacity: 0; }
.nm-opacity-25 { opacity: 0.25; }
.nm-opacity-50 { opacity: 0.5; }
.nm-opacity-75 { opacity: 0.75; }
.nm-opacity-100 { opacity: 1; }

/* -------------------------------------------------------------------------
   Z-INDEX
   ------------------------------------------------------------------------- */

.nm-z-base     { z-index: var(--z-base); }
.nm-z-raised   { z-index: var(--z-raised); }
.nm-z-dropdown { z-index: var(--z-dropdown); }
.nm-z-sticky   { z-index: var(--z-sticky); }
.nm-z-modal    { z-index: var(--z-modal); }

/* -------------------------------------------------------------------------
   DIVISORES Y SEPARADORES
   ------------------------------------------------------------------------- */

.nm-divider {
  height: 1px;
  background: var(--color-border);
  border: none;
  margin: var(--space-6) 0;
}

.nm-divider--vertical {
  width: 1px;
  height: auto;
  align-self: stretch;
  margin: 0 var(--space-4);
}

/* -------------------------------------------------------------------------
   FOCUS RESET — Para elementos que manejan su propio foco
   ------------------------------------------------------------------------- */

.nm-focus-reset:focus {
  outline: none;
}

.nm-focus-reset:focus-visible {
  outline: 2px solid var(--color-brand);
  outline-offset: 3px;
}

/* -------------------------------------------------------------------------
   TRUNCATE DE TEXTO
   ------------------------------------------------------------------------- */

.nm-truncate {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

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

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

/* -------------------------------------------------------------------------
   GRADIENTES UTILITARIOS
   ------------------------------------------------------------------------- */

.nm-gradient-brand {
  background: linear-gradient(135deg, var(--color-brand) 0%, var(--color-brand-dark) 100%);
}

.nm-gradient-dark {
  background: linear-gradient(180deg, var(--color-bg-deep) 0%, var(--color-bg) 100%);
}

.nm-gradient-glow {
  background: radial-gradient(ellipse 70% 60% at 50% 0%, var(--color-brand-glow) 0%, transparent 70%);
}

/* Fade-out hacia abajo (para listas con overflow) */
.nm-gradient-fade-bottom::after {
  content: '';
  position: absolute;
  bottom: 0;
  left: 0;
  right: 0;
  height: 60px;
  background: linear-gradient(to bottom, transparent, var(--color-bg));
  pointer-events: none;
}

/* -------------------------------------------------------------------------
   WORDPRESS ESPECÍFICO — Admin bar offset
   ------------------------------------------------------------------------- */

/* Skip link de accesibilidad */
.nm-skip-link {
  position: absolute;
  top: -100%;
  left: var(--space-4);
  background: var(--color-brand);
  color: var(--color-text-inverse);
  padding: var(--space-3) var(--space-6);
  font-weight: var(--fw-semibold);
  z-index: var(--z-max);
  text-decoration: none;
  border-radius: var(--radius-base);
  transition: top var(--duration-normal) var(--ease-out);
}

.nm-skip-link:focus {
  top: var(--space-4);
}