/*
 * anccer-theme — utilities.css
 * Single-purpose utility classes using design tokens.
 * Follows Tailwind-style naming for React developer familiarity.
 * Loaded last so utilities win without needing !important.
 */


/* ═══════════════════════════════════════════════════════
   DISPLAY
   ═══════════════════════════════════════════════════════ */

.hidden       { display: none !important; }
.block        { display: block; }
.inline-block { display: inline-block; }
.inline       { display: inline; }
.flex         { display: flex; }
.inline-flex  { display: inline-flex; }
.grid         { display: grid; }
.contents     { display: contents; }

/* Responsive show/hide */
@media (max-width: 767px)  { .hide-mobile  { display: none !important; } }
@media (min-width: 768px)  { .hide-desktop { display: none !important; } }
@media (min-width: 768px)  { .show-mobile-only { display: none !important; } }
@media (max-width: 767px)  { .show-desktop-only { display: none !important; } }


/* ═══════════════════════════════════════════════════════
   FLEX
   ═══════════════════════════════════════════════════════ */

.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; }
.flex-shrink-0 { flex-shrink: 0; }
.flex-grow     { flex-grow: 1; }

.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-auto   { align-self: auto; }


/* ═══════════════════════════════════════════════════════
   GAP
   ═══════════════════════════════════════════════════════ */

.gap-0  { gap: var(--space-0); }
.gap-1  { gap: var(--space-1); }
.gap-2  { gap: var(--space-2); }
.gap-3  { gap: var(--space-3); }
.gap-4  { gap: var(--space-4); }
.gap-5  { gap: var(--space-5); }
.gap-6  { gap: var(--space-6); }
.gap-8  { gap: var(--space-8); }
.gap-10 { gap: var(--space-10); }

.gap-x-2 { column-gap: var(--space-2); }
.gap-x-4 { column-gap: var(--space-4); }
.gap-x-6 { column-gap: var(--space-6); }
.gap-y-2 { row-gap: var(--space-2); }
.gap-y-4 { row-gap: var(--space-4); }
.gap-y-6 { row-gap: var(--space-6); }


/* ═══════════════════════════════════════════════════════
   PADDING
   ═══════════════════════════════════════════════════════ */

.p-0  { padding: var(--space-0); }
.p-1  { padding: var(--space-1); }
.p-2  { padding: var(--space-2); }
.p-3  { padding: var(--space-3); }
.p-4  { padding: var(--space-4); }
.p-5  { padding: var(--space-5); }
.p-6  { padding: var(--space-6); }
.p-8  { padding: var(--space-8); }

.px-0 { padding-inline: var(--space-0); }
.px-2 { padding-inline: var(--space-2); }
.px-3 { padding-inline: var(--space-3); }
.px-4 { padding-inline: var(--space-4); }
.px-5 { padding-inline: var(--space-5); }
.px-6 { padding-inline: var(--space-6); }

.py-0 { padding-block: var(--space-0); }
.py-2 { padding-block: var(--space-2); }
.py-3 { padding-block: var(--space-3); }
.py-4 { padding-block: var(--space-4); }
.py-5 { padding-block: var(--space-5); }
.py-6 { padding-block: var(--space-6); }

.pt-0 { padding-top: var(--space-0); }
.pt-2 { padding-top: var(--space-2); }
.pt-4 { padding-top: var(--space-4); }
.pt-6 { padding-top: var(--space-6); }

.pb-0 { padding-bottom: var(--space-0); }
.pb-2 { padding-bottom: var(--space-2); }
.pb-4 { padding-bottom: var(--space-4); }
.pb-6 { padding-bottom: var(--space-6); }


/* ═══════════════════════════════════════════════════════
   MARGIN
   ═══════════════════════════════════════════════════════ */

.m-0    { margin: var(--space-0); }
.m-auto { margin: auto; }
.mx-auto { margin-inline: auto; }

.mt-0  { margin-top: var(--space-0); }
.mt-1  { margin-top: var(--space-1); }
.mt-2  { margin-top: var(--space-2); }
.mt-3  { margin-top: var(--space-3); }
.mt-4  { margin-top: var(--space-4); }
.mt-6  { margin-top: var(--space-6); }
.mt-8  { margin-top: var(--space-8); }

.mb-0  { margin-bottom: var(--space-0); }
.mb-2  { margin-bottom: var(--space-2); }
.mb-3  { margin-bottom: var(--space-3); }
.mb-4  { margin-bottom: var(--space-4); }
.mb-6  { margin-bottom: var(--space-6); }


/* ═══════════════════════════════════════════════════════
   SIZING
   ═══════════════════════════════════════════════════════ */

