// SPDX-License-Identifier: MIT

/*
 * Pulse theme variables.
 *
 * Derived from Bootswatch Pulse (https://bootswatch.com/pulse/).
 *
 * This file is compiled by `build.ts` into a single CSS artifact
 * per theme (the directory name is used as the theme name):
 *   - dist/<theme>/theme.min.css  (Bulma bundle + variables on :root)
 *
 * Downstream consumers can also `@use` this file with
 * `with (...)` to override individual values and run their own
 * build, e.g.:
 *
 *   @use ".../pulse/variables" as pulse with (
 *     $primary-h: 280,
 *     $radius: 0.25rem,
 *   );
 *   :root { @include pulse.variables; }
 */

// --- scheme / text (hue tint only — Pitfall 5: do not emit L) ---
$scheme-h: 260 !default;
$scheme-s: 33% !default;
$text-h: 256 !default;
$text-s: 22% !default;

// --- primary / link ---
$primary-h: 266 !default;
$primary-s: 51% !default;
$primary-l: 39% !default;

// Bulma's default primary-invert lightness lands on a dark tone for our
// purple primary, leaving low-contrast text on primary backgrounds; force
// it to white so primary surfaces match the original Pulse look.
$primary-invert-l: 100% !default;
$link-h: 266 !default;
$link-s: 51% !default;
$link-l: 39% !default;
$link-invert-l: 100% !default;
$link-on-scheme-l: $link-l !default;

// --- secondary (Bootswatch Pulse $secondary #a991d4 → hsl(261, 44%, 70%);
// see the "Choosing a theme's secondary" policy in themes-authoring.md). The
// base colour is injected into Bulma's colour map via $custom-colors
// (entry.scss). Pulse draws #fff text on every .btn-* variant (see the
// admonition block below), so pin secondary invert-l to 100% to match. White
// on this #a991d4 fill is ~2.8:1 — below WCAG AA (3.0:1 for large text); an
// intentional source-fidelity exception, not an oversight. ---
$secondary-h: 261 !default;
$secondary-s: 44% !default;
$secondary-l: 70% !default;
$secondary-invert-l: 100% !default;
$custom-colors: ("secondary": (hsl($secondary-h, $secondary-s, $secondary-l))) !default;

// --- admonition palette (Pitfall 3: Bootswatch Pulse uses #fff text on
// every .btn-* color variant; force -invert-l to 100% to match) ---
$info-h: 199 !default;
$info-s: 100% !default;
$info-l: 43% !default;
$info-invert-l: 100% !default;
$success-h: 143 !default;
$success-s: 81% !default;
$success-l: 40% !default;
$success-invert-l: 100% !default;
$warning-h: 38 !default;
$warning-s: 87% !default;
$warning-l: 53% !default;
$warning-invert-l: 100% !default;
$danger-h: 0 !default;
$danger-s: 97% !default;
$danger-l: 61% !default;
$danger-invert-l: 100% !default;

// --- radius (flat by design; Bootswatch Pulse uses 0.375rem but Pulse
// intentionally zeroes out radius to keep the silhouette square) ---
$radius-small: 0 !default;
$radius: 0 !default;

// Bulma uses --bulma-radius-medium for both .button.is-medium and
// .button.is-large; zero it out to keep button sizes visually flat.
$radius-medium: 0 !default;
$radius-large: 0 !default;

