/**
 * NA-Kit UI — Utility Classes
 * Tailwind-inspired utility classes for one-off styling without custom CSS.
 */

/* ========== Display ========== */
.block { display: block; }
.inline-block { display: inline-block; }
.inline { display: inline; }
.flex { display: flex; }
.inline-flex { display: inline-flex; }
.grid { display: grid; }
.hidden { display: none; }
.contents { display: contents; }

/* ========== Flexbox ========== */
.flex-row { flex-direction: row; }
.flex-col { flex-direction: column; }
.flex-wrap { flex-wrap: wrap; }
.flex-nowrap { flex-wrap: nowrap; }
.flex-1 { flex: 1 1 0%; }
.flex-auto { flex: 1 1 auto; }
.flex-none { flex: none; }
.grow { flex-grow: 1; }
.shrink-0 { flex-shrink: 0; }

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

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

.self-start { align-self: flex-start; }
.self-center { align-self: center; }
.self-end { align-self: flex-end; }
.self-stretch { align-self: stretch; }

/* ========== Grid ========== */
.grid-cols-1 { grid-template-columns: repeat(1, minmax(0, 1fr)); }
.grid-cols-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
.grid-cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
.grid-cols-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
.grid-cols-6 { grid-template-columns: repeat(6, minmax(0, 1fr)); }
.grid-cols-12 { grid-template-columns: repeat(12, minmax(0, 1fr)); }
.col-span-2 { grid-column: span 2 / span 2; }
.col-span-3 { grid-column: span 3 / span 3; }
.col-span-4 { grid-column: span 4 / span 4; }
.col-span-6 { grid-column: span 6 / span 6; }
.col-span-full { grid-column: 1 / -1; }

/* ========== Gap ========== */
.gap-0 { gap: 0; }
.gap-1 { gap: 4px; }
.gap-2 { gap: 8px; }
.gap-3 { gap: 12px; }
.gap-4 { gap: 16px; }
.gap-5 { gap: 20px; }
.gap-6 { gap: 24px; }
.gap-8 { gap: 32px; }
.gap-10 { gap: 40px; }
.gap-12 { gap: 48px; }
.gap-16 { gap: 64px; }

/* ========== Spacing (margin) ========== */
.m-0 { margin: 0; }
.m-auto { margin: auto; }
.mx-auto { margin-left: auto; margin-right: auto; }
.mt-0 { margin-top: 0; }    .mt-1 { margin-top: 4px; }
.mt-2 { margin-top: 8px; }  .mt-3 { margin-top: 12px; }
.mt-4 { margin-top: 16px; } .mt-6 { margin-top: 24px; }
.mt-8 { margin-top: 32px; } .mt-12 { margin-top: 48px; }
.mt-16 { margin-top: 64px; }
.mb-0 { margin-bottom: 0; }    .mb-1 { margin-bottom: 4px; }
.mb-2 { margin-bottom: 8px; }  .mb-3 { margin-bottom: 12px; }
.mb-4 { margin-bottom: 16px; } .mb-6 { margin-bottom: 24px; }
.mb-8 { margin-bottom: 32px; } .mb-12 { margin-bottom: 48px; }
.ml-auto { margin-left: auto; }
.mr-auto { margin-right: auto; }

/* ========== Spacing (padding) ========== */
.p-0 { padding: 0; }
.p-1 { padding: 4px; }    .p-2 { padding: 8px; }
.p-3 { padding: 12px; }   .p-4 { padding: 16px; }
.p-6 { padding: 24px; }   .p-8 { padding: 32px; }
.p-12 { padding: 48px; }  .p-16 { padding: 64px; }
.px-0 { padding-left: 0; padding-right: 0; }
.px-4 { padding-left: 16px; padding-right: 16px; }
.px-6 { padding-left: 24px; padding-right: 24px; }
.px-8 { padding-left: 32px; padding-right: 32px; }
.py-0 { padding-top: 0; padding-bottom: 0; }
.py-4 { padding-top: 16px; padding-bottom: 16px; }
.py-6 { padding-top: 24px; padding-bottom: 24px; }
.py-8 { padding-top: 32px; padding-bottom: 32px; }
.py-12 { padding-top: 48px; padding-bottom: 48px; }
.py-16 { padding-top: 64px; padding-bottom: 64px; }
.py-20 { padding-top: 80px; padding-bottom: 80px; }

/* ========== Width & Height ========== */
.w-full { width: 100%; }
.w-auto { width: auto; }
.w-screen { width: 100vw; }
.min-w-0 { min-width: 0; }
.max-w-sm { max-width: 24rem; }
.max-w-md { max-width: 28rem; }
.max-w-lg { max-width: 32rem; }
.max-w-xl { max-width: 36rem; }
.max-w-2xl { max-width: 42rem; }
.max-w-4xl { max-width: 56rem; }
.max-w-6xl { max-width: 72rem; }
.max-w-7xl { max-width: 80rem; }
.max-w-full { max-width: 100%; }
.max-w-prose { max-width: 65ch; }