.w-full     { width: 100%; }
.w-auto     { width: auto; }
.max-w-full { max-width: 100%; }
.min-w-0    { min-width: 0; }
.h-full     { height: 100%; }
.min-h-0    { min-height: 0; }


/* ═══════════════════════════════════════════════════════
   TYPOGRAPHY
   ═══════════════════════════════════════════════════════ */

.text-xs   { font-size: var(--text-xs); }
.text-sm   { font-size: var(--text-sm); }
.text-base { font-size: var(--text-base); }
.text-lg   { font-size: var(--text-lg); }
.text-xl   { font-size: var(--text-xl); }
.text-2xl  { font-size: var(--text-2xl); }
.text-3xl  { font-size: var(--text-3xl); }

.font-normal   { font-weight: var(--font-normal); }
.font-medium   { font-weight: var(--font-medium); }
.font-semibold { font-weight: var(--font-semibold); }
.font-bold     { font-weight: var(--font-bold); }

.leading-tight   { line-height: var(--leading-tight); }
.leading-normal  { line-height: var(--leading-normal); }
.leading-relaxed { line-height: var(--leading-relaxed); }

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

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

.break-words {
    overflow-wrap: break-word;
    word-break: break-word;
}

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

.whitespace-nowrap { white-space: nowrap; }


/* ═══════════════════════════════════════════════════════
   COLOUR
   ═══════════════════════════════════════════════════════ */

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

.bg-surface    { background: var(--color-surface); }
.bg-bg         { background: var(--color-bg); }
.bg-primary    { background: var(--color-primary); }
.bg-accent     { background: var(--color-accent); }
.bg-danger-bg  { background: var(--color-danger-bg); }
.bg-success-bg { background: var(--color-success-bg); }


/* ═══════════════════════════════════════════════════════
   BORDER
   ═══════════════════════════════════════════════════════ */

.border          { border: 1px solid var(--color-border); }
.border-strong   { border: 1px solid var(--color-border-strong); }
.border-t        { border-top: 1px solid var(--color-border); }
.border-b        { border-bottom: 1px solid var(--color-border); }
.border-0        { border: 0; }

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


/* ═══════════════════════════════════════════════════════
   SHADOW
   ═══════════════════════════════════════════════════════ */

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


/* ═══════════════════════════════════════════════════════
   OVERFLOW
   ═══════════════════════════════════════════════════════ */

.overflow-hidden   { overflow: hidden; }
.overflow-auto     { overflow: auto; }
.overflow-x-auto   { overflow-x: auto; }
.overflow-x-hidden { overflow-x: hidden; }
.overflow-y-auto   { overflow-y: auto; }


/* ═══════════════════════════════════════════════════════
   POSITION
   ═══════════════════════════════════════════════════════ */

.relative { position: relative; }
.absolute { position: absolute; }
.fixed    { position: fixed; }
.sticky   { position: sticky; }

.inset-0  { inset: 0; }
.top-0    { top: 0; }
.left-0   { left: 0; }
.right-0  { right: 0; }
.bottom-0 { bottom: 0; }


/* ═══════════════════════════════════════════════════════
   CURSOR / INTERACTION
   ═══════════════════════════════════════════════════════ */

.cursor-pointer { cursor: pointer; }
.cursor-default { cursor: default; }
.select-none    { user-select: none; }
.pointer-none   { pointer-events: none; }


/* ═══════════════════════════════════════════════════════
   LAYOUT COMPOSITES
   Common multi-property patterns used by React components
   ═══════════════════════════════════════════════════════ */

/* Constrained centred container */
.container {
    width: 100%;
    max-width: var(--container-max);
    margin-inline: auto;
    padding-inline: var(--space-6);
    box-sizing: border-box;
}

/* Surface card */
.card {
    background: var(--color-surface);
    border-radius: var(--radius);
    border: 1px solid var(--color-border);
    padding: var(--space-5);
}

.card-sm { padding: var(--space-3); }
.card-lg { padding: var(--space-8); }

/* Horizontal divider */
.divider {
    height: 1px;
    background: var(--color-border);
    margin-block: var(--space-3);
}

/* Screen-reader-only */
.sr-only,
.bp-screen-reader-text,
.screen-reader-text {
    clip: rect(1px, 1px, 1px, 1px);
    clip-path: inset(50%);
    height: 1px;
    margin: -1px;
    overflow: hidden;
    padding: 0;
    position: absolute !important;
    width: 1px;
    word-wrap: normal !important;
}

/* Visually centred icon + label row */
.icon-row {
    display: flex;
    align-items: center;
    gap: var(--space-2);
}

/* Consistent interactive state */
.interactive {
    transition: background var(--transition-fast), color var(--transition-fast), opacity var(--transition-fast);
}

.interactive:hover { opacity: 0.85; }