/* ============================================================
   Utility Classes
   ============================================================ */

/* ─── Display ─── */
.d-none          { display: none !important; }
.d-block         { display: block; }
.d-inline        { display: inline; }
.d-inline-block  { display: inline-block; }
.d-flex          { display: flex; }
.d-inline-flex   { display: inline-flex; }
.d-grid          { display: grid; }

/* ─── 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-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; }

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

/* ─── Gap ─── */
.gap-1  { gap: var(--sp-1); }
.gap-2  { gap: var(--sp-2); }
.gap-3  { gap: var(--sp-3); }
.gap-4  { gap: var(--sp-4); }
.gap-5  { gap: var(--sp-5); }
.gap-6  { gap: var(--sp-6); }
.gap-8  { gap: var(--sp-8); }
.gap-10 { gap: var(--sp-10); }
.gap-12 { gap: var(--sp-12); }
.gap-16 { gap: var(--sp-16); }

/* ─── Grid ─── */
.grid-cols-1 { grid-template-columns: repeat(1, 1fr); }
.grid-cols-2 { grid-template-columns: repeat(2, 1fr); }
.grid-cols-3 { grid-template-columns: repeat(3, 1fr); }
.grid-cols-4 { grid-template-columns: repeat(4, 1fr); }

/* ─── Width / Height ─── */
.w-full    { width: 100%; }
.w-auto    { width: auto; }
.max-w-container { max-width: var(--container-max); }
.max-w-narrow    { max-width: var(--container-narrow); }
.h-full    { height: 100%; }
.h-auto    { height: auto; }
.min-h-screen { min-height: 100vh; }

/* ─── Margin ─── */
.mx-auto { margin-left: auto; margin-right: auto; }
.mt-0  { margin-top: 0; }
.mt-1  { margin-top: var(--sp-1); }
.mt-2  { margin-top: var(--sp-2); }
.mt-3  { margin-top: var(--sp-3); }
.mt-4  { margin-top: var(--sp-4); }
.mt-5  { margin-top: var(--sp-5); }
.mt-6  { margin-top: var(--sp-6); }
.mt-8  { margin-top: var(--sp-8); }
.mt-10 { margin-top: var(--sp-10); }
.mt-12 { margin-top: var(--sp-12); }
.mt-16 { margin-top: var(--sp-16); }
.mt-20 { margin-top: var(--sp-20); }

.mb-0  { margin-bottom: 0; }
.mb-1  { margin-bottom: var(--sp-1); }
.mb-2  { margin-bottom: var(--sp-2); }
.mb-3  { margin-bottom: var(--sp-3); }
.mb-4  { margin-bottom: var(--sp-4); }
.mb-5  { margin-bottom: var(--sp-5); }
.mb-6  { margin-bottom: var(--sp-6); }
.mb-8  { margin-bottom: var(--sp-8); }
.mb-10 { margin-bottom: var(--sp-10); }
.mb-12 { margin-bottom: var(--sp-12); }
.mb-16 { margin-bottom: var(--sp-16); }
.mb-20 { margin-bottom: var(--sp-20); }

.ml-auto { margin-left: auto; }
.mr-auto { margin-right: auto; }

/* ─── Padding ─── */
.p-0   { padding: 0; }
.p-2   { padding: var(--sp-2); }
.p-3   { padding: var(--sp-3); }
.p-4   { padding: var(--sp-4); }
.p-5   { padding: var(--sp-5); }
.p-6   { padding: var(--sp-6); }
.p-8   { padding: var(--sp-8); }
.p-10  { padding: var(--sp-10); }
.p-12  { padding: var(--sp-12); }

.px-0  { padding-left: 0; padding-right: 0; }
.px-2  { padding-left: var(--sp-2); padding-right: var(--sp-2); }
.px-3  { padding-left: var(--sp-3); padding-right: var(--sp-3); }
.px-4  { padding-left: var(--sp-4); padding-right: var(--sp-4); }
.px-5  { padding-left: var(--sp-5); padding-right: var(--sp-5); }
.px-6  { padding-left: var(--sp-6); padding-right: var(--sp-6); }
.px-8  { padding-left: var(--sp-8); padding-right: var(--sp-8); }

.py-0  { padding-top: 0; padding-bottom: 0; }
.py-2  { padding-top: var(--sp-2); padding-bottom: var(--sp-2); }
.py-3  { padding-top: var(--sp-3); padding-bottom: var(--sp-3); }
.py-4  { padding-top: var(--sp-4); padding-bottom: var(--sp-4); }
.py-6  { padding-top: var(--sp-6); padding-bottom: var(--sp-6); }
.py-8  { padding-top: var(--sp-8); padding-bottom: var(--sp-8); }
.py-10 { padding-top: var(--sp-10); padding-bottom: var(--sp-10); }
.py-12 { padding-top: var(--sp-12); padding-bottom: var(--sp-12); }
.py-16 { padding-top: var(--sp-16); padding-bottom: var(--sp-16); }
.py-20 { padding-top: var(--sp-20); padding-bottom: var(--sp-20); }
.py-24 { padding-top: var(--sp-24); padding-bottom: var(--sp-24); }

