/* All rules scoped under .doc-guide so this sheet never bleeds into the app shell.
   Diagrams use Shadow DOM (see docs_mermaid.js) because beautiful-mermaid SVG embeds a
   <style> block with bare `svg { … }` selectors that otherwise hit every icon in the layout. */

:root {
  scrollbar-gutter: stable;
}

@layer components {
  .doc-guide {
    width: 100%;
    box-sizing: border-box;

    & .docs-api-nav-mobile {
      display: none;
    }

    & .doc-guide__grid {
      display: grid;
      grid-template-columns: minmax(0, 1fr) minmax(15rem, 17rem);
      grid-template-areas: "main sidebar";
      gap: var(--space-6) var(--space-5);
      align-items: start;
      max-width: 82rem;
      padding-inline: 0;
      padding-block: var(--space-2) var(--space-6);
      box-sizing: border-box;
    }

    @media (max-width: 72rem) {
      & .doc-guide__grid {
        grid-template-columns: 1fr;
        grid-template-areas:
          "sidebar"
          "main";
        gap: var(--space-4);
      }

      & .docs-api-nav-mobile {
        display: grid;
        gap: var(--space-2);
      }

      & .docs-api-nav--desktop {
        display: none;
      }
    }

    & .doc-guide__main {
      grid-area: main;
      min-width: 0;
      display: flex;
      flex-direction: column;
      gap: clamp(var(--space-4), 0.9rem + 0.6vw, var(--space-6));
    }

    & .doc-guide__intro.page-header {
      margin-block-end: 0;
    }

    & .doc-guide__intro {
      width: 100%;
      max-width: none;
      padding-inline: 0;
    }

    & .doc-guide__intro .page-header__subline {
      max-width: 62ch;
      font-size: var(--text-body);
      line-height: 1.6;
      color: var(--color-ink-medium);
    }

    & .doc-guide__body {
      background-color: var(--color-canvas-raised);
      border: 1px solid var(--color-border);
      border-radius: var(--radius-lg);
      box-shadow: var(--shadow-card);
      padding-block: var(--space-5);
      padding-inline: clamp(var(--space-4), 3vw, var(--space-8));
      width: 100%;
      max-width: none;
      box-sizing: border-box;
      overflow-x: auto;
      font-family: var(--font-sans);
      font-size: var(--text-body);
      line-height: 1.72;
      color: var(--color-ink-dark);
    }

    & .doc-guide__body > *:last-child {
      margin-block-end: 0;
    }

    & .doc-guide__body h1 {
      font-family: var(--font-display);
      font-size: var(--text-xl);
      font-weight: 700;
      color: var(--color-ink);
      line-height: 1.16;
      letter-spacing: -0.02em;
      margin: 0 0 var(--space-5);
      padding-bottom: var(--space-3);
      border-bottom: 1px solid var(--color-border);
    }

    & .doc-guide__body h2 {
      font-family: var(--font-display);
      font-size: clamp(1.3rem, 1.1rem + 0.5vw, 1.55rem);
      font-weight: 600;
      line-height: 1.2;
      letter-spacing: -0.02em;
      color: var(--color-ink);
      margin: var(--space-8) 0 var(--space-4);
      scroll-margin-top: var(--space-4);
    }

    & .doc-guide__body h2:first-child {
      margin-top: 0;
    }

    & .doc-guide__body h3 {
      font-family: var(--font-display);
      font-size: var(--text-large);
      font-weight: 600;
      line-height: 1.25;
      letter-spacing: -0.015em;
      margin: var(--space-6) 0 var(--space-3);
      scroll-margin-top: var(--space-4);
    }

    & .doc-guide__body p {
      margin: 0 0 var(--space-4);
      max-width: 68ch;
    }

    & .doc-guide__body ul,
    & .doc-guide__body ol {
      margin: 0 0 var(--space-5);
      padding-left: 1.25rem;
      max-width: 68ch;
    }

    & .doc-guide__body ul {
      list-style: disc;
      list-style-position: outside;
    }

    & .doc-guide__body ol {
      list-style: decimal;
      list-style-position: outside;
    }

    & .doc-guide__body li {
      margin-bottom: var(--space-3);
      line-height: 1.7;
    }

    & .doc-guide__body li:last-child {
      margin-bottom: 0;
    }

    & .doc-guide__body a {
      color: var(--color-ink-dark);
      text-decoration: underline;
      text-decoration-color: color-mix(
        in srgb,
        var(--color-ink-medium) 50%,
        transparent
      );
      text-underline-offset: 0.15em;
    }

    & .doc-guide__body a:hover {
      color: var(--color-primary);
      text-decoration-color: var(--color-primary);
    }

    & .doc-guide__body strong {
      color: var(--color-ink);
    }

    & .doc-guide__body pre {
      margin: var(--space-4) 0;
      padding: var(--space-4) var(--space-5);
      overflow-x: auto;
      border-radius: var(--radius);
      background: var(--color-canvas-inset);
      border: 1px solid var(--color-border);
      font-family: var(--font-mono);
      font-size: var(--text-small);
      line-height: 1.6;
      max-width: 100%;
    }

    & .doc-guide__body code {
      font-family: var(--font-mono);
      font-size: 0.9em;
      padding: 0.125rem 0.4rem;
      border-radius: 0.25rem;
      background: var(--color-canvas-inset);
    }

    & .doc-guide__body pre code {
      padding: 0;
      background: transparent;
      font-size: inherit;
    }

    & .doc-guide__body blockquote {
      margin: var(--space-5) 0;
      padding: 0 0 0 var(--space-4);
      max-width: 66ch;
      border-left: 2px solid var(--color-border-strong);
      color: var(--color-ink-medium);
    }

    & .doc-guide__body table {
      width: 100%;
      max-width: 100%;
      border-collapse: collapse;
      margin: var(--space-4) 0;
      font-size: var(--text-small);
      font-family: var(--font-sans);
    }

    & .doc-guide__body th,
    & .doc-guide__body td {
      border: 1px solid var(--color-border);
      padding: var(--space-3) var(--space-4);
      text-align: left;
      vertical-align: top;
    }

    & .doc-guide__body th {
      background: var(--color-canvas-alt);
      font-weight: 600;
    }

    & .doc-guide__body td code {
      font-size: 0.85em;
    }

    & .doc-guide__sidebar.docs-api-nav {
      grid-area: sidebar;
      position: sticky;
      top: var(--space-4);
      align-self: start;
      width: 100%;
      box-sizing: border-box;
      background-color: var(--color-canvas-raised);
      border: 1px solid var(--color-border);
      border-radius: var(--radius-lg);
      box-shadow: var(--shadow-card);
      padding: var(--space-4) var(--space-4) var(--space-3);
    }

    @media (max-width: 72rem) {
      & .doc-guide__sidebar.docs-api-nav {
        position: static;
        top: auto;
        padding: 0;
        border: none;
        box-shadow: none;
        background: transparent;
      }
    }

    & .docs-api-nav__title {
      font-weight: 600;
      margin-bottom: var(--space-2);
      font-size: var(--text-caption);
      text-transform: uppercase;
      letter-spacing: 0.04em;
      color: var(--color-ink-light);
      text-wrap: balance;
      overflow-wrap: break-word;
      hyphens: auto;
    }

    & .docs-api-nav__list {
      list-style: none;
      margin: 0;
      padding: 0;
    }

    & .docs-api-nav__list li {
      margin: 0 0 var(--space-1);
    }

    & .docs-api-nav__link {
      display: block;
      padding: 0.625rem 0.75rem;
      border-radius: var(--radius-md);
      font-size: var(--text-body);
      font-weight: 500;
      color: var(--color-ink-dark);
      text-decoration: none;
      overflow-wrap: break-word;
      hyphens: auto;
      transition:
        background-color 0.15s ease,
        color 0.15s ease;
    }

    & .docs-api-nav__link:hover {
      background-color: var(--color-canvas);
      color: var(--color-ink);
    }

    & .docs-api-nav__link--active {
      background-color: var(--color-primary-light);
      color: var(--color-primary);
      font-weight: 600;
    }

    & .mermaid-diagram {
      margin: var(--space-4) 0;
      padding: var(--space-3) var(--space-4);
      border-radius: var(--radius);
      border: 1px solid var(--color-border);
      background: var(--color-canvas-alt);
      overflow-x: auto;
      max-width: 100%;
    }

    & .mermaid-diagram__error {
      margin: var(--space-3) 0;
      padding: var(--space-2) var(--space-3);
      border-radius: var(--radius);
      border: 1px solid var(--color-border);
      background: var(--color-canvas-inset);
      color: var(--color-ink-medium);
      font-size: var(--text-small);
      font-family: var(--font-mono);
      max-width: 100%;
    }
  }
}