@mixin variables {
  --bulma-scheme-h: #{$scheme-h};
  --bulma-scheme-s: #{$scheme-s};
  --bulma-text-h: #{$text-h};
  --bulma-text-s: #{$text-s};
  --bulma-primary-h: #{$primary-h};
  --bulma-primary-s: #{$primary-s};
  --bulma-primary-l: #{$primary-l};
  --bulma-primary-invert-l: #{$primary-invert-l};
  --bulma-secondary-invert-l: #{$secondary-invert-l};
  --bulma-link-h: #{$link-h};
  --bulma-link-s: #{$link-s};
  --bulma-link-l: #{$link-l};
  --bulma-link-invert-l: #{$link-invert-l};
  --bulma-link-on-scheme-l: #{$link-on-scheme-l};
  --bulma-info-h: #{$info-h};
  --bulma-info-s: #{$info-s};
  --bulma-info-l: #{$info-l};
  --bulma-info-invert-l: #{$info-invert-l};
  --bulma-success-h: #{$success-h};
  --bulma-success-s: #{$success-s};
  --bulma-success-l: #{$success-l};
  --bulma-success-invert-l: #{$success-invert-l};
  --bulma-warning-h: #{$warning-h};
  --bulma-warning-s: #{$warning-s};
  --bulma-warning-l: #{$warning-l};
  --bulma-warning-invert-l: #{$warning-invert-l};
  --bulma-danger-h: #{$danger-h};
  --bulma-danger-s: #{$danger-s};
  --bulma-danger-l: #{$danger-l};
  --bulma-danger-invert-l: #{$danger-invert-l};
  --bulma-radius-small: #{$radius-small};
  --bulma-radius: #{$radius};
  --bulma-radius-medium: #{$radius-medium};
  --bulma-radius-large: #{$radius-large};

  // Pitfall 6: pin every --bulma-control-* on the shared control selector
  // group so bare `.button` / `.input` / `.textarea` / `.select select` /
  // `.pagination-*` and their icons resolve padding, border, height, and
  // radius correctly. `.is-*` modifiers re-declare with higher
  // specificity, so per-modifier behaviour is preserved.
  .button,
  .control,
  .file-cta,
  .file-name,
  .input,
  .pagination,
  .pagination-ellipsis,
  .pagination-link,
  .pagination-next,
  .pagination-previous,
  .select,
  .select select,
  .textarea {
    --bulma-control-border-width: 1px;
    --bulma-control-height: 2.5em;
    --bulma-control-padding-vertical: calc(0.5em - 1px);
    --bulma-control-padding-horizontal: calc(0.75em - 1px);
    --bulma-control-radius: #{$radius};
  }

  // Pitfall 8: `--bulma-link-text` is set on :root via an hsl(var(...))
  // chain that can fall back to UA-default on `<a>`; pin literally.
  a {
    --bulma-link-text: hsl(#{$link-h}, #{$link-s}, #{$link-on-scheme-l});
  }

  // Bootswatch Pulse underlines body links; scope to .content so navbar /
  // menu / buttons stay clean.
  .content a {
    text-decoration: underline;
  }

  // Pitfall 14: `.breadcrumb a` reads `--bulma-breadcrumb-item-color`
  // (= var(--bulma-link-text)), whose hsl(var(), var(), var()) chain fails
  // at the child and drops the brand colour to the UA default. Pin the
  // literal link colour on the parent `.breadcrumb` (base colour only — a
  // hover lightness cannot be hard-coded generically and a base-only pin
  // does not regress hover).
  // Bootstrap-derived universal default #4: non-active breadcrumb items
  // are links (pinned above); the active (current-page) item is muted grey,
  // not a link colour. `--bulma-breadcrumb-item-active-color` chains through
  // `--bulma-link-text-active` (a compound hsl(var(), var(), calc(var()))
  // expression on :root) the same way Pitfall 8/14 do — pin it literally.
  .breadcrumb {
    --bulma-breadcrumb-item-color: hsl(#{$link-h}, #{$link-s}, #{$link-on-scheme-l});
    --bulma-breadcrumb-item-active-color: hsl(#{$scheme-h}, #{$scheme-s}, 45%);
  }

  // Bootswatch Pulse underlines links; underline breadcrumb link items too.
  // The current-page `.is-active` item is not a navigable link, so leave it
  // un-underlined (Bulma's own `.breadcrumb li.is-active a` rule does not
  // set text-decoration, so it is unaffected by this `:not(.is-active)`
  // scope).
  .breadcrumb li:not(.is-active) a {
    text-decoration: underline;
  }

  // Pitfall 4: burger icon on .navbar.is-primary follows primary-invert.
  .navbar.is-primary {
    --bulma-navbar-burger-color: var(--bulma-primary-invert);
  }

  // Bulma's `.panel-icon` is sized 1em x 1em assuming a font-glyph child;
  // when the child is a `<use href="#symbol">`-pattern SVG without a
  // viewBox on the outer element (the shape the @11ty/font-awesome
  // plugin emits), the symbol instance renders at its native viewBox
  // coordinates and floats far to the right of the panel item. Pin both
  // the outer SVG and its `<use>` instance to 1em so the symbol scales
  // back into the icon slot.
  .panel-icon svg {
    width: 1em;
    height: 1em;
  }

  .panel-icon svg use {
    width: 100%;
    height: 100%;
  }

  // Pitfall 10: --bulma-shadow's hsl(var(--bulma-shadow-h), ...) chain
  // on :root fails to resolve at .box / .card / .panel. Pin a literal
  // two-stop shadow on those selectors (mirrors Bulma's light-mode
  // default but with concrete hsla arguments). `.dropdown` uses a
  // two-level indirection (parent registers `--bulma-dropdown-content-
  // shadow: var(--bulma-shadow)`, child `.dropdown-content` reads it), so
  // per Pitfall 1's eager-substitution behaviour, the pin must go on the
  // parent `.dropdown` selector — pinning on `.dropdown-content` is too
  // late.
  .dropdown,
  .modal-card-head,
  .panel {
    --bulma-shadow:
      0 0.5em 1em -0.125em hsla(#{$scheme-h}, #{$scheme-s}, 4%, 10%),
      0 0 0 1px hsla(#{$scheme-h}, #{$scheme-s}, 4%, 2%);
  }

  // Bootstrap-derived universal default #7: card / box get a 1px border and
  // no drop shadow (Bootstrap `.card`) — replaces, rather than stacks on,
  // the Pitfall-10 shadow pin above. Real `border` → bare Sass vars.
  .box,
  .card {
    --bulma-shadow: none;

    border: 1px solid hsl($scheme-h, $scheme-s, 87%);
  }

  // Pitfall 11: separator borders on `.card-footer` / `.panel-block` /
  // `.panel-tabs` / `.dropdown-divider` chain through --bulma-border-weak,
  // and `.card-header`'s bottom rule chains through
  // --bulma-scheme-h/s/invert-l. Also `.tabs a` / `.tabs ul` chain through
  // --bulma-border with the same shape. All fail to resolve at the
  // sub-elements. Pin literal hsl() at the .card / .dropdown / .panel /
  // .tabs level so children inherit a resolved value.
  .card,
  .dropdown,
  .panel {
    --bulma-border-weak: hsl(#{$scheme-h}, #{$scheme-s}, 93%);
  }

  .tabs {
    --bulma-border: hsl(#{$scheme-h}, #{$scheme-s}, 86%);

    // Same Pitfall 12 shape: Bulma registers
    // `--bulma-tabs-boxed-link-active-background-color: var(--bulma-scheme-main)`
    // on `.tabs`, and the inner hsl(var(), var(), var()) chain fails at
    // the descendant `.tabs.is-boxed li.is-active a`, leaving its
    // background transparent — the ul's continuous bottom border bleeds
    // through and reads as an unwanted underline on the active is-boxed
    // tab. Pin literal hsl matching Bulma's light-mode
    // `--bulma-scheme-main-l` (100%).
    --bulma-tabs-boxed-link-active-background-color: hsl(#{$scheme-h}, #{$scheme-s}, 100%);
  }

  .card {
    --bulma-card-header-shadow: 0 0.125em 0.25em hsla(#{$scheme-h}, #{$scheme-s}, 4%, 10%);

    // Pitfall 13: `--bulma-card-radius` is Bulma's SCSS-default 0.75rem,
    // hardcoded in card.scss and NOT tied to any --bulma-radius token,
    // and Bulma re-declares it directly on `.card` in its register-vars
    // block. Emitting `--bulma-card-radius` on `:root` alone is shadowed
    // by that direct `.card` declaration, so the pin must be scoped to
    // `.card` too — inside the mixin, `.card { ... }` compiles to
    // `:root .card { ... }` and wins on specificity (0,2,0 vs 0,1,0).
    --bulma-card-radius: #{$radius};
  }

  // Same class of chain failure as Pitfall 11: `.modal` registers
  // `--bulma-modal-card-{head,body,foot}-background-color:
  // var(--bulma-scheme-{main,main-bis})`, which on :root is
  // `hsl(var(--bulma-scheme-h), var(--bulma-scheme-s),
  // var(--bulma-scheme-main{-bis}-l))`. The compound `hsl(var(), var(),
  // var())` fails at the descendant `.modal-card-{head,body,foot}` and
  // leaves the backgrounds transparent — the dark overlay bleeds
  // through and the modal becomes unreadable. Pin literal hsl on the
  // parent `.modal` per Pitfall 1's eager-substitution behaviour.
  // 100% / 98% match Bulma's light-mode `--bulma-scheme-main-l` and
  // `--bulma-scheme-main-bis-l`.
  .modal {
    --bulma-modal-card-head-background-color: hsl(#{$scheme-h}, #{$scheme-s}, 100%);
    --bulma-modal-card-body-background-color: hsl(#{$scheme-h}, #{$scheme-s}, 100%);
    --bulma-modal-card-foot-background-color: hsl(#{$scheme-h}, #{$scheme-s}, 98%);
  }

  // Pitfall 13 (continued): Bulma's `.card-image:first-child img` /
  // `:last-child img` rule only rounds `<img>` children. A
  // background-styled `<figure>` (e.g. the gradient placeholders used in
  // the Showcase and card demo) has no img target and its top/bottom
  // corners would visibly poke past the card silhouette on non-zero
  // radii. Emit the mirror rule for figures for consistency; on Pulse
  // the resolved value is 0 so this is a no-op, but keeps the theme
  // shape parallel with default and protects against downstream $radius
  // overrides.
  .card-image:first-child > figure {
    border-start-start-radius: var(--bulma-card-radius);
    border-start-end-radius: var(--bulma-card-radius);
  }

  .card-image:last-child > figure {
    border-end-start-radius: var(--bulma-card-radius);
    border-end-end-radius: var(--bulma-card-radius);
  }

  // Bootstrap-derived universal default #1: `.btn-link` maps to Bulma's
  // native `.button.is-ghost` (a transparent, link-coloured text button),
  // not `.is-link` — which stays Bulma's solid semantic colour and is
  // intentionally left un-restyled here.

  // Widen the active tab's underline from Bulma's 1px to 3px so it
  // reads as a clear accent under plain `.tabs`. Under `.tabs.is-boxed`,
  // Bulma sets `border-bottom-color: transparent !important` on the
  // active tab, so this width change stays invisible there — the pin
  // surfaces in the non-boxed variant where a stronger active marker is
  // wanted. link-h/s/l already match Pulse's primary (266°/51%/39%), so
  // the accent color follows the theme's primary hue without a further
  // override. Exclude `.is-toggle` because its active tab has an
  // all-four border and a 3px bottom would leave the active toggle 2px
  // taller than the neighbouring hover state.
  .tabs:not(.is-toggle) li.is-active a {
    border-bottom-width: 3px;
    margin-bottom: -3px;
  }

  // Bulma registers `--bulma-code` on :root as the danger/red colour
  // (hsl(danger-h, danger-s, danger-on-scheme-l)), so inline <code> reads
  // as an error state and clashes with the theme tone. Repoint both text and
  // background into the brand primary hue: a deep, dark primary tone for the
  // text (L=25%, below primary-l so it stays legible on the tint) over a
  // pale primary-hued chip (L=94%), so <code> reads as part of the palette
  // rather than Bulma's red-on-neutral default. Scope to the `code` selector
  // (0,1,1) so both win over Bulma's own :root registration regardless of
  // load order.
  code {
    --bulma-code: hsl(#{$primary-h}, #{$primary-s}, 25%);
    --bulma-code-background: hsl(#{$primary-h}, #{$primary-s}, 94%);
  }

  // --- Bootstrap-derived universal defaults ---

  // #2: joined pagination. Bootstrap page numbers are one segmented set
  // (adjacent borders overlap, only outer corners rounded). `.is-rounded`
  // opts out.
  .pagination:not(.is-rounded) .pagination-list {
    .pagination-link,
    .pagination-ellipsis {
      margin: 0;
      border-radius: 0;
    }

    li:not(:first-child) .pagination-link,
    li:not(:first-child) .pagination-ellipsis {
      margin-inline-start: -1px;
    }

    li:first-child :is(.pagination-link, .pagination-ellipsis) {
      border-start-start-radius: #{$radius};
      border-end-start-radius: #{$radius};
    }

    li:last-child :is(.pagination-link, .pagination-ellipsis) {
      border-start-end-radius: #{$radius};
      border-end-end-radius: #{$radius};
    }
  }

  // #5: checkbox / radio = primary fill + white glyph (Bootstrap
  // `.form-check-input`; no Bulma token — direct restyle of the native
  // input; real `background-color` → bare Sass vars). `appearance: none`
  // removes the native focus outline, so restore a `:focus-visible` ring.
  input[type="checkbox"],
  input[type="radio"] {
    width: 1em;
    height: 1em;
    appearance: none;
    vertical-align: -0.125em;
    background-color: transparent;
    background-repeat: no-repeat;
    background-position: center;
    background-size: contain;
    border: 1px solid hsl($scheme-h, $scheme-s, 70%);
  }

  input[type="checkbox"] {
    border-radius: 0.25em;
  }

  input[type="radio"] {
    border-radius: 50%;
  }

  input[type="checkbox"]:checked,
  input[type="checkbox"]:indeterminate,
  input[type="radio"]:checked {
    background-color: hsl($primary-h, $primary-s, $primary-l);
    border-color: hsl($primary-h, $primary-s, $primary-l);
  }

  input[type="checkbox"]:focus-visible,
  input[type="radio"]:focus-visible {
    outline: 2px solid hsl($primary-h, $primary-s, $primary-l);
    outline-offset: 2px;
  }

  input[type="checkbox"]:disabled,
  input[type="radio"]:disabled {
    opacity: 0.5;
  }

  input[type="checkbox"]:checked {
    background-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='m6 10 3 3 6-6'/%3e%3c/svg%3e");
  }

  // `appearance: none` makes an indeterminate checkbox otherwise render
  // identically to an unchecked one; give it the same primary fill as
  // :checked (above) plus a dash glyph.
  input[type="checkbox"]:indeterminate {
    background-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10h8'/%3e%3c/svg%3e");
  }

  input[type="radio"]:checked {
    background-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='2' fill='%23fff'/%3e%3c/svg%3e");
  }

  // #6: control right-icon follows the input's state colour (Bootstrap
  // colours its validation icon; Bulma leaves it a fixed muted grey; no
  // token — direct, per state, bare Sass vars). Left icon stays neutral.
  .control.has-icons-right .input.is-primary ~ .icon.is-right {
    color: hsl($primary-h, $primary-s, $primary-l);
  }

  .control.has-icons-right .input.is-link ~ .icon.is-right {
    color: hsl($link-h, $link-s, $link-l);
  }

  .control.has-icons-right .input.is-info ~ .icon.is-right {
    color: hsl($info-h, $info-s, $info-l);
  }

  .control.has-icons-right .input.is-success ~ .icon.is-right {
    color: hsl($success-h, $success-s, $success-l);
  }

  .control.has-icons-right .input.is-warning ~ .icon.is-right {
    color: hsl($warning-h, $warning-s, $warning-l);
  }

  .control.has-icons-right .input.is-danger ~ .icon.is-right {
    color: hsl($danger-h, $danger-s, $danger-l);
  }

  // --- Dark mode (Bulma neutral dark canvas + brand accents; driven by
  // [data-theme="dark"]) ---
  // pulse pins no scheme/text L, so Bulma's own [data-theme=dark] theme sets
  // the canvas; only the light-only literal pins above need dark counterparts.
  // `&` is :root, so this compiles to `:root[data-theme="dark"] …`.
  &[data-theme="dark"] {
    .dropdown,
    .modal-card-head,
    .panel {
      --bulma-shadow:
        0 0.5em 1em -0.125em hsl(0deg 0% 0% / 40%),
        0 0 0 1px hsl(0deg 0% 100% / 10%);
    }

    .box,
    .card {
      border-color: hsl($scheme-h, $scheme-s, 28%);
    }

    input[type="checkbox"],
    input[type="radio"] {
      border-color: hsl($scheme-h, $scheme-s, 42%);
    }

    .card,
    .dropdown,
    .panel {
      --bulma-border-weak: hsl(#{$scheme-h}, #{$scheme-s}, 21%);
    }

    .tabs {
      --bulma-border: hsl(#{$scheme-h}, #{$scheme-s}, 24%);
      --bulma-tabs-boxed-link-active-background-color: hsl(#{$scheme-h}, #{$scheme-s}, 9%);
    }

    .card {
      --bulma-card-header-shadow: 0 0.125em 0.25em hsl(0deg 0% 0% / 30%);
    }

    .modal {
      --bulma-modal-card-head-background-color: hsl(#{$scheme-h}, #{$scheme-s}, 9%);
      --bulma-modal-card-body-background-color: hsl(#{$scheme-h}, #{$scheme-s}, 9%);
      --bulma-modal-card-foot-background-color: hsl(#{$scheme-h}, #{$scheme-s}, 11%);
    }

    code {
      --bulma-code: hsl(#{$primary-h}, #{$primary-s}, 78%);
      --bulma-code-background: hsl(#{$primary-h}, #{$primary-s}, 16%);
    }

    // pulse's light link lightness (39%) is too dim on the dark canvas — lift
    // the body-link and breadcrumb tones for legibility.
    a {
      --bulma-link-text: hsl(#{$link-h}, #{$link-s}, 70%);
    }

    .breadcrumb {
      --bulma-breadcrumb-item-color: hsl(#{$link-h}, #{$link-s}, 70%);
      --bulma-breadcrumb-item-active-color: hsl(#{$scheme-h}, #{$scheme-s}, 62%);
    }

    // The checkbox/radio focus ring and the primary/link control-icon
    // colours are bare-Sass-var literals (Pitfall 15), so they don't pick up
    // the dark-mode custom-property lift above; re-declare them at the same
    // 70% lightness as the body-link lift, for the same 3:1 contrast reason
    // (39% lightness is only ~2.1:1 against the dark canvas).
    input[type="checkbox"]:focus-visible,
    input[type="radio"]:focus-visible {
      outline-color: hsl($primary-h, $primary-s, 70%);
    }

    .control.has-icons-right .input.is-primary ~ .icon.is-right {
      color: hsl($primary-h, $primary-s, 70%);
    }

    .control.has-icons-right .input.is-link ~ .icon.is-right {
      color: hsl($link-h, $link-s, 70%);
    }
  }
}