/* ============================================================
   DESIGN TOKENS
   Site-level custom properties layered on top of Material's
   variables. Prefix: --site-* to avoid collisions.
   ============================================================ */

:root {
  /* Typography */
  --md-text-font: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,
    "Segoe UI", Roboto, sans-serif;
  --md-code-font: ui-monospace, "SF Mono", "SFMono-Regular", Menlo, Consolas,
    "Liberation Mono", monospace;

  /* Border radius scale */
  --site-radius-xs:   4px;
  --site-radius-sm:   6px;
  --site-radius-md:   8px;
  --site-radius-lg:   12px;
  --site-radius-pill: 999px;

  /* Transition durations */
  --site-transition-fast: 0.12s ease;
  --site-transition-base: 0.15s ease;
  --site-transition-slow: 0.20s ease;

  /* Semantic colors */
  --site-color-success: #30d158;
}


/* ============================================================
   THEME: LIGHT  (Apple-inspired clean white)
   ============================================================ */

[data-md-color-scheme="default"] {
  --md-primary-fg-color:             #1d1d1f;
  --md-primary-fg-color--light:      #6e6e73;
  --md-primary-fg-color--dark:       #1d1d1f;
  --md-primary-bg-color:             #ffffff;
  --md-primary-bg-color--light:      #f5f5f7;

  --md-accent-fg-color:              #0071e3;
  --md-accent-fg-color--transparent: #0071e318;
  --md-accent-bg-color:              #ffffff;

  --md-default-fg-color:             #1d1d1f;
  --md-default-fg-color--light:      #6e6e73;
  --md-default-fg-color--lighter:    #a1a1a6;
  --md-default-fg-color--lightest:   #d2d2d7;

  --md-default-bg-color:             #ffffff;
  --md-default-bg-color--light:      #f5f5f7;
  --md-default-bg-color--lighter:    #f5f5f7;
  --md-default-bg-color--lightest:   #e8e8ed;

  --md-code-fg-color:                #1d1d1f;
  --md-code-bg-color:                #f5f5f7;

  --md-typeset-a-color:              #0071e3;

  --site-shadow-card: 0 1px 2px rgba(0, 0, 0, 0.04),
                      0 4px 12px -2px rgba(0, 0, 0, 0.06);
}


/* ============================================================
   THEME: DARK  (Google Cloud docs palette)
   ============================================================ */

[data-md-color-scheme="slate"] {
  --md-primary-fg-color:             #e8eaed;
  --md-primary-fg-color--light:      #9aa0a6;
  --md-primary-fg-color--dark:       #ffffff;
  --md-primary-bg-color:             #202124;
  --md-primary-bg-color--light:      #292a2d;

  --md-accent-fg-color:              #8ab4f8;
  --md-accent-fg-color--transparent: #8ab4f818;
  --md-accent-bg-color:              #202124;

  --md-default-fg-color:             #e8eaed;
  --md-default-fg-color--light:      #9aa0a6;
  --md-default-fg-color--lighter:    #5f6368;
  --md-default-fg-color--lightest:   #3c4043;

  --md-default-bg-color:             #202124;
  --md-default-bg-color--light:      #292a2d;
  --md-default-bg-color--lighter:    #292a2d;
  --md-default-bg-color--lightest:   #35363a;

  --md-code-fg-color:                #e8eaed;
  --md-code-bg-color:                #292a2d;

  --md-typeset-a-color:              #8ab4f8;

  --site-shadow-card: 0 1px 2px rgba(0, 0, 0, 0.20),
                      0 4px 12px -2px rgba(0, 0, 0, 0.30);
}


/* ============================================================
   BASE
   ============================================================ */

html {
  scroll-behavior: smooth;
}


/* ============================================================
   LAYOUT
   ============================================================ */

.md-grid {
  max-width: 100%;
  padding: 0 1rem;
}

/* Sidebar widths — desktop only */
@media screen and (min-width: 76.25em) {
  .md-sidebar            { width: 14rem; }
  .md-sidebar--secondary { width: 13rem; }
}

.md-content {
  max-width: none;
}

.md-content__inner {
  max-width: 1008px;
  padding: 2.5rem 2rem 5rem;
}

/* Tablet */
@media screen and (max-width: 76.1875em) {
  .md-content__inner {
    padding: 2rem 1.5rem 4rem;
  }
}

