/* =========================================================================
   SKP DESIGN SYSTEM — TOKENS
   v4 (2026-08-25)   Loaded by skp-theme-tokens.php at priority 5.

   M3 supplies the ARCHITECTURE — colour roles with mandatory `on-` pairs,
                                  container ladders, state layers, type scale.
   Apple HIG supplies the JUDGEMENT — Clarity, Deference, Depth. Flat by
                                  default; elevation only where interactive.
   SKP supplies the MEANING — yellow marks a material hub, blue an application
                                  page. Colour is catalogue navigation.

   ---------------------------------------------------------------------
   WHAT CHANGED IN v4, AND WHY
   An adversarial audit on 2026-08-25 found v3 was never enqueued: zero
   references anywhere in the repo. The live site ran a different vocabulary
   declared inside skp-design-system.css. Eight blocker-severity findings
   survived refutation. v4 fixes them and adds a compatibility layer so the
   two vocabularies can coexist while the 13 product pages are rebuilt.

     1. NOW ENQUEUED           skp-theme-tokens.php, priority 5.
     2. COLLISIONS RESOLVED    v1 `--skp-surface` meant #f2f5f8 (a tint);
                               v3 means #ffffff. v1 `--skp-shadow` was a
                               shadow VALUE; v3 was a colour. Both v1 names
                               now alias correctly (see COMPAT block) and the
                               v3 shadow colour is renamed --skp-shadow-tint.
     3. FOCUS RING FIXED       04-INTERACTION said the ring is "the section's
                               accent colour". On a hub that is #FFCD57 —
                               1.49:1 on white. Unusable. The ring now keys
                               off the SURFACE, not the tier: blue on light
                               (5.57–7.27:1), yellow on dark (11.06:1).
     4. TYPE HIERARCHY FIXED   headline-large capped 2.6rem and
                               headline-medium 2.5rem, so H1 and H2 rendered
                               1.6px apart above 1481px on all ten use-case
                               pages. Now 2.9rem / 2.2rem — a 1.32 ratio.
     5. MUTED INK FIXED        --skp-on-surface-variant #5b6b7d computed
                               4.19:1 on surface-container-highest, below the
                               system's own 4.5 floor. Now #4f5d70, min 5.14
                               across the entire surface ladder.
     6. DARK-BAND MUTED INK    was a hardcoded rgba() in a descendant rule.
                               Now a real role: --skp-inverse-on-surface-variant.
     7. DIVIDER MADE VISIBLE   outline-variant at 0.10 computed 1.22:1. The
                               whole deference principle rests on rules rather
                               than boxes, so an invisible rule collapses it.
                               Now 0.16.
     8. ANCHORS COVERED        surface utilities set an on-colour for
                               h1-h4/strong/p/li but not <a>, so an inline
                               link on a dark band inherited Astra's blue at
                               ~2.3:1. Anchors are now covered on every surface.
     9. BUTTON IMPLEMENTED     the one element every component needs had no
                               implementation anywhere. .skp-btn now exists.
    10. TIER ALIASES           --skp-accent / --skp-card-pad / --skp-grid-gap /
                               --skp-section-rhythm resolve per tier, so a
                               component is written once, not twice.

   ALL RATIOS IN THIS FILE ARE MEASURED, NOT ESTIMATED.
   Recompute after any colour change. An unverified ratio is an assumption.
   ========================================================================= */

