/* Documentation-only styles. Built on Bana tokens so the guide dogfoods the framework. */
@layer bana.utilities {
  /* ---------- header ---------- */
  .doc-bar { gap: var(--bana-space-4); }
  .wordmark { display: inline-flex; align-items: center; gap: var(--bana-space-2); font-weight: 800; letter-spacing: 0; }
  .mark { position: relative; display: inline-block; inline-size: 1.4rem; block-size: 1.4rem; }
  .mark::before, .mark::after { content: ""; position: absolute; inset: 14%; background: var(--bana-accent); }
  .mark::after { transform: rotate(45deg); }
  .doc-controls { display: flex; align-items: center; gap: var(--bana-space-3); }
  .density { inline-size: auto; }
  .seg button[aria-pressed="true"] { --_bg: var(--bana-accent-subtle); --_fg: var(--bana-accent-text); --_bd: var(--bana-accent); }
  .swatches { display: inline-flex; gap: var(--bana-space-1); }
  .swatch {
    inline-size: 1.5rem; block-size: 1.5rem; padding: 0; border-radius: 50%; cursor: pointer;
    border: 2px solid var(--bana-surface-raised); background: var(--sw);
    box-shadow: 0 0 0 1px var(--bana-border-default);
    transition: transform var(--bana-duration-fast) var(--bana-ease-spring);
  }
  .swatch:hover { transform: scale(1.18); }
  .swatch[aria-pressed="true"] { box-shadow: 0 0 0 2px var(--bana-text-primary); }
  @media (max-width: 40rem) { .density, .swatches { display: none; } }

  /* ---------- hero ---------- */
  .hero { background: var(--bana-surface-raised); border-block-end: 1px solid var(--bana-border-subtle); padding-block: clamp(2.5rem, 6vw, 5rem) clamp(2.25rem, 5vw, 4rem); }
  .hero-in { display: grid; grid-template-columns: minmax(0, 1.15fr) minmax(0, 1fr); gap: clamp(2rem, 6vw, 5rem); align-items: center; }
  .hero-text { display: grid; gap: var(--bana-space-5); justify-items: start; }
  .hero h1 { font-size: clamp(2rem, 1.1rem + 3.4vw, 3.6rem); font-weight: 800; line-height: 1.35; max-inline-size: 16ch; }
  .hero p { color: var(--bana-text-secondary); font-size: var(--bana-text-lg); max-inline-size: 44ch; }
  @media (max-width: 52rem) { .hero-in { grid-template-columns: 1fr; } }

  /* theme tiles: an eight-point star from two squares, the way tile-work is drawn */
  .tiles { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: clamp(0.5rem, 1.6vw, 1rem); }
  .tile {
    --bg: var(--p100); --fg: var(--p600);
    appearance: none; cursor: pointer;
    display: grid; justify-items: center; gap: var(--bana-space-3);
    padding: clamp(0.75rem, 2vw, 1.25rem) var(--bana-space-2) var(--bana-space-3);
    background: var(--bg); color: var(--bana-text-primary);
    border: 1px solid color-mix(in oklab, var(--bg), var(--fg) 22%);
    border-radius: var(--bana-radius-md);
    font-size: var(--bana-text-sm); font-weight: var(--bana-weight-semibold);
    transition: transform var(--bana-duration-base) var(--bana-ease-out), box-shadow var(--bana-duration-base) var(--bana-ease-out);
  }
  .tile:hover { transform: translateY(-2px); }
  .tile i { position: relative; display: block; inline-size: 62%; aspect-ratio: 1; transition: transform var(--bana-duration-slow) var(--bana-ease-spring); }
  .tile i::before, .tile i::after {
    content: ""; position: absolute; inset: 7%; background: var(--fg);
    outline: 2px solid color-mix(in oklab, var(--bg) 62%, transparent); outline-offset: -0.55rem;
  }
  .tile i::after { transform: rotate(45deg); }
  .tile[aria-pressed="true"] { box-shadow: 0 0 0 2px var(--bana-surface-raised), 0 0 0 4px var(--fg); }
  .tile[aria-pressed="true"] i { transform: rotate(45deg); }
  :root[data-theme="dark"] .tile { --bg: var(--p900); --fg: var(--p400); }
  @media (prefers-color-scheme: dark) {
    :root:not([data-theme="light"]):not([data-theme="dark"]) .tile { --bg: var(--p900); --fg: var(--p400); }
  }

  /* ---------- body ---------- */
  .doc-aside { position: sticky; inset-block-start: 4.5rem; max-block-size: calc(100dvh - 5.5rem); overflow-y: auto; align-self: flex-start; }
  .doc-aside a[aria-current] { background: var(--bana-accent-subtle); color: var(--bana-accent-text); font-weight: var(--bana-weight-semibold); }
  @media (max-width: 52rem) {
    .doc-aside { position: sticky; inset-block-start: 3.5rem; z-index: var(--bana-z-sticky); inline-size: 100%; max-block-size: none; overflow: visible; margin-inline: calc(-1 * var(--bana-gutter)); padding-inline: var(--bana-gutter); background: var(--bana-surface-base); border-block-end: 1px solid var(--bana-border-subtle); flex: none; }
    .doc-aside ul { display: flex; gap: var(--bana-space-1); overflow-x: auto; scrollbar-width: none; padding-block: var(--bana-space-2); }
    .doc-aside a { white-space: nowrap; min-block-size: 2.25rem; }
  }
  .doc-main { padding-block: var(--bana-space-4) var(--bana-space-16); }
  .doc-section { scroll-margin-block-start: 4.5rem; padding-block: var(--bana-space-10) var(--bana-space-4); }
  .doc-section > h2 { font-size: var(--bana-text-3xl); font-weight: 800; margin-block-end: var(--bana-space-2); }
  .doc-lead { color: var(--bana-text-secondary); font-size: var(--bana-text-lg); max-inline-size: 64ch; margin-block-end: var(--bana-space-6); }
  .doc-section h3 { font-size: var(--bana-text-xl); margin-block: var(--bana-space-8) var(--bana-space-3); }
  .doc-section > p, .doc-section > ul, .doc-section > ol { max-inline-size: 70ch; }
  .doc-section > :is(ul, ol) { padding-inline-start: 1.4rem; }
  .doc-section li + li { margin-block-start: var(--bana-space-1); }
  .doc-footer { padding-block: var(--bana-space-10); color: var(--bana-text-muted); font-size: var(--bana-text-sm); border-block-start: 1px solid var(--bana-border-subtle); margin-block-start: var(--bana-space-10); }

  /* ---------- live example frames ---------- */
  .example { margin-block: var(--bana-space-4) var(--bana-space-8); border: 1px solid var(--bana-border-subtle); border-radius: var(--bana-radius-lg); overflow: clip; background: var(--bana-surface-raised); box-shadow: var(--bana-shadow-sm); }
  .example > .cap { padding: var(--bana-space-2) var(--bana-space-4); font-size: var(--bana-text-xs); font-weight: var(--bana-weight-medium); color: var(--bana-text-muted); border-block-end: 1px solid var(--bana-border-subtle); }
  .example > .demo { padding: var(--bana-space-8) var(--bana-space-6); background-color: var(--bana-surface-base); }
  .example > .demo.pad-0 { padding: 0; background-image: none; }

  .code { --code-bg: oklch(0.972 0.008 262); --code-fg: oklch(0.28 0.03 262); --code-muted: oklch(0.52 0.03 262); --code-line: oklch(0.3 0.03 262 / 0.09); --code-btn: oklch(0.3 0.03 262 / 0.07);
    --tk-c: oklch(0.5 0.03 262); --tk-s: oklch(0.47 0.1 196); --tk-t: oklch(0.46 0.15 262); --tk-a: oklch(0.5 0.12 62); --tk-k: oklch(0.5 0.17 14); --tk-v: oklch(0.47 0.1 196); --tk-n: oklch(0.46 0.12 142);
    background: var(--code-bg); color: var(--code-fg); }
  :root[data-theme="dark"] .code { --code-bg: oklch(0.2 0.035 262); --code-fg: oklch(0.93 0.01 262); --code-muted: oklch(0.72 0.03 262); --code-line: oklch(1 0 0 / 0.09); --code-btn: oklch(1 0 0 / 0.1);
    --tk-c: oklch(0.7 0.04 262); --tk-s: oklch(0.84 0.1 196); --tk-t: oklch(0.8 0.11 262); --tk-a: oklch(0.85 0.11 82); --tk-k: oklch(0.78 0.13 14); --tk-v: oklch(0.84 0.1 196); --tk-n: oklch(0.84 0.12 142); }
  @media (prefers-color-scheme: dark) { :root:not([data-theme="light"]):not([data-theme="dark"]) .code { --code-bg: oklch(0.2 0.035 262); --code-fg: oklch(0.93 0.01 262); --code-muted: oklch(0.72 0.03 262); --code-line: oklch(1 0 0 / 0.09); --code-btn: oklch(1 0 0 / 0.1);
    --tk-c: oklch(0.7 0.04 262); --tk-s: oklch(0.84 0.1 196); --tk-t: oklch(0.8 0.11 262); --tk-a: oklch(0.85 0.11 82); --tk-k: oklch(0.78 0.13 14); --tk-v: oklch(0.84 0.1 196); --tk-n: oklch(0.84 0.12 142); } }
  .example > .demo + .code { border-block-start: 1px solid var(--bana-border-subtle); }
  .code .bar { display: flex; align-items: center; justify-content: space-between; padding: 0.25rem 0.5rem 0.25rem 1rem; border-block-end: 1px solid var(--code-line); font-size: var(--bana-text-xs); color: var(--code-muted); }
  .code .bar button { --_t: var(--code-fg); --_s: var(--code-btn); --_c: var(--code-fg); }
  .code pre[ui~="code"] { background: transparent; color: var(--code-fg); border: 0; border-radius: 0; margin: 0; max-block-size: 24rem; padding: var(--bana-space-4) var(--bana-space-5); }
  .tk-c { color: var(--tk-c); }
  .tk-s { color: var(--tk-s); }
  .tk-t { color: var(--tk-t); }
  .tk-a { color: var(--tk-a); }
  .tk-k { color: var(--tk-k); }
  .tk-v { color: var(--tk-v); }
  .tk-n { color: var(--tk-n); }

  /* ---------- helpers used inside demos ---------- */
  .ramp { display: grid; grid-template-columns: 5.5rem repeat(11, minmax(0, 1fr)); gap: 2px; align-items: center; margin-block-end: var(--bana-space-2); direction: ltr; }
  .ramp > b { font-size: var(--bana-text-xs); color: var(--bana-text-secondary); font-weight: var(--bana-weight-semibold); }
  .ramp > i { display: block; block-size: 2.25rem; border-radius: 4px; }
  .ramp.head > span { font-size: 0.625rem; color: var(--bana-text-muted); text-align: center; font-variant-numeric: tabular-nums; }
  .chip { display: inline-block; inline-size: 1rem; block-size: 1rem; border-radius: 4px; vertical-align: middle; box-shadow: 0 0 0 1px var(--bana-border-default); }
  .tok td:first-child, .tok td:nth-child(2) { direction: ltr; text-align: left; font-family: var(--bana-font-mono); font-size: var(--bana-text-xs); }
  .ltr { direction: ltr; unicode-bidi: isolate; }
  .scale-box { display: grid; place-items: center; background: var(--bana-accent-subtle); color: var(--bana-accent-text); font-weight: 700; font-size: var(--bana-text-sm); min-block-size: 4rem; border-radius: var(--bana-radius-sm); }
  .pass { color: var(--bana-success-text); font-weight: 700; }
  .icon-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(7.5rem, 1fr)); gap: var(--bana-space-3); }
  .icon-grid > div { display: grid; justify-items: center; gap: var(--bana-space-2); padding: var(--bana-space-4) var(--bana-space-2); border: 1px solid var(--bana-border-subtle); border-radius: var(--bana-radius-md); background: var(--bana-surface-raised); font-size: var(--bana-text-xs); color: var(--bana-text-secondary); direction: ltr; }
  .icon-grid bana-icon { --bana-icon-size: 1.75rem; color: var(--bana-text-primary); }
}

@layer docs { .icon-grid > button { font: inherit; font-size: var(--bana-text-xs); background: none; color: var(--bana-text-secondary); cursor: pointer; direction: ltr; border: 1px solid var(--bana-border-subtle); border-radius: var(--bana-radius-sm); display: grid; justify-items: center; gap: var(--bana-space-2); padding: var(--bana-space-3) var(--bana-space-2); } .icon-grid > button:hover { background: var(--bana-surface-sunken); } .icon-grid > button[hidden] { display: none; } .icon-grid > button > span { overflow-wrap: anywhere; } .icon-lab { align-items: end; } }