/* Mobile */
@media screen and (max-width: 44.9375em) {
  .md-grid {
    padding: 0;
  }
  .md-content__inner {
    padding: 1.5rem 1rem 3rem;
  }
  .md-typeset {
    font-size: 0.82rem;
  }
  .md-typeset h1 {
    font-size: 1.45rem;
  }
  .md-typeset h2 {
    font-size: 1.15rem;
    margin-top: 2em;
  }
  .md-typeset h3 {
    font-size: 0.95rem;
  }
  .md-typeset pre > code {
    padding: 0.75rem 0.85rem;
    font-size: 0.8em;
  }
  .md-copy-markdown-fixed {
    bottom: 5rem;
    right: 1rem;
  }
}


/* ============================================================
   HEADER
   ============================================================ */

/* Seamless: suppress Material's scroll-triggered shadow */
.md-header,
.md-header--shadow {
  box-shadow: none !important;
  background-color: var(--md-default-bg-color) !important;
  color: var(--md-default-fg-color) !important;
}

.md-header__button,
.md-header__title {
  color: var(--md-default-fg-color) !important;
}

/* Dark-mode logo inversion (logo rendered as <img>, not inline SVG) */
[data-md-color-scheme="slate"] .md-logo img {
  filter: brightness(0) invert(1);
}

/* Theme toggle button */
.md-header__button[for="__palette"] {
  width: 2rem;
  height: 2rem;
  padding: 0.3rem;
  margin: 0 0.1rem;
  border: none;
  border-radius: var(--site-radius-sm);
  background: transparent;
  color: var(--md-default-fg-color--light);
  transition: background-color var(--site-transition-base),
              color var(--site-transition-base);
}

.md-header__button[for^="__palette"] svg {
  display: block;
  width: 1.1rem;
  height: 1.1rem;
  transition: transform 0.2s ease-in-out;
}

.md-header__button[for^="__palette"]:hover svg {
  transform: scale(1.15);
}


/* ============================================================
   SEARCH
   ============================================================ */

.md-search__form {
  border-radius: var(--site-radius-md);
  border: 1px solid var(--md-default-fg-color--lightest);
  background: var(--md-default-bg-color--light);
  transition: border-color var(--site-transition-base),
              box-shadow var(--site-transition-base);
}

.md-search__form:focus-within {
  border-color: var(--md-accent-fg-color);
  box-shadow: 0 0 0 3px var(--md-accent-fg-color--transparent);
}

.md-search__input {
  background: transparent;
  color: var(--md-default-fg-color);
  border: none;
  border-radius: var(--site-radius-md);
}

.md-search__input::placeholder {
  color: var(--md-default-fg-color--lighter);
}

.md-search__icon {
  color: var(--md-default-fg-color--light);
}

.md-search__icon:hover {
  color: var(--md-default-fg-color);
  opacity: 1;
}

/* Results dropdown */
.md-search__output {
  border-radius: 0 0 var(--site-radius-md) var(--site-radius-md);
  border: 1px solid var(--md-default-fg-color--lightest);
  border-top: none;
  box-shadow: var(--site-shadow-card);
  overflow: hidden;
}

.md-search__scrollwrap {
  background-color: var(--md-default-bg-color);
}

.md-search-result__meta {
  background-color: var(--md-default-bg-color--light);
  color: var(--md-default-fg-color--lighter);
  border-bottom: 1px solid var(--md-default-fg-color--lightest);
  font-size: 0.7rem;
  padding: 0.4em 1em;
}

.md-search-result__item {
  border-top: 1px solid var(--md-default-fg-color--lightest);
}

.md-search-result__link:hover .md-search-result__article,
.md-search-result__link:focus .md-search-result__article {
  background-color: var(--md-default-bg-color--light);
}

.md-search-result__title {
  color: var(--md-default-fg-color);
  font-weight: 600;
  font-size: 0.85rem;
}

.md-search-result__teaser {
  color: var(--md-default-fg-color--light);
  font-size: 0.78rem;
  line-height: 1.6;
}

.md-search-result mark {
  color: var(--md-accent-fg-color);
  background-color: var(--md-accent-fg-color--transparent);
  border-radius: 2px;
  padding: 0 1px;
  font-style: normal;
}


/* ============================================================
   NAVIGATION — PRIMARY SIDEBAR
   ============================================================ */

/* Zero external gap — no margin anywhere between items */
.md-nav--primary .md-nav__item {
  margin: 0 !important;
}

/* Nav links: consistent font size, muted default, smooth hover */
.md-nav--primary .md-nav__link {
  font-size: 0.72rem;
  line-height: 1.45;
  padding-top: 0.25em !important;
  padding-bottom: 0.25em !important;
  color: var(--md-default-fg-color--light);
  transition: color var(--site-transition-fast);
}