.h-full { height: 100%; }
.h-screen { height: 100vh; }
.min-h-screen { min-height: 100vh; }

/* ========== Typography ========== */
.text-xs { font-size: 0.75rem; line-height: 1rem; }
.text-sm { font-size: 0.875rem; line-height: 1.25rem; }
.text-base { font-size: 1rem; line-height: 1.5rem; }
.text-lg { font-size: 1.125rem; line-height: 1.75rem; }
.text-xl { font-size: 1.25rem; line-height: 1.75rem; }
.text-2xl { font-size: 1.5rem; line-height: 2rem; }
.text-3xl { font-size: 1.875rem; line-height: 2.25rem; }
.text-4xl { font-size: 2.25rem; line-height: 2.5rem; }
.text-5xl { font-size: 3rem; line-height: 1.15; }
.text-6xl { font-size: 3.75rem; line-height: 1.1; }
.text-7xl { font-size: 4.5rem; line-height: 1.05; }
.text-8xl { font-size: 6rem; line-height: 1; }
.text-9xl { font-size: 8rem; line-height: 1; }

.font-light { font-weight: 300; }
.font-normal { font-weight: 400; }
.font-medium { font-weight: 500; }
.font-semibold { font-weight: 600; }
.font-bold { font-weight: 700; }
.font-extrabold { font-weight: 800; }

.italic { font-style: italic; }
.not-italic { font-style: normal; }

.tracking-tight { letter-spacing: -0.025em; }
.tracking-normal { letter-spacing: 0; }
.tracking-wide { letter-spacing: 0.025em; }
.tracking-wider { letter-spacing: 0.05em; }
.tracking-widest { letter-spacing: 0.1em; }

.leading-none { line-height: 1; }
.leading-tight { line-height: 1.25; }
.leading-snug { line-height: 1.375; }
.leading-normal { line-height: 1.5; }
.leading-relaxed { line-height: 1.625; }
.leading-loose { line-height: 2; }

.text-left { text-align: left; }
.text-center { text-align: center; }
.text-right { text-align: right; }

.uppercase { text-transform: uppercase; }
.lowercase { text-transform: lowercase; }
.capitalize { text-transform: capitalize; }
.normal-case { text-transform: none; }

.underline { text-decoration-line: underline; }
.line-through { text-decoration-line: line-through; }
.no-underline { text-decoration-line: none; }

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

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

.whitespace-nowrap { white-space: nowrap; }
.whitespace-pre-wrap { white-space: pre-wrap; }
.break-words { overflow-wrap: break-word; }

.font-mono { font-family: var(--ui-font-mono); }

/* ========== Colors ========== */
.text-primary { color: var(--ui-text-primary); }
.text-secondary { color: var(--ui-text-secondary); }
.text-muted { color: var(--ui-text-muted); }
.text-inverse { color: var(--ui-text-inverse); }
.text-link { color: var(--ui-text-link); }
.text-success { color: var(--ui-color-success); }
.text-warning { color: var(--ui-color-warning); }
.text-danger { color: var(--ui-color-danger); }
.text-info { color: var(--ui-color-info); }

.bg-primary { background-color: var(--ui-bg-primary); }
.bg-secondary { background-color: var(--ui-bg-secondary); }
.bg-tertiary { background-color: var(--ui-bg-tertiary); }
.bg-elevated { background-color: var(--ui-bg-elevated); }
.bg-transparent { background-color: transparent; }

.border-default { border-color: var(--ui-border-color); }
.border-strong { border-color: var(--ui-border-color-strong); }

/* ========== Borders ========== */
.border { border-width: var(--ui-border-width); border-style: solid; border-color: var(--ui-border-color); }
.border-0 { border-width: 0; }
.border-t { border-top-width: var(--ui-border-width); border-style: solid; border-color: var(--ui-border-color); }
.border-b { border-bottom-width: var(--ui-border-width); border-style: solid; border-color: var(--ui-border-color); }

.rounded-none { border-radius: 0; }
.rounded-sm { border-radius: var(--ui-border-radius-sm); }
.rounded { border-radius: var(--ui-border-radius); }
.rounded-lg { border-radius: var(--ui-border-radius-lg); }
.rounded-xl { border-radius: var(--ui-border-radius-xl); }
.rounded-2xl { border-radius: var(--ui-border-radius-2xl); }
.rounded-full { border-radius: var(--ui-border-radius-full); }

/* ========== Shadows ========== */
.shadow-sm { box-shadow: var(--ui-shadow-sm); }
.shadow { box-shadow: var(--ui-shadow-md); }
.shadow-lg { box-shadow: var(--ui-shadow-lg); }
.shadow-xl { box-shadow: var(--ui-shadow-xl); }
.shadow-none { box-shadow: none; }

/* ========== Overflow ========== */
.overflow-hidden { overflow: hidden; }
.overflow-auto { overflow: auto; }
.overflow-x-auto { overflow-x: auto; }
.overflow-y-auto { overflow-y: auto; }
.overflow-visible { overflow: visible; }