.pt-0  { padding-top: 0; }
.pt-4  { padding-top: var(--sp-4); }
.pt-8  { padding-top: var(--sp-8); }
.pt-12 { padding-top: var(--sp-12); }
.pt-16 { padding-top: var(--sp-16); }
.pt-20 { padding-top: var(--sp-20); }

.pb-0  { padding-bottom: 0; }
.pb-4  { padding-bottom: var(--sp-4); }
.pb-8  { padding-bottom: var(--sp-8); }
.pb-12 { padding-bottom: var(--sp-12); }
.pb-16 { padding-bottom: var(--sp-16); }
.pb-20 { padding-bottom: var(--sp-20); }

/* ─── Typography ─── */
.text-xs    { font-size: var(--fs-xs); }
.text-sm    { font-size: var(--fs-sm); }
.text-base  { font-size: var(--fs-base); }
.text-lg    { font-size: var(--fs-lg); }
.text-xl    { font-size: var(--fs-xl); }
.text-2xl   { font-size: var(--fs-2xl); }
.text-3xl   { font-size: var(--fs-3xl); }
.text-4xl   { font-size: var(--fs-4xl); }
.text-5xl   { font-size: var(--fs-5xl); }
.text-6xl   { font-size: var(--fs-6xl); }

.font-light     { font-weight: var(--fw-light); }
.font-regular   { font-weight: var(--fw-regular); }
.font-medium    { font-weight: var(--fw-medium); }
.font-semibold  { font-weight: var(--fw-semibold); }
.font-bold      { font-weight: var(--fw-bold); }
.font-extrabold { font-weight: var(--fw-extrabold); }

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

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

.tracking-tight  { letter-spacing: var(--ls-tight); }
.tracking-normal { letter-spacing: var(--ls-normal); }
.tracking-wide   { letter-spacing: var(--ls-wide); }

.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; }
.whitespace-nowrap { white-space: nowrap; }

/* ─── Text Colors ─── */
.text-primary    { color: var(--color-primary); }
.text-dark       { color: var(--color-text-dark); }
.text-default    { color: var(--color-text); }
.text-light      { color: var(--color-text-light); }
.text-lighter    { color: var(--color-text-lighter); }
.text-white      { color: var(--color-white); }
.text-success    { color: var(--color-success); }
.text-error      { color: var(--color-error); }
.text-warning    { color: var(--color-warning); }
.text-accent     { color: var(--color-accent); }

/* ─── Background Colors ─── */
.bg-white        { background-color: var(--color-white); }
.bg-gray-50      { background-color: var(--color-gray-50); }
.bg-gray-100     { background-color: var(--color-gray-100); }
.bg-primary      { background-color: var(--color-primary); }
.bg-primary-dark { background-color: var(--color-primary-dark); }
.bg-primary-darker { background-color: var(--color-primary-darker); }
.bg-primary-bg   { background-color: var(--color-primary-bg); }
.bg-primary-bg-alt { background-color: var(--color-primary-bg-alt); }
.bg-success-bg   { background-color: var(--color-success-bg); }
.bg-error-bg     { background-color: var(--color-error-bg); }
.bg-gradient     { background: var(--gradient-primary); }

/* ─── Border ─── */
.border          { border: 1px solid var(--color-gray-200); }
.border-t        { border-top: 1px solid var(--color-gray-200); }
.border-b        { border-bottom: 1px solid var(--color-gray-200); }
.border-primary  { border-color: var(--color-primary); }

/* ─── Border Radius ─── */
.rounded-none { border-radius: 0; }
.rounded-sm   { border-radius: var(--radius-sm); }
.rounded-md   { border-radius: var(--radius-md); }
.rounded-lg   { border-radius: var(--radius-lg); }
.rounded-xl   { border-radius: var(--radius-xl); }
.rounded-2xl  { border-radius: var(--radius-2xl); }
.rounded-3xl  { border-radius: var(--radius-3xl); }
.rounded-full { border-radius: var(--radius-full); }

/* ─── Shadows ─── */
.shadow-none  { box-shadow: none; }
.shadow-sm    { box-shadow: var(--shadow-sm); }
.shadow-md    { box-shadow: var(--shadow-md); }
.shadow-lg    { box-shadow: var(--shadow-lg); }
.shadow-xl    { box-shadow: var(--shadow-xl); }
.shadow-card  { box-shadow: var(--shadow-card); }
.shadow-float { box-shadow: var(--shadow-float); }

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

/* ─── Position ─── */
.relative { position: relative; }
.absolute { position: absolute; }
.fixed    { position: fixed; }
.sticky   { position: sticky; }

/* ─── Cursor ─── */
.cursor-pointer  { cursor: pointer; }
.pointer-events-none { pointer-events: none; }

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

/* ─── Transition ─── */
.transition-fast   { transition: var(--transition-fast); }
.transition-base   { transition: var(--transition-base); }
.transition-slow   { transition: var(--transition-slow); }

/* ─── Screen Reader Only ─── */
.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;
}

/* ─── Word Break (Korean) ─── */
.word-keep { word-break: keep-all; }