/* ==========================================================================
   Wayanad Stays — Frontend Design System (Phase 6A)
   --------------------------------------------------------------------------
   A reusable, prefixed, additive design system. Everything is namespaced
   with `ds-` (components) or `u-` (utilities) and `--ds-*` (tokens) so it can
   be linked globally without altering existing pages, the admin, or Bootstrap.

   Inspiration (not copies): Airbnb, Booking.com, MakeMyTrip, Hostinger,
   Google Material. Mobile-first. Fast. Minimal.

   Contents
     1.  Design tokens (:root)
     2.  Typography
     3.  Buttons
     4.  Badges
     5.  Cards
     6.  Forms
     7.  Search
     8.  Filter chips
     9.  Images / media
     10. Navigation
     11. Modals
     12. Toasts
     13. Loading (skeleton / spinner / progress / shimmer)
     14. Animations
     15. Utilities
     16. Accessibility
     17. Responsive helpers
   ========================================================================== */

/* ==========================================================================
   1. DESIGN TOKENS
   Breakpoints (documented; CSS media queries can't read variables):
     xs 320  ·  360  ·  390  ·  414  ·  sm 576  ·  md 768  ·  lg 992
     xl 1200  ·  xxl 1440
   ========================================================================== */
:root {
    /* ---- Color: brand (aligned with the existing public theme) ---- */
    --ds-primary:        #1b5e3f;
    --ds-primary-hover:  #14402e;
    --ds-primary-active: #0f2e21;
    --ds-primary-soft:   #e4f2ea;
    --ds-on-primary:     #ffffff;

    --ds-secondary:        #17231d;
    --ds-secondary-hover:  #0f2e21;
    --ds-on-secondary:     #ffffff;

    --ds-accent:        #c8912f;   /* gold */
    --ds-accent-hover:  #a8791f;
    --ds-accent-soft:   #f7ecd4;
    --ds-on-accent:     #3a2a06;

    /* ---- Color: status ---- */
    --ds-success:      #1b7a4b;
    --ds-success-soft: #e2f3ea;
    --ds-warning:      #b8860b;
    --ds-warning-soft: #fbf1d8;
    --ds-danger:       #c0392b;
    --ds-danger-soft:  #fbe9e7;
    --ds-info:         #2b6cb0;
    --ds-info-soft:    #e6f0fa;

    /* ---- Color: neutrals & surfaces ---- */
    --ds-light:      #faf8f3;
    --ds-dark:       #0f2e21;
    --ds-muted:      #6b7a72;
    --ds-background: #faf8f3;
    --ds-surface:    #ffffff;
    --ds-surface-2:  #f4f6f4;
    --ds-border:     #e6ece8;
    --ds-border-strong: #d4ddd7;
    --ds-ink:        #17231d;
    --ds-ink-soft:   #45564d;

    /* ---- Interaction states ---- */
    --ds-hover-overlay:   rgba(15, 46, 33, 0.06);
    --ds-active-overlay:  rgba(15, 46, 33, 0.12);
    --ds-disabled-bg:     #eef1ef;
    --ds-disabled-fg:     #9aa8a1;
    --ds-focus-ring:      0 0 0 3px rgba(27, 94, 63, 0.35);
    --ds-focus-ring-danger: 0 0 0 3px rgba(192, 57, 43, 0.32);

    /* ---- Typography ---- */
    --ds-font-sans:    "Inter", "Segoe UI", system-ui, -apple-system, Roboto, Helvetica, Arial, sans-serif;
    --ds-font-display: "Fraunces", "Georgia", "Times New Roman", serif;

    --ds-fs-display: clamp(2.4rem, 6vw, 4rem);
    --ds-fs-h1:      clamp(2rem, 5vw, 3.1rem);
    --ds-fs-h2:      clamp(1.55rem, 3.6vw, 2.25rem);
    --ds-fs-h3:      clamp(1.28rem, 2.6vw, 1.6rem);
    --ds-fs-h4:      clamp(1.1rem, 2vw, 1.28rem);
    --ds-fs-body-lg: 1.125rem;
    --ds-fs-body:    1rem;
    --ds-fs-sm:      0.875rem;
    --ds-fs-caption: 0.78rem;
    --ds-fs-badge:   0.72rem;
    --ds-fs-button:  0.95rem;

    --ds-lh-tight: 1.15;
    --ds-lh-snug:  1.3;
    --ds-lh-body:  1.6;

    --ds-fw-regular: 400;
    --ds-fw-medium:  500;
    --ds-fw-semibold: 600;
    --ds-fw-bold:    700;
    --ds-fw-extra:   800;

    /* ---- Spacing (4px base scale) ---- */
    --ds-space-0: 0;
    --ds-space-1: 4px;
    --ds-space-2: 8px;
    --ds-space-3: 12px;
    --ds-space-4: 16px;
    --ds-space-5: 24px;
    --ds-space-6: 32px;
    --ds-space-7: 48px;
    --ds-space-8: 64px;
    --ds-space-9: 96px;

    /* ---- Section / grid / card rhythm ---- */
    --ds-section-y: clamp(2.5rem, 6vw, 5rem);
    --ds-grid-gap:  clamp(1rem, 2.5vw, 1.75rem);
    --ds-card-pad:  clamp(1rem, 2vw, 1.25rem);

    /* ---- Radius ---- */
    --ds-r-xs:   6px;
    --ds-r-sm:   10px;
    --ds-r-md:   14px;
    --ds-r-lg:   20px;
    --ds-r-xl:   28px;
    --ds-r-pill: 999px;
    --ds-r-circle: 50%;

    /* ---- Border ---- */
    --ds-bw:    1px;
    --ds-bw-2:  2px;
    --ds-border-style: var(--ds-bw) solid var(--ds-border);

    /* ---- Elevation ---- */
    --ds-shadow-xs: 0 1px 2px rgba(15, 46, 33, 0.06);
    --ds-shadow-sm: 0 1px 2px rgba(15, 46, 33, 0.06), 0 2px 6px rgba(15, 46, 33, 0.05);
    --ds-shadow-md: 0 6px 18px rgba(15, 46, 33, 0.09);
    --ds-shadow-lg: 0 18px 40px rgba(15, 46, 33, 0.14);
    --ds-shadow-xl: 0 28px 60px rgba(15, 46, 33, 0.20);

    /* ---- Layout ---- */
    --ds-container:        1180px;
    --ds-container-narrow: 820px;
    --ds-container-wide:   1400px;
    --ds-header-h:         68px;
    --ds-bottomnav-h:      64px;

    /* ---- Icon / control sizing ---- */
    --ds-icon-sm: 16px;
    --ds-icon-md: 20px;
    --ds-icon-lg: 24px;
    --ds-icon-xl: 32px;

    --ds-control-sm: 36px;
    --ds-control-md: 44px;   /* min touch target */
    --ds-control-lg: 52px;

    /* ---- Motion ---- */
    --ds-dur-fast:   120ms;
    --ds-dur-base:   200ms;
    --ds-dur-slow:   320ms;
    --ds-ease:       cubic-bezier(0.4, 0, 0.2, 1);
    --ds-ease-out:   cubic-bezier(0.16, 1, 0.3, 1);
    --ds-ease-in:    cubic-bezier(0.4, 0, 1, 1);

    /* ---- Z-index scale ---- */
    --ds-z-header:   1000;
    --ds-z-bottomnav: 1010;
    --ds-z-dropdown: 1100;
    --ds-z-modal:    1200;
    --ds-z-toast:    1300;
}