/* ========== Position ========== */
.relative { position: relative; }
.absolute { position: absolute; }
.fixed { position: fixed; }
.sticky { position: sticky; top: 0; }
.inset-0 { inset: 0; }

/* ========== Opacity ========== */
.opacity-0 { opacity: 0; }
.opacity-25 { opacity: 0.25; }
.opacity-50 { opacity: 0.5; }
.opacity-75 { opacity: 0.75; }
.opacity-100 { opacity: 1; }

/* ========== Cursor ========== */
.cursor-pointer { cursor: pointer; }
.cursor-not-allowed { cursor: not-allowed; }
.cursor-default { cursor: default; }

/* ========== Pointer Events ========== */
.pointer-events-none { pointer-events: none; }
.pointer-events-auto { pointer-events: auto; }

/* ========== User Select ========== */
.select-none { user-select: none; }
.select-text { user-select: text; }
.select-all { user-select: all; }

/* ========== Accessibility ========== */
.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;
}

.not-sr-only {
  position: static;
  width: auto;
  height: auto;
  padding: 0;
  margin: 0;
  overflow: visible;
  clip: auto;
  white-space: normal;
}

/* ========== Transitions ========== */
.transition { transition-property: color, background-color, border-color, box-shadow, opacity, transform; transition-duration: 150ms; transition-timing-function: ease; }
.transition-all { transition: all 150ms ease; }
.transition-colors { transition-property: color, background-color, border-color; transition-duration: 150ms; }
.transition-opacity { transition-property: opacity; transition-duration: 150ms; }
.transition-transform { transition-property: transform; transition-duration: 150ms; }
.duration-75 { transition-duration: 75ms; }
.duration-150 { transition-duration: 150ms; }
.duration-300 { transition-duration: 300ms; }
.duration-500 { transition-duration: 500ms; }

/* ========== Transforms ========== */
.scale-95 { transform: scale(0.95); }
.scale-100 { transform: scale(1); }
.scale-105 { transform: scale(1.05); }
.translate-y-0 { transform: translateY(0); }
.translate-y-1 { transform: translateY(4px); }
.-translate-y-1 { transform: translateY(-4px); }

/* ========== Responsive ========== */
@media (min-width: 640px) {
  .sm\:flex { display: flex; }
  .sm\:hidden { display: none; }
  .sm\:block { display: block; }
  .sm\:grid-cols-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
  .sm\:grid-cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
  .sm\:flex-row { flex-direction: row; }
  .sm\:text-left { text-align: left; }
  .sm\:text-center { text-align: center; }
}

@media (min-width: 768px) {
  .md\:flex { display: flex; }
  .md\:hidden { display: none; }
  .md\:block { display: block; }
  .md\:grid-cols-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
  .md\:grid-cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
  .md\:grid-cols-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
  .md\:flex-row { flex-direction: row; }
  .md\:text-left { text-align: left; }
  .md\:px-8 { padding-left: 32px; padding-right: 32px; }
}

@media (min-width: 1024px) {
  .lg\:flex { display: flex; }
  .lg\:hidden { display: none; }
  .lg\:block { display: block; }
  .lg\:grid-cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
  .lg\:grid-cols-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
  .lg\:grid-cols-6 { grid-template-columns: repeat(6, minmax(0, 1fr)); }
  .lg\:flex-row { flex-direction: row; }
  .lg\:px-12 { padding-left: 48px; padding-right: 48px; }
}

@media (min-width: 1280px) {
  .xl\:grid-cols-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
  .xl\:grid-cols-6 { grid-template-columns: repeat(6, minmax(0, 1fr)); }
}

/* ========== Extended Grid ========== */
.grid-cols-5  { grid-template-columns: repeat(5, minmax(0, 1fr)); }
.grid-rows-1  { grid-template-rows: repeat(1, minmax(0, 1fr)); }
.grid-rows-2  { grid-template-rows: repeat(2, minmax(0, 1fr)); }
.grid-rows-3  { grid-template-rows: repeat(3, minmax(0, 1fr)); }
.row-span-2   { grid-row: span 2 / span 2; }
.row-span-3   { grid-row: span 3 / span 3; }
.row-span-full { grid-row: 1 / -1; }
.col-span-1   { grid-column: span 1 / span 1; }
.col-span-5   { grid-column: span 5 / span 5; }

.gap-x-1 { column-gap: 4px; }  .gap-x-2 { column-gap: 8px; }
.gap-x-3 { column-gap: 12px; } .gap-x-4 { column-gap: 16px; }
.gap-x-6 { column-gap: 24px; } .gap-x-8 { column-gap: 32px; }
.gap-y-1 { row-gap: 4px; }     .gap-y-2 { row-gap: 8px; }
.gap-y-3 { row-gap: 12px; }    .gap-y-4 { row-gap: 16px; }
.gap-y-6 { row-gap: 24px; }    .gap-y-8 { row-gap: 32px; }

.place-items-center  { place-items: center; }
.place-content-center { place-content: center; }