:root {

  /* =======================================================================
     COLOUR ROLES — M3 core set. Every role has a mandatory `on-` pair.
     Setting a background without its paired text colour is a defect: it is
     how white text shipped on a white live CTA.
     ======================================================================= */

  /* primary — conversion actions, application tier */
  --skp-primary:                   #0056A7;
  --skp-on-primary:                #ffffff;   /*  7.27:1 measured */
  --skp-primary-container:         #d9e7f6;
  --skp-on-primary-container:      #0f4c81;   /*  7.05:1 measured */

  /* secondary — structure and authority */
  --skp-secondary:                 #102033;
  --skp-on-secondary:              #ffffff;   /* 16.45:1 measured */
  --skp-secondary-container:       #e9eff6;
  --skp-on-secondary-container:    #1e293b;   /* 12.64:1 measured */

  /* tertiary — MATERIAL tier signal. A LIGHT surface: it takes dark ink.
     White on #FFCD57 is 1.49:1. This has caused a live failure once. */
  --skp-tertiary:                  #FFCD57;
  --skp-on-tertiary:               #102033;   /* 11.06:1 measured */
  --skp-tertiary-container:        #fff4d6;
  --skp-on-tertiary-container:     #5c4300;   /*  8.49:1 measured */

  /* error */
  --skp-error:                     #b3261e;
  --skp-on-error:                  #ffffff;   /*  7.00:1 measured */
  --skp-error-container:           #f9dedc;
  --skp-on-error-container:        #8c1d18;   /*  8.24:1 measured */

  /* surfaces — M3 container ladder, lowest to highest */
  --skp-surface:                   #ffffff;
  --skp-on-surface:                #334155;   /* 10.35:1 measured */
  --skp-surface-variant:           #e9eff6;

  /* v3 shipped #5b6b7d, which computed 4.19:1 on surface-container-highest
     and therefore failed the system's own 4.5 floor on a surface it is
     documented to sit on. #4f5d70 measures, across the full ladder:
       on #ffffff 6.70 · #f8fafc 6.41 · #f2f5f8 6.13 · #e9eff6 5.79 · #d6e3f0 5.14 */
  --skp-on-surface-variant:        #4f5d70;   /*  5.14:1 worst case, measured */

  --skp-surface-container-lowest:  #ffffff;
  --skp-surface-container-low:     #f8fafc;
  --skp-surface-container:         #f2f5f8;
  --skp-surface-container-high:    #e9eff6;
  --skp-surface-container-highest: #d6e3f0;

  /* inverse — dark bands on a light page */
  --skp-inverse-surface:           #102033;
  --skp-inverse-on-surface:        #ffffff;   /* 16.45:1 measured */
  /* the muted ink for dark bands. Was a hardcoded rgba(234,241,248,.86) in a
     descendant rule, which is the same thing as not having a role at all. */
  --skp-inverse-on-surface-variant:#cbd4dc;   /* 10.96:1 measured */
  --skp-inverse-primary:           #FFCD57;   /* 11.06:1 measured */

  /* outline. outline-variant is the DIVIDER — the system separates items with
     rules rather than boxes, so this value is load-bearing, not cosmetic.
     At 0.10 it computed 1.22:1 and was effectively invisible. 0.16 is 1.39:1:
     still a quiet hairline, but one that actually performs its job. */
  --skp-outline:                   rgba(16, 32, 51, 0.28);
  --skp-outline-variant:           rgba(16, 32, 51, 0.16);
  --skp-outline-inverse:           rgba(234, 241, 248, 0.28);

  --skp-scrim:                     rgba(11, 26, 43, 0.72);
  --skp-shadow-tint:               rgba(15, 23, 42, 1);

  /* =======================================================================
     FOCUS — keyed off the SURFACE, never the tier.
     04-INTERACTION previously said "the section's accent colour", which on a
     material hub resolves to #FFCD57 at 1.49:1 on white. A focus ring nobody
     can see is the same as no focus ring.
     ======================================================================= */
  --skp-focus-ring:                #0056A7;   /* 5.57–7.27:1 across the light ladder */
  --skp-focus-ring-inverse:        #FFCD57;   /* 11.06:1 on inverse-surface */
  --skp-focus-width:               2px;
  --skp-focus-offset:              2px;

  /* =======================================================================
     STATE LAYERS — M3 opacities
     ======================================================================= */
  --skp-state-hover:               0.08;
  --skp-state-focus:               0.10;
  --skp-state-pressed:             0.10;
  --skp-state-dragged:             0.16;
  --skp-state-disabled-content:    0.38;
  --skp-state-disabled-container:  0.12;

  /* =======================================================================
     ACCESSIBILITY FLOORS — HIG values, stricter than M3 where they differ
     ======================================================================= */
  --skp-target-min:                48px;   /* max(M3 48, HIG 44) */
  --skp-contrast-body:             4.5;    /* HIG; M3 permits 3.0 */
  --skp-contrast-large:            3.0;

  /* =======================================================================
     TYPOGRAPHY — M3's 15 roles, one industrial family.
     The condensed face lets a spec table hold more columns without dropping
     below body size, which is the entire job of a product page.
     ======================================================================= */
  --skp-font:                      "Barlow Semi Condensed", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;

  --skp-display-large:             clamp(2.9rem, 5.2vw, 4.5rem);
  --skp-display-medium:            clamp(2.5rem, 4.4vw, 3.6rem);
  --skp-display-small:             clamp(2.2rem, 3.6vw, 2.9rem);

  /* v3 capped headline-large at 2.6rem (41.6px) and headline-medium at 2.5rem
     (40.0px). Above 1481px both hit their caps and H1 sat 1.6px from H2 — no
     hierarchy at all on the ten use-case pages, where headline-large IS the
     H1 role. 2.9rem / 2.2rem restores a 1.32 ratio (46.4px / 35.2px). */
  --skp-headline-large:            clamp(2.05rem, 3.4vw, 2.9rem);
  --skp-headline-medium:           clamp(1.6rem,  2.5vw, 2.2rem);
  --skp-headline-small:            clamp(1.4rem,  2.0vw, 1.75rem);

  --skp-title-large:               clamp(1.15rem, 1.5vw, 1.4rem);
  --skp-title-medium:              1.06rem;
  --skp-title-small:               0.96rem;

  --skp-body-large:                clamp(1.05rem, 1.32vw, 1.3rem);
  --skp-body-medium:               clamp(1rem, 1.08vw, 1.12rem);
  --skp-body-small:                0.92rem;

  --skp-label-large:               1rem;
  --skp-label-medium:              0.86rem;
  --skp-label-small:               0.76rem;

  --skp-measure-body:              72ch;
  --skp-measure-lede:              62ch;

  /* =======================================================================
     SHAPE — M3's corner scale, exact dp values.
     Radius is a part of speech:
       full    = an action. A pill that is not clickable is a bug.
       large   = a surface holding content
       x-large = photography
       small   = a label
     ======================================================================= */
  --skp-shape-none:                0;
  --skp-shape-extra-small:         4px;
  --skp-shape-small:               8px;
  --skp-shape-medium:              12px;
  --skp-shape-large:               16px;
  --skp-shape-extra-large:         28px;
  --skp-shape-full:                999px;

  --skp-shape-button:              var(--skp-shape-full);
  --skp-shape-card:                var(--skp-shape-large);
  --skp-shape-media:               var(--skp-shape-extra-large);
  --skp-shape-chip:                var(--skp-shape-small);

  /* =======================================================================
     ELEVATION — M3 levels 0..5, tinted to SKP navy.
     Elevation signals INTERACTIVITY, never decoration. A shadow on something
     you cannot click is noise. Flat is the default.
     ======================================================================= */
  --skp-elevation-0:               none;
  --skp-elevation-1:               0 1px 2px rgba(16, 32, 51, 0.30), 0 1px 3px 1px rgba(16, 32, 51, 0.13);
  --skp-elevation-2:               0 1px 2px rgba(16, 32, 51, 0.30), 0 2px 6px 2px rgba(16, 32, 51, 0.13);
  --skp-elevation-3:               0 1px 3px rgba(16, 32, 51, 0.30), 0 4px 8px 3px rgba(16, 32, 51, 0.13);
  --skp-elevation-4:               0 2px 3px rgba(16, 32, 51, 0.30), 0 6px 10px 4px rgba(16, 32, 51, 0.13);
  --skp-elevation-5:               0 4px 4px rgba(16, 32, 51, 0.30), 0 8px 12px 6px rgba(16, 32, 51, 0.13);

  --skp-elevation-card:            var(--skp-elevation-1);
  --skp-elevation-card-hover:      var(--skp-elevation-3);
  --skp-elevation-media:           var(--skp-elevation-4);
  --skp-elevation-menu:            var(--skp-elevation-5);

  /* =======================================================================
     SPACING · LAYOUT · MOTION
     ======================================================================= */
  --skp-space-xs:                  4px;
  --skp-space-sm:                  8px;
  --skp-space-md:                  14px;
  --skp-space-lg:                  22px;
  --skp-space-xl:                  30px;
  --skp-space-2xl:                 44px;
  /* stacked-button gap on mobile (04-INTERACTION s1.7). Two components had
     expressed the same 12px two different ways. */
  --skp-space-stack:               12px;

  /* v3 shipped a single --skp-space-section: clamp(48px, 6vw, 88px) that
     matched NEITHER tier's documented rhythm and was referenced by nothing.
     Section rhythm is tier-resolved in the TIER ALIASES block below. */

  --skp-inner-cap:                 min(94%, 1600px);
  --skp-gutter:                    max(18px, 3vw, calc((100vw - 1600px) / 2));

  --skp-motion-standard:           0.2s cubic-bezier(0.2, 0, 0, 1);
  --skp-motion-emphasized:         0.3s cubic-bezier(0.2, 0, 0, 1);
  --skp-motion-fast:               0.18s cubic-bezier(0.2, 0, 0, 1);

  /* =======================================================================
     TIER ALIASES — DEFAULT (use-case / application).
     A component references --skp-accent once; the tier resolves it. Without
     this layer every component has to be written twice, which is how five
     hand-written accent bars ended up in skp-product-tiers.css.
     ======================================================================= */
  --skp-accent:                    var(--skp-primary);
  --skp-on-accent:                 var(--skp-on-primary);
  --skp-accent-bar:                3px;
  --skp-card-pad:                  var(--skp-space-lg);   /* 22px */
  --skp-grid-gap:                  var(--skp-space-lg);   /* 22px */
  --skp-section-rhythm:            clamp(44px, 5vw, 72px);
  --skp-hero-rhythm:               clamp(48px, 5.5vw, 84px);
  /* A tight band (Stats, Lineage) is not a full section. Without this token it
     was the one rhythm value still being hand-written inside a component. */
  --skp-band-rhythm:               clamp(28px, 3vw, 44px);

  /* The tier's body prose role. 01 s2.2 states it as a tier fact — hub prose is
     body-large, use-case prose is body-medium — but gave no token, so three
     components each invented a private name for it. */
  --skp-prose-size:                var(--skp-body-medium);
  --skp-prose-leading:             1.68;
  --skp-prose-measure:             var(--skp-measure-body);

  /* Inline prose link ink. Rebound per surface exactly like --skp-focus-ring,
     so a link inside a dark band is never Astra's theme blue at 2.3:1. */
  --skp-link-ink:                  var(--skp-primary);

  /* The divider, as a shorthand. Written out longhand in eight components. */
  --skp-hairline:                  1px solid var(--skp-outline-variant);

  /* =======================================================================
     COMPAT — v1 names, aliased onto v3 roles.
     These are the names the live site is built on today. They keep every
     shipped stylesheet working unchanged while the 13 product pages migrate.
     DELETE A ROW ONLY WHEN NOTHING REFERENCES IT:
       grep -rn "var(--skp-<name>)" site/mu-plugins/*.css
     ======================================================================= */
  --skp-accent-dark:               var(--skp-on-primary-container);
  --skp-accent-wash:               rgba(0, 86, 167, 0.10);
  --skp-signal:                    var(--skp-tertiary);
  --skp-ink:                       var(--skp-secondary);
  --skp-text:                      var(--skp-on-surface);
  --skp-muted:                     var(--skp-on-surface-variant);
  --skp-surface-2:                 var(--skp-surface-container-high);
  --skp-card:                      var(--skp-surface);
  --skp-line:                      var(--skp-outline-variant);
  --skp-shadow:                    var(--skp-elevation-1);
  --skp-shadow-lift:               var(--skp-elevation-3);
  --skp-radius-card:               var(--skp-shape-large);       /* was a literal 18px */
  --skp-radius-media:              var(--skp-shape-extra-large); /* was a literal 20px */
  --skp-radius-pill:               var(--skp-shape-full);
  --skp-heading-font:              var(--skp-font);
  --skp-h1:                        var(--skp-display-medium);
  --skp-h2:                        var(--skp-headline-medium);
  --skp-h3:                        var(--skp-title-large);
  --skp-body:                      var(--skp-body-medium);
  --skp-lede:                      var(--skp-body-large);
}

