/* ==========================================================================
   nginstack JSDoc Theme — Unified with Hugo Docsy (Bootstrap 5.3 + Roboto)
   ========================================================================== */

:root,
[data-bs-theme="light"] {
  --td-primary: #1565c0;
  --td-primary-hover: #104f96;
  --td-secondary: #63789d;
  --td-navbar-bg: #1565c0;
  --td-navbar-text: rgba(255, 255, 255, 0.75);
  --td-navbar-text-active: #ffffff;
  --td-body-bg: #ffffff;
  --td-body-color: #212529;
  --td-muted-color: #6c757d;
  --td-heading-color: #1a1d20;
  --td-border-color: #dee2e6;
  --td-border-subtle: #e9ecef;
  --td-sidebar-bg: #f8f9fa;
  --td-sidebar-hover: rgba(21, 101, 192, 0.08);
  --td-sidebar-active-bg: rgba(21, 101, 192, 0.13);
  --td-sidebar-active-color: #1565c0;
  --td-surface-bg: #f8f9fa;
  --td-surface-alt: #f1f3f5;
  --td-link-color: #1565c0;
  --td-link-hover-color: #0d47a1;
  --td-code-inline-bg: rgba(27, 31, 35, 0.06);
  --td-code-inline-color: #0d3c73;
  --td-pre-bg: #f6f8fa;
  --td-pre-border: #d0d7de;
  --td-table-stripe: rgba(0, 0, 0, 0.02);
  --td-table-head-bg: #f8f9fa;
  --td-deprecated-bg: #fff8e6;
  --td-deprecated-border: #f59f00;
  --td-deprecated-text: #664d03;
  --td-footer-bg: #343a40;
  --td-footer-color: #dee2e6;
  --td-shadow-sm: 0 2px 8px rgba(0, 0, 0, 0.08);
  /* GitHub Light syntax tokens */
  --hl-keyword: #cf222e;
  --hl-string: #0a3069;
  --hl-comment: #6e7781;
  --hl-number: #0550ae;
  --hl-function: #8250df;
  --hl-builtin: #953800;
}

[data-bs-theme="dark"] {
  --td-primary: #4dabf7;
  --td-primary-hover: #74c0fc;
  --td-secondary: #869ab8;
  --td-navbar-bg: #0f4c81;
  --td-navbar-text: rgba(255, 255, 255, 0.75);
  --td-navbar-text-active: #ffffff;
  --td-body-bg: #17191c;
  --td-body-color: #e2e6ea;
  --td-muted-color: #9aa0a6;
  --td-heading-color: #f8f9fa;
  --td-border-color: #30363d;
  --td-border-subtle: #24292f;
  --td-sidebar-bg: #1c1f24;
  --td-sidebar-hover: rgba(77, 171, 247, 0.12);
  --td-sidebar-active-bg: rgba(77, 171, 247, 0.18);
  --td-sidebar-active-color: #74c0fc;
  --td-surface-bg: #1f2329;
  --td-surface-alt: #262b33;
  --td-link-color: #58a6ff;
  --td-link-hover-color: #79c0ff;
  --td-code-inline-bg: rgba(110, 118, 129, 0.25);
  --td-code-inline-color: #a5d6ff;
  --td-pre-bg: #161b22;
  --td-pre-border: #30363d;
  --td-table-stripe: rgba(255, 255, 255, 0.025);
  --td-table-head-bg: #21262d;
  --td-deprecated-bg: rgba(210, 153, 34, 0.14);
  --td-deprecated-border: #d29922;
  --td-deprecated-text: #e3b341;
  --td-footer-bg: #111316;
  --td-footer-color: #adb5bd;
  --td-shadow-sm: 0 4px 12px rgba(0, 0, 0, 0.45);
  /* GitHub Dark syntax tokens */
  --hl-keyword: #ff7b72;
  --hl-string: #a5d6ff;
  --hl-comment: #8b949e;
  --hl-number: #79c0ff;
  --hl-function: #d2a8ff;
  --hl-builtin: #ffa657;
}

/* Base & Typography */
*,
*::before,
*::after {
  box-sizing: border-box;
}

html {
  font-size: 16px;
  scroll-padding-top: 4.75rem;
}