/* ==========================================================================
   2. TYPOGRAPHY  (class-based only — never restyles bare tags)
   ========================================================================== */
.ds-display { font-family: var(--ds-font-display); font-size: var(--ds-fs-display); line-height: var(--ds-lh-tight); font-weight: var(--ds-fw-semibold); letter-spacing: -0.02em; color: var(--ds-ink); margin: 0; }
.ds-h1 { font-family: var(--ds-font-display); font-size: var(--ds-fs-h1); line-height: var(--ds-lh-tight); font-weight: var(--ds-fw-semibold); letter-spacing: -0.015em; color: var(--ds-ink); margin: 0; }
.ds-h2 { font-family: var(--ds-font-display); font-size: var(--ds-fs-h2); line-height: var(--ds-lh-snug); font-weight: var(--ds-fw-semibold); color: var(--ds-ink); margin: 0; }
.ds-h3 { font-family: var(--ds-font-sans); font-size: var(--ds-fs-h3); line-height: var(--ds-lh-snug); font-weight: var(--ds-fw-bold); color: var(--ds-ink); margin: 0; }
.ds-h4 { font-family: var(--ds-font-sans); font-size: var(--ds-fs-h4); line-height: var(--ds-lh-snug); font-weight: var(--ds-fw-semibold); color: var(--ds-ink); margin: 0; }
.ds-body-lg { font-family: var(--ds-font-sans); font-size: var(--ds-fs-body-lg); line-height: var(--ds-lh-body); color: var(--ds-ink-soft); }
.ds-body { font-family: var(--ds-font-sans); font-size: var(--ds-fs-body); line-height: var(--ds-lh-body); color: var(--ds-ink-soft); }
.ds-small { font-size: var(--ds-fs-sm); line-height: 1.5; color: var(--ds-ink-soft); }
.ds-caption { font-size: var(--ds-fs-caption); line-height: 1.45; color: var(--ds-muted); letter-spacing: 0.02em; }
.ds-overline { font-size: var(--ds-fs-caption); text-transform: uppercase; letter-spacing: 0.12em; font-weight: var(--ds-fw-semibold); color: var(--ds-muted); }
.ds-lead { font-size: var(--ds-fs-body-lg); line-height: 1.55; color: var(--ds-ink-soft); }

/* ==========================================================================
   3. BUTTONS
   ========================================================================== */
.ds-btn {
    --_bg: var(--ds-primary);
    --_fg: var(--ds-on-primary);
    --_bd: transparent;
    display: inline-flex; align-items: center; justify-content: center; gap: var(--ds-space-2);
    min-height: var(--ds-control-md);
    padding: 0 var(--ds-space-5);
    font-family: var(--ds-font-sans); font-size: var(--ds-fs-button); font-weight: var(--ds-fw-semibold);
    line-height: 1; text-decoration: none; white-space: nowrap; cursor: pointer;
    color: var(--_fg); background: var(--_bg);
    border: var(--ds-bw) solid var(--_bd); border-radius: var(--ds-r-pill);
    transition: transform var(--ds-dur-fast) var(--ds-ease), box-shadow var(--ds-dur-base) var(--ds-ease), background var(--ds-dur-base) var(--ds-ease), filter var(--ds-dur-base) var(--ds-ease);
    position: relative; overflow: hidden; -webkit-tap-highlight-color: transparent;
    user-select: none;
}
.ds-btn:hover { background: var(--ds-primary-hover); box-shadow: var(--ds-shadow-sm); }
.ds-btn:active { transform: translateY(1px); }
.ds-btn:focus-visible { outline: none; box-shadow: var(--ds-focus-ring); }

.ds-btn--secondary { --_bg: var(--ds-secondary); --_fg: var(--ds-on-secondary); }
.ds-btn--secondary:hover { background: var(--ds-secondary-hover); }

.ds-btn--accent { --_bg: var(--ds-accent); --_fg: var(--ds-on-accent); }
.ds-btn--accent:hover { background: var(--ds-accent-hover); }

.ds-btn--outline { --_bg: transparent; --_fg: var(--ds-primary); --_bd: var(--ds-primary); }
.ds-btn--outline:hover { background: var(--ds-primary-soft); box-shadow: none; }

.ds-btn--ghost { --_bg: transparent; --_fg: var(--ds-ink); }
.ds-btn--ghost:hover { background: var(--ds-hover-overlay); box-shadow: none; }