/* -------------------------------------------------------------------------
   TIER ALIASES — MATERIAL HUB.
   Set on <body> by skp-product-tiers.php. Only the deltas.
   ------------------------------------------------------------------------- */
body.skp-tier-material {
  --skp-accent:                    var(--skp-tertiary);
  --skp-on-accent:                 var(--skp-on-tertiary);
  --skp-accent-bar:                4px;
  --skp-card-pad:                  var(--skp-space-xl);   /* 30px */
  --skp-grid-gap:                  var(--skp-space-xl);   /* 30px */
  --skp-section-rhythm:            clamp(64px, 7vw, 104px);
  --skp-hero-rhythm:               clamp(64px, 8vw, 120px);
  --skp-band-rhythm:               clamp(36px, 4vw, 56px);
  --skp-prose-size:                var(--skp-body-large);
  --skp-prose-leading:             1.60;
  --skp-prose-measure:             var(--skp-measure-lede);
}

/* =========================================================================
   SURFACE UTILITIES
   Role + on-role applied together, so the pair cannot be broken by
   forgetting one half. Each also rebinds the focus ring and the accent,
   because a yellow ring on white and a blue ring on navy are both invisible.
   ========================================================================= */

.skp-surface           { background: var(--skp-surface);                 color: var(--skp-on-surface); }
.skp-surface-container { background: var(--skp-surface-container);       color: var(--skp-on-surface); }
.skp-surface-high      { background: var(--skp-surface-container-high);  color: var(--skp-on-surface); }
.skp-primary           { background: var(--skp-primary);                 color: var(--skp-on-primary); }
.skp-primary-container { background: var(--skp-primary-container);       color: var(--skp-on-primary-container); }
.skp-secondary         { background: var(--skp-secondary);               color: var(--skp-on-secondary); }
.skp-tertiary          { background: var(--skp-tertiary);                color: var(--skp-on-tertiary); }
.skp-inverse           { background: var(--skp-inverse-surface);         color: var(--skp-inverse-on-surface); }