body {
  margin: 0;
  font-family: 'Roboto', 'Helvetica Neue', Arial, sans-serif;
  font-size: 1rem;
  font-weight: 400;
  line-height: 1.6;
  color: var(--td-body-color);
  background-color: var(--td-body-bg);
  -webkit-font-smoothing: antialiased;
}

a {
  color: var(--td-link-color);
  text-decoration: none;
}

a:hover {
  color: var(--td-link-hover-color);
  text-decoration: underline;
}

code,
pre,
.signature,
.type-signature {
  font-family: 'Roboto Mono', SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', monospace;
}

code {
  font-size: 0.875em;
  color: var(--td-code-inline-color);
  background-color: var(--td-code-inline-bg);
  padding: 0.15em 0.35em;
  border-radius: 4px;
  word-break: break-word;
}

pre code {
  color: inherit;
  background: transparent;
  padding: 0;
  font-size: inherit;
}

/* Bootstrap-compatible Layout Utilities */
.container-fluid {
  width: 100%;
  padding-right: 1rem;
  padding-left: 1rem;
  margin-right: auto;
  margin-left: auto;
}

.row {
  display: flex;
  flex-wrap: wrap;
  margin-right: -1rem;
  margin-left: -1rem;
}

.d-flex { display: flex !important; }
.d-none { display: none !important; }
.align-items-center { align-items: center !important; }
.justify-content-between { justify-content: space-between !important; }
.justify-content-center { justify-content: center !important; }
.flex-column { flex-direction: column !important; }
.w-100 { width: 100% !important; }
.fw-bold { font-weight: 700 !important; }
.mb-0 { margin-bottom: 0 !important; }
.text-center { text-align: center !important; }

/* ==========================================================================
   Top Navbar (Docsy .td-navbar)
   ========================================================================== */
.td-navbar {
  position: sticky;
  top: 0;
  z-index: 1030;
  min-height: 4rem;
  background-color: var(--td-navbar-bg);
  color: #fff;
  padding: 0.5rem 1.25rem;
  box-shadow: 0 1px 4px rgba(0, 0, 0, 0.18);
  display: flex;
  align-items: center;
}

.td-navbar > .container-fluid {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0;
}

.navbar-brand {
  display: inline-flex;
  align-items: center;
  gap: 0.55rem;
  color: #fff !important;
  font-size: 1.25rem;
  text-decoration: none !important;
  padding: 0.25rem 0;
}

.navbar-brand__logo {
  display: inline-flex;
  align-items: center;
}

.navbar-brand__logo svg {
  height: 30px;
  width: 30px;
}

.td-navbar-nav-scroll .navbar-nav {
  display: flex;
  align-items: center;
  list-style: none;
  margin: 0;
  padding: 0;
  gap: 0.25rem;
}

.td-navbar .nav-link {
  display: inline-flex;
  align-items: center;
  padding: 0.5rem 0.75rem;
  color: var(--td-navbar-text) !important;
  font-weight: 700;
  font-size: 0.95rem;
  text-decoration: none !important;
  transition: color 0.15s ease-in-out;
  background: transparent !important;
  border: 0;
  cursor: pointer;
}

.td-navbar .nav-link:hover,
.td-navbar .nav-link:focus,
.td-navbar .nav-link.active {
  color: var(--td-navbar-text-active) !important;
  background: transparent !important;
}

.td-navbar .dropdown-toggle::after {
  display: inline-block;
  margin-left: 0.35em;
  vertical-align: 0.2em;
  content: "";
  border-top: 0.3em solid;
  border-right: 0.3em solid transparent;
  border-bottom: 0;
  border-left: 0.3em solid transparent;
}

.td-mobile-nav-toggle {
  color: #fff;
  background: transparent;
  border: 1px solid rgba(255, 255, 255, 0.3);
  border-radius: 4px;
  padding: 0.3rem 0.5rem;
  cursor: pointer;
}

/* Theme Dropdown */
.td-theme-selector {
  position: relative;
  margin-left: 0.25rem;
}

.td-theme-selector .theme-icon {
  display: none;
}