.ds-btn--danger { --_bg: var(--ds-danger); --_fg: #fff; }
.ds-btn--danger:hover { background: #a5271b; }
.ds-btn--danger:focus-visible { box-shadow: var(--ds-focus-ring-danger); }

/* Sizes */
.ds-btn--sm { min-height: var(--ds-control-sm); padding: 0 var(--ds-space-4); font-size: var(--ds-fs-sm); }
.ds-btn--lg { min-height: var(--ds-control-lg); padding: 0 var(--ds-space-6); font-size: var(--ds-fs-body-lg); }
.ds-btn--block { display: flex; width: 100%; }

/* Icon button (square) */
.ds-btn--icon { padding: 0; width: var(--ds-control-md); min-width: var(--ds-control-md); border-radius: var(--ds-r-circle); }
.ds-btn--icon.ds-btn--sm { width: var(--ds-control-sm); min-width: var(--ds-control-sm); }
.ds-btn--icon.ds-btn--lg { width: var(--ds-control-lg); min-width: var(--ds-control-lg); }

/* Disabled */
.ds-btn:disabled, .ds-btn[aria-disabled="true"], .ds-btn.is-disabled {
    background: var(--ds-disabled-bg); color: var(--ds-disabled-fg); border-color: transparent;
    cursor: not-allowed; box-shadow: none; transform: none; pointer-events: none;
}

/* Loading */
.ds-btn.is-loading { color: transparent !important; pointer-events: none; }
.ds-btn.is-loading::after {
    content: ""; position: absolute; width: 1.1em; height: 1.1em; top: 50%; left: 50%;
    margin: -0.55em 0 0 -0.55em; border-radius: 50%;
    border: 2px solid rgba(255, 255, 255, 0.55); border-top-color: #fff;
    animation: ds-spin 0.7s linear infinite;
}
.ds-btn--outline.is-loading::after, .ds-btn--ghost.is-loading::after { border-color: rgba(27, 94, 63, 0.35); border-top-color: var(--ds-primary); }

/* Ripple element injected by JS */
.ds-ripple-ink { position: absolute; border-radius: 50%; transform: scale(0); background: rgba(255, 255, 255, 0.5); pointer-events: none; animation: ds-ripple 0.6s var(--ds-ease-out); }
.ds-btn--outline .ds-ripple-ink, .ds-btn--ghost .ds-ripple-ink { background: rgba(27, 94, 63, 0.25); }

/* ==========================================================================
   4. BADGES
   ========================================================================== */
.ds-badge {
    display: inline-flex; align-items: center; gap: 4px;
    padding: 3px 10px; font-size: var(--ds-fs-badge); font-weight: var(--ds-fw-semibold);
    line-height: 1.3; border-radius: var(--ds-r-pill); letter-spacing: 0.02em;
    background: var(--ds-surface-2); color: var(--ds-ink-soft); white-space: nowrap;
}
.ds-badge--featured { background: var(--ds-accent); color: var(--ds-on-accent); }
.ds-badge--verified { background: var(--ds-success-soft); color: var(--ds-success); }
.ds-badge--new      { background: var(--ds-info-soft); color: var(--ds-info); }
.ds-badge--popular  { background: #fdeede; color: #9a5b12; }
.ds-badge--luxury   { background: linear-gradient(135deg, #2a2a2a, #444); color: #f4dfae; }
.ds-badge--premium  { background: linear-gradient(135deg, #6a4e12, #c8912f); color: #fff; }
.ds-badge--bestseller { background: var(--ds-danger); color: #fff; }
.ds-badge--soft     { background: var(--ds-primary-soft); color: var(--ds-primary); }

/* ==========================================================================
   5. CARDS
   ========================================================================== */
.ds-card {
    background: var(--ds-surface); border: var(--ds-border-style); border-radius: var(--ds-r-lg);
    box-shadow: 0 1px 2px rgba(15,46,33,0.04), 0 6px 20px rgba(15,46,33,0.06);
    overflow: hidden; display: flex; flex-direction: column;
    transition: transform var(--ds-dur-base) var(--ds-ease), box-shadow var(--ds-dur-base) var(--ds-ease), border-color var(--ds-dur-base) var(--ds-ease);
}
.ds-card__media { position: relative; aspect-ratio: 4 / 3; background: var(--ds-surface-2); overflow: hidden; }
.ds-card__media img { width: 100%; height: 100%; object-fit: cover; display: block; transition: transform var(--ds-dur-slow) var(--ds-ease); }
.ds-card__badges { position: absolute; top: var(--ds-space-3); left: var(--ds-space-3); display: flex; gap: 6px; flex-wrap: wrap; }
.ds-card__fav { position: absolute; top: var(--ds-space-3); right: var(--ds-space-3); }
.ds-card__body { padding: var(--ds-space-4); display: flex; flex-direction: column; gap: var(--ds-space-2); flex: 1; }
.ds-card__title { font-family: var(--ds-font-sans); font-size: 1.06rem; font-weight: var(--ds-fw-bold); line-height: 1.32; color: var(--ds-ink); margin: 0; overflow-wrap: break-word; min-width: 0; }
.ds-card__meta { font-size: var(--ds-fs-sm); color: var(--ds-muted); display: flex; align-items: center; gap: 6px; flex-wrap: wrap; min-width: 0; }
.ds-card__foot { margin-top: auto; display: flex; align-items: center; justify-content: space-between; gap: 8px; padding-top: var(--ds-space-3); border-top: 1px solid var(--ds-border); }
.ds-card__price { font-size: 1.18rem; font-weight: var(--ds-fw-extra); color: var(--ds-ink); line-height: 1.2; }
.ds-card__price small { font-size: 0.72rem; font-weight: var(--ds-fw-regular); color: var(--ds-muted); }

/* Interactive lift (property/category/location/gallery) */
.ds-card--interactive { cursor: pointer; }
.ds-card--interactive:hover { transform: translateY(-6px); box-shadow: var(--ds-shadow-lg); border-color: #d7e8de; }
.ds-card--interactive:hover .ds-card__media img { transform: scale(1.06); }
.ds-card--interactive:focus-within { box-shadow: var(--ds-focus-ring); }

/* Property card = default .ds-card + interactive */
.ds-card--property { }

/* Feature card (icon + text, no media) */
.ds-feature-card { background: var(--ds-surface); border: var(--ds-border-style); border-radius: var(--ds-r-lg); padding: var(--ds-space-5); display: flex; flex-direction: column; gap: var(--ds-space-3); box-shadow: var(--ds-shadow-xs); transition: box-shadow var(--ds-dur-base) var(--ds-ease), transform var(--ds-dur-base) var(--ds-ease); }
.ds-feature-card:hover { box-shadow: var(--ds-shadow-md); transform: translateY(-2px); }
.ds-feature-card__icon { width: 48px; height: 48px; border-radius: var(--ds-r-md); display: grid; place-items: center; background: var(--ds-primary-soft); color: var(--ds-primary); font-size: var(--ds-icon-lg); }

/* Category card (compact, image + label overlay) */
.ds-category-card { position: relative; border-radius: var(--ds-r-lg); overflow: hidden; aspect-ratio: 3 / 4; display: block; box-shadow: var(--ds-shadow-sm); }
.ds-category-card img { width: 100%; height: 100%; object-fit: cover; transition: transform var(--ds-dur-slow) var(--ds-ease); }
.ds-category-card:hover img { transform: scale(1.07); }
.ds-category-card__label { position: absolute; inset: auto 0 0 0; padding: var(--ds-space-4); color: #fff; font-weight: var(--ds-fw-semibold); background: linear-gradient(to top, rgba(0,0,0,0.65), transparent); }

/* Location card (horizontal) */
.ds-location-card { display: flex; gap: var(--ds-space-3); align-items: center; background: var(--ds-surface); border: var(--ds-border-style); border-radius: var(--ds-r-md); padding: var(--ds-space-2); box-shadow: var(--ds-shadow-xs); transition: box-shadow var(--ds-dur-base) var(--ds-ease); }
.ds-location-card:hover { box-shadow: var(--ds-shadow-md); }
.ds-location-card__thumb { width: 64px; height: 64px; border-radius: var(--ds-r-sm); object-fit: cover; flex: none; background: var(--ds-surface-2); }

/* Gallery card */
.ds-gallery-card { position: relative; border-radius: var(--ds-r-md); overflow: hidden; aspect-ratio: 1 / 1; background: var(--ds-surface-2); }
.ds-gallery-card img { width: 100%; height: 100%; object-fit: cover; transition: transform var(--ds-dur-slow) var(--ds-ease); }
.ds-gallery-card:hover img { transform: scale(1.05); }

/* Info card */
.ds-info-card { background: var(--ds-primary-soft); border: var(--ds-bw) solid #cfe6da; border-radius: var(--ds-r-md); padding: var(--ds-space-4); color: var(--ds-primary-active); display: flex; gap: var(--ds-space-3); }
.ds-info-card--warning { background: var(--ds-warning-soft); border-color: #ecdcae; color: #7a5a13; }
.ds-info-card--danger { background: var(--ds-danger-soft); border-color: #f0c8c3; color: #8a271c; }

/* Statistic card */
.ds-stat-card { background: var(--ds-surface); border: var(--ds-border-style); border-radius: var(--ds-r-lg); padding: var(--ds-space-5); text-align: center; box-shadow: var(--ds-shadow-xs); }
.ds-stat-card__value { font-family: var(--ds-font-display); font-size: clamp(1.8rem, 4vw, 2.6rem); font-weight: var(--ds-fw-semibold); color: var(--ds-primary); line-height: 1; }
.ds-stat-card__label { margin-top: 6px; font-size: var(--ds-fs-sm); color: var(--ds-muted); }

/* Empty state card */
.ds-empty { text-align: center; padding: var(--ds-space-8) var(--ds-space-5); border: 1.5px dashed var(--ds-border-strong); border-radius: var(--ds-r-lg); color: var(--ds-muted); background: var(--ds-surface); }
.ds-empty__icon { font-size: 2.5rem; margin-bottom: var(--ds-space-3); opacity: 0.7; }
.ds-empty__title { font-weight: var(--ds-fw-semibold); color: var(--ds-ink); margin-bottom: 4px; }

/* Skeleton card */
.ds-skel-card { background: var(--ds-surface); border: var(--ds-border-style); border-radius: var(--ds-r-lg); overflow: hidden; }
.ds-skel-card__media { aspect-ratio: 4 / 3; }
.ds-skel-card__body { padding: var(--ds-card-pad); display: flex; flex-direction: column; gap: 10px; }

/* ==========================================================================
   6. FORMS
   ========================================================================== */
.ds-field { display: flex; flex-direction: column; gap: 6px; margin-bottom: var(--ds-space-4); }
.ds-label { font-size: var(--ds-fs-sm); font-weight: var(--ds-fw-semibold); color: var(--ds-ink); }
.ds-label .ds-req { color: var(--ds-danger); }

.ds-input, .ds-textarea, .ds-select {
    width: 100%; min-height: var(--ds-control-md);
    padding: 10px var(--ds-space-4); font-family: var(--ds-font-sans); font-size: var(--ds-fs-body);
    color: var(--ds-ink); background: var(--ds-surface);
    border: var(--ds-bw) solid var(--ds-border-strong); border-radius: var(--ds-r-sm);
    transition: border-color var(--ds-dur-base) var(--ds-ease), box-shadow var(--ds-dur-base) var(--ds-ease);
    appearance: none;
}
.ds-textarea { min-height: 96px; padding-top: 12px; resize: vertical; line-height: 1.5; }
.ds-input::placeholder, .ds-textarea::placeholder { color: #9aa8a1; }
.ds-input:hover, .ds-textarea:hover, .ds-select:hover { border-color: var(--ds-muted); }
.ds-input:focus, .ds-textarea:focus, .ds-select:focus { outline: none; border-color: var(--ds-primary); box-shadow: var(--ds-focus-ring); }
.ds-input:disabled, .ds-textarea:disabled, .ds-select:disabled { background: var(--ds-disabled-bg); color: var(--ds-disabled-fg); cursor: not-allowed; }

.ds-select { background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' viewBox='0 0 24 24' fill='none' stroke='%236b7a72' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolyline points='6 9 12 15 18 9'%3E%3C/polyline%3E%3C/svg%3E"); background-repeat: no-repeat; background-position: right 12px center; padding-right: 40px; }

/* Input group with leading icon */
.ds-input-group { position: relative; display: flex; align-items: center; }
.ds-input-group .ds-input { padding-left: 42px; }
.ds-input-group__icon { position: absolute; left: 14px; color: var(--ds-muted); pointer-events: none; display: inline-flex; }

/* Validation states */
.ds-field.is-valid .ds-input, .ds-field.is-valid .ds-textarea, .ds-field.is-valid .ds-select, .ds-input.is-valid { border-color: var(--ds-success); }
.ds-field.is-valid .ds-input:focus { box-shadow: 0 0 0 3px rgba(27, 122, 75, 0.28); }
.ds-field.is-invalid .ds-input, .ds-field.is-invalid .ds-textarea, .ds-field.is-invalid .ds-select, .ds-input.is-invalid { border-color: var(--ds-danger); }
.ds-field.is-invalid .ds-input:focus { box-shadow: var(--ds-focus-ring-danger); }
.ds-help { font-size: var(--ds-fs-caption); color: var(--ds-muted); }
.ds-error { font-size: var(--ds-fs-caption); color: var(--ds-danger); display: flex; align-items: center; gap: 4px; }
.ds-success-text { font-size: var(--ds-fs-caption); color: var(--ds-success); }

/* Checkbox & radio */
.ds-check { display: inline-flex; align-items: flex-start; gap: var(--ds-space-2); cursor: pointer; font-size: var(--ds-fs-body); color: var(--ds-ink-soft); user-select: none; min-height: var(--ds-control-md); }
.ds-check input { position: absolute; opacity: 0; width: 0; height: 0; }
.ds-check__box { flex: none; width: 22px; height: 22px; border: 2px solid var(--ds-border-strong); border-radius: 6px; background: #fff; display: inline-grid; place-items: center; transition: all var(--ds-dur-fast) var(--ds-ease); margin-top: 1px; }
.ds-check input:checked + .ds-check__box { background: var(--ds-primary); border-color: var(--ds-primary); }
.ds-check input:checked + .ds-check__box::after { content: ""; width: 6px; height: 11px; border: solid #fff; border-width: 0 2px 2px 0; transform: rotate(45deg) translate(-1px, -1px); }
.ds-check input:focus-visible + .ds-check__box { box-shadow: var(--ds-focus-ring); }
.ds-check--radio .ds-check__box { border-radius: 50%; }
.ds-check--radio input:checked + .ds-check__box::after { content: ""; width: 10px; height: 10px; border: 0; border-radius: 50%; background: #fff; transform: none; }
.ds-check input:disabled + .ds-check__box { background: var(--ds-disabled-bg); border-color: var(--ds-border); }

/* Toggle switch */
.ds-toggle { display: inline-flex; align-items: center; gap: var(--ds-space-2); cursor: pointer; user-select: none; min-height: var(--ds-control-md); }
.ds-toggle input { position: absolute; opacity: 0; width: 0; height: 0; }
.ds-toggle__track { width: 46px; height: 26px; border-radius: var(--ds-r-pill); background: var(--ds-border-strong); position: relative; transition: background var(--ds-dur-base) var(--ds-ease); flex: none; }
.ds-toggle__track::after { content: ""; position: absolute; top: 3px; left: 3px; width: 20px; height: 20px; border-radius: 50%; background: #fff; box-shadow: var(--ds-shadow-sm); transition: transform var(--ds-dur-base) var(--ds-ease); }
.ds-toggle input:checked + .ds-toggle__track { background: var(--ds-primary); }
.ds-toggle input:checked + .ds-toggle__track::after { transform: translateX(20px); }
.ds-toggle input:focus-visible + .ds-toggle__track { box-shadow: var(--ds-focus-ring); }

/* ==========================================================================
   7. SEARCH
   ========================================================================== */
.ds-search { display: flex; align-items: stretch; gap: var(--ds-space-2); background: var(--ds-surface); border: var(--ds-bw) solid var(--ds-border-strong); border-radius: var(--ds-r-pill); padding: 6px; box-shadow: var(--ds-shadow-md); }
.ds-search__field { flex: 1; display: flex; align-items: center; gap: var(--ds-space-2); padding: 0 var(--ds-space-4); min-width: 0; }
.ds-search__field input { border: 0; outline: none; width: 100%; font-size: var(--ds-fs-body); background: transparent; color: var(--ds-ink); min-height: var(--ds-control-md); }
.ds-search__divider { width: 1px; background: var(--ds-border); margin: 8px 0; }
.ds-search__btn { flex: none; }
/* Tablet / mobile: stack into rows */
@media (max-width: 767.98px) {
    .ds-search { flex-direction: column; border-radius: var(--ds-r-lg); padding: var(--ds-space-3); gap: var(--ds-space-2); }
    .ds-search__field { border: var(--ds-bw) solid var(--ds-border); border-radius: var(--ds-r-sm); padding: 6px var(--ds-space-3); }
    .ds-search__divider { display: none; }
    .ds-search__btn { width: 100%; }
}

/* ==========================================================================
   8. FILTER CHIPS
   ========================================================================== */
.ds-chips { display: flex; gap: var(--ds-space-2); flex-wrap: wrap; }
.ds-chips--scroll { flex-wrap: nowrap; overflow-x: auto; scrollbar-width: none; -webkit-overflow-scrolling: touch; padding-bottom: 4px; }
.ds-chips--scroll::-webkit-scrollbar { display: none; }
.ds-chip {
    display: inline-flex; align-items: center; gap: 6px; white-space: nowrap;
    min-height: var(--ds-control-sm); padding: 0 var(--ds-space-4);
    font-size: var(--ds-fs-sm); font-weight: var(--ds-fw-medium); color: var(--ds-ink-soft);
    background: var(--ds-surface); border: var(--ds-bw) solid var(--ds-border-strong);
    border-radius: var(--ds-r-pill); cursor: pointer; user-select: none;
    transition: all var(--ds-dur-fast) var(--ds-ease); -webkit-tap-highlight-color: transparent;
}
.ds-chip:hover { border-color: var(--ds-primary); color: var(--ds-primary); }
.ds-chip:focus-visible { outline: none; box-shadow: var(--ds-focus-ring); }
.ds-chip.is-active, .ds-chip[aria-pressed="true"] { background: var(--ds-primary); border-color: var(--ds-primary); color: #fff; }
.ds-chip__count { font-size: 0.72rem; opacity: 0.8; }

/* Active filter badge (removable) */
.ds-filter-tags { display: flex; gap: var(--ds-space-2); flex-wrap: wrap; align-items: center; }
.ds-filter-tag { display: inline-flex; align-items: center; gap: 6px; padding: 4px 6px 4px 12px; font-size: var(--ds-fs-sm); background: var(--ds-primary-soft); color: var(--ds-primary); border-radius: var(--ds-r-pill); }
.ds-filter-tag__x { display: inline-grid; place-items: center; width: 20px; height: 20px; border: 0; border-radius: 50%; background: rgba(27, 94, 63, 0.15); color: var(--ds-primary); cursor: pointer; font-size: 12px; line-height: 1; }
.ds-filter-tag__x:hover { background: rgba(27, 94, 63, 0.28); }
.ds-clear-all { background: none; border: 0; color: var(--ds-danger); font-size: var(--ds-fs-sm); font-weight: var(--ds-fw-semibold); cursor: pointer; text-decoration: underline; }

/* ==========================================================================
   9. IMAGES / MEDIA
   ========================================================================== */
.ds-img { display: block; width: 100%; height: auto; }
.ds-img--cover { object-fit: cover; }
.ds-ratio { position: relative; width: 100%; background: var(--ds-surface-2); overflow: hidden; }
.ds-ratio > img, .ds-ratio > iframe, .ds-ratio > video { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; }
.ds-ratio--1x1 { aspect-ratio: 1 / 1; }
.ds-ratio--4x3 { aspect-ratio: 4 / 3; }
.ds-ratio--16x9 { aspect-ratio: 16 / 9; }
.ds-ratio--3x4 { aspect-ratio: 3 / 4; }

/* Rounded variants */
.ds-rounded-sm { border-radius: var(--ds-r-sm); overflow: hidden; }
.ds-rounded-md { border-radius: var(--ds-r-md); overflow: hidden; }
.ds-rounded-lg { border-radius: var(--ds-r-lg); overflow: hidden; }
.ds-rounded-circle { border-radius: var(--ds-r-circle); overflow: hidden; }

/* Lazy image fade-in + broken fallback */
.ds-lazy { opacity: 0; transition: opacity var(--ds-dur-slow) var(--ds-ease); background: var(--ds-surface-2); }
.ds-lazy.is-loaded { opacity: 1; }
.ds-img-broken { display: grid; place-items: center; background: var(--ds-surface-2); color: var(--ds-muted); font-size: var(--ds-fs-sm); }
.ds-img-placeholder { display: grid; place-items: center; background: repeating-linear-gradient(45deg, #f0f3f1, #f0f3f1 10px, #eaefec 10px, #eaefec 20px); color: var(--ds-muted); }

/* ==========================================================================
   10. NAVIGATION
   ========================================================================== */
.ds-header { position: relative; z-index: var(--ds-z-header); background: var(--ds-surface); border-bottom: var(--ds-border-style); }
.ds-header__inner { display: flex; align-items: center; justify-content: space-between; gap: var(--ds-space-4); min-height: var(--ds-header-h); }
.ds-header--sticky { position: sticky; top: 0; }
.ds-header--sticky.is-scrolled { box-shadow: var(--ds-shadow-md); }
.ds-header--transparent { background: transparent; border-color: transparent; }
.ds-header--transparent.is-scrolled { background: var(--ds-surface); border-color: var(--ds-border); }
.ds-brand { display: inline-flex; align-items: center; gap: var(--ds-space-2); font-family: var(--ds-font-display); font-weight: var(--ds-fw-semibold); font-size: 1.25rem; color: var(--ds-primary); text-decoration: none; }
.ds-navlinks { display: flex; align-items: center; gap: var(--ds-space-5); }
.ds-navlinks a { color: var(--ds-ink); text-decoration: none; font-weight: var(--ds-fw-medium); font-size: var(--ds-fs-sm); transition: color var(--ds-dur-base) var(--ds-ease); }
.ds-navlinks a:hover, .ds-navlinks a.is-active { color: var(--ds-primary); }
.ds-nav-toggle { display: none; }
@media (max-width: 991.98px) {
    .ds-navlinks { display: none; }
    .ds-nav-toggle { display: inline-flex; }
}

/* Bottom navigation (mobile) */
.ds-bottomnav { position: fixed; inset: auto 0 0 0; z-index: var(--ds-z-bottomnav); display: none; grid-auto-flow: column; grid-auto-columns: 1fr; background: var(--ds-surface); border-top: var(--ds-border-style); box-shadow: 0 -4px 16px rgba(15,46,33,0.08); padding-bottom: env(safe-area-inset-bottom); }
.ds-bottomnav a { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 2px; min-height: var(--ds-bottomnav-h); color: var(--ds-muted); text-decoration: none; font-size: 0.68rem; font-weight: var(--ds-fw-medium); }
.ds-bottomnav a .ds-bottomnav__icon { font-size: var(--ds-icon-md); }
.ds-bottomnav a.is-active { color: var(--ds-primary); }
@media (max-width: 767.98px) { .ds-bottomnav { display: grid; } }

/* Breadcrumb */
.ds-breadcrumb { display: flex; flex-wrap: wrap; align-items: center; gap: 6px; font-size: var(--ds-fs-sm); color: var(--ds-muted); list-style: none; padding: 0; margin: 0; }
.ds-breadcrumb li { display: inline-flex; align-items: center; gap: 6px; }
.ds-breadcrumb a { color: var(--ds-ink-soft); text-decoration: none; }
.ds-breadcrumb a:hover { color: var(--ds-primary); text-decoration: underline; }
.ds-breadcrumb li + li::before { content: "/"; color: var(--ds-border-strong); }
.ds-breadcrumb [aria-current="page"] { color: var(--ds-ink); font-weight: var(--ds-fw-medium); }

/* Pagination */
.ds-pagination { display: flex; gap: 6px; align-items: center; flex-wrap: wrap; list-style: none; padding: 0; margin: 0; }
.ds-pagination a, .ds-pagination span { display: inline-grid; place-items: center; min-width: var(--ds-control-sm); min-height: var(--ds-control-sm); padding: 0 10px; border-radius: var(--ds-r-sm); border: var(--ds-bw) solid var(--ds-border); color: var(--ds-ink); text-decoration: none; font-size: var(--ds-fs-sm); font-weight: var(--ds-fw-medium); transition: all var(--ds-dur-fast) var(--ds-ease); }
.ds-pagination a:hover { border-color: var(--ds-primary); color: var(--ds-primary); }
.ds-pagination .is-current { background: var(--ds-primary); border-color: var(--ds-primary); color: #fff; }
.ds-pagination .is-disabled { opacity: 0.45; pointer-events: none; }

/* ==========================================================================
   11. MODALS
   ========================================================================== */
.ds-modal { position: fixed; inset: 0; z-index: var(--ds-z-modal); display: none; align-items: center; justify-content: center; padding: var(--ds-space-4); }
.ds-modal.is-open { display: flex; }
.ds-modal__backdrop { position: absolute; inset: 0; background: rgba(15, 35, 29, 0.55); backdrop-filter: blur(2px); animation: ds-fade var(--ds-dur-base) var(--ds-ease); }
.ds-modal__dialog { position: relative; background: var(--ds-surface); border-radius: var(--ds-r-lg); box-shadow: var(--ds-shadow-xl); width: 100%; max-width: 460px; max-height: 90vh; overflow: auto; animation: ds-scale-in var(--ds-dur-slow) var(--ds-ease-out); }
.ds-modal__dialog--lg { max-width: 720px; }
.ds-modal__head { display: flex; align-items: center; justify-content: space-between; gap: var(--ds-space-3); padding: var(--ds-space-5) var(--ds-space-5) 0; }
.ds-modal__title { font-family: var(--ds-font-display); font-size: 1.3rem; font-weight: var(--ds-fw-semibold); color: var(--ds-ink); margin: 0; }
.ds-modal__body { padding: var(--ds-space-4) var(--ds-space-5); color: var(--ds-ink-soft); line-height: 1.55; }
.ds-modal__foot { display: flex; gap: var(--ds-space-2); justify-content: flex-end; padding: 0 var(--ds-space-5) var(--ds-space-5); flex-wrap: wrap; }
.ds-modal__close { background: none; border: 0; font-size: 1.5rem; line-height: 1; color: var(--ds-muted); cursor: pointer; width: var(--ds-control-sm); height: var(--ds-control-sm); border-radius: 50%; }
.ds-modal__close:hover { background: var(--ds-hover-overlay); color: var(--ds-ink); }
.ds-modal__icon { width: 56px; height: 56px; border-radius: 50%; display: grid; place-items: center; font-size: 1.6rem; margin-bottom: var(--ds-space-3); }
.ds-modal__icon--success { background: var(--ds-success-soft); color: var(--ds-success); }
.ds-modal__icon--danger { background: var(--ds-danger-soft); color: var(--ds-danger); }
.ds-modal__icon--warning { background: var(--ds-warning-soft); color: var(--ds-warning); }
body.ds-modal-open { overflow: hidden; }

/* ==========================================================================
   12. TOASTS
   ========================================================================== */
.ds-toast-region { position: fixed; z-index: var(--ds-z-toast); top: var(--ds-space-4); right: var(--ds-space-4); display: flex; flex-direction: column; gap: var(--ds-space-2); max-width: min(360px, calc(100vw - 32px)); pointer-events: none; }
.ds-toast { display: flex; align-items: flex-start; gap: var(--ds-space-3); background: var(--ds-surface); border: var(--ds-border-style); border-left: 4px solid var(--ds-muted); border-radius: var(--ds-r-sm); box-shadow: var(--ds-shadow-lg); padding: var(--ds-space-3) var(--ds-space-4); pointer-events: auto; animation: ds-slide-in-right var(--ds-dur-slow) var(--ds-ease-out); }
.ds-toast.is-leaving { animation: ds-fade-out var(--ds-dur-base) var(--ds-ease) forwards; }
.ds-toast__icon { flex: none; font-size: var(--ds-icon-md); line-height: 1.4; }
.ds-toast__body { flex: 1; font-size: var(--ds-fs-sm); color: var(--ds-ink); }
.ds-toast__close { background: none; border: 0; color: var(--ds-muted); cursor: pointer; font-size: 1.1rem; line-height: 1; }
.ds-toast--success { border-left-color: var(--ds-success); } .ds-toast--success .ds-toast__icon { color: var(--ds-success); }
.ds-toast--warning { border-left-color: var(--ds-warning); } .ds-toast--warning .ds-toast__icon { color: var(--ds-warning); }
.ds-toast--danger  { border-left-color: var(--ds-danger); }  .ds-toast--danger .ds-toast__icon { color: var(--ds-danger); }
.ds-toast--info    { border-left-color: var(--ds-info); }    .ds-toast--info .ds-toast__icon { color: var(--ds-info); }
@media (max-width: 575.98px) { .ds-toast-region { left: var(--ds-space-4); right: var(--ds-space-4); max-width: none; } }

/* ==========================================================================
   13. LOADING
   ========================================================================== */
.ds-skeleton { background: linear-gradient(100deg, #eef1ef 30%, #f6f8f7 50%, #eef1ef 70%); background-size: 200% 100%; animation: ds-shimmer 1.3s linear infinite; border-radius: var(--ds-r-sm); }
.ds-skeleton--text { height: 0.85em; margin: 4px 0; border-radius: 4px; }
.ds-skeleton--title { height: 1.1em; width: 70%; border-radius: 5px; }
.ds-skeleton--line { height: 0.85em; }
.ds-skeleton--line.w-60 { width: 60%; } .ds-skeleton--line.w-40 { width: 40%; }
.ds-skeleton--circle { border-radius: 50%; }
.ds-skeleton--block { width: 100%; height: 100%; }

.ds-spinner { display: inline-block; width: var(--ds-icon-lg); height: var(--ds-icon-lg); border: 3px solid var(--ds-border); border-top-color: var(--ds-primary); border-radius: 50%; animation: ds-spin 0.7s linear infinite; }
.ds-spinner--sm { width: var(--ds-icon-md); height: var(--ds-icon-md); border-width: 2px; }
.ds-spinner--lg { width: 40px; height: 40px; border-width: 4px; }

.ds-progress { height: 8px; background: var(--ds-surface-2); border-radius: var(--ds-r-pill); overflow: hidden; }
.ds-progress__bar { height: 100%; background: var(--ds-primary); border-radius: inherit; width: 0; transition: width var(--ds-dur-base) var(--ds-ease); }
.ds-progress--indeterminate .ds-progress__bar { width: 40%; animation: ds-indeterminate 1.2s var(--ds-ease) infinite; }

.ds-shimmer { position: relative; overflow: hidden; background: var(--ds-surface-2); }
.ds-shimmer::after { content: ""; position: absolute; inset: 0; transform: translateX(-100%); background: linear-gradient(90deg, transparent, rgba(255,255,255,0.6), transparent); animation: ds-shimmer-sweep 1.4s infinite; }

/* ==========================================================================
   14. ANIMATIONS
   ========================================================================== */
@keyframes ds-spin { to { transform: rotate(360deg); } }
@keyframes ds-shimmer { to { background-position: -200% 0; } }
@keyframes ds-shimmer-sweep { 100% { transform: translateX(100%); } }
@keyframes ds-fade { from { opacity: 0; } to { opacity: 1; } }
@keyframes ds-fade-out { to { opacity: 0; transform: translateY(-6px); } }
@keyframes ds-scale-in { from { opacity: 0; transform: scale(0.94); } to { opacity: 1; transform: scale(1); } }
@keyframes ds-slide-up { from { opacity: 0; transform: translateY(16px); } to { opacity: 1; transform: translateY(0); } }
@keyframes ds-slide-in-right { from { opacity: 0; transform: translateX(24px); } to { opacity: 1; transform: translateX(0); } }
@keyframes ds-ripple { to { transform: scale(2.6); opacity: 0; } }
@keyframes ds-indeterminate { 0% { margin-left: -40%; } 100% { margin-left: 100%; } }

/* Reveal-on-scroll (JS adds .is-visible) */
.ds-animate { opacity: 0; transform: translateY(18px); transition: opacity var(--ds-dur-slow) var(--ds-ease-out), transform var(--ds-dur-slow) var(--ds-ease-out); will-change: opacity, transform; }
.ds-animate.is-visible { opacity: 1; transform: none; }
.ds-animate--scale { transform: scale(0.96); }
.ds-animate--left { transform: translateX(-18px); }
.ds-animate--right { transform: translateX(18px); }
.ds-fade-in { animation: ds-fade var(--ds-dur-slow) var(--ds-ease); }
.ds-slide-up { animation: ds-slide-up var(--ds-dur-slow) var(--ds-ease-out); }

/* Hover helpers */
.ds-hover-lift { transition: transform var(--ds-dur-base) var(--ds-ease), box-shadow var(--ds-dur-base) var(--ds-ease); }
.ds-hover-lift:hover { transform: translateY(-3px); box-shadow: var(--ds-shadow-md); }

/* ==========================================================================
   15. UTILITIES
   ========================================================================== */
/* Container */
.ds-container { width: 100%; max-width: var(--ds-container); margin-inline: auto; padding-inline: var(--ds-space-4); }
.ds-container--narrow { max-width: var(--ds-container-narrow); }
.ds-container--wide { max-width: var(--ds-container-wide); }
.ds-section { padding-block: var(--ds-section-y); }

/* Display / flex / grid */
.u-flex { display: flex; } .u-inline-flex { display: inline-flex; } .u-grid { display: grid; } .u-block { display: block; } .u-inline-block { display: inline-block; } .u-hidden { display: none; }
.u-flex-col { flex-direction: column; } .u-flex-wrap { flex-wrap: wrap; } .u-flex-1 { flex: 1; } .u-flex-none { flex: none; }
.u-items-center { align-items: center; } .u-items-start { align-items: flex-start; } .u-items-end { align-items: flex-end; } .u-items-stretch { align-items: stretch; }
.u-justify-center { justify-content: center; } .u-justify-between { justify-content: space-between; } .u-justify-end { justify-content: flex-end; } .u-justify-start { justify-content: flex-start; }
.u-gap-1 { gap: var(--ds-space-1); } .u-gap-2 { gap: var(--ds-space-2); } .u-gap-3 { gap: var(--ds-space-3); } .u-gap-4 { gap: var(--ds-space-4); } .u-gap-5 { gap: var(--ds-space-5); } .u-gap-6 { gap: var(--ds-space-6); }
.u-grid-auto { display: grid; gap: var(--ds-grid-gap); grid-template-columns: repeat(auto-fill, minmax(min(240px, 100%), 1fr)); }
.u-grid-2 { display: grid; gap: var(--ds-grid-gap); grid-template-columns: repeat(2, minmax(0, 1fr)); }
.u-grid-3 { display: grid; gap: var(--ds-grid-gap); grid-template-columns: repeat(3, minmax(0, 1fr)); }
.u-grid-4 { display: grid; gap: var(--ds-grid-gap); grid-template-columns: repeat(4, minmax(0, 1fr)); }
@media (max-width: 991.98px) { .u-grid-3, .u-grid-4 { grid-template-columns: repeat(2, minmax(0, 1fr)); } }
@media (max-width: 575.98px) { .u-grid-2, .u-grid-3, .u-grid-4 { grid-template-columns: 1fr; } }

/* Spacing (margin/padding) */
.u-m-0 { margin: 0; } .u-mt-1 { margin-top: var(--ds-space-1); } .u-mt-2 { margin-top: var(--ds-space-2); } .u-mt-3 { margin-top: var(--ds-space-3); } .u-mt-4 { margin-top: var(--ds-space-4); } .u-mt-5 { margin-top: var(--ds-space-5); } .u-mt-6 { margin-top: var(--ds-space-6); }
.u-mb-1 { margin-bottom: var(--ds-space-1); } .u-mb-2 { margin-bottom: var(--ds-space-2); } .u-mb-3 { margin-bottom: var(--ds-space-3); } .u-mb-4 { margin-bottom: var(--ds-space-4); } .u-mb-5 { margin-bottom: var(--ds-space-5); } .u-mb-6 { margin-bottom: var(--ds-space-6); }
.u-mx-auto { margin-inline: auto; }
.u-p-0 { padding: 0; } .u-p-2 { padding: var(--ds-space-2); } .u-p-3 { padding: var(--ds-space-3); } .u-p-4 { padding: var(--ds-space-4); } .u-p-5 { padding: var(--ds-space-5); } .u-p-6 { padding: var(--ds-space-6); }

/* Text helpers */
.u-text-center { text-align: center; } .u-text-left { text-align: left; } .u-text-right { text-align: right; }
.u-text-primary { color: var(--ds-primary); } .u-text-accent { color: var(--ds-accent); } .u-text-muted { color: var(--ds-muted); } .u-text-ink { color: var(--ds-ink); } .u-text-danger { color: var(--ds-danger); } .u-text-success { color: var(--ds-success); } .u-text-white { color: #fff; }
.u-fw-medium { font-weight: var(--ds-fw-medium); } .u-fw-semibold { font-weight: var(--ds-fw-semibold); } .u-fw-bold { font-weight: var(--ds-fw-bold); }
.u-truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.u-clamp-2 { display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }
.u-clamp-3 { display: -webkit-box; -webkit-line-clamp: 3; -webkit-box-orient: vertical; overflow: hidden; }
.u-uppercase { text-transform: uppercase; letter-spacing: 0.04em; }

/* Background helpers */
.u-bg-surface { background: var(--ds-surface); } .u-bg-light { background: var(--ds-light); } .u-bg-primary { background: var(--ds-primary); color: #fff; } .u-bg-primary-soft { background: var(--ds-primary-soft); } .u-bg-dark { background: var(--ds-dark); color: #fff; } .u-bg-accent-soft { background: var(--ds-accent-soft); }

/* Border / radius / shadow helpers */
.u-border { border: var(--ds-border-style); } .u-border-top { border-top: var(--ds-border-style); } .u-border-bottom { border-bottom: var(--ds-border-style); } .u-border-0 { border: 0; }
.u-rounded-sm { border-radius: var(--ds-r-sm); } .u-rounded-md { border-radius: var(--ds-r-md); } .u-rounded-lg { border-radius: var(--ds-r-lg); } .u-rounded-pill { border-radius: var(--ds-r-pill); } .u-rounded-circle { border-radius: 50%; }
.u-shadow-none { box-shadow: none; } .u-shadow-sm { box-shadow: var(--ds-shadow-sm); } .u-shadow-md { box-shadow: var(--ds-shadow-md); } .u-shadow-lg { box-shadow: var(--ds-shadow-lg); }
.u-w-full { width: 100%; } .u-h-full { height: 100%; }
.u-relative { position: relative; } .u-absolute { position: absolute; }

/* ==========================================================================
   16. ACCESSIBILITY
   ========================================================================== */
.ds-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; }
.ds-skip-link { position: absolute; left: -999px; top: 0; z-index: calc(var(--ds-z-toast) + 1); background: var(--ds-primary); color: #fff; padding: 10px 16px; border-radius: 0 0 var(--ds-r-sm) 0; }
.ds-skip-link:focus { left: 0; }
.ds-focusable:focus-visible { outline: none; box-shadow: var(--ds-focus-ring); border-radius: var(--ds-r-xs); }
/* Ensure interactive DS controls meet the 44px touch target guidance */
.ds-touch { min-height: var(--ds-control-md); min-width: var(--ds-control-md); }

@media (prefers-reduced-motion: reduce) {
    *, .ds-animate { animation-duration: 0.001ms !important; animation-iteration-count: 1 !important; transition-duration: 0.001ms !important; }
    .ds-animate { opacity: 1 !important; transform: none !important; }
}

/* ==========================================================================
   17. RESPONSIVE VISIBILITY HELPERS
   Breakpoints: md=768, lg=992
   ========================================================================== */
.u-hide-mobile { }
.u-show-mobile { display: none; }
@media (max-width: 767.98px) {
    .u-hide-mobile { display: none !important; }
    .u-show-mobile { display: block !important; }
}
@media (min-width: 768px) and (max-width: 991.98px) {
    .u-hide-tablet { display: none !important; }
}
@media (min-width: 992px) {
    .u-hide-desktop { display: none !important; }
    .u-show-desktop { display: block !important; }
}