/* ========== Aspect Ratio ========== */
.aspect-auto    { aspect-ratio: auto; }
.aspect-square  { aspect-ratio: 1 / 1; }
.aspect-video   { aspect-ratio: 16 / 9; }
.aspect-photo   { aspect-ratio: 4 / 3; }
.aspect-portrait { aspect-ratio: 3 / 4; }
.aspect-21-9    { aspect-ratio: 21 / 9; }

/* ========== Object Fit & Position ========== */
.object-contain  { object-fit: contain; }
.object-cover    { object-fit: cover; }
.object-fill     { object-fit: fill; }
.object-none     { object-fit: none; }
.object-scale    { object-fit: scale-down; }
.object-center   { object-position: center; }
.object-top      { object-position: top; }
.object-bottom   { object-position: bottom; }
.object-left     { object-position: left; }
.object-right    { object-position: right; }

/* ========== Extended Width / Height ========== */
.w-0   { width: 0; }
.w-px  { width: 1px; }
.w-4   { width: 16px; }
.w-6   { width: 24px; }
.w-8   { width: 32px; }
.w-10  { width: 40px; }
.w-12  { width: 48px; }
.w-16  { width: 64px; }
.w-20  { width: 80px; }
.w-24  { width: 96px; }
.w-32  { width: 128px; }
.w-48  { width: 192px; }
.w-64  { width: 256px; }
.w-80  { width: 320px; }
.w-96  { width: 384px; }
.w-1\/2 { width: 50%; }
.w-1\/3 { width: 33.333333%; }
.w-2\/3 { width: 66.666667%; }
.w-1\/4 { width: 25%; }
.w-3\/4 { width: 75%; }

.h-0   { height: 0; }
.h-px  { height: 1px; }
.h-4   { height: 16px; }
.h-6   { height: 24px; }
.h-8   { height: 32px; }
.h-10  { height: 40px; }
.h-12  { height: 48px; }
.h-16  { height: 64px; }
.h-20  { height: 80px; }
.h-24  { height: 96px; }
.h-32  { height: 128px; }
.h-48  { height: 192px; }
.h-64  { height: 256px; }
.h-screen-50 { height: 50vh; }
.h-screen-75 { height: 75vh; }

.max-h-0    { max-height: 0; }
.max-h-48   { max-height: 192px; }
.max-h-64   { max-height: 256px; }
.max-h-96   { max-height: 384px; }
.max-h-full { max-height: 100%; }
.max-h-screen { max-height: 100vh; }

.min-h-0    { min-height: 0; }
.min-h-full { min-height: 100%; }

/* ========== Extended Spacing ========== */
.px-1 { padding-left: 4px;  padding-right: 4px; }
.px-2 { padding-left: 8px;  padding-right: 8px; }
.px-3 { padding-left: 12px; padding-right: 12px; }
.px-5 { padding-left: 20px; padding-right: 20px; }
.px-10 { padding-left: 40px; padding-right: 40px; }
.px-12 { padding-left: 48px; padding-right: 48px; }
.px-16 { padding-left: 64px; padding-right: 64px; }

.py-1 { padding-top: 4px;  padding-bottom: 4px; }
.py-2 { padding-top: 8px;  padding-bottom: 8px; }
.py-3 { padding-top: 12px; padding-bottom: 12px; }
.py-5 { padding-top: 20px; padding-bottom: 20px; }
.py-10 { padding-top: 40px; padding-bottom: 40px; }

.pt-0  { padding-top: 0; }    .pt-1  { padding-top: 4px; }
.pt-2  { padding-top: 8px; }  .pt-3  { padding-top: 12px; }
.pt-4  { padding-top: 16px; } .pt-6  { padding-top: 24px; }
.pt-8  { padding-top: 32px; } .pt-12 { padding-top: 48px; }
.pt-16 { padding-top: 64px; }

.pb-0  { padding-bottom: 0; }    .pb-1  { padding-bottom: 4px; }
.pb-2  { padding-bottom: 8px; }  .pb-3  { padding-bottom: 12px; }
.pb-4  { padding-bottom: 16px; } .pb-6  { padding-bottom: 24px; }
.pb-8  { padding-bottom: 32px; } .pb-12 { padding-bottom: 48px; }
.pb-16 { padding-bottom: 64px; }

.pl-0  { padding-left: 0; }  .pl-1  { padding-left: 4px; }
.pl-2  { padding-left: 8px; } .pl-4  { padding-left: 16px; }
.pl-6  { padding-left: 24px; } .pl-8  { padding-left: 32px; }

.pr-0  { padding-right: 0; }  .pr-1  { padding-right: 4px; }
.pr-2  { padding-right: 8px; } .pr-4  { padding-right: 16px; }
.pr-6  { padding-right: 24px; } .pr-8  { padding-right: 32px; }

.mx-0  { margin-left: 0; margin-right: 0; }
.mx-1  { margin-left: 4px; margin-right: 4px; }
.mx-2  { margin-left: 8px; margin-right: 8px; }
.mx-4  { margin-left: 16px; margin-right: 16px; }
.mx-6  { margin-left: 24px; margin-right: 24px; }
.mx-8  { margin-left: 32px; margin-right: 32px; }