.md-nav--primary .md-nav__link:hover,
.md-nav--primary .md-nav__link:focus {
  color: var(--md-default-fg-color);
}

/* Active item: left-accent bar */
.md-nav--primary .md-nav__link--active {
  color: var(--md-accent-fg-color) !important;
  font-weight: 500;
  border-left: 2px solid var(--md-accent-fg-color);
  border-radius: 0 var(--site-radius-xs) var(--site-radius-xs) 0;
  padding-left: 0.6em;
  margin-left: -0.6em;
}


/* ============================================================
   NAVIGATION — TOC (SECONDARY SIDEBAR)
   Scoped to .md-sidebar--secondary to avoid bleed into other navs.
   ============================================================ */

/* Zero external gap between items */
.md-sidebar--secondary .md-nav__item {
  margin: 0 !important;
}

/* TOC label ("Table of contents") */
.md-sidebar--secondary .md-nav__title {
  font-size: 0.6rem;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--md-default-fg-color--lighter);
  padding-bottom: 0.4em;
}

/* Links: compact, muted, smooth hover */
.md-sidebar--secondary .md-nav__link {
  font-size: 0.65rem;
  line-height: 1.35;
  padding-top: 0.18em !important;
  padding-bottom: 0.18em !important;
  color: var(--md-default-fg-color--light);
  transition: color var(--site-transition-fast);
}

.md-sidebar--secondary .md-nav__link:hover,
.md-sidebar--secondary .md-nav__link:focus {
  color: var(--md-default-fg-color);
}

/* Active item: accent colour only */
.md-sidebar--secondary .md-nav__link--active {
  color: var(--md-accent-fg-color) !important;
  font-weight: 500;
}


/* ============================================================
   PAGE META
   ============================================================ */

.page-meta {
  display: flex;
  flex-wrap: wrap;
  gap: 0.8rem;
  margin-top: 0.3rem;
  margin-bottom: 1.8rem;
}

.page-meta__item {
  font-size: 0.78rem;
  font-style: italic;
  color: var(--md-default-fg-color--lighter);
  letter-spacing: 0.02em;
}

.md-nav__link[href^="http"]::after {
  content: "⧉ ↗";
  font-size: 0.7em;
  margin-left: 0.3em;
  opacity: 0.85;
}


/* ============================================================
   FOOTER
   ============================================================ */

.md-footer,
.md-footer-meta {
  background-color: var(--md-default-bg-color);
}

.md-footer__title,
.md-footer__direction,
.md-footer-copyright {
  color: var(--md-default-fg-color--light);
}

/* Footer social icons: scoped to .md-footer so these rules don't bleed
   into any other component that happens to use .md-social__link.
   !important required to beat Material's inline SVG dimension attributes. */
.md-footer .md-social__link {
  color: var(--md-default-fg-color) !important;
  opacity: 0.8 !important;
  width: 1.26rem !important;
  height: 1.26rem !important;
  margin: 0 0.35rem 0.55rem !important;
  transition: color 0.35s ease, filter 0.35s ease, opacity 0.35s ease, transform 0.2s ease-in-out !important;
}

.md-footer .md-social__link svg {
  width: 100% !important;
  height: 100% !important;
  max-width: none !important;
  max-height: none !important;
}

.md-footer .md-social__link:hover {
  color: var(--md-accent-fg-color) !important;
  filter: none !important;
  opacity: 1 !important;
  transform: scale(1.1) !important;
}


/* ============================================================
   TYPOGRAPHY
   ============================================================ */

.md-typeset {
  font-size: 0.88rem;
  line-height: 1.8;
}

.md-typeset h1 {
  font-size: 1.9rem;
  font-weight: 700;
  letter-spacing: -0.025em;
  margin-bottom: 0.6em;
  line-height: 1.2;
}

.md-typeset h2 {
  font-size: 1.3rem;
  font-weight: 600;
  letter-spacing: -0.015em;
  margin-top: 2.8em;
  margin-bottom: 0.8em;
}

.md-typeset h3 {
  font-size: 1.05rem;
  font-weight: 600;
  margin-top: 2em;
  margin-bottom: 0.6em;
}

/* Light mode: anchor headings to near-black (avoids cascaded grey) */
[data-md-color-scheme="default"] .md-typeset h1,
[data-md-color-scheme="default"] .md-typeset h2,
[data-md-color-scheme="default"] .md-typeset h3,
[data-md-color-scheme="default"] .md-typeset h4 {
  color: var(--md-default-fg-color);
}