/* Dark surfaces rebind the ring, the accent, the link ink and the muted ink to
   their light-on-dark pairs. A component references the alias and is correct on
   both without writing a single surface-specific rule. */
.skp-secondary,
.skp-inverse,
.skp-primary {
  --skp-focus-ring:         var(--skp-focus-ring-inverse);
  --skp-accent:             var(--skp-inverse-primary);
  --skp-on-accent:          var(--skp-on-tertiary);
  --skp-link-ink:           var(--skp-inverse-primary);
  --skp-hairline:           1px solid var(--skp-outline-inverse);
  /* #4f5d70 computes 2.45:1 on inverse-surface. A muted label on a dark band
     MUST use the inverse role — this is the Stats label failure. */
  --skp-on-surface-variant: var(--skp-inverse-on-surface-variant);
}

/* Descendants inherit the surface's on-colour rather than a global ink value,
   so a component placed on a dark band stays readable without extra rules.
   ANCHORS ARE INCLUDED. v3 covered h1-h4/strong/p/li but not <a>, so an inline
   link on a dark band fell through to Astra's theme blue at ~2.3:1. */
.skp-secondary :is(h1, h2, h3, h4, h5, h6, strong),
.skp-inverse   :is(h1, h2, h3, h4, h5, h6, strong) { color: var(--skp-inverse-on-surface); }