.my-0  { margin-top: 0; margin-bottom: 0; }
.my-1  { margin-top: 4px; margin-bottom: 4px; }
.my-2  { margin-top: 8px; margin-bottom: 8px; }
.my-4  { margin-top: 16px; margin-bottom: 16px; }
.my-6  { margin-top: 24px; margin-bottom: 24px; }
.my-8  { margin-top: 32px; margin-bottom: 32px; }
.my-12 { margin-top: 48px; margin-bottom: 48px; }
.my-16 { margin-top: 64px; margin-bottom: 64px; }

/* ========== Logical Properties (RTL-friendly) ========== */
.ms-auto { margin-inline-start: auto; }
.me-auto { margin-inline-end: auto; }
.ms-0    { margin-inline-start: 0; }
.ms-1    { margin-inline-start: 4px; }
.ms-2    { margin-inline-start: 8px; }
.ms-4    { margin-inline-start: 16px; }
.ms-6    { margin-inline-start: 24px; }
.me-0    { margin-inline-end: 0; }
.me-1    { margin-inline-end: 4px; }
.me-2    { margin-inline-end: 8px; }
.me-4    { margin-inline-end: 16px; }
.pi-0    { padding-inline: 0; }
.pi-2    { padding-inline: 8px; }
.pi-4    { padding-inline: 16px; }
.pi-6    { padding-inline: 24px; }
.pi-8    { padding-inline: 32px; }
.pb-block-0 { padding-block: 0; }
.pb-block-2 { padding-block: 8px; }
.pb-block-4 { padding-block: 16px; }
.pb-block-6 { padding-block: 24px; }