.md-typeset p {
  margin-bottom: 1.25em;
}

.md-typeset ul,
.md-typeset ol {
  margin-bottom: 1.25em;
  padding-left: 1.5em;
}

.md-typeset li {
  margin-bottom: 0.4em;
}

.md-typeset hr {
  margin: 2.5em 0;
  border-color: var(--md-default-fg-color--lightest);
}


/* ============================================================
   LINKS
   ============================================================ */

/* Content links: border-bottom underline instead of text-decoration */
.md-typeset a {
  text-decoration: none;
  border-bottom: 1px solid var(--md-typeset-a-color);
  transition: color var(--site-transition-fast),
              border-color var(--site-transition-fast),
              opacity var(--site-transition-fast);
}

.md-typeset a:hover {
  opacity: 0.8;
}

/* Structural/UI links: no underline */
.md-nav a,
.md-header a,
.md-footer a,
.md-tabs a {
  border-bottom: none !important;
  text-decoration: none;
}

/* Copy page button: no underline (own rule, isolated from link resets above) */
.md-copy-markdown {
  text-decoration: none;
}

/* Permalink: fade in on heading hover */
.md-typeset .headerlink {
  color: var(--md-default-fg-color--lighter);
  opacity: 0;
  margin-left: 0.3em;
  font-weight: 400;
  transition: opacity var(--site-transition-base);
}

.md-typeset h1:hover .headerlink,
.md-typeset h2:hover .headerlink,
.md-typeset h3:hover .headerlink,
.md-typeset h4:hover .headerlink {
  opacity: 1;
}


/* ============================================================
   CODE
   ============================================================ */

/* Inline code */
.md-typeset code {
  font-size: 0.875em;
  border-radius: var(--site-radius-xs);
  padding: 0.15em 0.35em;
}

/* Code block container */
.md-typeset pre {
  border-radius: var(--site-radius-md);
  margin: 0.35em 0 2.2em;
  border: 1px solid var(--md-default-fg-color--lightest);
  box-shadow: var(--site-shadow-card);
}

/* Code block content */
.md-typeset pre > code {
  padding: 1rem 1.2rem;
  font-size: 0.85em;
  line-height: 1.65;
}

/* Language label bar (CSS-only via :has — no JS required) */
.md-typeset .highlight:has(> pre > code[class*="language-"])::before {
  display: block;
  padding: 0.4em 1.2rem;
  font-size: 0.7rem;
  font-weight: 600;
  font-family: var(--md-text-font);
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--md-default-fg-color--lighter);
  background: var(--md-default-bg-color--lightest);
  border-bottom: 1px solid var(--md-default-fg-color--lightest);
  border-radius: var(--site-radius-sm) var(--site-radius-sm) 0 0;
}

/* Code block highlight wrapper: asymmetric margins — snug above, open below */
.md-typeset .highlight {
  margin: 0.35em 0 2.2em;
}

/* Flatten top corners of pre block when label bar is present */
.md-typeset .highlight:has(> pre > code[class*="language-"]) > pre {
  border-radius: 0 0 var(--site-radius-sm) var(--site-radius-sm);
  margin-top: 0;
}

/* Language label text per language */
.md-typeset .highlight:has(> pre > code.language-bash)::before       { content: "bash"; }
.md-typeset .highlight:has(> pre > code.language-sh)::before         { content: "shell"; }
.md-typeset .highlight:has(> pre > code.language-shell)::before      { content: "shell"; }
.md-typeset .highlight:has(> pre > code.language-python)::before     { content: "python"; }
.md-typeset .highlight:has(> pre > code.language-py)::before         { content: "python"; }
.md-typeset .highlight:has(> pre > code.language-go)::before         { content: "go"; }
.md-typeset .highlight:has(> pre > code.language-yaml)::before       { content: "yaml"; }
.md-typeset .highlight:has(> pre > code.language-json)::before       { content: "json"; }
.md-typeset .highlight:has(> pre > code.language-dockerfile)::before { content: "dockerfile"; }
.md-typeset .highlight:has(> pre > code.language-javascript)::before { content: "javascript"; }
.md-typeset .highlight:has(> pre > code.language-typescript)::before { content: "typescript"; }

/* Code block copy button */
.md-code__button {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: 5px 8px;
  background: var(--md-default-bg-color--light);
  border: 1px solid var(--md-default-fg-color--lightest);
  border-radius: var(--site-radius-md);
  color: var(--md-default-fg-color--light);
  transition: color var(--site-transition-base),
              border-color var(--site-transition-base),
              background-color var(--site-transition-base);
}