.skp-secondary :is(p, li, td, th, dd, dt, blockquote),
.skp-inverse   :is(p, li, td, th, dd, dt, blockquote) { color: var(--skp-inverse-on-surface-variant); }

.skp-secondary :is(figcaption, small, .skp-caption),
.skp-inverse   :is(figcaption, small, .skp-caption) { color: var(--skp-inverse-on-surface-variant); }

.skp-secondary a:not(.skp-btn),
.skp-inverse   a:not(.skp-btn) { color: var(--skp-inverse-primary); }

.skp-tertiary :is(h1, h2, h3, h4, h5, h6, strong, p, li, td, th, figcaption, small) { color: var(--skp-on-tertiary); }
.skp-tertiary a:not(.skp-btn) { color: var(--skp-on-tertiary); text-decoration-thickness: 1px; }

.skp-primary :is(h1, h2, h3, h4, h5, h6, strong, p, li, td, th, figcaption, small) { color: var(--skp-on-primary); }
.skp-primary a:not(.skp-btn) { color: var(--skp-on-primary); }

/* =========================================================================
   TYPE UTILITIES
   All 15 roles, each carrying its weight, leading and tracking — not just a
   size. v3 shipped 8 utilities and left seven documented roles with nowhere
   to get their weight and line-height from, including headline-large, which
   is the H1 role on ten of the thirteen product pages.
   ========================================================================= */