[data-theme-pref="light"] .td-theme-selector .theme-icon-light,
[data-theme-pref="dark"] .td-theme-selector .theme-icon-dark,
[data-theme-pref="auto"] .td-theme-selector .theme-icon-auto,
html:not([data-theme-pref]) .td-theme-selector .theme-icon-auto {
  display: inline-block;
}

.td-theme-selector .dropdown-menu {
  display: none;
  position: absolute;
  right: 0;
  left: auto;
  top: calc(100% + 0.25rem);
  min-width: 8rem;
  padding: 0.35rem 0;
  margin: 0;
  list-style: none;
  background-color: #212529;
  border: 1px solid rgba(255, 255, 255, 0.15);
  border-radius: 0.375rem;
  box-shadow: 0 0.5rem 1rem rgba(0, 0, 0, 0.25);
  z-index: 1050;
}

.td-theme-selector .dropdown-menu.show {
  display: block;
}

.td-theme-selector .dropdown-item {
  display: flex;
  align-items: center;
  gap: 0.6rem;
  width: 100%;
  padding: 0.42rem 0.9rem;
  border: 0;
  background: transparent;
  color: #dee2e6;
  font-size: 0.9rem;
  text-align: left;
  cursor: pointer;
}

.td-theme-selector .dropdown-item .theme-item-icon {
  opacity: 0.65;
  flex-shrink: 0;
}

.td-theme-selector .dropdown-item:hover {
  background-color: rgba(255, 255, 255, 0.08);
  color: #ffffff;
}

.td-theme-selector .dropdown-item.active {
  background-color: #1565c0;
  color: #ffffff;
  font-weight: 500;
}

.td-theme-selector .dropdown-item.active .theme-item-icon {
  opacity: 1;
}

/* ==========================================================================
   3-Column Main Grid (.td-outer / .td-main)
   ========================================================================== */
.td-outer {
  display: flex;
  flex-direction: column;
  min-height: calc(100vh - 4rem);
}

.td-main {
  flex: 1 0 auto;
}

.td-main > .row {
  margin: 0 -1rem;
}

/* Left Sidebar (.td-sidebar) */
.td-sidebar {
  background-color: var(--td-sidebar-bg);
  border-right: 1px solid var(--td-border-color);
  padding: 0;
}

.td-sidebar__inner {
  display: flex;
  flex-direction: column;
  height: 100%;
}

.td-sidebar__search {
  padding: 0.85rem 0.85rem 0.5rem;
  border-bottom: 1px solid var(--td-border-color);
  background-color: var(--td-sidebar-bg);
  position: sticky;
  top: 0;
  z-index: 2;
}

.td-search-box {
  position: relative;
  display: flex;
  align-items: center;
}

.td-search-icon {
  position: absolute;
  left: 0.65rem;
  color: var(--td-muted-color);
  pointer-events: none;
}

.td-search-input {
  width: 100%;
  padding: 0.42rem 1.8rem 0.42rem 2rem;
  font-size: 0.85rem;
  font-family: inherit;
  color: var(--td-body-color);
  background-color: var(--td-body-bg);
  border: 1px solid var(--td-border-color);
  border-radius: 5px;
  outline: none;
  transition: border-color 0.15s ease, box-shadow 0.15s ease;
}

.td-search-input:focus {
  border-color: var(--td-primary);
  box-shadow: 0 0 0 2px rgba(21, 101, 192, 0.2);
}

.td-search-clear {
  position: absolute;
  right: 0.4rem;
  border: 0;
  background: transparent;
  color: var(--td-muted-color);
  font-size: 1.1rem;
  line-height: 1;
  cursor: pointer;
  padding: 0.15rem 0.3rem;
}

.td-sidebar-tabs {
  display: flex;
  gap: 0.2rem;
  margin-top: 0.55rem;
}

.td-sidebar-tab {
  flex: 1;
  padding: 0.28rem 0.35rem;
  font-size: 0.75rem;
  font-weight: 500;
  color: var(--td-muted-color);
  background: transparent;
  border: 1px solid transparent;
  border-radius: 4px;
  cursor: pointer;
  transition: all 0.12s ease;
}

.td-sidebar-tab:hover {
  color: var(--td-body-color);
  background-color: var(--td-sidebar-hover);
}

.td-sidebar-tab.active {
  color: var(--td-sidebar-active-color);
  background-color: var(--td-sidebar-active-bg);
  border-color: rgba(21, 101, 192, 0.25);
  font-weight: 600;
}