.md-code__button:hover {
  color: var(--md-accent-fg-color);
  border-color: var(--md-accent-fg-color);
  background: var(--md-default-bg-color--lighter);
}

.md-code__button.copied {
  color: var(--site-color-success);
  border-color: var(--site-color-success);
}


/* ============================================================
   BLOCKQUOTES
   ============================================================ */

.md-typeset blockquote {
  border-left: 3px solid var(--md-accent-fg-color);
  padding: 0.6em 1.2em;
  margin: 1.8em 0;
  color: var(--md-default-fg-color--light);
  font-style: normal;
}


/* ============================================================
   TABLES
   ============================================================ */

.md-typeset table {
  font-size: 0.875em;
  display: block;
  overflow-x: auto;
  border: 1px solid var(--md-default-fg-color--lightest);
  border-radius: var(--site-radius-md);
  box-shadow: var(--site-shadow-card);
}

.md-typeset th,
.md-typeset td {
  padding: 0.6em 1em;
  border-color: var(--md-default-fg-color--lightest);
}

.md-typeset tbody tr {
  transition: background-color var(--site-transition-fast);
}

.md-typeset tbody tr:hover {
  background-color: var(--md-default-bg-color--light);
}


/* ============================================================
   ADMONITIONS
   ============================================================ */

/* Left-accent strip; no card shadow */
.md-typeset .admonition,
.md-typeset details {
  border-radius: var(--site-radius-sm);
  border-width: 0;
  border-left-width: 3px;
  box-shadow: none;
  font-size: 0.875em;
}

.md-typeset .admonition-title,
.md-typeset summary {
  font-weight: 600;
  font-size: 0.8rem;
  border-radius: 0;
  background: transparent !important;
}


/* ============================================================
   COPY MARKDOWN BUTTON
   ============================================================ */

/* Row inserted above page h1 */
.md-copy-markdown-row {
  display: flex;
  justify-content: flex-end;
  margin-bottom: 1.2rem;
  padding-bottom: 2px;
  overflow: visible;
  position: relative;
  z-index: 1;
}

/* Fixed floating variant (bottom-right) */
.md-copy-markdown-fixed {
  position: fixed;
  bottom: 4rem;
  right: 7rem;
  z-index: 100;
}

/* Button — shared by both placements */
.md-copy-markdown {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  padding: 7px 13px;
  font-size: 0.8rem;
  font-weight: 500;
  font-family: var(--md-text-font);
  line-height: 1;
  white-space: nowrap;
  user-select: none;
  color: var(--md-default-fg-color--light);
  background: var(--md-default-bg-color--light);
  border: 1px solid var(--md-default-fg-color--lightest);
  border-radius: var(--site-radius-md);
  cursor: pointer;
  transition: color var(--site-transition-base),
              border-color var(--site-transition-base),
              background-color var(--site-transition-base);
}

.md-copy-markdown:hover {
  color: var(--md-accent-fg-color);
  border-color: var(--md-accent-fg-color);
  background: var(--md-default-bg-color--lighter);
}

.md-copy-markdown:focus-visible {
  outline: 2px solid var(--md-accent-fg-color);
  outline-offset: 2px;
}

.md-copy-markdown:active {
  transform: scale(0.96);
}

.md-copy-markdown svg {
  display: block;
  flex-shrink: 0;
}

.md-copy-markdown.copied {
  color: var(--site-color-success);
  border-color: var(--site-color-success);
  background: var(--md-default-bg-color--lighter);
}

/* Suppress Material's built-in copy snackbar (custom toast used instead) */
.md-dialog[data-md-component="dialog"] {
  display: none !important;
}


/* ============================================================
   TOAST NOTIFICATION
   ============================================================ */

.md-copy-toast {
  position: fixed;
  bottom: 2rem;
  left: 50%;
  z-index: 200;
  display: inline-flex;
  align-items: center;
  gap: 0.4em;
  padding: 0.45em 1em;
  font-size: 0.8rem;
  font-family: var(--md-text-font);
  background-color: var(--md-default-fg-color);
  color: var(--md-default-bg-color);
  border-radius: var(--site-radius-pill);
  opacity: 0;
  pointer-events: none;
  transform: translateX(-50%) translateY(0.6rem);
  transition: opacity var(--site-transition-slow),
              transform var(--site-transition-slow);
}

.md-copy-toast.show {
  opacity: 1;
  transform: translateX(-50%) translateY(0);
}