.skp-display-large   { font: 700 var(--skp-display-large)/1.04   var(--skp-font); letter-spacing: -0.02em; }
.skp-display-medium  { font: 700 var(--skp-display-medium)/1.06  var(--skp-font); letter-spacing: -0.02em; }
.skp-display-small   { font: 700 var(--skp-display-small)/1.08   var(--skp-font); letter-spacing: -0.02em; }

.skp-headline-large  { font: 700 var(--skp-headline-large)/1.08  var(--skp-font); letter-spacing: -0.015em; }
.skp-headline-medium { font: 600 var(--skp-headline-medium)/1.10 var(--skp-font); letter-spacing: -0.015em; }
.skp-headline-small  { font: 600 var(--skp-headline-small)/1.15  var(--skp-font); letter-spacing: -0.01em; }

.skp-title-large     { font: 600 var(--skp-title-large)/1.25     var(--skp-font); letter-spacing: -0.01em; }
.skp-title-medium    { font: 600 var(--skp-title-medium)/1.3     var(--skp-font); }
.skp-title-small     { font: 600 var(--skp-title-small)/1.35     var(--skp-font); }

.skp-body-large      { font: 400 var(--skp-body-large)/1.6       var(--skp-font); max-width: var(--skp-measure-lede); }
.skp-body-medium     { font: 400 var(--skp-body-medium)/1.68     var(--skp-font); max-width: var(--skp-measure-body); }
.skp-body-small      { font: 400 var(--skp-body-small)/1.6       var(--skp-font); max-width: var(--skp-measure-body); }

.skp-label-large     { font: 600 var(--skp-label-large)/1.4      var(--skp-font); }
.skp-label-medium    { font: 600 var(--skp-label-medium)/1.3     var(--skp-font); letter-spacing: 0.08em; }
.skp-label-small     { font: 700 var(--skp-label-small)/1.2      var(--skp-font); letter-spacing: 0.2em; text-transform: uppercase; }

/* A measure cap left-aligns by default, which is correct for prose. A CENTRED
   block (the CTA body) needs the cap centred too, or it renders far off-centre
   inside its section. */
.skp-measure-center { margin-inline: auto; }

/* =========================================================================
   STATE LAYER — M3 pattern. A pseudo-element carries the state tint so the
   base colour is never mutated and contrast stays predictable.
   ========================================================================= */