/* ========== Border Extensions ========== */
.border-l { border-left-width: var(--ui-border-width, 1px); border-style: solid; border-color: var(--ui-border-color, #e5e7eb); }
.border-r { border-right-width: var(--ui-border-width, 1px); border-style: solid; border-color: var(--ui-border-color, #e5e7eb); }
.border-2 { border-width: 2px; border-style: solid; border-color: var(--ui-border-color, #e5e7eb); }
.border-4 { border-width: 4px; border-style: solid; border-color: var(--ui-border-color, #e5e7eb); }
.border-dashed { border-style: dashed; }
.border-dotted { border-style: dotted; }
.border-transparent { border-color: transparent; }
.border-success { border-color: var(--ui-color-success, #10b981); }
.border-warning { border-color: var(--ui-color-warning, #f59e0b); }
.border-danger  { border-color: var(--ui-color-danger, #ef4444); }
.border-info    { border-color: var(--ui-color-info, #3b82f6); }
.border-primary { border-color: var(--ui-color-primary, #6366f1); }
.divide-y > * + * { border-top-width: 1px; border-style: solid; border-color: var(--ui-border-color, #e5e7eb); }
.divide-x > * + * { border-left-width: 1px; border-style: solid; border-color: var(--ui-border-color, #e5e7eb); }

/* ========== Semantic Background Colors ========== */
.bg-brand    { background-color: var(--ui-color-primary, #6366f1); }
.bg-success  { background-color: var(--ui-color-success, #10b981); }
.bg-warning  { background-color: var(--ui-color-warning, #f59e0b); }
.bg-danger   { background-color: var(--ui-color-danger, #ef4444); }
.bg-info     { background-color: var(--ui-color-info, #3b82f6); }
.bg-surface  { background-color: var(--ui-color-surface, #f3f4f6); }
.bg-overlay  { background-color: var(--ui-bg-overlay, rgba(0,0,0,.5)); }
.bg-black    { background-color: #000; }
.bg-white    { background-color: #fff; }
.bg-canvas   { background-color: var(--ui-bg-secondary, #f9fafb); }

/* Light tinted semantic backgrounds */
.bg-success-light { background-color: #d1fae5; }
.bg-warning-light { background-color: #fef3c7; }
.bg-danger-light  { background-color: #fee2e2; }
.bg-info-light    { background-color: #dbeafe; }
.bg-brand-light   { background-color: #eef2ff; }

/* ========== Semantic Text Colors ========== */
.text-brand   { color: var(--ui-color-primary, #6366f1); }
.text-black   { color: #000; }
.text-white   { color: #fff; }
.text-on-brand  { color: #fff; }
.text-current { color: currentColor; }

/* ========== Gradient Utilities ========== */
.bg-gradient-to-r   { background-image: linear-gradient(to right, var(--ui-gradient-from, #6366f1), var(--ui-gradient-to, #8b5cf6)); }
.bg-gradient-to-l   { background-image: linear-gradient(to left,  var(--ui-gradient-from, #6366f1), var(--ui-gradient-to, #8b5cf6)); }
.bg-gradient-to-t   { background-image: linear-gradient(to top,    var(--ui-gradient-from, #6366f1), var(--ui-gradient-to, #8b5cf6)); }
.bg-gradient-to-b   { background-image: linear-gradient(to bottom, var(--ui-gradient-from, #6366f1), var(--ui-gradient-to, #8b5cf6)); }
.bg-gradient-to-br  { background-image: linear-gradient(to bottom right, var(--ui-gradient-from, #6366f1), var(--ui-gradient-to, #8b5cf6)); }
.bg-gradient-to-tr  { background-image: linear-gradient(to top right,    var(--ui-gradient-from, #6366f1), var(--ui-gradient-to, #8b5cf6)); }
/* Common preset gradients */
.bg-gradient-primary  { background-image: linear-gradient(135deg, #6366f1, #8b5cf6); }
.bg-gradient-success  { background-image: linear-gradient(135deg, #10b981, #059669); }
.bg-gradient-fire     { background-image: linear-gradient(135deg, #f59e0b, #ef4444); }
.bg-gradient-ocean    { background-image: linear-gradient(135deg, #3b82f6, #06b6d4); }
.bg-gradient-sunset   { background-image: linear-gradient(135deg, #f43f5e, #f97316); }
.bg-gradient-purple   { background-image: linear-gradient(135deg, #8b5cf6, #ec4899); }

/* ========== Extended Opacity ========== */
.opacity-0   { opacity: 0; }
.opacity-5   { opacity: 0.05; }
.opacity-10  { opacity: 0.10; }
.opacity-20  { opacity: 0.20; }
.opacity-30  { opacity: 0.30; }
.opacity-40  { opacity: 0.40; }
.opacity-50  { opacity: 0.50; }
.opacity-60  { opacity: 0.60; }
.opacity-70  { opacity: 0.70; }
.opacity-75  { opacity: 0.75; }
.opacity-80  { opacity: 0.80; }
.opacity-90  { opacity: 0.90; }
.opacity-95  { opacity: 0.95; }
.opacity-100 { opacity: 1; }

/* ========== Z-Index ========== */
.z-0   { z-index: 0; }
.z-10  { z-index: 10; }
.z-20  { z-index: 20; }
.z-30  { z-index: 30; }
.z-40  { z-index: 40; }
.z-50  { z-index: 50; }
.z-100 { z-index: 100; }
.z-auto { z-index: auto; }

/* ========== Extended Transforms ========== */
.rotate-0   { transform: rotate(0deg); }
.rotate-45  { transform: rotate(45deg); }
.rotate-90  { transform: rotate(90deg); }
.rotate-180 { transform: rotate(180deg); }
.-rotate-45 { transform: rotate(-45deg); }
.-rotate-90 { transform: rotate(-90deg); }

.translate-x-0  { transform: translateX(0); }
.translate-x-1  { transform: translateX(4px); }
.translate-x-2  { transform: translateX(8px); }
.-translate-x-1 { transform: translateX(-4px); }
.-translate-x-2 { transform: translateX(-8px); }
.translate-y-0  { transform: translateY(0); }
.translate-y-2  { transform: translateY(8px); }
.translate-y-4  { transform: translateY(16px); }
.-translate-y-2 { transform: translateY(-8px); }
.-translate-y-4 { transform: translateY(-16px); }

.scale-0    { transform: scale(0); }
.scale-50   { transform: scale(.5); }
.scale-75   { transform: scale(.75); }
.scale-90   { transform: scale(.9); }
.scale-95   { transform: scale(.95); }
.scale-100  { transform: scale(1); }
.scale-105  { transform: scale(1.05); }
.scale-110  { transform: scale(1.1); }
.scale-125  { transform: scale(1.25); }
.scale-150  { transform: scale(1.5); }

.skew-x-1 { transform: skewX(1deg); }
.skew-y-1 { transform: skewY(1deg); }
.-skew-x-1 { transform: skewX(-1deg); }
.-skew-y-1 { transform: skewY(-1deg); }

.transform-gpu { transform: translateZ(0); will-change: transform; }
.will-change-transform { will-change: transform; }
.will-change-opacity   { will-change: opacity; }

/* ========== Outline / Ring ========== */
.outline-none { outline: none; }
.outline       { outline: 2px solid var(--ui-color-primary, #6366f1); outline-offset: 2px; }
.outline-danger { outline: 2px solid var(--ui-color-danger, #ef4444); outline-offset: 2px; }
.focus-ring:focus-visible { outline: 2px solid var(--ui-color-primary, #6366f1); outline-offset: 2px; }
.ring   { box-shadow: 0 0 0 3px rgba(99,102,241,.35); }
.ring-2 { box-shadow: 0 0 0 2px rgba(99,102,241,.35); }
.ring-4 { box-shadow: 0 0 0 4px rgba(99,102,241,.35); }
.ring-inset { box-shadow: inset 0 0 0 2px rgba(99,102,241,.35); }
.ring-danger  { box-shadow: 0 0 0 3px rgba(239,68,68,.35); }
.ring-success { box-shadow: 0 0 0 3px rgba(16,185,129,.35); }

/* ========== Backdrop Filter ========== */
.backdrop-blur-sm { -webkit-backdrop-filter: blur(4px); backdrop-filter: blur(4px); }
.backdrop-blur    { -webkit-backdrop-filter: blur(8px); backdrop-filter: blur(8px); }
.backdrop-blur-md { -webkit-backdrop-filter: blur(12px); backdrop-filter: blur(12px); }
.backdrop-blur-lg { -webkit-backdrop-filter: blur(16px); backdrop-filter: blur(16px); }
.backdrop-blur-xl { -webkit-backdrop-filter: blur(24px); backdrop-filter: blur(24px); }
.backdrop-blur-2xl { -webkit-backdrop-filter: blur(40px); backdrop-filter: blur(40px); }
.backdrop-brightness-50 { -webkit-backdrop-filter: brightness(.5); backdrop-filter: brightness(.5); }
.backdrop-saturate { -webkit-backdrop-filter: saturate(1.5); backdrop-filter: saturate(1.5); }
.backdrop-bg-glass { background: rgba(255,255,255,.7); -webkit-backdrop-filter: blur(12px) saturate(1.5); backdrop-filter: blur(12px) saturate(1.5); }
.backdrop-bg-dark-glass { background: rgba(0,0,0,.4); -webkit-backdrop-filter: blur(12px) saturate(1.2); backdrop-filter: blur(12px) saturate(1.2); }

/* ========== Extended Transition Timing ========== */
.ease-linear  { transition-timing-function: linear; }
.ease-in      { transition-timing-function: cubic-bezier(.4,0,1,1); }
.ease-out     { transition-timing-function: cubic-bezier(0,0,.2,1); }
.ease-in-out  { transition-timing-function: cubic-bezier(.4,0,.2,1); }
.ease-spring  { transition-timing-function: cubic-bezier(.34,1.56,.64,1); }
.ease-back    { transition-timing-function: cubic-bezier(.68,-.55,.27,1.55); }
.duration-0   { transition-duration: 0ms; }
.duration-100 { transition-duration: 100ms; }
.duration-200 { transition-duration: 200ms; }
.duration-700 { transition-duration: 700ms; }
.duration-1000 { transition-duration: 1000ms; }
.delay-75   { transition-delay: 75ms; }
.delay-100  { transition-delay: 100ms; }
.delay-150  { transition-delay: 150ms; }
.delay-300  { transition-delay: 300ms; }
.delay-500  { transition-delay: 500ms; }

/* ========== Extended Position ========== */
.top-0    { top: 0; }
.top-1    { top: 4px; }
.top-2    { top: 8px; }
.top-4    { top: 16px; }
.top-full { top: 100%; }
.top-auto { top: auto; }
.bottom-0    { bottom: 0; }
.bottom-2    { bottom: 8px; }
.bottom-4    { bottom: 16px; }
.bottom-full { bottom: 100%; }
.left-0    { left: 0; }
.left-2    { left: 8px; }
.left-4    { left: 16px; }
.left-full { left: 100%; }
.right-0   { right: 0; }
.right-2   { right: 8px; }
.right-4   { right: 16px; }
.right-full { right: 100%; }
.inset-x-0  { left: 0; right: 0; }
.inset-y-0  { top: 0; bottom: 0; }

/* ========== Visibility ========== */
.visible   { visibility: visible; }
.invisible { visibility: hidden; }
.collapse  { visibility: collapse; }

/* ========== Table ========== */
.table-auto    { table-layout: auto; }
.table-fixed   { table-layout: fixed; }
.border-collapse { border-collapse: collapse; }
.border-separate { border-collapse: separate; }

/* ========== Container ========== */
.container {
  width: 100%;
  margin-left: auto;
  margin-right: auto;
  padding-left: 16px;
  padding-right: 16px;
}
@media (min-width: 640px)  { .container { max-width: 640px; } }
@media (min-width: 768px)  { .container { max-width: 768px; } }
@media (min-width: 1024px) { .container { max-width: 1024px; padding-left: 24px; padding-right: 24px; } }
@media (min-width: 1280px) { .container { max-width: 1280px; padding-left: 32px; padding-right: 32px; } }
@media (min-width: 1536px) { .container { max-width: 1536px; } }

.container-narrow  { max-width: 768px; margin-left: auto; margin-right: auto; }
.container-medium  { max-width: 1024px; margin-left: auto; margin-right: auto; }
.container-wide    { max-width: 1280px; margin-left: auto; margin-right: auto; }
.container-fluid   { max-width: none; margin-left: auto; margin-right: auto; padding-left: 16px; padding-right: 16px; }

/* ========== Scroll Behavior ========== */
.scroll-smooth  { scroll-behavior: smooth; }
.scroll-auto    { scroll-behavior: auto; }
.overscroll-auto    { overscroll-behavior: auto; }
.overscroll-contain { overscroll-behavior: contain; }
.overscroll-none    { overscroll-behavior: none; }
.scroll-snap-x { scroll-snap-type: x mandatory; }
.scroll-snap-y { scroll-snap-type: y mandatory; }
.snap-start    { scroll-snap-align: start; }
.snap-center   { scroll-snap-align: center; }
.snap-end      { scroll-snap-align: end; }

/* ========== Extended Responsive (2XL & print) ========== */
@media (min-width: 1536px) {
  .\32xl\:grid-cols-5  { grid-template-columns: repeat(5, minmax(0, 1fr)); }
  .\32xl\:grid-cols-6  { grid-template-columns: repeat(6, minmax(0, 1fr)); }
  .\32xl\:text-6xl { font-size: 3.75rem; }
}

@media print {
  .print\:hidden  { display: none !important; }
  .print\:block   { display: block !important; }
  .print\:text-sm { font-size: 0.875rem !important; }
  .print\:border  { border: 1px solid #e5e7eb !important; }
  .print\:shadow-none { box-shadow: none !important; }
}

/* ========== Dark Mode Semantic Utilities ========== */
@media (prefers-color-scheme: dark) {
  .dark\:bg-surface  { background-color: var(--ui-bg-secondary, #1f2937); }
  .dark\:text-white  { color: #fff; }
  .dark\:border-dark { border-color: var(--ui-color-border, #374151); }
}
[data-theme="dark"] .dark\:bg-surface  { background-color: var(--ui-bg-secondary, #1f2937); }
[data-theme="dark"] .dark\:text-white  { color: #fff; }
[data-theme="dark"] .dark\:border-dark { border-color: var(--ui-color-border, #374151); }

/* ========== Container Queries ========== */
.cq-container     { container-type: inline-size; }
.cq-container-sz  { container-type: size; }
.cq-container-normal { container-type: normal; }

@container (min-width: 320px)  {
  .cq-sm\:flex       { display: flex; }
  .cq-sm\:grid-cols-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
  .cq-sm\:text-sm    { font-size: 0.875rem; }
}
@container (min-width: 480px)  {
  .cq-md\:grid-cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
  .cq-md\:flex-row    { flex-direction: row; }
  .cq-md\:hidden      { display: none; }
}
@container (min-width: 640px)  {
  .cq-lg\:grid-cols-4  { grid-template-columns: repeat(4, minmax(0, 1fr)); }
  .cq-lg\:flex-row     { flex-direction: row; }
  .cq-lg\:text-lg      { font-size: 1.125rem; }
}
@container (min-width: 800px)  {
  .cq-xl\:grid-cols-5  { grid-template-columns: repeat(5, minmax(0, 1fr)); }
}

/* ========== Masonry Layout (CSS-only) ========== */
.masonry-2 { columns: 2; column-gap: 16px; }
.masonry-3 { columns: 3; column-gap: 16px; }
.masonry-4 { columns: 4; column-gap: 16px; }
.masonry-item { break-inside: avoid; margin-bottom: 16px; }

/* ========== CSS Variable Overrides (per-element theming) ========== */
.theme-danger  { --ui-color-primary: var(--ui-color-danger,  #ef4444); }
.theme-success { --ui-color-primary: var(--ui-color-success, #10b981); }
.theme-warning { --ui-color-primary: var(--ui-color-warning, #f59e0b); }
.theme-info    { --ui-color-primary: var(--ui-color-info,    #3b82f6); }

/* ========== Animated Utility Classes (use with JS toggle) ========== */
.animate-fade-in     { animation: fade-in    200ms ease forwards; }
.animate-fade-out    { animation: fade-out   200ms ease forwards; }
.animate-slide-up    { animation: slide-up   300ms cubic-bezier(.34,1.56,.64,1) forwards; }
.animate-slide-down  { animation: slide-down 300ms cubic-bezier(.34,1.56,.64,1) forwards; }
.animate-scale-in    { animation: scale-in   200ms cubic-bezier(.34,1.56,.64,1) forwards; }
.animate-spin        { animation: spin       1s linear infinite; }
.animate-ping        { animation: ping       1s cubic-bezier(0,0,.2,1) infinite; }
.animate-pulse       { animation: pulse      2s cubic-bezier(.4,0,.6,1) infinite; }
.animate-bounce      { animation: bounce     1s infinite; }

@keyframes fade-in    { from { opacity: 0; } to { opacity: 1; } }
@keyframes fade-out   { from { opacity: 1; } to { opacity: 0; } }
@keyframes slide-up   { from { opacity: 0; transform: translateY(12px); } to { opacity: 1; transform: translateY(0); } }
@keyframes slide-down { from { opacity: 0; transform: translateY(-12px); } to { opacity: 1; transform: translateY(0); } }
@keyframes scale-in   { from { opacity: 0; transform: scale(.9); } to { opacity: 1; transform: scale(1); } }
@keyframes spin       { from { transform: rotate(0deg); } to { transform: rotate(360deg); } }
@keyframes ping       { 0%,100% { opacity: 1; transform: scale(1); } 50% { opacity: .5; transform: scale(1.5); } }
@keyframes pulse      { 0%,100% { opacity: 1; } 50% { opacity: .5; } }
@keyframes bounce     { 0%,100% { transform: translateY(-20%); animation-timing-function: cubic-bezier(.8,0,1,1); } 50% { transform: translateY(0); animation-timing-function: cubic-bezier(0,0,.2,1); } }