/* Sidebar Navigation Tree (.td-sidebar-nav) */
.td-sidebar-nav {
  font-size: 0.9rem;
  padding: 0.65rem 0.5rem 2rem;
  overflow-y: auto;
}

.td-tree-list {
  list-style: none;
  padding-left: 0;
  margin: 0;
}

.td-tree-list .td-tree-list {
  padding-left: 0.7rem;
  border-left: 1px solid var(--td-border-color);
  margin-left: 0.45rem;
}

.td-tree-folder {
  margin: 1px 0;
}

.td-tree-toggle {
  display: flex;
  align-items: center;
  gap: 0.35rem;
  width: 100%;
  padding: 0.28rem 0.45rem;
  border: 0;
  background: transparent;
  color: var(--td-body-color);
  font-family: inherit;
  font-size: 0.88rem;
  font-weight: 500;
  text-align: left;
  border-radius: 4px;
  cursor: pointer;
}

.td-tree-toggle:hover {
  background-color: var(--td-sidebar-hover);
}

.td-tree-toggle--pkg {
  font-weight: 600;
  color: var(--td-heading-color);
  padding-top: 0.36rem;
  padding-bottom: 0.36rem;
}

.td-tree-chevron {
  display: inline-block;
  width: 0.85rem;
  font-size: 0.68rem;
  color: var(--td-muted-color);
  transition: transform 0.15s ease;
  flex-shrink: 0;
  text-align: center;
}

.td-tree-folder.open > .td-tree-toggle > .td-tree-chevron {
  transform: rotate(90deg);
}

.td-tree-folder:not(.open) > .td-tree-list {
  display: none;
}

.td-tree-count {
  margin-left: auto;
  font-size: 0.74rem;
  color: var(--td-muted-color);
  font-weight: 400;
}

.td-tree-item {
  display: flex;
  align-items: center;
  gap: 0.35rem;
  padding: 0.22rem 0.4rem;
  border-radius: 4px;
  margin: 1px 0;
}

.td-tree-item--flat {
  align-items: flex-start;
  padding: 0.28rem 0.4rem;
}

.td-tree-item--flat > .td-badge {
  margin-top: 0.15rem;
}

.td-tree-item:hover {
  background-color: var(--td-sidebar-hover);
}

.td-tree-item.active {
  background-color: var(--td-sidebar-active-bg);
}

.td-tree-link {
  flex: 1;
  min-width: 0;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
  color: var(--td-body-color);
  text-decoration: none !important;
  font-size: 0.875rem;
  line-height: 1.4;
}

.td-tree-link--stacked {
  display: flex;
  flex-direction: column;
  white-space: normal;
}

.td-tree-link__main {
  display: block;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
  font-size: 0.875rem;
  font-weight: 500;
  line-height: 1.35;
}

.td-tree-link__sub {
  display: block;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
  font-size: 0.75rem;
  color: var(--td-muted-color);
  line-height: 1.25;
}

.td-tree-item.active > .td-tree-link,
.td-tree-item.active > .td-tree-link .td-tree-link__main {
  color: var(--td-sidebar-active-color);
  font-weight: 600;
}

.td-badge {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 1.15rem;
  height: 1.15rem;
  font-size: 0.65rem;
  font-weight: 700;
  border-radius: 3px;
  flex-shrink: 0;
  text-decoration: none !important;
}

.td-badge--class {
  background-color: rgba(21, 101, 192, 0.15);
  color: var(--td-link-color);
}

.td-badge--module {
  background-color: rgba(99, 120, 157, 0.18);
  color: var(--td-secondary);
}

.td-badge--namespace {
  background-color: rgba(130, 80, 223, 0.15);
  color: var(--hl-function);
}

.td-badge--global {
  background-color: rgba(45, 164, 78, 0.16);
  color: #2da44e;
}

.td-badge-alt-link {
  font-size: 0.64rem;
  padding: 0.04rem 0.26rem;
  border-radius: 3px;
  background-color: var(--td-surface-alt);
  color: var(--td-muted-color) !important;
  text-decoration: none !important;
  border: 1px solid var(--td-border-color);
  flex-shrink: 0;
}