.skp-state { position: relative; isolation: isolate; }
.skp-state::after {
  content: "";
  position: absolute;
  inset: 0;
  border-radius: inherit;
  background: currentColor;
  opacity: 0;
  transition: opacity var(--skp-motion-fast);
  pointer-events: none;
  z-index: 0;
}
.skp-state:hover::after         { opacity: var(--skp-state-hover); }
.skp-state:focus-visible::after { opacity: var(--skp-state-focus); }
.skp-state:active::after        { opacity: var(--skp-state-pressed); }

/* =========================================================================
   FOCUS — visible on every surface, never removed.
   M3 uses a state layer; HIG wants a ring. We take both.
   ========================================================================= */

.skp-btn:focus-visible,
.skp-card:focus-visible,
.skp-faq summary:focus-visible,
a.skp-state:focus-visible,
.skp-focusable:focus-visible {
  outline: var(--skp-focus-width) solid var(--skp-focus-ring);
  outline-offset: var(--skp-focus-offset);
}

/* =========================================================================
   BUTTON — the one element every component needs, and the one v3 never
   implemented. Three roles; appearance is a lookup against the surface,
   never a judgement call.
   ========================================================================= */

.skp-btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  gap: var(--skp-space-md);
  min-height: var(--skp-target-min);
  padding: 13px 30px;
  border: 1px solid transparent;
  border-radius: var(--skp-shape-button);
  font: 600 var(--skp-label-large)/1.2 var(--skp-font);
  letter-spacing: 0.01em;
  text-align: center;
  text-decoration: none;
  cursor: pointer;
  /* colour is NEVER transitioned — it reads as a flicker, not a transition */
  transition: transform var(--skp-motion-standard),
              box-shadow var(--skp-motion-standard),
              background-color var(--skp-motion-standard);
}

/* Astra styles `a:not(...)` at a specificity that outranks a single class, so a
   plain `text-decoration: none` loses and every button renders underlined.
   Observed live 2026-08-26 on both hero buttons. 07 §3.3 documents the pattern. */
.skp-btn,
a.skp-btn,
.entry-content a.skp-btn { text-decoration: none !important; }

.skp-btn:hover  { transform: translateY(-2px); box-shadow: var(--skp-elevation-3); }
.skp-btn:active { transform: translateY(0);    box-shadow: none; }

.skp-btn[disabled],
.skp-btn[aria-disabled="true"] {
  opacity: var(--skp-state-disabled-content);
  pointer-events: none;
}

/* Background and colour are ALWAYS set together. Setting one without the
   other is how white text shipped on a white button on a live CTA. */
.skp-btn--primary {
  background: var(--skp-primary);
  color: var(--skp-on-primary);
}

/* v3 specified the outlined border as outline-variant, which computes 1.22:1 —
   below the system's own 3.0 non-text floor. Even --skp-outline is only 1.81:1.
   A solid primary border measures 7.27:1 and reads correctly as an action. */
.skp-btn--secondary {
  background: var(--skp-surface);
  color: var(--skp-on-primary-container);
  border-color: var(--skp-primary);
}

/* Dark surfaces: yellow fill takes dark ink. */
:is(.skp-inverse, .skp-secondary) .skp-btn--primary {
  background: var(--skp-tertiary);
  color: var(--skp-on-tertiary);
}
:is(.skp-inverse, .skp-secondary) .skp-btn--secondary {
  background: transparent;
  color: var(--skp-inverse-on-surface);
  border-color: var(--skp-outline-inverse);
}

/* Yellow band: navy fill. */
.skp-tertiary .skp-btn--primary {
  background: var(--skp-secondary);
  color: var(--skp-on-secondary);
}
.skp-tertiary .skp-btn--secondary {
  background: transparent;
  color: var(--skp-on-tertiary);
  border-color: rgba(16, 32, 51, 0.55);   /* 3.78:1 measured */
}

@media (max-width: 900px) {
  .skp-btn { width: 100%; }
}

/* =========================================================================
   REDUCED MOTION — every transition off. The focus ring is not motion and
   is deliberately unaffected.
   ========================================================================= */

@media (prefers-reduced-motion: reduce) {
  .skp-state::after,
  .skp-btn { transition: none; }
  .skp-btn:hover { transform: none; }
}