.td-badge-alt-link:hover,
.td-badge-alt-link.active {
  color: var(--td-link-color) !important;
  border-color: var(--td-link-color);
}

/* Right Sidebar Table of Contents (.td-sidebar-toc / .td-toc) */
.td-sidebar-toc {
  border-left: 1px solid var(--td-border-color);
  padding: 1.25rem 0.85rem;
}

.td-toc {
  font-size: 0.85rem;
}

.td-toc__title {
  font-weight: 700;
  font-size: 0.78rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--td-muted-color);
  margin-bottom: 0.6rem;
  padding-bottom: 0.35rem;
  border-bottom: 1px solid var(--td-border-color);
}

.td-toc-group {
  margin-bottom: 0.75rem;
}

.td-toc-group__heading {
  display: block;
  font-weight: 600;
  font-size: 0.8rem;
  color: var(--td-heading-color);
  margin-bottom: 0.25rem;
  text-decoration: none !important;
}

.td-toc-list {
  list-style: none;
  padding-left: 0.5rem;
  margin: 0;
  border-left: 1px solid var(--td-border-color);
}

.td-toc-list li {
  margin: 0.18rem 0;
}

.td-toc-link {
  display: block;
  color: var(--td-muted-color);
  font-size: 0.8rem;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
  padding: 0.1rem 0.35rem;
  border-radius: 3px;
  text-decoration: none !important;
}

.td-toc-link:hover,
.td-toc-link.active {
  color: var(--td-link-color);
  background-color: var(--td-sidebar-hover);
}

.td-toc-link.is-deprecated {
  text-decoration: line-through !important;
  opacity: 0.65;
}

/* ==========================================================================
   Main Content Area (.td-content)
   ========================================================================== */
main[role="main"] {
  padding: 1.5rem 2rem 3rem;
  min-width: 0;
}

.td-breadcrumbs {
  font-size: 0.85rem;
  color: var(--td-muted-color);
  margin-bottom: 0.85rem;
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 0.35rem;
}

.td-breadcrumbs a {
  color: var(--td-muted-color);
}

.td-breadcrumbs a:hover {
  color: var(--td-link-color);
}

.td-breadcrumbs__sep {
  opacity: 0.5;
}

.td-content {
  max-width: 58rem;
}

.td-content h1.page-title {
  font-size: 2rem;
  font-weight: 700;
  color: var(--td-heading-color);
  margin: 0 0 0.75rem;
  padding-bottom: 0.6rem;
  border-bottom: 1px solid var(--td-border-color);
  word-break: break-word;
}

.api-doc-header h2 {
  font-size: 1.25rem;
  font-weight: 500;
  color: var(--td-secondary);
  margin: 0 0 1rem;
}

.api-doc-header .ancestors a {
  color: var(--td-link-color);
}

.subsection-title {
  font-size: 1.35rem;
  font-weight: 600;
  color: var(--td-heading-color);
  margin: 2.25rem 0 1rem;
  padding-bottom: 0.4rem;
  border-bottom: 2px solid var(--td-border-color);
}

/* Related Module/Class Cross-Navigation Banner */
.api-related-banner {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 0.5rem;
  padding: 0.65rem 1rem;
  margin-bottom: 1.25rem;
  background-color: var(--td-surface-bg);
  border: 1px solid var(--td-border-color);
  border-left: 4px solid var(--td-primary);
  border-radius: 6px;
  font-size: 0.9rem;
}

.api-related-banner a {
  font-weight: 600;
}

/* Symbol Lists (Classes, Mixins, Namespaces inside a module) */
.api-symbol-list {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
  gap: 0.75rem;
  margin: 0 0 1.5rem;
}

.api-symbol-list dt {
  background-color: var(--td-surface-bg);
  border: 1px solid var(--td-border-color);
  border-radius: 6px;
  padding: 0.65rem 0.9rem;
  font-weight: 600;
  font-family: 'Roboto Mono', monospace;
  font-size: 0.9rem;
}

.api-symbol-list dd {
  display: none;
}

/* Member & Method Entries */
.td-content hr {
  border: 0;
  border-top: 1px solid var(--td-border-color);
  margin: 1.75rem 0 1.25rem;
}

.api-item-header h4.name {
  font-family: 'Roboto Mono', SFMono-Regular, Consolas, monospace;
  font-size: 1.05rem;
  font-weight: 600;
  color: var(--td-heading-color);
  background-color: var(--td-surface-bg);
  border: 1px solid var(--td-border-color);
  border-left: 4px solid var(--td-primary);
  padding: 0.6rem 0.9rem;
  border-radius: 6px;
  margin: 0 0 0.75rem;
  position: relative;
  word-break: break-word;
}

.api-item-header h4.name .type-signature {
  color: var(--td-secondary);
  font-weight: 400;
  font-size: 0.92em;
}

.api-item-header h4.name .optional {
  color: var(--td-muted-color);
  font-weight: 400;
}

.api-anchor-link {
  margin-left: 0.5rem;
  opacity: 0;
  color: var(--td-muted-color);
  font-weight: 400;
  text-decoration: none !important;
  transition: opacity 0.15s ease;
}

.api-item-header h4.name:hover .api-anchor-link {
  opacity: 1;
}

.api-item-body {
  margin-left: 0;
  padding-left: 0.25rem;
}

.api-item-body h5 {
  font-size: 0.9rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.03em;
  color: var(--td-secondary);
  margin: 1.1rem 0 0.45rem;
}

.description p {
  margin: 0 0 0.75rem;
}

/* Details & Deprecated Notice */
dl.details {
  margin: 0.85rem 0;
  font-size: 0.9rem;
}

dl.details dt {
  font-weight: 600;
  color: var(--td-secondary);
  margin-top: 0.5rem;
}

dl.details dd {
  margin-left: 0;
  margin-bottom: 0.5rem;
}

dl.details ul.dummy {
  list-style: none;
  padding-left: 0;
  margin: 0.2rem 0;
}

dl.details dt.tag-deprecated {
  display: inline-block;
  color: var(--td-deprecated-text);
  font-weight: 700;
  background-color: var(--td-deprecated-bg);
  border: 1px solid var(--td-deprecated-border);
  border-bottom: 0;
  padding: 0.25rem 0.65rem 0.1rem;
  border-radius: 5px 5px 0 0;
  margin-top: 0.75rem;
}

dl.details dd.tag-deprecated {
  background-color: var(--td-deprecated-bg);
  border: 1px solid var(--td-deprecated-border);
  color: var(--td-deprecated-text);
  padding: 0.5rem 0.85rem;
  border-radius: 0 5px 5px 5px;
  margin-bottom: 0.75rem;
}

/* Tables (Parameters & Properties) */
.table {
  width: 100%;
  border-collapse: collapse;
  margin: 0.5rem 0 1.25rem;
  font-size: 0.9rem;
  border: 1px solid var(--td-border-color);
  border-radius: 6px;
  overflow: hidden;
}

.table th,
.table td {
  padding: 0.55rem 0.75rem;
  border-bottom: 1px solid var(--td-border-color);
  text-align: left;
  vertical-align: top;
}

.table thead th {
  background-color: var(--td-table-head-bg);
  color: var(--td-heading-color);
  font-weight: 600;
  border-bottom: 2px solid var(--td-border-color);
}

.table-striped tbody tr:nth-of-type(odd) {
  background-color: var(--td-table-stripe);
}

.table td.type,
.param-type {
  font-family: 'Roboto Mono', monospace;
  font-size: 0.85rem;
}

.param-type-sep {
  color: var(--td-muted-color);
  padding: 0 0.2rem;
}

.table td.attributes {
  font-family: 'Roboto Mono', monospace;
  font-size: 0.8rem;
  color: var(--td-muted-color);
}

/* Code Examples & Syntax Highlighting */
pre,
pre.code-example {
  position: relative;
  background-color: var(--td-pre-bg);
  border: 1px solid var(--td-pre-border);
  border-radius: 6px;
  padding: 0.9rem 1.1rem;
  overflow-x: auto;
  font-size: 0.875rem;
  line-height: 1.5;
  margin: 0.65rem 0 1.25rem;
}

.code-copy-btn {
  position: absolute;
  top: 0.45rem;
  right: 0.5rem;
  padding: 0.2rem 0.5rem;
  font-size: 0.72rem;
  font-family: 'Roboto', sans-serif;
  color: var(--td-muted-color);
  background-color: var(--td-body-bg);
  border: 1px solid var(--td-border-color);
  border-radius: 4px;
  cursor: pointer;
  opacity: 0;
  transition: opacity 0.15s ease;
}

pre:hover .code-copy-btn {
  opacity: 1;
}

.code-copy-btn:hover {
  color: var(--td-link-color);
  border-color: var(--td-link-color);
}

.hl-kw { color: var(--hl-keyword); font-weight: 500; }
.hl-str { color: var(--hl-string); }
.hl-cmt { color: var(--hl-comment); font-style: italic; }
.hl-num { color: var(--hl-number); }
.hl-fn { color: var(--hl-function); }

/* Homepage Package Grid & Section Index Pages */
.api-home-overview {
  margin-top: 2rem;
}

.api-pkg-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
  gap: 1rem;
  margin-top: 1rem;
}

.api-pkg-card {
  display: flex;
  flex-direction: column;
  justify-content: space-between;
  padding: 1.1rem 1.25rem;
  background-color: var(--td-surface-bg);
  border: 1px solid var(--td-border-color);
  border-radius: 8px;
  transition: border-color 0.15s ease, transform 0.15s ease;
}

.api-pkg-card:hover {
  border-color: var(--td-primary);
  transform: translateY(-1px);
}

.api-pkg-card__title {
  font-family: 'Roboto Mono', monospace;
  font-weight: 700;
  font-size: 1rem;
  color: var(--td-link-color);
  margin: 0 0 0.35rem;
}

.api-pkg-card__meta {
  font-size: 0.82rem;
  color: var(--td-muted-color);
}

.section-index-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: 0.5rem;
  margin-top: 1rem;
}

.section-index-item {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  padding: 0.45rem 0.75rem;
  background-color: var(--td-surface-bg);
  border: 1px solid var(--td-border-color);
  border-radius: 5px;
  font-family: 'Roboto Mono', monospace;
  font-size: 0.84rem;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

/* Footer (.td-footer) */
.td-footer {
  background-color: var(--td-footer-bg);
  color: var(--td-footer-color);
  padding: 1.5rem 1rem;
  font-size: 0.875rem;
  margin-top: 3rem;
}

.td-footer a {
  color: #fff;
  text-decoration: underline;
}

/* ==========================================================================
   Responsive Breakpoints (Bootstrap 5 md = 768px, xl = 1200px)
   ========================================================================== */
@media (min-width: 768px) {
  .d-md-none { display: none !important; }
  .ms-md-auto { margin-left: auto !important; }
  .flex-md-row { flex-direction: row !important; }
  .w-md-auto { width: auto !important; }

  .td-sidebar {
    flex: 0 0 280px;
    max-width: 280px;
    position: sticky;
    top: 4rem;
    height: calc(100vh - 4rem);
  }

  .td-sidebar__inner {
    height: 100%;
  }

  .td-sidebar-nav {
    flex: 1;
  }

  main[role="main"] {
    flex: 1 1 0%;
  }
}

@media (min-width: 1200px) {
  .d-xl-block { display: block !important; }
  .flex-xl-nowrap { flex-wrap: nowrap !important; }

  .td-sidebar {
    flex: 0 0 300px;
    max-width: 300px;
  }

  .td-sidebar-toc {
    flex: 0 0 240px;
    max-width: 240px;
    order: 2;
    position: sticky;
    top: 4rem;
    height: calc(100vh - 4rem);
    overflow-y: auto;
  }

  main[role="main"] {
    order: 1;
  }
}

@media (max-width: 767.98px) {
  .td-navbar > .container-fluid {
    flex-direction: column;
    align-items: stretch;
  }

  .td-navbar-nav-scroll {
    margin-top: 0.35rem;
    overflow-x: auto;
  }

  .td-sidebar {
    display: none;
    width: 100%;
    border-right: 0;
    border-bottom: 1px solid var(--td-border-color);
    max-height: 70vh;
    overflow-y: auto;
  }

  .td-sidebar.mobile-open {
    display: block;
  }

  main[role="main"] {
    width: 100%;
    padding: 1rem 1.25rem 2.5rem;
  }
}